JavaScript forEach() 方法

Array 對象參考手冊 JavaScript Array 對象

實例

列出數組的每個元素:

<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


定義和用法

forEach() 方法用於調用數組的每個元素,並將元素傳遞給回調函數。

注意: forEach() 對於空數組是不會執行回調函數的。


流覽器支持

表格中的數字表示支持該方法的第一個流覽器版本號。

方法
forEach() Yes 9.0 1.5 Yes Yes

語法

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

參數

參數 描述
function(currentValue, index, arr) 必需。 數組中每個元素需要調用的函數。
函數參數:
參數 描述
currentValue 必需。當前元素
index 可選。當前元素的索引值。
arr 可選。當前元素所屬的數組對象。
thisValue 可選。傳遞給函數的值一般用 "this" 值。
如果這個參數為空, "undefined" 會傳遞給 "this" 值

技術細節

返回值: 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>


Array 對象參考手冊 JavaScript Array 對象