CKTIS / JavaScript
DOMTokenList.add() — Tokens hinzufügen
DOMTokenList.add() fügt Tokens hinzu, etwa Klassen über element.classList, überspringt Duplikate und überprüft die Argumente.
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.add(...tokens)DOMTokenList.add() fügt Tokens zu einer geordneten Menge hinzu, zum Beispiel über element.classList. Vorhandene Tokens bleiben erhalten, Duplikate werden übersprungen und neue Tokens in der Reihenfolge der Argumente angehängt. Ein Aufruf von add() ohne Argumente ist gültig. Die Methode aktualisiert das zugehörige Attribut, außer wenn die Token-Menge leer und das Attribut nicht vorhanden ist. In diesem Fall wird das Attribut nicht angelegt.
Übergib separate Zeichenfolgen: element.classList.add('card', 'active'). Die Methode gibt undefined zurück, nicht die Liste oder einen booleschen Wert.
Ein leeres Token löst eine DOMException namens SyntaxError aus; ASCII-Leerraum innerhalb eines Tokens löst InvalidCharacterError aus. Alle Tokens werden vor dem Einfügen überprüft: Ein ungültiges Argument verhindert, dass auch gültige Tokens dieses Aufrufs hinzugefügt werden.
Dies ist eine DOM-API und keine Funktion von ECMAScript allein. Das Beispiel benötigt ein Browser-Dokument; dass Node 24 vorhanden ist, belegt nicht die Unterstützung dieser API.
Beispiele
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);Ergebnis
card active undefined InvalidCharacterError card active
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.