Documentation for: ASP.NET Ajax Version 1.0

This documentation is for a previous version. For the current released version, see the ASP.NET Ajax documentation on MSDN.

 

 

 

 

 

 

 

Array.forEach Function

Calls a specified function for each element of an Array object. This function is static and can be invoked without creating an instance of the object.

Syntax

Array.forEach(array, method, context);

Arguments

Term

Definition

array

The Array object to enumerate.

method

The function to call for each element in the array.

instance

The context for calling method.

Remarks

Use the forEach function to invoke a specified function for each element in an array.

The specified function must accept the following arguments in the following order: element, index, and array. The element argument is the array element that the function will take action on. The index argument is the index of element, and the array argument is the array that contains element.

note

In all browsers except Mozilla Firefox, the forEach function skips elements in the array that have a value of undefined. The function skips unassigned elements in all browsers.

Example

The following example shows how to use the forEach function to append a character between each existing element of an array.

JavaScript

var a = ['a', 'b', 'c', 'd'];
a[5] = 'e';
var result = '';

function appendToString(element, index, array) {
    // "this" is the context parameter, i.e. '|'.
    result += element + this + index + ',';
}
Array.forEach(a, appendToString, '|');
// View the results: a|0,b|1,c|2,d|3,e|5,
alert(result);