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.