Функция 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);
См. также
Ссылки
Оснастки расширений типов "массив"