JavaScript Array map() メソッド

Array 对象参考手册JavaScript Array オブジェクト

実例

元の配列の各要素の平方根を持つ配列を返します:

var numbers = [4, 9, 16, 25];

function myFunction() {
    x = document.getElementById("demo")
    x.innerHTML = numbers.map(Math.sqrt);
}

出力結果は:

2,3,4,5

試してみる »

定義と使い方

map() メソッドは、元の配列の各要素に関数を適用した結果を要素とする新しい配列を返します。

map() メソッドは、元の配列の要素の順番に従って要素を処理します。

注意:map() は空の配列をチェックしません。

注意:map() は元の配列を変更しません。


ブラウザサポート

表内の数字は、そのメソッドをサポートする最初のブラウザのバージョン番号を示します。

メソッド
map() Yes 9 1.5 Yes Yes

構文

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

パラメータの説明

パラメータ 説明
function(currentValue, index,arr) 必須。関数。配列の各要素に対して実行される関数です。
関数のパラメータ:
パラメータ 説明
currentValue 必須。現在の要素の値
index 省略可能。現在の要素のインデックス値
arr 省略可能。現在の要素が属する配列オブジェクト
thisValue 省略可能。コールバック実行時に使用するオブジェクトで、関数に渡され、"this" の値として使用されます。
thisValue を省略した場合、または null、undefined を渡した場合、コールバック関数の this はグローバルオブジェクトになります。

技術詳細

戻り値: 元の配列の各要素に関数を適用した結果を要素とする新しい配列を返します。
JavaScript バージョン: 1.6

その他の例

実例

配列の各要素に入力ボックスで指定した値を掛け、新しい配列を返します:

var numbers = [65, 44, 12, 4];

function multiplyArrayElement(num) {
    return num * document.getElementById("multiplyWith").value;
}

function myFunction() {
    document.getElementById("demo").innerHTML = numbers.map(multiplyArrayElement);
}

試してみる »

Array 对象参考手册JavaScript Array オブジェクト

その他の拡張