Функция Array.forEach

Вызывает заданную функцию для каждого элемента объекта Array. Эта функция является статической, и ее можно вызывать, не создавая экземпляр объекта.

Array.forEach(array, method, instance);

Аргументы

Термин

Определение

array

Объект Array, в котором необходимо произвести перечисление.

method

Функция, которую требуется вызвать для каждого элемента массива.

instance

Контекст для вызова method.

Заметки

Вызов заданной функции для каждого элемента массива производится при помощи функции forEach.

Функция, указанная параметром method parameter, должна принимать перечисленные ниже аргументы в следующем порядке: element, index и array. Аргумент element — это элемент массива, для которого будет вызываться функция. Аргумент index — это индекс элемента element, а аргумент array — массив, содержащий element..

Примечание

Во всех обозревателях, кроме Mozilla Firefox, функция forEach пропускает элементы массива, имеющие значение undefined.Элементы, которым не присвоено значение, пропускаются во всех обозревателях.

Пример

В следующем примере демонстрируется использование функции forEach для добавления символа между имеющимися элементами массива.

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);

См. также

Ссылки

Объект Array

Оснастки расширений типов "массив"

Другие ресурсы

Справочник по языку