配列が指定した値を含んでいるかどうかを判定する - 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(全要素)から検索