RetroSearch Browse

Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://webplatform.github.io/docs/javascript/Array/map below:

map · WebPlatform Docs

map Summary

Calls a defined callback function on each element of an array, and returns an array that contains the results.

Syntax

map( callbackfn [, thisArg ])

callbackfn: Required. A function that accepts up to three arguments. The map method calls the callbackfn function one time for each element in the array.
thisArg: Optional. An object to which the this keyword can refer in the callbackfn function. If thisArg is omitted, undefined is used as the this value.

Return Value

A new array in which each element is the callback function return value for the associated original array element.

Examples

The following example illustrates the use of the map method.


 function AreaOfCircle(radius) {
     var area = Math.PI * (radius * radius);
     return area.toFixed(0);
 }

 
 var radii = [10, 20, 30];

 
 var areas = radii.map(AreaOfCircle);

 document.write(areas);

The following example illustrates the use of the thisArg argument, which specifies an object to which the this keyword can refer.


 
 var obj = {
     divisor: 10,
     remainder: function (value) {
         return value % this.divisor;
     }
 }

 
 var numbers = [6, 12, 25, 30];

 
 
 var result = numbers.map(obj.remainder, obj);
 document.write(result);

In the following example, a built-inJavaScript method is used as the callback function.


 var numbers = [9, 16];
 var result = numbers.map(Math.sqrt);

 document.write(result);

The map method can be applied to a string. The following example illustrates this.


 function threeChars(value, index, str) {
     
     
     return str.substring(index - 1, index + 2);
 }

 
 var word = "Thursday";

 
 
 
 
 var result = [].map.call(word, threeChars);
 

 document.write(result);

Remarks

The map method calls the callbackfn function one time for each element in the array, in ascending index order. The callback function is not called for missing elements of the array.

In addition to array objects, the map method can be used by any object that has a length property and that has numerically indexed property names.

The syntax of the callback function is as follows:

function callbackfn(value, index, array1)

You can declare the callback function by using up to three parameters.

The following table lists the callback function parameters.

Callback argument Definition value The value of the array element. index The numeric index of the array element. array1 The array object that contains the element.

The array object can be modified by the callback function.

The following table describes the results of modifying the array object after the map method starts.

Condition after the map method starts Element passed to callback function? Element is added beyond the original length of the array. No. Element is added to fill in a missing element of the array. Yes, if that index has not yet been passed to the callback function. Element is changed. Yes, if that element has not yet been passed to the callback function. Element is deleted from the array. No, unless that element has already been passed to the callback function. Exceptions

If the callbackfn argument is not a function object, a TypeError exception is thrown.