Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

DOMTokenList.remove() — odebrání tokenů

DOMTokenList.remove() odstraňuje zadané tokeny, například třídy prvku prostřednictvím classList. Zjistěte, jak se zpracovávají více argumentů, chybějící tokeny a neplatné hodnoty.

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

Syntaxe

tokenList.remove(...tokens)

DOMTokenList.remove() odstraní nula nebo více tokenů. U element.classList změní atribut class, aniž by odstranila samotný prvek. Chybějící tokeny se ignorují; metoda vrací undefined.

Předávejte samostatné argumenty: element.classList.remove('selected', 'hidden'), nikoli jeden řetězec obsahující mezery. Prázdný token vyvolá DOMException s názvem SyntaxError; token obsahující bílé znaky ASCII vyvolá InvalidCharacterError.

Všechny argumenty se ověří před odebráním. Pozdější neplatný argument proto zabrání odebrání dřívějších tokenů. Po chybě zůstane v příkladu card.

Jde o DOM API definované standardem WHATWG, nikoli o funkci samotného ECMAScriptu. Příklad vyžaduje document v prohlížeči; samotná verze Node.js nedokazuje, že je toto API dostupné.

Příklady

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

Výsledek

card
undefined
InvalidCharacterError
card

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje