CKTIS / JavaScript
DOMTokenList.contains — comprobar si un token está presente
DOMTokenList.contains(token) indica si una lista contiene exactamente el token indicado, por ejemplo una clase CSS en element.classList.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
tokenList.contains(token)DOMTokenList.contains(token) devuelve true cuando la lista contiene el token indicado y, en caso contrario, false. No modifica la lista. Un uso habitual es element.classList.contains('active').
Comprueba un token completo, no un fragmento de texto ni un selector CSS. Distingue entre mayúsculas y minúsculas: active y Active son tokens distintos. No pongas un punto delante del nombre de la clase.
Una cadena vacía o una cadena que contenga espacios en blanco ASCII devuelve false, sin las excepciones de validación asociadas a add(). Este método pertenece a la DOM Web API, no a ECMAScript; el ejemplo necesita un DOM de navegador, que Node 24 por sí solo no proporciona.
Ejemplos
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
La lista contiene dos tokens distintos: `active` e `item`. Solo la primera comprobación devuelve `true`. `tokens.contains('active item')` busca la cadena completa como un único token y devuelve `false` en vez de lanzar un `SyntaxError`, por lo que la última comprobación se ejecuta y devuelve `false`.