array.forEach( callback, thisObject )メソッド

array.forEach( callback, thisObject )メソッドは、配列の各要素に、引数「callback」に指定したコールバック関数を実行するメソッド。コールバック関数内でthisキーワードが参照するオブジェクトを、引数「thisObject」に指定できる。

構文

array.forEach( callback, thisObject )

引数

callback
配列の各要素毎に実行したいコールバック関数を指定する。
thisObject
コールバック関数内で、thisキーワードが参照するオブジェクトを指定できる。
省略可能。詳しくは、array.forEach( callback )へ。

コールバック関数の構文

function callback( value, index, array ) {
    // 配列の各要素に実行する処理
}

引数

value
配列要素の値。
index
配列要素のインデックス。
array
要素を格納している配列オブジェクト。

サンプル

<script type="text/javascript">
function sampleFunc( $value, $index ) {
    if ( $value <= this.small ) {
        document.write( '$value[' + $index + ']: ' + $value + ' (Small)' );
        document.write( '<br />' );
    } else if ( $value >= this.large ) {
        document.write( '$value[' + $index + ']: ' + $value + ' (Large)' );
        document.write( '<br />' );
    } else {
        document.write( '$value[' + $index + ']: ' + $value + ' (Medium)' );
        document.write( '<br />' );
    }
}
var $sampleArray = new Array( 43, 14, 55, 89, 31 );
var $criteria = { small: 30, large: 70 };
$sampleArray.forEach( sampleFunc, $criteria );
</script>

↓↓↓出力結果↓↓↓

スポンサード リンク

カテゴリー: Arrayオブジェクト, JavaScript, イテレーションメソッド(反復メソッド), メソッド, リファレンス, 組み込みオブジェクト タグ: パーマリンク