CKTIS / JavaScript
DOMTokenList.contains — Token-Vorkommen prüfen
DOMTokenList.contains(token) gibt an, ob eine Liste genau das angegebene Token enthält, zum Beispiel eine CSS-Klasse in element.classList.
Version: 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) gibt true zurück, wenn die Liste das angegebene Token enthält, andernfalls false. Die Liste wird dabei nicht verändert. Ein typischer Einsatz ist element.classList.contains('active').
Die Methode prüft ein vollständiges Token, keinen Textausschnitt und keinen CSS-Selektor. Bei der Unterscheidung wird die Groß- und Kleinschreibung berücksichtigt: active und Active sind unterschiedliche Tokens. Setze vor einen Klassennamen keinen Punkt.
Eine leere Zeichenfolge oder eine Zeichenfolge mit ASCII-Leerraumzeichen ergibt false; anders als bei add() werden dabei keine Validierungsausnahmen ausgelöst. Die Methode gehört zur DOM Web API, nicht zu ECMAScript. Das Beispiel benötigt ein Browser-DOM, das Node 24 allein nicht bereitstellt.
Beispiele
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(''));Ergebnis
true false false false false
Die Liste enthält zwei getrennte Tokens: `active` und `item`. Nur die erste Prüfung ergibt `true`. `tokens.contains('active item')` prüft die gesamte Zeichenfolge als ein einziges Token und gibt `false` zurück, statt einen `SyntaxError` auszulösen. Die letzte Prüfung wird daher ebenfalls ausgeführt und ergibt `false`.