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.
The includes() method of 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 Array.prototype.includes().
Try it
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
includes(searchElement)
includes(searchElement, fromIndex)
Parameters
searchElement-
The value to search for.
fromIndexOptional-
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 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
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-%typedarray%.prototype.includes |
Browser compatibility
Loading…