CKTIS / JavaScript
DOMTokenList.add() — aggiungere token
DOMTokenList.add() aggiunge token, ad esempio classi tramite element.classList, ignora i duplicati e convalida gli argomenti.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
tokenList.add(...tokens)DOMTokenList.add() aggiunge token a un insieme ordinato, per esempio tramite element.classList. Mantiene i token esistenti, ignora i duplicati e aggiunge quelli nuovi nell’ordine degli argomenti. È possibile chiamare add() senza argomenti. Il metodo aggiorna l’attributo associato, tranne quando l’insieme dei token è vuoto e l’attributo è assente. In questo caso l’attributo non viene creato.
Passa stringhe separate: element.classList.add('card', 'active'). Il metodo restituisce undefined, non la lista né un valore booleano.
Un token vuoto genera una DOMException chiamata SyntaxError; la presenza di un carattere di spaziatura ASCII, come una tabulazione o un carattere di nuova riga, all’interno di un token genera InvalidCharacterError. Tutti i token vengono convalidati prima dell’inserimento: un argomento non valido impedisce di aggiungere anche i token validi di quella chiamata.
Questa è un’API DOM, non una funzionalità del solo ECMAScript. L’esempio richiede un documento del browser; la presenza di Node 24 non dimostra il supporto di questa API.
Esempi
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);Risultato
card active undefined InvalidCharacterError card active
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.