Метод forEach()

Array.forEach()

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

Синтаксис

array.forEach(callback(currentValue, index, arr),thisValue) 

Параметры

callback

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

• currentValue – значение текущего элемента.
• index – индекс массива текущего элемента.
• arr – массив, к которому принадлежит текущий элемент (по которому осуществляется проход).

thisValue

Необязательный параметр. Объект, на который может ссылаться ключевое слово this в функции callback. Если аргумент thisValue опущен, в качестве значения this используется undefined (в конечном счете this будет зависеть от обычных правил контекста выполнения функции).

Возвращаемое значение

Не определено.

Описание

Метод forEach() выполняет функцию callback один раз для каждого элемента, находящегося в массиве в порядке возрастания индекса. Функция callback не будет вызвана для удалённых или пропущенных элементов массива. Однако, она будет вызвана для элементов, которые присутствуют в массиве и имеют значение undefined.

Примеры

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

В следующем примере рассматривается использование второго аргумента метода forEach, указывающий на объект, на который может ссылаться ключевое слова this внутри функции обратного вызова: