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.