CKTIS / JavaScript
DOMTokenList.toggle() — alternar un token
DOMTokenList.toggle() alterna la presencia de un token o la fuerza mediante force. Devuelve si el token está presente después de la llamada.
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.toggle(token)
tokenList.toggle(token, force)DOMTokenList.toggle() actúa sobre una lista de tokens, como element.classList. Sin force, añade un token que no esté presente o elimina uno que sí lo esté. Pasa un solo token, no varias clases separadas por espacios.
Con force establecido en true, se garantiza la presencia del token; con false, se garantiza su ausencia. Repetir la misma operación forzada no invierte el estado. El resultado es true si el token está presente después de la llamada, o false si está ausente. No indica si se produjo algún cambio.
Un token vacío lanza una DOMException llamada SyntaxError; los espacios en blanco ASCII en el token provocan InvalidCharacterError. Esta es una API del DOM, no una función integrada de ECMAScript. El ejemplo requiere un DOM de navegador.
Ejemplos
const element = document.createElement('div');
const tokens = element.classList;
const results = [
tokens.toggle('active'),
tokens.toggle('active'),
tokens.toggle('active', true),
tokens.toggle('active', true),
tokens.toggle('active', false)
];
console.log(JSON.stringify(results));
console.log(JSON.stringify(element.className));Resultado
[true,false,true,true,false] ""
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.