Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

DOMTokenList.remove() — usuwanie tokenów

DOMTokenList.remove() usuwa wskazane tokeny, np. klasy elementu przez classList. Poznaj obsługę wielu argumentów, brakujących tokenów i nieprawidłowych wartości.

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.remove(...tokens)

DOMTokenList.remove() usuwa zero lub więcej tokenów. Dla element.classList zmienia atrybut class, nie usuwając elementu. Brakujące tokeny są ignorowane; metoda zwraca undefined.

Przekazuj osobne argumenty: element.classList.remove('selected', 'hidden'), nie jeden ciąg ze spacją. Pusty token powoduje DOMException o nazwie SyntaxError; token zawierający biały znak ASCII powoduje InvalidCharacterError.

Wszystkie argumenty są sprawdzane przed usuwaniem. Dlatego nieprawidłowy późniejszy argument zapobiega usunięciu wcześniejszych tokenów. Przykład pozostawia card po błędzie.

To API DOM określone w standardzie WHATWG, nie funkcja samego ECMAScript. Przykład wymaga przeglądarkowego document; sama wersja Node.js nie potwierdza dostępności tego API.

Przykłady

const element = document.createElement('div');
element.className = 'card selected hidden';
const result = element.classList.remove('selected', 'hidden', 'missing');
console.log(element.className);
console.log(result);

try {
  element.classList.remove('card', 'bad token');
} catch (error) {
  console.log(error.name);
}
console.log(element.className);

Wynik

card
undefined
InvalidCharacterError
card

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

Źródła