KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

DOMTokenList.add() — tokens toevoegen

DOMTokenList.add() voegt tokens toe, zoals klassen via element.classList, slaat duplicaten over en controleert de argumenten.

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

DOMTokenList.add() voegt tokens toe aan een geordende verzameling, bijvoorbeeld via element.classList. Bestaande tokens blijven behouden, duplicaten worden overgeslagen en nieuwe tokens worden toegevoegd in de volgorde van de argumenten. Je kunt add() zonder argumenten aanroepen. De methode werkt het bijbehorende attribuut bij, behalve als de verzameling tokens leeg is en het attribuut ontbreekt. In dat geval wordt het attribuut niet aangemaakt.

Geef afzonderlijke tekenreeksen door: element.classList.add('card', 'active'). De methode retourneert undefined, niet de lijst of een booleaanse waarde.

Een leeg token veroorzaakt een DOMException met de naam SyntaxError; ASCII-witruimte binnen een token veroorzaakt InvalidCharacterError. Alle tokens worden vóór het toevoegen gecontroleerd: een ongeldig argument voorkomt dat ook geldige tokens uit die aanroep worden toegevoegd.

Dit is een DOM-API, geen functie van alleen ECMAScript. Het voorbeeld vereist een browserdocument; de aanwezigheid van Node 24 toont niet aan dat deze API wordt ondersteund.

Voorbeelden

const element = document.createElement('div');
element.classList.add('card');
const result = element.classList.add('card', 'active');
console.log(element.className);
console.log(result);

try {
  element.classList.add('pending', 'not valid');
} catch (error) {
  console.log(error.name);
}
console.log(element.className);

Resultaat

card active
undefined
InvalidCharacterError
card active

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