配列が指定した値を含んでいるかどうかを判定する - includes

《 初回公開:2023/10/19 , 最終更新:未 》

includesメソッドは指定した値が配列内の要素に含まれているかどうかを論理値として返す。

構文
array.includes(value, fromIndex)
引数
value
配列内で検索する値。
fromIndex (オプション)
検索を開始するインデックス、デフォルト値は 0 すなわち配列内の全要素から検索。
fromIndex が負の場合、検索は末尾からのオフセット(array.length + fromIndex )。

const array = ["a", "b", "c"];

array.includes("a");
console.log(array.includes("a"));   // true
console.log(array.includes("a", 1));    // false
console.log(array.includes("b", 1));    // true
console.log(array.includes("b", -2));   // true

fromIndex が負の場合でlengthの値を超える場合,すなわち-length以下の場合、配列全体から検索される。

console.log(array.includes("a", -2));   // false index=1から検索
console.log(array.includes("a", -3));   // true  index=0(全要素)から検索
console.log(array.includes("a", -4));   // true  index=-1(全要素)から検索
ページのトップへ戻る