Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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

Zdroje