Array.prototype.forEach
Выполняет функцию для каждого элемента массива.
Доступно с: ES5
Синтаксис
array.forEach(callbackFn)Параметры
| Параметр | Тип | Описание |
|---|---|---|
| callbackFn | Function | Функция, которая получает элемент, его индекс и весь массив. |
Возвращаемое значение
undefinedМетод ничего не возвращает.
Примеры
Действие для каждого элемента:
['tea', 'coffee'].forEach((item) => {
console.log(item);
});Результат:
tea
coffeeВторым аргументом функция получает индекс:
['tea', 'coffee'].forEach((item, index) => {
console.log(index + 1 + '. ' + item);
});Результат:
1. tea
2. coffeeПримечания
Прервать forEach() досрочно нельзя: break в нём не работает. Если нужен выход из цикла, используйте for...of.
См. также
- Array.prototype.map — Создаёт новый массив, преобразуя каждый элемент.
- for...of — Перебирает значения массива, строки, Map, Set и других перебираемых объектов.
- Array.prototype.entries — Возвращает пары индекс — элемент для перебора в цикле for...of.
Вопросы и ответы по теме
В учебнике
- Перебор массива — Как пройти по всем элементам массива в JavaScript: цикл for, for...of, forEach и entries.