CKTIS / JavaScript
DOMTokenList.contains — verificar a presença de um token
DOMTokenList.contains(token) indica se uma lista contém exatamente o token indicado, por exemplo, uma classe CSS em element.classList.
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.contains(token)DOMTokenList.contains(token) devolve true quando a lista contém o token indicado e, caso contrário, false. Não altera a lista. Uma utilização comum é element.classList.contains('active').
Verifica um token completo, não um fragmento de texto nem um seletor CSS. Distingue maiúsculas de minúsculas: active e Active são tokens diferentes. Não coloques um ponto antes do nome da classe.
Uma cadeia vazia ou uma cadeia que contenha espaços em branco ASCII devolve false, sem as exceções de validação associadas a add(). Este método pertence à DOM Web API, não a ECMAScript. O exemplo requer um DOM de navegador, que o Node 24, por si só, não disponibiliza.
Exemplos
const element = document.createElement('div');
element.className = 'active item';
const tokens = element.classList;
console.log(tokens.contains('active'));
console.log(tokens.contains('act'));
console.log(tokens.contains('Active'));
console.log(tokens.contains('active item'));
console.log(tokens.contains(''));Resultado
true false false false false
A lista contém dois tokens distintos: `active` e `item`. Só a primeira verificação devolve `true`. `tokens.contains('active item')` procura a cadeia inteira como um único token e devolve `false` em vez de lançar um `SyntaxError`. Assim, a última verificação é executada e devolve `false`.