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

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.

Sources