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

CKTIS / JavaScript

DOMTokenList.remove() — supprimer des jetons

DOMTokenList.remove() supprime les jetons indiqués, par exemple les classes d’un élément via classList. Découvrez le traitement des arguments multiples, des jetons absents et des valeurs invalides.

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.remove(...tokens)

DOMTokenList.remove() supprime zéro ou plusieurs jetons. Sur element.classList, la méthode modifie l’attribut class sans supprimer l’élément. Les jetons absents sont ignorés ; la méthode renvoie undefined.

Passez des arguments distincts : element.classList.remove('selected', 'hidden'), et non une seule chaîne contenant une espace. Un jeton vide déclenche une DOMException nommée SyntaxError ; un jeton contenant un espace blanc ASCII déclenche InvalidCharacterError.

Tous les arguments sont validés avant la suppression. Un argument ultérieur invalide empêche donc la suppression des jetons précédents. Après l’erreur, l’exemple conserve card.

Il s’agit d’une API DOM définie par WHATWG, et non d’une fonctionnalité propre à ECMAScript. L’exemple nécessite un document de navigateur ; une version de Node.js, à elle seule, ne permet pas d’établir la disponibilité de cette API.

Exemples

const element = document.createElement('div');
element.className = 'card selected hidden';
const result = element.classList.remove('selected', 'hidden', 'missing');
console.log(element.className);
console.log(result);

try {
  element.classList.remove('card', 'bad token');
} catch (error) {
  console.log(error.name);
}
console.log(element.className);

Résultat

card
undefined
InvalidCharacterError
card

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