Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti