JavaScript Array filter() メソッド

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

例

返された配列ages中のすべての要素が18より大きい要素:

var ages = [32, 33, 16, 40];

function checkAdult(age) {
    return age >= 18;
}

function myFunction() {
    document.getElementById("demo").innerHTML = ages.filter(checkAdult);
}

出力結果は:

32,33,40

試してみる »

定義と用法

filter() メソッドは新しい配列を作成します。新しい配列の要素は、指定された配列内の条件を満たすすべての要素です。

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

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


ブラウザサポート

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

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

構文

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

引数の説明

引数 説明
function(currentValue, index,arr) 必須。関数。配列内の各要素がこの関数を実行します。
関数の引数:
引数 説明
currentValue 必須。現在の要素の値
index 任意。現在の要素のインデックス値
arr 任意。現在の要素が属する配列オブジェクト
thisValue 任意。コールバック実行時に使用されるオブジェクトで、関数に渡され、「this」の値として使用されます。
thisValue を省略した場合、「this」の値は「undefined」になります。

技術詳細

戻り値: 条件を満たすすべての要素を含む配列を返します。条件を満たす要素がない場合は空の配列を返します。
JavaScript バージョン: 1.6

その他の例

例

配列 ages の中で、入力ボックスで指定した数値より大きいすべての要素を返します:

<p>最小年齢: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">クリック</button>

<p>指定された配列より大きいすべての要素は? <span id="demo"></span></p>

<script>
var ages = [32, 33, 12, 40];

function checkAdult(age) {
    return age >= document.getElementById("ageToCheck").value;
}

function myFunction() {
    document.getElementById("demo").innerHTML = ages.filter(checkAdult);
}
</script>
試してみる »

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

その他の拡張