JavaScript forEach()Метод
Пример
Перечислить каждый элемент массива:
<button onclick="numbers.forEach(myFunction)">Нажми меня</button>
<p id="demo"></p>
<script>
demoP = document.getElementById("demo");
var numbers = [4, 9, 16, 25];
function myFunction(item, index) {
demoP.innerHTML = demoP.innerHTML + "index[" + index + "]: " + item + "<br>";
}
</script>
Результат вывода:
index[0]: 4
index[1]: 9
index[2]: 16
index[3]: 25
index[1]: 9
index[2]: 16
index[3]: 25
Попробуйте сами »
Определение и использование
Метод forEach() используется для вызова каждого элемента массива и передачи элемента функции обратного вызова.
Примечание:forEach() не выполняет функцию обратного вызова для пустых массивов.
Поддержка браузеров
Числа в таблице указывают номер первой версии браузера, поддерживающей метод.
| Метод | |||||
|---|---|---|---|---|---|
| forEach() | Да | 9.0 | 1.5 | Да | Да |
Синтаксис
array.forEach(callbackFn(currentValue, index, arr), thisValue)
Parameters
| Параметр | Описание | ||||||||
|---|---|---|---|---|---|---|---|---|---|
| callbackFn(currentValue, index, arr) | Обязательный. Функция, которая будет вызвана для каждого элемента массива. Параметры функции:
|
||||||||
| thisValue | Необязательный. Значение, переданное функции, обычно используется как значение "this". Если этот параметр пуст, в значение "this" будет передано "undefined". |
Другие форматы синтаксиса:
// Стрелочная функция
forEach((element) => { /* … */ })
forEach((element, index) => { /* … */ })
forEach((element, index, array) => { /* … */ })
// Функция обратного вызова
forEach(callbackFn)
forEach(callbackFn, thisArg)
// Встроенная функция обратного вызова
forEach(function(element) { /* … */ })
forEach(function(element, index) { /* … */ })
forEach(function(element, index, array){ /* … */ })
forEach(function(element, index, array) { /* … */ }, thisArg)
forEach((element) => { /* … */ })
forEach((element, index) => { /* … */ })
forEach((element, index, array) => { /* … */ })
// Функция обратного вызова
forEach(callbackFn)
forEach(callbackFn, thisArg)
// Встроенная функция обратного вызова
forEach(function(element) { /* … */ })
forEach(function(element, index) { /* … */ })
forEach(function(element, index, array){ /* … */ })
forEach(function(element, index, array) { /* … */ }, thisArg)
Технические детали
| Возвращаемое значение: | undefined |
|---|---|
| Версия JavaScript: | ECMAScript 3 |
Другие примеры
Пример
Вычислите общую сумму всех элементов в массиве:
<button onclick="numbers.forEach(myFunction)">Нажми меня</button>
<p>Сумма элементов массива:<span id="demo"></span></p>
<script>
var sum = 0;
var numbers = [65, 44, 12, 4];
function myFunction(item) {
sum += item;
demo.innerHTML = sum;
}
</script>
Попробуйте сами »
Пример
Умножьте все значения в массиве на заданное число:
<p>Умножить на:<input type="number" id="multiplyWith" value="10"></p>
<button onclick="numbers.forEach(myFunction)">Нажми меня</button>
<p>Вычисленное значение:<span id="demo"></span></p>
<script>
var numbers = [65, 44, 12, 4];
function myFunction(item,index,arr) {
arr[index] = item * document.getElementById("multiplyWith").value;
demo.innerHTML = numbers;
}
</script>
Попробуйте сами »
Continue и Break в forEach()
forEach() сам по себе не поддерживает операторы continue и break. Мы можемsomeиeveryреализовать это.
Используйтеreturnоператор, чтобы реализоватьcontinueэффект ключевого слова:
Реализация continue
Пример
var arr = [1, 2, 3, 4, 5];
arr.forEach(function (item) {
if (item === 3) {
return;
}
console.log(item);
});
arr.forEach(function (item) {
if (item === 3) {
return;
}
console.log(item);
});

var arr = [1, 2, 3, 4, 5];
arr.some(function (item) {
if (item === 2) {
return; // Не может быть return false
}
console.log(item);
});
arr.some(function (item) {
if (item === 2) {
return; // Не может быть return false
}
console.log(item);
});

Реализация break
Пример
var arr = [1, 2, 3, 4, 5];
arr.every(function (item) {
console.log(item);
return item !== 3;
});
arr.every(function (item) {
console.log(item);
return item !== 3;
});

Другие расширения
Объект Array в JavaScript