TypedArray.prototype.includes()

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

試してみましょう

構文

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 の扱い (Float32 および Float64 に限り true)
new Uint8Array([NaN]).includes(NaN); // false (コンストラクターに渡した NaN は 0 に変換されるため)
new Float32Array([NaN]).includes(NaN); // true;
new Float64Array([NaN]).includes(NaN); // true;

仕様書

Specification
ECMAScript Language Specification
# sec-%typedarray%.prototype.includes

ブラウザーの互換性

BCD tables only load in the browser

関連情報