Function

Type: Function

函数对象的方法。

另请参见:

• MDN Function

Function: Function.from

如果传递的参数是一个函数，它会返回自身。否则，它会返回一个可以返回传递参数的函数。

语法:

var foo = Function.from(obj);

参数:

1. obj - (mixed)如果该参数是一个函数，它只会返回自身。否则，它会返回一个可以返回传递参数的函数。

返回:

• (function)返回一个函数，此函数返回传递的参数。

示例:

var fn = Function.from(42);
alert(fn());    // alerts '42'
 
var fn2 = Function.from(fn);
alert(fn2());   // alerts '42'

Function: Function.attempt

执行一系列函数,返回第一个非失败的函数,如果没有成功的将返回null。

语法:

Function.attempt(fn[, fn, fn, fn, ...]);

参数:

• fn - (function)任意数量的函数。

返回:

• (mixed)第一个成功的函数返回值。
• (null)null，如果全部函数失败。

示例:

var result = Function.attempt(function(){
    return some.made.up.object;
}, function(){
    return jibberish.that.doesnt.exists;
}, function(){
    return false;
});
 
//result is false
 
var failure, success;
 
Function.attempt(function(){
    some.made.up.object = 'something';
    success = true;
}, function(){
    failure = true;
});
 
if (success) alert('yey!');

Function method: extend

扩展了一个函数新的方法或属性.

语法:

myFunction.extend(key, value);
 
// Or
 
myFunction.extend(object);

参数:

1. key - (string)方法或属性的
2. value - (mixed)函数或属性值

或

1. object - (object)包含多个属性或方法的对象

返回:

• (function)原函数

例如:

var myFunction = function(){};
myFunction.extend('alert', function(text){
    alert(text);
});
myFunction.alert('Hello!'); // alerts Hello!
 
// Using objects
myFunction.extend({
    alert: function(text){
        alert(text);
    }
});

Function method: implement

函数的原型扩展方法。

语法:

myFunction.implement(key, value);
 
// Or
 
myFunction.implement(object);

参数:

1. key - (string)方法或属性名.
2. value - (mixed)函数或属性值.

或

1. object - (object)包含新属性或方法的对象.

返回:

• (function)原函数.

例如:

var myFunction = function(){};
myFunction.implement('alert', function(text){
    alert(text);
});
var myInstance = new myFunction();
myInstance.alert('Hello!'); // alerts Hello!
 
// Using objects
myInstance.implement({
    alert: function(text){
        alert(text);
    }
});

注意事项:

implement和extend的区别,extend只影响一个对象的实例,而implement作用到原型上,影响此对象下的所有实例.

Function method: attempt

试图执行函数,如果它不失败则返回此函数的返回值，否则返回null 。

语法:

var myFunctionResult = myFunction.attempt(args[, bind]);

参数:

1. args - (mixed)参数，或参数的数组。
2. bind - (object, optional)函数绑定到此对象执行(函数内部this指向到此对象)。

返回:

• (mixed)这个函数的返回值。
• (null)函数失败。

示例:

var myFunction = function(){
    return some.made.up.object;
};
myFunction.attempt(); // returns 'null'
 
 
var myFunction = function(val){
    return val;
};
myFunction.attempt(false); // returns 'false'

Function method: pass

返回一个闭包。

语法:

var newFunction = myFunction.pass([args[, bind]]);

参数:

1. args - (mixed, optional)参数(如果传递多个参数,必须是一个数组)。
2. bind - (object, optional)函数绑定到此对象执行(函数内部this指向到此对象)。

返回:

• (function)一个新函数，它的参数调用时被传递。

例如:

var myFunction = function(){
    var result = 'Passed: ';
    for (var i = 0, l = arguments.length; i < l; i++){
        result += (arguments[i] + ' ');
    }
    return result;
}
var myHello = myFunction.pass('hello');
var myItems = myFunction.pass(['peach', 'apple', 'orange']);
 
// Later in the code, the functions can be executed:
alert(myHello()); // passes 'hello' to myFunction.
alert(myItems()); // passes the array of items to myFunction.

Function method: bind

改变this的作用范围,并向函数传递参数.

语法:

myFunction.bind([bind[, arg1, arg2, ...]]);

参数:

1. bind - (object, optional)函数绑定到此对象执行(函数内部this指向到此对象)。
2. arg1, arg2, ... - (mixed, optional)参数传递给函数。如果被绑定的函数被调用时有其他参数,参数将被合并。

返回:

• (function)绑定后函数。

例如:

function myFunction(){
    // Note that 'this' here refers to window, not an element.
    // the function must be bound to the element we want to manipulate.
    this.setStyle('color', 'red');
};
var myBoundFunction = myFunction.bind(myElement);
myBoundFunction(); // makes myElement's text red
 
// To show how bind works the following example:
var myBoundFunction = myFunction.bind(anyVar);
// is roughly equivalent with
var myBoundFunction = function(){
    return myFunction.call(this);
};

Function method: delay

延迟执行一个函数。

语法:

var timeoutID = myFunction.delay(delay[, bind[, args]]);

参数:

1. delay - (number)等待时间(以毫秒为单位) 。
2. bind - (object, optional)函数绑定到此对象执行(函数内部this指向到此对象)。
3. args - (mixed, optional)传递的参数(如果参数多于一个,必须是一个数组) 。

返回:

• (number)JavaScript timeout id (用于清除延迟) 。

例如:

var myFunction = function(){ alert('moo! Element id is: ' + this.id); };
 
//wait 50 milliseconds, then call myFunction and bind myElement to it
myFunction.delay(50, myElement); // alerts: 'moo! Element id is: ... '
 
//an anonymous function which waits a second and then alerts
(function(){ alert('one second later...'); }).delay(1000);
 
//to stop the delay, clearTimeout can be used like so:
var timer = myFunction.delay(50);
clearTimeout(timer);

另请参见:

Function method: periodical

间隔执行的函数。可以使用clearInterval停止。

语法:

var intervalID = myFunction.periodical(period[, bind[, args]]);

参数:

1. period - (number)执行的间隔。
2. bind - (object, optional)函数绑定到此对象执行(函数内部this指向到此对象)。
3. args - (mixed, optional)传递的参数(如果参数多于一个,必须是一个数组) 。

返回:

(number)Interval id(用于清除间隔执行) 。

例如:

var Site = { counter: 0 };
var addCount = function(){ this.counter++; };
addCount.periodical(1000, Site); //adds the number of seconds at the Site.
 
// the interval can be stopped using the clearInterval function
var timer = myFunction.periodical(1000);
clearInterval(timer);