CKTIS / JavaScript
DOMTokenList.add() — přidávání tokenů
DOMTokenList.add() přidává tokeny, například třídy přes element.classList, vynechává duplicity a ověřuje argumenty.
Verze: 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.add(...tokens)DOMTokenList.add() přidává tokeny do uspořádané množiny, například prostřednictvím element.classList. Zachovává existující tokeny, vynechává duplicity a nové tokeny připojuje v pořadí argumentů. Metodu add() lze volat i bez argumentů. Metoda aktualizuje související atribut, pokud ovšem není množina tokenů prázdná a atribut zároveň chybí. V takovém případě se atribut nevytvoří.
Předávejte samostatné řetězce: element.classList.add('card', 'active'). Metoda vrací undefined, nikoli seznam ani logickou hodnotu.
Prázdný token vyvolá DOMException s názvem SyntaxError; ASCII bílé znaky uvnitř tokenu vyvolají InvalidCharacterError. Všechny tokeny se ověřují před vložením: neplatný argument zabrání přidání i platných tokenů z tohoto volání.
Jde o API DOM, nikoli o funkci samotného ECMAScriptu. Příklad vyžaduje dokument prohlížeče; přítomnost Node 24 nedokazuje podporu tohoto API.
Příklady
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);Výsledek
card active undefined InvalidCharacterError card active
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.