CKTIS / JavaScript
DOMTokenList.add() — ajouter des jetons
DOMTokenList.add() ajoute des jetons, par exemple des classes via element.classList, ignore les doublons et valide les arguments.
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.add(...tokens)DOMTokenList.add() ajoute des jetons à un ensemble ordonné, par exemple via element.classList. Les jetons existants sont conservés, les doublons sont ignorés et les nouveaux jetons sont ajoutés dans l’ordre des arguments. Il est possible d’appeler add() sans argument. La méthode met à jour l’attribut associé, sauf si l’ensemble de jetons est vide et que l’attribut est absent. Dans ce cas, l’attribut n’est pas créé.
Passez des chaînes distinctes : element.classList.add('card', 'active'). La méthode renvoie undefined, et non la liste ni une valeur booléenne.
Un jeton vide déclenche une DOMException nommée SyntaxError ; la présence d’un caractère blanc ASCII dans un jeton déclenche InvalidCharacterError. Tous les jetons sont validés avant l’insertion : un argument invalide empêche aussi l’ajout des jetons valides de cet appel.
Il s’agit d’une API DOM, et non d’une fonctionnalité d’ECMAScript seul. L’exemple nécessite un document de navigateur ; la présence de Node 24 ne prouve pas la prise en charge de cette API.
Exemples
const element = document.createElement('div');
element.classList.add('card');
const result = element.classList.add('card', 'active');
console.log(element.className);
console.log(result);
try {
element.classList.add('pending', 'not valid');
} catch (error) {
console.log(error.name);
}
console.log(element.className);Résultat
card active undefined InvalidCharacterError card active
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.