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

CKTIS / JavaScript

DOMTokenList.add() — añadir tokens

DOMTokenList.add() añade tokens, como clases mediante element.classList, omite duplicados y valida los argumentos.

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.add(...tokens)

DOMTokenList.add() añade tokens a un conjunto ordenado, por ejemplo mediante element.classList. Conserva los tokens existentes, omite los duplicados y agrega los nuevos en el orden de los argumentos. Se puede llamar a add() sin argumentos. El método actualiza el atributo asociado, salvo si el conjunto de tokens está vacío y el atributo no existe. En ese caso, el atributo no se crea.

Pasa cadenas separadas: element.classList.add('card', 'active'). El método devuelve undefined, no la lista ni un valor booleano.

Un token vacío lanza una DOMException llamada SyntaxError; la presencia de un carácter de espacio en blanco ASCII, como una tabulación o un salto de línea, dentro de un token da lugar a InvalidCharacterError. Todos los tokens se validan antes de insertarlos: un argumento no válido impide que se añadan incluso los tokens válidos de esa llamada.

Esta es una API del DOM, no una función exclusiva de ECMAScript. El ejemplo requiere un documento del navegador; la presencia de Node 24 no demuestra que esta API sea compatible.

Ejemplos

const element = document.createElement('div');
element.classList.add('card');
const result = element.classList.add('card', 'active');
console.log(element.className);
console.log(result);

try {
  element.classList.add('pending', 'not valid');
} catch (error) {
  console.log(error.name);
}
console.log(element.className);

Resultado

card active
undefined
InvalidCharacterError
card active

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