TypedArray.prototype.includes()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2016.

includes()TypedArray インスタンスのメソッドで、型付き配列の項目内に特定の値が含まれているかどうかを判断し、その結果に応じて truefalse を返します。このメソッドは 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

関連情報