re:re:actable
Урок 032 минуты чтения

forEach() в массиве

На этой странице
Кратко

forEach() выполняет callback для каждого элемента массива и всегда возвращает undefined. Его используют для side effects, а не для создания нового массива.

Вопрос

Для чего используется arr.forEach()? Чем отличается от map и filter?

Синтаксис

array.forEach((element, index, array) => {
  // действие
});

Пример

const users = ["Anna", "Max"];
 
users.forEach((user) => {
  console.log(user);
});

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

const result = [1, 2, 3].forEach((number) => number * 2);
 
console.log(result); // undefined

Если нужен новый массив, используйте map.

const doubled = [1, 2, 3].map((number) => number * 2);

Когда использовать

forEach подходит для действий:

  • логирование;
  • запись в DOM;
  • вызов функции для каждого элемента;
  • изменение внешней структуры, если это осознанно.
const names = [];
 
users.forEach((user) => {
  names.push(user.name);
});

Но часто лучше:

const names = users.map((user) => user.name);

Нельзя остановить через break

array.forEach((item) => {
  if (item === target) {
    // break здесь нельзя
  }
});

Если нужно остановиться, используйте for...of, some, every или find.

Что важно помнить

  • forEach возвращает undefined — его нельзя использовать в цепочке.
  • break и return не останавливают перебор; для раннего выхода — for...of, some, find.
  • forEach не ждет async-колбэков: arr.forEach(async ...) запустит всё и не дождется.
  • Пропускает дырки разреженных массивов.

Мини-шпаргалка

МетодВозвращаетЗадача
forEachundefinedвыполнить действие
mapновый массивпреобразовать
filterновый массивотфильтровать
findэлемент или undefinedнайти первый

Документация

MDN: Array.prototype.forEach().

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам