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.