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.