DOMTokenList.contains()

La méthode contains() de l'interface DOMTokenList renvoie un Boolean (en-US) (booléen) — true (vrai) si la liste sous-jacente contient le symbole donné, sinon false (faux).

Syntaxe

tokenList.contains(token);

Paramètres

token
Une DOMString (chaîne de caractères) représentant la "token" (marque) dont vous voulez vérifier l'existence dans la liste.

Valeur renvoyée

Un Boolean (en-US) (booléen)— true (vrai) si la liste sous-jacente contient la marque donnée, sinon false (faux).

Exemples

Dans l'exemple suivant, nous récupérons la liste des classes définies sur un élément <span> en tant que DOMTokenList en utilisant Element.classList. Nous testons ensuite l'existence de "c" dans la liste, et écrivons le résultat dans le Node.textContent du <span>.

Tout d'abord, le code HTML :

<span class="a b c"></span>

Maintenant, le JavaScript :

var span = document.querySelector("span");
var classes = span.classList;
var result = classes.contains("c");
if(result) {
  span.textContent = "The classList contains 'c'";
} else {
   span.textContent = "The classList does not contain 'c'";
}

La sortie ressemble à ceci :

Spécifications

Spécification Statut Commentaire
DOM
La définition de 'contains()' dans cette spécification.
Standard évolutif Définition initiale

Compatibilité des navigateurs

BCD tables only load in the browser