Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

DOMTokenList.add() — pridávanie tokenov

DOMTokenList.add() pridáva tokeny, napríklad triedy cez element.classList, vynecháva duplicity a overuje argumenty.

Verzia: 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() pridáva tokeny do usporiadanej množiny, napríklad prostredníctvom element.classList. Zachováva existujúce tokeny, vynecháva duplicity a nové tokeny pridáva v poradí argumentov. Metódu add() možno volať aj bez argumentov. Metóda aktualizuje súvisiaci atribút okrem prípadu, keď je množina tokenov prázdna a atribút chýba. V takom prípade sa atribút nevytvorí.

Odovzdávajte samostatné reťazce: element.classList.add('card', 'active'). Metóda vracia undefined, nie zoznam ani logickú hodnotu.

Prázdny token vyvolá DOMException s názvom SyntaxError; ASCII biele znaky vo vnútri tokenu vyvolajú InvalidCharacterError. Všetky tokeny sa overujú pred vložením: neplatný argument zabráni pridaniu aj platných tokenov z tohto volania.

Ide o API DOM, nie o funkciu samotného ECMAScriptu. Príklad vyžaduje dokument prehliadača; prítomnosť Node 24 nedokazuje podporu tohto API.

Prí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ýsledok

card active
undefined
InvalidCharacterError
card active

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje