Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes