Méthode includes() du tableau JavaScript
Exemple
Détecter si le tableausitecontient example :
let site = ['example', 'google', 'taobao'];
site.includes('example');
// true
site.includes('baidu');
// false
Essayez-le vous-même »
Définition et utilisation
La méthode includes() permet de déterminer si un tableau contient une valeur spécifiée. Si c'est le cas, elle renvoie true ; sinon, elle renvoie false.
[1, 2, 3].includes(2); // true [1, 2, 3].includes(4); // false [1, 2, 3].includes(3, 3); // false [1, 2, 3].includes(3, -1); // true [1, 2, NaN].includes(NaN); // true
Prise en charge des navigateurs
Les nombres dans le tableau indiquent la première version du navigateur qui prend en charge la méthode.
| Méthode | |||||
|---|---|---|---|---|---|
| includes() | 47 | 14 | 43 | 9 | 34 |
Syntaxe
arr.includes(searchElement) arr.includes(searchElement, fromIndex)
Description du paramètre
| Paramètre | Description |
|---|---|
| searchElement | Requis. La valeur de l'élément à rechercher. |
| fromIndex | Facultatif. L'indice auquel commencer la recherche de searchElement. Si négatif, la recherche commence à l'indice array.length + fromIndex par ordre croissant. La valeur par défaut est 0. |
Détails techniques
| Valeur de retour : | Booléen. Renvoie true si la valeur spécifiée est trouvée, sinon renvoie false. |
|---|---|
| Version JavaScript : | ECMAScript 6 |
Plus d’exemples
fromIndex supérieur ou égal à la longueur du tableau
Si fromIndex est supérieur ou égal à la longueur du tableau, false est renvoyé. Le tableau ne sera pas parcouru :
Exemple
var arr = ['a', 'b', 'c'];
arr.includes('c', 3); //false
arr.includes('c', 100); // false
Indice calculé inférieur à 0
Si fromIndex est négatif, l'indice calculé est utilisé comme position à laquelle commencer la recherche de searchElement. Si l'indice calculé est inférieur à 0, tout le tableau sera parcouru.
Exemple
//La longueur du tableau est 3
//fromIndex est -100
//l'indice calculé est 3 + (-100) = -97
var arr = ['a', 'b', 'c'];
arr.includes('a', -100); // true
arr.includes('b', -100); // true
arr.includes('c', -100); // true
Objet Array JavaScript