KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

DOMTokenList.remove() — tokens verwijderen

DOMTokenList.remove() verwijdert opgegeven tokens, zoals elementklassen via classList. Lees hoe meerdere argumenten, ontbrekende tokens en ongeldige waarden worden afgehandeld.

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

Syntax

tokenList.remove(...tokens)

DOMTokenList.remove() verwijdert nul of meer tokens. Bij element.classList wijzigt de methode het class-attribuut zonder het element te verwijderen. Ontbrekende tokens worden genegeerd; de methode retourneert undefined.

Geef afzonderlijke argumenten door: element.classList.remove('selected', 'hidden'), niet één tekenreeks met spaties. Een lege token veroorzaakt een DOMException met de naam SyntaxError; een token met ASCII-witruimte veroorzaakt InvalidCharacterError.

Alle argumenten worden gevalideerd voordat er iets wordt verwijderd. Een later ongeldig argument voorkomt dus dat eerdere tokens worden verwijderd. Na de fout behoudt het voorbeeld card.

Dit is een door WHATWG gespecificeerde DOM-API, geen functie die alleen bij ECMAScript hoort. Het voorbeeld vereist een browser-document; alleen een Node.js-versie toont niet aan dat deze API beschikbaar is.

Voorbeelden

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

Resultaat

card
undefined
InvalidCharacterError
card

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen