mozilla
您的搜索结果

    Array.prototype.forEach()

    概述

    forEach() 方法让数组的每一项都执行一次给定的函数。

    语法

    array.forEach(callback[, thisArg])

    参数

    callback
    在数组每一项上执行的函数,接收三个参数:
    currentValue
    当前项(指遍历时正在被处理那个数组项)的值。
    index
    当前项的索引(或下标)。
    array
    数组本身。
    thisArg
    可选参数。用来当作callback 函数内this的值的对象。

    描述

    forEach 方法按升序为数组中含有效值的每一项执行一次callback 函数,那些已删除(使用delete方法等情况)或者从未赋值的项将被跳过(但不包括哪些值为 undefined 的项)。

    callback 函数会被依次传入三个参数:

    • 数组当前项的值
    • 数组当前项的索引
    • 数组对象本身

    如果给forEach传递了thisArg 参数,它将作为 callback 函数的执行上下文,类似执行如下函数callback.call(thisArg, element, index, array)。如果 thisArg 值为 undefinednull,函数的 this 值取决于当前执行环境是否为严格模式(严格模式下为 undefined,非严格模式下为全局对象)。

    forEach 遍历的范围在第一次调用 callback 前就会确定。调用forEach 后添加到数组中的项不会被 callback 访问到。如果已经存在的值被改变,则传递给 callback 的值是 forEach 遍历到他们那一刻的值。已删除的项不会被遍历到。

    注意: 没有办法中止 forEach 循环。如果要中止,可使用  Array.everyArray.some。见下面的例子。

    forEach 为数组中的元素执行一次 callback 函数,不像 every 和 some,它总是返回 undefined

    示例

    打印出数组的内容

    下面的代码会为每一个数组元素输出一行记录:

    function logArrayElements(element, index, array) {
        console.log("a[" + index + "] = " + element);
    }
    [2, 5, 9].forEach(logArrayElements);
    // logs:
    // a[0] = 2
    // a[1] = 5
    // a[2] = 9
    

    中止循环

    下面的代码使用 Array.prototype.every 记录一个数组的内容,当其遍历到的一个元素值大于给定的 THRESHOLD 值时,就会中止循环。

    var THRESHOLD = 12;
    var v = [5, 2, 16, 4, 3, 18, 20];
    var res;
    
    res = v.every(function(element, index, array) {
        console.log("element:", element);
        if (element >= THRESHOLD) {
            return false;
        }
    
        return true;
    });
    console.log("res:", res);
    // logs:
    // element: 5
    // element: 2
    // element: 16
    // res: false
    
    res = v.some(function(element, index, array) {
        console.log("element:", element);
        if (element >= THRESHOLD) {
            return true;
        }
    
        return false;
    });
    console.log("res:", res);
    // logs:
    // element: 5
    // element: 2
    // element: 16
    // res: true

    一个可以克隆对象的函数

    使用下面的代码可以复制一个给定的对象,虽然有很多不同的复制对象的方法.不过下面介绍的这种方法使用了Array.prototype.forEach和其他一些ECMAScript 5中的Object.*函数.

    function copy(o){
      var copy = Object.create( Object.getPrototypeOf(o) );
      var propNames = Object.getOwnPropertyNames(o);
    
      propNames.forEach(function(name){
        var desc = Object.getOwnPropertyDescriptor(o, name);
        Object.defineProperty(copy, name, desc);
      });
    
      return copy;
    }
    
    var o1 = {a:1, b:2};
    var o2 = copy(o1); // o2 looks like o1 now
    

    兼容旧环境(Polyfill)

    forEach 是在最近被添加到 ECMA-262 标准的;这样它可能在标准的其他实现中不存在,你可以在你调用 forEach 之前 插入下面的代码,在本地不支持的情况下使用 forEach该算法是 ECMA-262 第5版中指定的算法。算法假定 ObjectTypeError  拥有它们的初始值。callback.call 等价于 Function.prototype.call

    // Production steps of ECMA-262, Edition 5, 15.4.4.18
    // Reference: http://es5.github.com/#x15.4.4.18
    if ( !Array.prototype.forEach ) {
    
      Array.prototype.forEach = function forEach( callback, thisArg ) {
    
        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; // Hack to convert O.length to a UInt32
    
        // 4. If IsCallable(callback) is false, throw a TypeError exception.
        // See: http://es5.github.com/#x9.11
        if ( {}.toString.call(callback) !== "[object Function]" ) {
          throw new TypeError( callback + " is not a function" );
        }
    
        // 5. If thisArg was supplied, let T be thisArg; else let T be undefined.
        if ( thisArg ) {
          T = thisArg;
        }
    
        // 6. Let k be 0
        k = 0;
    
        // 7. Repeat, while k < len
        while( k < len ) {
    
          var kValue;
    
          // a. Let Pk be ToString(k).
          //   This is implicit for LHS operands of the in operator
          // b. Let kPresent be the result of calling the HasProperty internal method of O with argument Pk.
          //   This step can be combined with c
          // c. If kPresent is true, then
          if ( Object.prototype.hasOwnProperty.call(O, k) ) {
    
            // i. Let kValue be the result of calling the Get internal method of O with argument Pk.
            kValue = O[ k ];
    
            // ii. Call the Call internal method of callback with T as the this value and
            // argument list containing kValue, k, and O.
            callback.call( T, kValue, k, O );
          }
          // d. Increase k by 1.
          k++;
        }
        // 8. return undefined
      };
    }
    

    规范

    Specification Status Comment
    ECMAScript 5.1 (ECMA-262)
    Array.prototype.forEach
    Standard Initial definition.
    Implemented in JavaScript 1.6
    ECMAScript 6 (ECMA-262)
    Array.prototype.forEach
    Release Candidate  

    浏览器兼容性

    Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
    Basic support (Yes) 1.5 9 (Yes) (Yes)
    Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
    Basic support ? ? ? ? ?

    相关链接

    文档标签和贡献者

    此页面的贡献者有: ziyunfei, yanhaijing1234, AlexChao, Harvesty, teoli
    最后编辑者: Harvesty,
    隐藏侧边栏