CKTIS / JavaScript
DOMTokenList.contains — kontrola prítomnosti tokenu
DOMTokenList.contains(token) uvádza, či zoznam obsahuje presne zadaný token, napríklad CSS triedu v element.classList.
Verzia: 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) vráti true, keď zoznam obsahuje zadaný token, inak vráti false. Zoznam pritom nemení. Typickým použitím je element.classList.contains('active').
Metóda kontroluje celý token, nie časť textu ani selektor CSS. Rozlišuje veľké a malé písmená: active a Active sú rôzne tokeny. Pred názov triedy nedávajte bodku.
Pri prázdnom reťazci alebo reťazci s bielymi znakmi ASCII metóda vráti false bez validačných výnimiek známych z add(). Táto metóda patrí do DOM Web API, nie do ECMAScriptu. Príklad vyžaduje DOM prehliadača, ktorý samotný Node 24 neposkytuje.
Príklady
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(''));Výsledok
true false false false false
Zoznam obsahuje dva samostatné tokeny: `active` a `item`. Iba prvá kontrola vráti `true`. Volanie `tokens.contains('active item')` hľadá celý reťazec ako jeden token a vráti `false` namiesto vyvolania výnimky `SyntaxError`. Posledná kontrola sa preto vykoná a vráti `false`.