unbounded

unbounded

Function.prototype.bind replacement that provides an unbounded hidden property on the returned bounded function, that contains the original unbounded function

Install

npm

• Install: npm install --save unbounded
• Require: require('unbounded')

jspm

<script type="module">
    import * as pkg from '//dev.jspm.io/unbounded'
</script>

Editions

This package is published with the following editions:

• unbounded aliases unbounded/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

Usage

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')

History

Discover the release history by heading on over to the HISTORY.md file.

Contribute

Discover how you can contribute by heading on over to the CONTRIBUTING.md file.

Backers

Maintainers

These amazing people are maintaining this project:

• Benjamin Lupton — view contributions

Sponsors

No sponsors yet! Will you be the first?

Contributors

These amazing people have contributed code to this project:

• Benjamin Lupton — view contributions

Discover how you can contribute by heading on over to the CONTRIBUTING.md file.

License

Unless stated otherwise all works are:

• Copyright © 2018+ Benjamin Lupton

and licensed under:

• MIT License