Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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

Zdroje