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()
.
On this page
TypedArray.prototype.includes()
Try it
Syntax
js
includes(searchElement)
includes(searchElement, fromIndex)
Parameters
-
searchElement
-
The value to search for.
fromIndex
Optional-
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()
js
const uint8 = new Uint8Array([1, 2, 3]);
uint8.includes(2); // true
uint8.includes(4); // false
uint8.includes(3, 3); // false
// NaN handling (only true for Float32 and Float64)
new Uint8Array([NaN]).includes(NaN); // false, since the NaN passed to the constructor gets converted to 0
new Float32Array([NaN]).includes(NaN); // true;
new Float64Array([NaN]).includes(NaN); // true;
Specifications
Browser compatibility
Desktop | Mobile | Server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | WebView Android | Deno | Node.js | ||
includes |
47 | 14 | 43 | 34 | 10 | 47 | 43 | 34 | 10 | 5.0 | 47 | 1.0 | 6.0.0 |
See also
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/includes