Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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`.

Sources