WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen