CKTIS / JavaScript
DOMTokenList.remove() – Tokens entfernen
DOMTokenList.remove() entfernt angegebene Tokens, zum Beispiel Elementklassen über classList. Erfahre, wie mehrere Argumente, fehlende Tokens und ungültige Werte behandelt werden.
Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
tokenList.remove(...tokens)DOMTokenList.remove() entfernt null oder mehr Tokens. Bei element.classList wird dadurch das Attribut class geändert, ohne das Element zu entfernen. Fehlende Tokens werden ignoriert; die Methode gibt undefined zurück.
Übergib einzelne Argumente: element.classList.remove('selected', 'hidden'), nicht eine Zeichenfolge mit Leerzeichen. Ein leeres Token löst eine DOMException namens SyntaxError aus; ein Token mit ASCII-Leerraumzeichen löst InvalidCharacterError aus.
Alle Argumente werden vor dem Entfernen geprüft. Ein späteres ungültiges Argument verhindert daher, dass vorherige Tokens entfernt werden. Das Beispiel behält nach dem Fehler card bei.
Dies ist eine WHATWG-DOM-API und keine Funktion, die ausschließlich zu ECMAScript gehört. Das Beispiel benötigt ein Browser-document; allein eine Node.js-Version belegt nicht, dass diese API verfügbar ist.
Beispiele
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);Ergebnis
card undefined InvalidCharacterError card
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.