function-extended

0.0.9 • Public • Published

Build Status

browser support

function-extended

function-extended is a Javascript library that can be used standalone or incorporated into extended

var fn = require("function-extended");

Or

var myextended = require("extended")
    .register(require("function-extended"));

Installation

npm install function-extended

Or download the source (minified)

Usage

bind

Binds a function to the specified scope, while currying any extra arguments.

bindAll

Binds all functions or a list of named functions to the specified scope.

var scope = {
    a: "a",
    b: "b",
    c: "c",
    aFunc: function () {
        return this.a;
    },
    bFunc: function () {
        return this.b;
    },
    cFunc: function () {
        return this.c;
    }
};
 
fn.bindAll(scope);
 
scope.aFunc.call({}); //"a"
scope.bFunc.call({}); //"a"
scope.cFunc.call({}); //"c"
 
//or
 
fn.bindAll(scope, ["aFunc"]);
 
scope.aFunc.call({}); //"a"
scope.bFunc.call({}); //undefined
scope.cFunc.call({}); //undefined
 

bindIgnore

Binds a function to the specified scope while ignoring any extra arguments passed in.

var func = function () {
    return [arguments.length, this.test];
};
var scope = {test: true};
 
var fn1 = fn.bindIgnore(obj, func, "hello"),
    fn2 = fn(func).bindIgnore(obj, "hello").f(),
    fn3 = fn(obj).bindIgnore(func, "hello");
 
 
fn1("world"); //[1, true]
fn2("world"); //[1,true]
fn3.f()("world"); //[1, true];

partial

Creates a function that does not change the eventual scope, but allows the you specify arguments that should be passed in.

var func = function (str) {
    return str + " " + this.world;
};
 
var a = fn.partial(func, "hello");
var b =fn(func).partial("hello").f();
 
a.call({world: "world"}); //hello world
b.call({world: "world"}); //hello world
 
//With a string
 
var c = fn.partial("test"),
    c2 = fn("test2").partial().f(),
 
var scope = {
    test : function(){
        return "hello";
    },
    test2 : function(){
        return "world";
    }
};
c.call(scope); //hello
c2.call(scope); //world

applyFirst

Binds the function to the first arguments passed in.

 
var func = function () {
    return this.test;
};
 
var newFn = fn.applyFirst(func);
newFn({test: true}); //true
 
newFn = fn(func).applyFirst().f();
newFn({test: true});
 
var push = fn.applyFirst("push"), pop = fn("pop").applyFirst().fn();
 
var arr = [];
push(arr, 1);
//arr === [1];
 
pop(arr);
//arr === [];
 

curry

Create a curried function.

var curried = fn.curry(4, function(a,b,c,d){
    return [a,b,c,d].join(",");
});
 
curried("a");
curried("b");
curried("c");
curried("d"); //"a,b,c,d"
 
//OR
 
curried("a")("b")("c")("d"); //"a,b,c,d"

Package Sidebar

Install

npm i function-extended

Weekly Downloads

3,279

Version

0.0.9

License

MIT

Last publish

Collaborators

  • damartin