Function.prototype.bind replacement that provides an unbounded
hidden property on the returned bounded function, that contains the original unbounded function
- Install:
npm install --save unbounded
- Require:
require('unbounded')
<script type="module">
import * as pkg from '//dev.jspm.io/unbounded'
</script>
This package is published with the following editions:
-
unbounded
aliasesunbounded/index.js
which uses Editions to automatically select the correct edition for the consumers environment -
unbounded/source/index.js
is esnext source code with require for modules -
unbounded/edition-browsers/index.js
is esnext compiled for browsers with require for modules -
unbounded/edition-node-0.8/index.js
is esnext compiled for node.js 0.8 with require for modules
This package functions like Function.prototype.bind
, however it exposes a hidden unbounded
property on the returned bounded function that contains the original unbounded function.
This is very useful as it means you can do (fn.unbounded || fn).length
to always get the correct amount of arguments, or (fn.unbounded || fn).toString()
to always get the source code of any function instead of getting function () { [native code] }
for bounded functions.
You can use unbounded via require('unbounded').binder
like so:
const {binder} = require('unbounded')
const context = { hello: 'world' }
function a () {
return this.hello
}
const b = binder.call(a, context)
equal(b(), context.hello, 'context was correct')
equal(b.unbounded, a, 'unbounded was correct')
Or you can patch Function.prototype.bind
directly:
require('unbounded').patch()
const context = { hello: 'world' }
function a () {
return this.hello
}
const b = a.bind(context)
equal(b(), context.hello, 'context was correct')
equal(b.unbounded, a, 'unbounded was correct')
Discover the release history by heading on over to the HISTORY.md
file.
Discover how you can contribute by heading on over to the CONTRIBUTING.md
file.
These amazing people are maintaining this project:
No sponsors yet! Will you be the first?
These amazing people have contributed code to this project:
Discover how you can contribute by heading on over to the CONTRIBUTING.md
file.
Unless stated otherwise all works are:
- Copyright © 2018+ Benjamin Lupton
and licensed under: