Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes