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

array.some( callback, thisObject )メソッドは、配列の全要素に、引数「callback」に指定したチェック用のコールバック関数を実行し、要素が1つでもチェック条件を満たす場合、「true」を返すメソッド。コールバック関数内でthisキーワードが参照するオブジェクトを、引数「thisObject」に指定できる。

構文

array.some( callback, thisObject )

引数

callback
チェックに使用するコールバック関数を指定する。
thisObject
コールバック関数内で、thisキーワードが参照するオブジェクトを指定できる。
省略可能。詳しくは、array.some( callback )へ。

戻り値

要素が1つでもチェック条件に合致する場合、「true」を返す。

コールバック関数の構文

function callback( value, index, array ) {
    // 要素が1つでもチェック条件を満たす場合、「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>

↓↓↓出力結果↓↓↓

スポンサード リンク

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