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.
La méthode includes() détermine si un tableau typé possède un certain élément et renvoie true ou false selon le cas de figure. Cette méthode utilise le même algorithme que la méthode Array.prototype.includes(). Dans le reste de l'article TypedArray fait référence à un des types de tableau typé.
Exemple interactif
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
Syntaxe
js
typedarray.includes(élémentRecherché[, indiceDébut]);
Paramètres
élémentRecherché-
L'élément qu'on cherche au sein du tableau typé.
indiceDébut-
Paramètre optionnel qui correspond à la position du tableau à partir de laquelle effectuer la recherche. La valeur par défaut est 0.
Valeur de retour
Un booléen indiquant la présence de l'élément (true s'il y est, false sinon).
Exemples
js
var uint8 = new Uint8Array([1, 2, 3]);
uint8.includes(2); // true
uint8.includes(4); // false
uint8.includes(3, 3); // false
// Gestion de NaN (vrai uniquement pour Float32 et Float64)
new Uint8Array([NaN]).includes(NaN); // false car NaN est converti en 0 par le constructeur
new Float32Array([NaN]).includes(NaN); // true;
new Float64Array([NaN]).includes(NaN); // true;
Spécifications
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-%typedarray%.prototype.includes |