Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

DOMTokenList.toggle() — alternare un token

DOMTokenList.toggle() alterna la presenza di un token oppure la forza tramite force. Restituisce se il token è presente dopo la chiamata.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

tokenList.toggle(token)
tokenList.toggle(token, force)

DOMTokenList.toggle() opera su una lista di token, come element.classList. Senza force, aggiunge un token assente oppure rimuove un token presente. Passa un solo token, non più classi separate da spazi.

Con force impostato su true, la presenza del token è garantita; con false, ne è garantita l’assenza. Ripetere la stessa operazione forzata non inverte lo stato. Il risultato è true se il token è presente dopo la chiamata, oppure false se è assente. Non indica se è avvenuta una modifica.

Un token vuoto genera una DOMException denominata SyntaxError; gli spazi ASCII nel token causano InvalidCharacterError. Questa è un’API DOM, non una funzionalità integrata di ECMAScript. L’esempio richiede un DOM del browser.

Esempi

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));

Risultato

[true,false,true,true,false]
""

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti