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é.

Syntaxe

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).

Exemple

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

Spécification État Commentaires
ECMAScript 2016 (ECMA-262)
La définition de 'TypedArray.prototype.includes' dans cette spécification.
Standard Définition initiale.
ECMAScript Latest Draft (ECMA-262)
La définition de 'TypedArray.prototype.includes' dans cette spécification.
Projet  

Compatibilité des navigateurs

FonctionnalitéChromeEdgeFirefoxInternet ExplorerOperaSafari
Support simple471443 Non3410
FonctionnalitéAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Support simple Non47 ?4334105.0

1. From version 5.0.0: this feature is behind the --harmony runtime flag.

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : SphinxKnight
Dernière mise à jour par : SphinxKnight,