Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje