WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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`.

Quellen