CKTIS / JavaScript
DOMTokenList.toggle() — alternar um token
DOMTokenList.toggle() alterna a presença de um token ou força-a através de force. Devolve se o token está presente após a chamada.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
tokenList.toggle(token)
tokenList.toggle(token, force)DOMTokenList.toggle() atua sobre uma lista de tokens, como element.classList. Sem force, adiciona um token ausente ou remove um token presente. Passe um único token, não várias classes separadas por espaços.
Com force definido como true, garante-se a presença do token; com false, garante-se a sua ausência. Repetir a mesma operação forçada não inverte o estado. O resultado é true se o token estiver presente após a chamada, ou false se estiver ausente. Não indica se ocorreu alguma alteração.
Um token vazio lança uma DOMException com o nome SyntaxError; os espaços em branco ASCII no token causam InvalidCharacterError. Esta é uma API DOM, não uma funcionalidade integrada de ECMAScript. O exemplo requer um DOM de navegador.
Exemplos
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] ""
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.