Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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

Fuentes