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

Спецификация: ECMAScript 5.1 (ECMA-262)
array.forEach(callback(currentValue, index, arr),thisValue) 

Параметры

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

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

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

Примечание: Метод forEach не вызывает функцию для элементов массива, которые не имеют значений.

Примечание: Помимо объектов массива, метод forEach может использоваться любым объектом, имеющим свойство length и обладающим численно проиндексированными именами свойств.

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

Выполнить код »

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

Выполнить код »

Комментарии

пожелания к комментариям…
  • Приветствуются комментарии, соответствующие теме урока: вопросы, ответы, предложения.
  • Одну строчку кода оборачивайте в тег <code>, несколько строчек кода — в теги <pre><code>...ваш код...</code></pre>.
  • Допускаются ссылки на онлайн-песочницы (codepen, plnkr, JSBin и др.).