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

CKTIS / JavaScript

DOMTokenList: gestionar tokens con classList

DOMTokenList representa un conjunto de tokens, como las clases de un elemento accesibles mediante classList. Aprende a añadir, eliminar, alternar y comprobar tokens sin procesar manualmente el texto del atributo class.

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

const tokens = element.classList;
tokens.add(token1, token2);
tokens.remove(token1, token2);
tokens.toggle(token);
tokens.toggle(token, force);
tokens.contains(token);

DOMTokenList representa un conjunto ordenado de tokens y distingue entre mayúsculas y minúsculas. En el valor del atributo, solo los espacios en blanco ASCII separan los tokens. Por ejemplo, un espacio de no separación (U+00A0) puede formar parte de un único token de clase en lugar de separar dos clases. Un ejemplo habitual es element.classList: un objeto vivo que refleja el atributo class. Los cambios en la lista actualizan el atributo, y los cambios en el atributo son visibles a través del mismo objeto. No es un array de JavaScript.

DOMTokenList.add, llamada como tokens.add("card", "active"), añade tokens individuales y omite los que ya están presentes. DOMTokenList.remove, por ejemplo tokens.remove("active", "missing"), elimina los tokens indicados; si un token no está presente, no se produce ningún error. Ambos métodos aceptan varios argumentos y devuelven undefined. Pasa las clases por separado: tokens.add("card", "active"), no tokens.add("card active"). En add(), un token vacío provoca una DOMException llamada SyntaxError, mientras que un token que contiene espacios en blanco ASCII provoca InvalidCharacterError.

DOMTokenList.contains, utilizada como tokens.contains("active"), devuelve true o false sin cambiar la lista. DOMTokenList.toggle, utilizada como tokens.toggle("selected"), añade un token ausente o elimina uno presente. Su valor de retorno indica si el token está presente después de la operación, no si se produjo un cambio. La forma tokens.toggle("ready", force) con el valor booleano true garantiza que el token esté presente, mientras que false garantiza que esté ausente. Usa esta forma para sincronizar con un estado explícito en lugar de alternar a ciegas.

Esta es una API del DOM, no una característica de una edición concreta de ECMAScript. MDN indica que la interfaz y los cuatro métodos tratados aquí están ampliamente disponibles desde julio de 2015; si se trata de navegadores antiguos, comprueba la compatibilidad con las variantes de llamada concretas. Que Node 24 esté presente en un repositorio no demuestra que haya compatibilidad con el DOM. El ejemplo requiere un navegador; no hace falta que el elemento esté unido al documento.

Ejemplos

{
  const element = document.createElement("div");
  const tokens = element.classList;

  tokens.add("card", "active", "card");
  console.log(tokens.contains("active"));

  tokens.remove("active", "missing");
  console.log(tokens.toggle("selected"));
  console.log(tokens.toggle("selected", false));

  tokens.toggle("ready", true);
  console.log(element.className);
}

Resultado

true
true
false
card ready

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes