JavaScript Array forEach()

定義と用法

forEach() メソッドは関数を配列の各要素に対して順次呼び出します。

注釈：値のない配列の要素に対しては実行されませんforEach() メソッド。

例

例1

配列の各要素をリストアップします：

var fruits = ["apple", "orange", "cherry"];
fruits.forEach(myFunction);
function myFunction(item, index) {
  document.getElementById("demo").innerHTML += index + ":" + item + "<br>"; 
}

実際に試してみてください

例2

配列のすべての値の合計を取得します：

var sum = 0;
var numbers = [65, 44, 12, 4];
numbers.forEach(myFunction);
function myFunction(item) {
  sum += item;
  document.getElementById("demo").innerHTML = sum;
}

実際に試してみてください

例3

配列の各要素に対して：値を元の値の10倍に更新します：

var numbers = [65, 44, 12, 4];
numbers.forEach(myFunction)
function myFunction(item, index, arr) {
  arr[index] = item * 10;
}

実際に試してみてください

構文

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

パラメータ値

パラメータ 説明
function(currentValue, index, arr) 必須。配列の各要素に実行される関数。

関数パラメータ：

パラメータ 説明
currentValue 必須。現在の要素の値。
index オプション。現在の要素の配列インデックス。
arr オプション。現在の要素が属する配列オブジェクト。
thisValue

オプション。関数に渡してその「this」値として使用する値。

この引数が空の場合、値「undefined」がその「this」値として伝達されます。

技術的な詳細

返り値： undefined
JavaScriptのバージョン： ECMAScript 5

ブラウザのサポート

すべてのブラウザが完全にサポートしています forEach() 方法：

Chrome IE Edge Firefox Safari オペラ
Chrome IE Edge Firefox Safari オペラ
サポート 9.0 サポート サポート サポート サポート

関連ページ

チュートリアル：JavaScript 配列

チュートリアル：JavaScript 配列 Const

チュートリアル：JavaScript 配列メソッド

チュートリアル：JavaScript 配列のソート

チュートリアル：JavaScript 配列のイテレーション