array.some( callback, thisObject )メソッドは、配列の全要素に、引数「callback」に指定したチェック用のコールバック関数を実行し、要素が１つでもチェック条件を満たす場合、「true」を返すメソッド。コールバック関数内でthisキーワードが参照するオブジェクトを、引数「thisObject」に指定できる。
構文
array.some( callback, thisObject )
引数
- callback
- チェックに使用するコールバック関数を指定する。
- thisObject
- コールバック関数内で、thisキーワードが参照するオブジェクトを指定できる。
- 省略可能。詳しくは、array.some( callback )へ。
戻り値
要素が１つでもチェック条件に合致する場合、「true」を返す。
コールバック関数の構文
function callback( value, index, array ) {
// 要素が１つでもチェック条件を満たす場合、「true」を返す
// 全ての要素がチェック条件を満たさない場合、「false」を返す
}
// 要素が１つでもチェック条件を満たす場合、「true」を返す
// 全ての要素がチェック条件を満たさない場合、「false」を返す
}
引数
- value
- 配列要素の値。
- index
- 配列要素のインデックス。
- array
- 要素を格納している配列オブジェクト。
サンプル
数値をチェック
配列に、30以下か70以上の数値がないかチェック。
<script type="text/javascript">
function checkFunc( $value ) {
return ( $value <= this.minimum || $value >= this.maximum );
}
var $criteria = { minimum: 30, maximum: 70 };
var $sampleArray = new Array( 53, 68, 33, 44, 50 );
if ( $sampleArray.some( checkFunc, $criteria ) ) {
document.write( '「' + $sampleArray + '」' );
document.write( 'には、不合格なものが含まれています。' );
document.write( '<br />' );
} else {
document.write( '「' + $sampleArray + '」' );
document.write( 'は、全て合格です。' );
document.write( '<br />' );
}
var $sampleArray = new Array( 43, 60, 15, 89, 31 );
if ( $sampleArray.some( checkFunc, $criteria ) ) {
document.write( '「' + $sampleArray + '」' );
document.write( 'には、不合格なものが含まれています。' );
document.write( '<br />' );
} else {
document.write( '「' + $sampleArray + '」' );
document.write( 'は、全て合格です。' );
document.write( '<br />' );
}
</script>
function checkFunc( $value ) {
return ( $value <= this.minimum || $value >= this.maximum );
}
var $criteria = { minimum: 30, maximum: 70 };
var $sampleArray = new Array( 53, 68, 33, 44, 50 );
if ( $sampleArray.some( checkFunc, $criteria ) ) {
document.write( '「' + $sampleArray + '」' );
document.write( 'には、不合格なものが含まれています。' );
document.write( '<br />' );
} else {
document.write( '「' + $sampleArray + '」' );
document.write( 'は、全て合格です。' );
document.write( '<br />' );
}
var $sampleArray = new Array( 43, 60, 15, 89, 31 );
if ( $sampleArray.some( checkFunc, $criteria ) ) {
document.write( '「' + $sampleArray + '」' );
document.write( 'には、不合格なものが含まれています。' );
document.write( '<br />' );
} else {
document.write( '「' + $sampleArray + '」' );
document.write( 'は、全て合格です。' );
document.write( '<br />' );
}
</script>
↓↓↓出力結果↓↓↓