TypedArray.prototype.includes()

The includes() method of {{jsxref("TypedArray")}} instances determines whether a typed array includes a certain value among its entries, returning true or false as appropriate. This method has the same algorithm as {{jsxref("Array.prototype.includes()")}}.

{{InteractiveExample("JavaScript Demo: TypedArray.prototype.includes()")}}

```js interactive-example const uint8 = new Uint8Array([10, 20, 30, 40, 50]);

console.log(uint8.includes(20)); // Expected output: true

// Check from position 3 console.log(uint8.includes(20, 3)); // Expected output: false

## Syntax

```js-nolint
includes(searchElement)
includes(searchElement, fromIndex)

Parameters#

• searchElement
• : The value to search for.
• fromIndex {{optional_inline}}
• : Zero-based index at which to start searching, converted to an integer.

Return value#

A boolean value which is true if the value searchElement is found within the typed array (or the part of the typed array indicated by the index fromIndex, if specified).

Description#

See {{jsxref("Array.prototype.includes()")}} for more details. This method is not generic and can only be called on typed array instances.

Examples#

Using includes()#

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

// NaN handling (only relevant for floating point arrays)
new Uint8Array([NaN]).includes(NaN); // false, since the NaN passed to the constructor gets converted to 0
new Float32Array([NaN]).includes(NaN); // true

Specifications#

{{Specifications}}

Browser compatibility#

{{Compat}}

See also#

• Polyfill of TypedArray.prototype.includes in core-js
• JavaScript typed arrays guide
• {{jsxref("TypedArray")}}
• {{jsxref("TypedArray.prototype.indexOf()")}}
• {{jsxref("TypedArray.prototype.find()")}}
• {{jsxref("TypedArray.prototype.findIndex()")}}
• {{jsxref("Array.prototype.includes()")}}
• {{jsxref("String.prototype.includes()")}}