DOMTokenList.contains()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

La méthode contains() de l'interface DOMTokenList renvoie un Boolean (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 (booléen)— true (vrai) si la liste sous-jacente contient la marque donnée, sinon false (faux).

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 :

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

Specification
DOM Standard # ref-for-dom-domtokenlist-contains①

Compatibilité des navigateurs

BCD tables only load in the browser