mozilla

Compare Revisions

Array.prototype.map()

Change Revisions

Revision 508903:

Revision 508903 by Waldo on

Revision 508921:

Revision 508921 by Waldo on

Title:
Array.prototype.map()
Array.prototype.map()
Slug:
Web/JavaScript/Reference/Global_Objects/Array/map
Web/JavaScript/Reference/Global_Objects/Array/map
Tags:
"ECMAScript5", "JavaScript 1.6", "Array", "prototype", "JavaScript", "Method"
"ECMAScript5", "JavaScript 1.6", "Array", "prototype", "JavaScript", "Method"
Content:

Revision 508903
Revision 508921
n137// Production steps of ECMA-262, Edition 5, 15.4.4.19n
138// Reference: http://es5.github.com/#x15.4.4.19
139if (!Array.prototype.map) {137if (!Array.prototype.map)
138{
140  Array.prototype.map = function(callback, thisArg) {139  Array.prototype.map = function(fun /*, thisArg */)
140  {
141    "use strict";
n142    var T, A, k;n143    if (this === void 0 || this === null)
144      throw new TypeError();
n144    if (this == null) {n146    var t = Object(this);
145      throw new TypeError(" this is null or not defined");147    var len = t.length >>> 0;
148    if (typeof fun !== "function")
149      throw new TypeError();
150 
151    var res = new Array(len);
152    var thisArg = arguments.length >= 2 ? arguments[1] : void 
 >0;
153    for (var i = 0; i < len; i++)
154    {
155      // NOTE: Absolute correctness would demand Object.definePro
 >perty
156      //       be used.  But this method is fairly new, and failu
 >re is
157      //       possible only if Object.prototype or Array.prototy
 >pe
158      //       has a property |i| (very unlikely), so use a less-
 >correct
159      //       but more portable alternative.
160      if (i in t)
161        res[i] = fun.call(thisArg, t[i], i, t);
t148    // 1. Let O be the result of calling ToObject passing the |tht
>is| value as the argument. 
149    var O = Object(this);
150 
151    // 2. Let lenValue be the result of calling the Get internal 
>method of O with the  
152    //    argument "length".
153    // 3. Let len be ToUint32(lenValue).
154    var len = O.length >>> 0;
155 
156    // 4. If IsCallable(callback) is false, throw a TypeError exc
>eption. 
157    // See: http://es5.github.com/#x9.11
158    if (typeof callback !== "function") {
159      throw new TypeError(callback + " is not a function");
160    }
161 
162    // 5. If thisArg was supplied, let T be thisArg; else let T b
>e undefined. 
163    if (arguments.length > 1) {
164      T = thisArg;
165    }
166 
167    // 6. Let A be a new array created as if by the expression ne
>w Array(len) where 
168    //    Array is the standard built-in constructor with that na
>me and len is the  
169    //    value of len.
170    A = new Array(len);
171 
172    // 7. Let k be 0
173    k = 0;
174 
175    // 8. Repeat, while k < len
176    while(k < len) {
177 
178      var kValue, mappedValue;
179 
180      // a. Let Pk be ToString(k).
181      //   This is implicit for LHS operands of the in operator
182      // b. Let kPresent be the result of calling the HasProperty
>  
183      //   internal method of O with argument Pk.
184      //   This step can be combined with c
185      // c. If kPresent is true, then
186      if (k in O) {
187 
188        // i. Let kValue be the result of calling the Get interna
>l 
189        //    method of O with argument Pk.
190        kValue = O[ k ];
191 
192        // ii. Let mappedValue be the result of calling the Call 
193        //     internal method of callback with T as the this val
>ue and  
194        //     argument list containing kValue, k, and O.
195        mappedValue = callback.call(T, kValue, k, O);
196 
197        // iii. Call the DefineOwnProperty internal method of A w
>ith arguments 
198        //      Pk, Property Descriptor {Value: mappedValue, : tr
>ue,  
199        //      Enumerable: true, Configurable: true}, and false.
200 
201        // In browsers that support Object.defineProperty, use th
>e following: 
202        // Object.defineProperty(A, Pk, { value: mappedValue, wri
>table: true,  
203        // enumerable: true, configurable: true });
204 
205        // For best browser support, use the following:
206        A[ k ] = mappedValue;
207      }
208      // d. Increase k by 1.
209      k++;
210    }
211 
212    // 9. return A
213    return A;164    return res;
214  };      165  };

Back to History