CKTIS / JavaScript
DOMTokenList.contains — ověření přítomnosti tokenu
DOMTokenList.contains(token) udává, zda seznam obsahuje přesně zadaný token, například třídu CSS v element.classList.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
tokenList.contains(token)DOMTokenList.contains(token) vrací true, pokud seznam obsahuje zadaný token, jinak vrací false. Seznam přitom nemění. Typickým použitím je element.classList.contains('active').
Metoda kontroluje celý token, nikoli část textu nebo selektor CSS. Rozlišuje velikost písmen: active a Active jsou různé tokeny. Před název třídy nepřidávejte tečku.
Pro prázdný řetězec nebo řetězec obsahující bílé znaky ASCII metoda vrací false bez validačních výjimek známých z add(). Tato metoda patří do DOM Web API, nikoli do ECMAScriptu. Příklad vyžaduje DOM prohlížeče, který samotný Node 24 neposkytuje.
Pří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ýsledek
true false false false false
Seznam obsahuje dva samostatné tokeny: `active` a `item`. Pouze první kontrola vrátí `true`. Volání `tokens.contains('active item')` hledá celý řetězec jako jediný token a namísto vyvolání výjimky `SyntaxError` vrátí `false`. Poslední kontrola se tedy provede a vrátí `false`.