KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

DOMTokenList.contains — controleren of een token aanwezig is

DOMTokenList.contains(token) geeft aan of een lijst precies het opgegeven token bevat, bijvoorbeeld een CSS-klasse in element.classList.

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.contains(token)

DOMTokenList.contains(token) geeft true terug als de lijst het opgegeven token bevat, en anders false. De lijst wordt niet gewijzigd. Een veelvoorkomend gebruik is element.classList.contains('active').

De methode controleert een volledig token, geen deel van een tekst en geen CSS-selector. Er wordt onderscheid gemaakt tussen hoofdletters en kleine letters: active en Active zijn verschillende tokens. Zet geen punt voor een klassenaam.

Een lege tekenreeks of een tekenreeks met ASCII-witruimtetekens geeft false terug, zonder de validatie-uitzonderingen die bij add() horen. Deze methode hoort bij de DOM Web API, niet bij ECMAScript. Het voorbeeld vereist een browser-DOM, die Node 24 op zichzelf niet biedt.

Voorbeelden

const element = document.createElement('div');
element.className = 'active item';
const tokens = element.classList;

console.log(tokens.contains('active'));
console.log(tokens.contains('act'));
console.log(tokens.contains('Active'));
console.log(tokens.contains('active item'));
console.log(tokens.contains(''));

Resultaat

true
false
false
false
false

De lijst bevat twee afzonderlijke tokens: `active` en `item`. Alleen de eerste controle geeft `true` terug. `tokens.contains('active item')` zoekt de hele tekenreeks als één token en geeft `false` terug zonder een `SyntaxError` te veroorzaken. De laatste controle wordt dus uitgevoerd en geeft `false` terug.

Bronnen