CKTIS / JavaScript
DOMTokenList.contains — vérifier la présence d’un jeton
DOMTokenList.contains(token) indique si une liste contient exactement le jeton donné, par exemple une classe CSS dans element.classList.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
tokenList.contains(token)DOMTokenList.contains(token) renvoie true si la liste contient le jeton indiqué, et false dans le cas contraire. La liste n’est pas modifiée. Un usage courant est element.classList.contains('active').
La méthode vérifie un jeton entier, pas une partie de texte ni un sélecteur CSS. La casse est prise en compte : active et Active sont des jetons différents. N’ajoutez pas de point devant le nom d’une classe.
Une chaîne vide ou une chaîne contenant des caractères d’espacement ASCII donne false, sans les exceptions de validation associées à add(). Cette méthode fait partie de l’API Web DOM, et non d’ECMAScript. L’exemple nécessite un DOM de navigateur, que Node 24 ne fournit pas à lui seul.
Exemples
const element = document.createElement('div');
element.className = 'active item';
const tokens = element.classList;
console.log(tokens.contains('active'));
console.log(tokens.contains('act'));
console.log(tokens.contains('Active'));
console.log(tokens.contains('active item'));
console.log(tokens.contains(''));Résultat
true false false false false
La liste contient deux jetons distincts : `active` et `item`. Seule la première vérification renvoie `true`. `tokens.contains('active item')` recherche la chaîne entière comme un seul jeton et renvoie `false` sans lever de `SyntaxError`. La dernière vérification s’exécute donc et renvoie `false`.