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

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`.

Fontes