CKTIS / JavaScript
DOMTokenList.add() — dodajanje žetonov
DOMTokenList.add() dodaja žetone, na primer razrede prek element.classList, preskoči dvojnike in preveri argumente.
Različica: 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() doda žetone v urejeno množico, na primer prek element.classList. Obstoječe žetone ohrani, dvojnike preskoči, nove žetone pa doda po vrstnem redu argumentov. Metodo add() lahko pokličeš brez argumentov. Metoda posodobi povezani atribut, razen če je množica žetonov prazna in atribut ne obstaja. V tem primeru se atribut ne ustvari.
Podaj ločene nize: element.classList.add('card', 'active'). Metoda vrne undefined, ne seznama ali logične vrednosti.
Prazen žeton sproži DOMException z imenom SyntaxError; prisotnost belega znaka ASCII, kot sta tabulator ali znak za novo vrstico, znotraj žetona sproži InvalidCharacterError. Pred dodajanjem se preverijo vsi žetoni: neveljaven argument prepreči dodajanje tudi veljavnih žetonov iz tega klica.
To je API DOM, ne funkcija samega ECMAScripta. Primer zahteva dokument brskalnika; prisotnost Node 24 ne dokazuje podpore za ta API.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.