README

unbounded

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

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

Install

npm

Install: npm install --save unbounded
Import: import * as pkg from ('unbounded')
Require: const pkg = require('unbounded')

jspm

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

Editions

This package is published with the following editions:

unbounded aliases unbounded/source/index.js
unbounded/source/index.js is ESNext source code for Node.js 10 || 12 || 14 || 16 with Require for modules
unbounded/edition-browsers/index.js is ESNext compiled for web browsers with Require for modules