part-native
v0.1.2
Published
generate helpful methods from native objects using _part_
Downloads
4
Maintainers
Readme
part-native
generate helpful methods from native objects using _part_
Why?
- With one small lib, you can use
part
to safely expose all available methods of an object. This can help make code more modular, functional, and maintainable. - When passing functions as first-class objects, we often lose the method receiver (thisArg).
part-native
methods are bound to their context or will allow you to curry the context. - Array methods will work on ArrayLike objects (including Arguments objects) so your code will contain less type checking and slicing of arguments.
- By using
part-native
at startup, your application will have cached versions of the functions you need, immune to attempts to hack the native object prototypes. - Turn your own simple prototypes into
part
-style method collections.
Getting started
Installation:
npm install --save-dev part-native
Usage:
Get a reference to a bound function on a native object.
var log = require( 'part-native' )( 'console' ).log;
[1,2,3].map( log );
or
var map_ = require( 'Array.map_' );
var logAll = map_( log );
logAll( [1,2,3] );
Get a reference to a collection of methods.
var partArray = require( 'part-native' )( 'Array' );
var sum = partArray.reduce_( add );
or use your own objects
function Klass( id ){
this.id = id;
}
Klass.prototype.test = function ( msg ) {
console.log( msg + this.id );
};
var partKlass = require( 'part-native' )( 'Klass', Klass );
var klassMsg = partKlass.test_( 'hi from ' );
klassMsg( new Klass( 1 ) );