Function.prototype.apply()
apply()
方法调用一个具有给定 this
值的函数,以及以一个数组(或一个类数组对象)的形式提供的参数。
尝试一下
语法
apply(thisArg)
apply(thisArg, argsArray)
参数
返回值
调用有指定 this
值和参数的函数的结果。
描述
备注: 虽然这个函数的语法与 call()
几乎相同,但根本区别在于,call()
接受一个参数列表,而 apply()
接受一个参数的单数组。
在调用一个存在的函数时,你可以为其指定一个 this
对象。this
指当前对象,也就是正在调用这个函数的对象。使用 apply
,你可以只写一次这个方法然后在另一个对象中继承它,而不用在新对象中重复写该方法。
apply
与 call()
非常相似,不同之处在于提供参数的方式。apply
使用参数数组而不是一组参数列表。apply
可以使用数组字面量(array literal),如 fun.apply(this, ['eat', 'bananas'])
,或数组对象,如 fun.apply(this, new Array('eat', 'bananas'))
。
你也可以使用 arguments
对象作为 argsArray
参数。arguments
是一个函数的局部变量。它可以被用作被调用对象的所有未指定的参数。这样,你在使用 apply 函数的时候就不需要知道被调用对象的所有参数。你可以使用 arguments 来把所有的参数传递给被调用对象。被调用对象接下来就负责处理这些参数。
从 ECMAScript 第 5 版开始,可以使用任何种类的类数组对象,就是说只要有一个 length
属性和 (0..length-1)
范围的整数属性。例如现在可以使用 NodeList
或一个自己定义的类似 {'length': 2, '0': 'eat', '1': 'bananas'}
形式的对象。
备注: 许多较旧的浏览器,包括 Chrome <17 以及 Internet Explorer <9 不接受类数组对象。如果传入类数组对象,它们会抛出异常。
示例
用 apply
将数组各项添加到另一个数组
我们可以使用 push
将元素追加到数组中。由于 push 接受可变数量的参数,所以也可以一次追加多个元素。
但是,如果 push
的参数是数组,它会将该数组作为单个元素添加,而不是将这个数组内的每个元素添加进去,因此我们最终会得到一个数组内的数组。如果不想这样呢?concat
符合我们的需求,但它并不是将元素添加到现有数组,而是创建并返回一个新数组。然而我们需要将元素追加到现有数组......那么怎么做好?难道要写一个循环吗?别当然不是!
apply
正派上用场!
const array = ['a', 'b'];
const elements = [0, 1, 2];
array.push.apply(array, elements);
console.info(array); // ["a", "b", 0, 1, 2]
使用 apply
和内置函数
对于一些需要写循环以遍历数组各项的需求,我们可以用 apply
完成以避免循环。
下面是示例,我们将用 Math.max
/Math.min
求得数组中的最大/小值。
// 找出数组中最大/小的数字
const numbers = [5, 6, 2, 3, 7];
// 使用 Math.min/Math.max 以及 apply 函数时的代码
let max = Math.max.apply(null, numbers); // 基本等同于 Math.max(numbers[0], ...) 或 Math.max(5, 6, ..)
let min = Math.min.apply(null, numbers);
// 对比:简单循环算法
max = -Infinity, min = +Infinity;
for (let i = 0; i < numbers.length; i++) {
if (numbers[i] > max)
max = numbers[i];
if (numbers[i] < min)
min = numbers[i];
}
注意:如果按上面方式调用 apply
,有超出 JavaScript 引擎参数长度上限的风险。一个方法传入过多参数(比如一万个)时的后果在不同 JavaScript 引擎中表现不同。(JavaScriptCore 引擎中有被硬编码的参数个数上限:65536)。
这是因为此限制(实际上也是任何用到超大栈空间的行为的自然表现)是不明确的。一些引擎会抛出异常,更糟糕的是其他引擎会直接限制传入到方法的参数个数,导致参数丢失。比如:假设某个引擎的方法参数上限为 4(实际上限当然要高得多),这种情况下,上面的代码执行后,真正被传递到 apply
的参数为 5, 6, 2, 3
,而不是完整的数组。
如果你的参数数组可能非常大,那么推荐使用下面这种混合策略:将数组切块后循环传入目标方法:
function minOfArray(arr) {
let min = Infinity;
let QUANTUM = 32768;
for (let i = 0, len = arr.length; i < len; i += QUANTUM) {
const submin = Math.min.apply(null, arr.slice(i, Math.min(i + QUANTUM, len)));
min = Math.min(submin, min);
}
return min;
}
let min = minOfArray([5, 6, 2, 3, 7]);
使用 apply 来链接构造器
你可以使用 apply 来链接一个对象构造器,类似于 Java。在接下来的例子中我们会创建一个全局 Global_Objects/Function
对象的 construct
方法,来使你能够在构造器中使用一个类数组对象而非参数列表。
Function.prototype.construct = function (aArgs) {
let oNew = Object.create(this.prototype);
this.apply(oNew, aArgs);
return oNew;
};
使用示例:
function MyConstructor() {
for (let nProp = 0; nProp < arguments.length; nProp++) {
this['property' + nProp] = arguments[nProp];
}
}
let myArray = [4, 'Hello world!', false];
let myInstance = MyConstructor.construct(myArray);
console.log(myInstance.property1); // logs 'Hello world!'
console.log(myInstance instanceof MyConstructor); // logs 'true'
console.log(myInstance.constructor); // logs 'MyConstructor'
备注: 这个非原生的 Function.construct
方法无法和一些原生构造器(例如 Date
)一起使用。在这种情况下你必须使用 Function.prototype.bind
方法。例如,想象有如下一个数组要用在 Date 构造器中:[2012, 11, 4]
;这时你需要这样写:new (Function.prototype.bind.apply(Date, [null].concat([2012, 11, 4])))()
——无论如何这不是最好的实现方式并且也许不该用在任何生产环境中。
规范
Specification |
---|
ECMAScript Language Specification # sec-function.prototype.apply |
浏览器兼容性
BCD tables only load in the browser