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.