Array.prototype.every() - JavaScript Array 对象
Array.prototype.every()
every()
方法测试一个数组内的所有元素是否都能通过某个指定函数的测试。它返回一个布尔值。
注意:若收到一个空数组,此方法在一切情况下都会返回true
。
语法
arr.every(callback[, thisArg])
参数
callback
用来测试每个元素的函数,它可以接收三个参数:element
用于测试的当前值。index
可选用于测试的当前值的索引。array
可选调用every
的当前数组。thisArg
执行callback
时使用的this
值。返回值
如果回调函数的每一次返回都为 truthy 值,返回true
,否则返回false
。
描述
every
方法为数组中的每个元素执行一次callback
函数,直到它找到一个会使callback
返回 falsy 的元素。如果发现了一个这样的元素,every
方法将会立即返回false
。否则,callback
为每一个元素返回true
,every
就会返回true
。callback
只会为那些已经被赋值的索引调用。不会为那些被删除或从未被赋值的索引调用。
callback
在被调用时可传入三个参数:元素值,元素的索引,原数组。
如果为every
提供一个thisArg
参数,则该参数为调用callback
时的this
值。如果省略该参数,则callback
被调用时的this
值,在非严格模式下为全局对象,在严格模式下传入undefined
。详见this
条目。
every
不会改变原数组。
every
遍历的元素范围在第一次调用callback
之前就已确定了。在调用every
之后添加到数组中的元素不会被callback
访问到。如果数组中存在的元素被更改,则他们传入callback
的值是every
访问到他们那一刻的值。那些被删除的元素或从来未被赋值的元素将不会被访问到。
every
和数学中的"所有"类似,当所有的元素都符合条件才会返回true
。正因如此,若传入一个空数组,无论如何都会返回true
。(这种情况属于无条件正确:正因为一个空集合没有元素,所以它其中的所有元素都符合给定的条件。)
例子
检测所有数组元素的大小
下例检测数组中的所有元素是否都大于 10。
function isBigEnough(element, index, array) { return element >= 10; } [12, 5, 8, 130, 44].every(isBigEnough); // false [12, 54, 18, 130, 44].every(isBigEnough); // true
使用箭头函数
箭头函数为上面的检测过程提供了更简短的语法。
[12, 5, 8, 130, 44].every(x => x >= 10); // false [12, 54, 18, 130, 44].every(x => x >= 10); // true
兼容旧环境(Polyfill)
在 ECMA-262 第 5 版时,every
被添加进 ECMA-262 标准;因此,在某些实现环境中,它尚未被支持。你可以把下面的代码放到脚本的开头来解决此问题,该代码允许在那些没有原生支持every
的实现环境中使用它。该算法是 ECMA-262 第 5 版中指定的算法,它假定Object
和TypeError
拥有它们的初始值,且fun.call
等价于Function.prototype.call
。
if (!Array.prototype.every) { Array.prototype.every = function(callbackfn, thisArg) { 'use strict'; var T, k; if (this == null) { throw new TypeError('this is null or not defined'); } // 1. Let O be the result of calling ToObject passing the this // value as the argument. var O = Object(this); // 2. Let lenValue be the result of calling the Get internal method // of O with the argument "length". // 3. Let len be ToUint32(lenValue). var len = O.length >>> 0; // 4. If IsCallable(callbackfn) is false, throw a TypeError exception. if (typeof callbackfn !== 'function') { throw new TypeError(); } // 5. If thisArg was supplied, let T be thisArg; else let T be undefined. if (arguments.length > 1) { T = thisArg; } // 6. Let k be 0. k = 0; // 7. Repeat, while k
鹏仔微信 15129739599 鹏仔QQ344225443 鹏仔前端 pjxi.com 共享博客 sharedbk.com
图片声明:本站部分配图来自网络。本站只作为美观性配图使用,无任何非法侵犯第三方意图,一切解释权归图片著作权方,本站不承担任何责任。如有恶意碰瓷者,必当奉陪到底严惩不贷!