Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

DOMTokenList.toggle() — przełączanie tokenu

DOMTokenList.toggle() przełącza obecność tokenu lub wymusza ją argumentem force. Zwraca informację o obecności tokenu po wywołaniu.

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

Składnia

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

DOMTokenList.toggle() działa na liście tokenów, np. element.classList. Bez force dodaje nieobecny token albo usuwa obecny. Przekaż jeden token, nie ciąg kilku klas oddzielonych spacjami.

force równe true zapewnia obecność tokenu, a false — jego brak. Powtórzenie tej samej wymuszonej operacji nie odwraca stanu. Wynik to true, jeśli token jest obecny po wywołaniu, lub false, jeśli go nie ma; nie informuje, czy nastąpiła zmiana.

Pusty token powoduje DOMException o nazwie SyntaxError; białe znaki ASCII w tokenie powodują InvalidCharacterError. To API DOM, nie funkcja samego ECMAScript. Przykład wymaga przeglądarkowego DOM.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła