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>
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>
↓↓↓出力結果↓↓↓