TypedArray.prototype.includes()

Baseline 広く利用可能

この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2016年9月以降、すべてのブラウザーで利用可能です。

includes() は TypedArray インスタンスのメソッドで、型付き配列の項目内に特定の値が含まれているかどうかを判断し、その結果に応じて true か false を返します。このメソッドは Array.prototype.includes() と同じアルゴリズムです。

試してみましょう

const uint8 = new Uint8Array([10, 20, 30, 40, 50]);

console.log(uint8.includes(20));
// 予想される結果: true

// Check from position 3
console.log(uint8.includes(20, 3));
// 予想される結果: false

構文

js
includes(searchElement)
includes(searchElement, fromIndex)

引数

searchElement

探す対象の要素

fromIndex 省略可

検索を始める位置を示すゼロ基点のインデックスで、整数に変換されます。

返値

論理値で、型付き配列（指定する場合はインデックス fromIndex で示される型付き配列の一部）内で値 searchElement が見つかった場合に true なります。

解説

詳細については、 Array.prototype.includes() をご覧ください。このメソッドは汎用的ではなく、型付き配列インスタンスに対してのみ呼び出すことができます。

例

includes の使用

js
const uint8 = new Uint8Array([1, 2, 3]);
uint8.includes(2); // true
uint8.includes(4); // false
uint8.includes(3, 3); // false

// NaN の扱い（浮動小数点型の配列の場合のみ関係）
new Uint8Array([NaN]).includes(NaN); // false (コンストラクターに渡した NaN は 0 に変換されるため)
new Float32Array([NaN]).includes(NaN); // true