Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / JavaScript

DOMTokenList.add() — dodavanje tokena

DOMTokenList.add() dodaje tokene, primjerice klase putem element.classList, preskače duplikate i provjerava argumente.

Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

tokenList.add(...tokens)

DOMTokenList.add() dodaje tokene u uređeni skup, primjerice putem element.classList. Zadržava postojeće tokene, preskače duplikate i dodaje nove redoslijedom argumenata. Metoda add() može se pozvati bez argumenata. Metoda ažurira povezani atribut, osim ako je skup tokena prazan, a atribut ne postoji. U tom se slučaju atribut ne stvara.

Proslijedite zasebne nizove znakova: element.classList.add('card', 'active'). Metoda vraća undefined, a ne popis ni Booleovu vrijednost.

Prazan token uzrokuje DOMException s nazivom SyntaxError; ASCII bjeline unutar tokena uzrokuju InvalidCharacterError. Svi se tokeni provjeravaju prije dodavanja: nevaljan argument sprječava dodavanje i valjanih tokena iz tog poziva.

Ovo je DOM API, a ne značajka samo ECMAScripta. Primjer zahtijeva dokument preglednika; prisutnost Node 24 ne dokazuje podršku za ovaj API.

Primjeri

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);

Rezultat

card active
undefined
InvalidCharacterError
card active

Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.

Izvori