CKTIS / JavaScript
DOMTokenList.add() — adicionar tokens
DOMTokenList.add() adiciona tokens, como classes através de element.classList, ignora duplicados e valida os argumentos.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
tokenList.add(...tokens)DOMTokenList.add() adiciona tokens a um conjunto ordenado, por exemplo através de element.classList. Mantém os tokens existentes, ignora os duplicados e acrescenta os novos pela ordem dos argumentos. É possível chamar add() sem argumentos. O método atualiza o atributo associado, exceto se o conjunto de tokens estiver vazio e o atributo não existir. Nesse caso, o atributo não é criado.
Passe cadeias de caracteres separadas: element.classList.add('card', 'active'). O método devolve undefined, não a lista nem um valor booleano.
Um token vazio lança uma DOMException com o nome SyntaxError; a presença de um caráter de espaço em branco ASCII, como uma tabulação ou uma mudança de linha, dentro de um token provoca InvalidCharacterError. Todos os tokens são validados antes da inserção: um argumento inválido impede que também sejam adicionados os tokens válidos dessa chamada.
Esta é uma API DOM, não uma funcionalidade exclusiva de ECMAScript. O exemplo requer um documento de browser; a presença de Node 24 não comprova o suporte desta API.
Exemplos
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);Resultado
card active undefined InvalidCharacterError card active
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.