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.