CKTIS / JavaScript
DOMTokenList.remove() — remover tokens
DOMTokenList.remove() remove os tokens indicados, como as classes de um elemento através de classList. Saiba como são tratados vários argumentos, tokens em falta e valores inválidos.
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.remove(...tokens)DOMTokenList.remove() remove zero ou mais tokens. Em element.classList, altera o atributo class sem remover o elemento. Os tokens em falta são ignorados; o método devolve undefined.
Passe argumentos separados: element.classList.remove('selected', 'hidden'), e não uma única cadeia com espaços. Um token vazio lança uma DOMException com o nome SyntaxError; um token que contenha um espaço em branco ASCII lança InvalidCharacterError.
Todos os argumentos são validados antes da remoção. Assim, um argumento posterior inválido impede a remoção dos tokens anteriores. Após o erro, o exemplo mantém card.
Esta é uma API do DOM definida pelo WHATWG, não uma funcionalidade exclusiva do ECMAScript. O exemplo requer um document do navegador; por si só, uma versão do Node.js não comprova a disponibilidade desta API.
Exemplos
const element = document.createElement('div');
element.className = 'card selected hidden';
const result = element.classList.remove('selected', 'hidden', 'missing');
console.log(element.className);
console.log(result);
try {
element.classList.remove('card', 'bad token');
} catch (error) {
console.log(error.name);
}
console.log(element.className);Resultado
card undefined InvalidCharacterError card
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.