Méthode includes() du tableau JavaScript

Array 对象参考手册Objet Array 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

Array 对象参考手册Objet Array JavaScript

Autres extensions