Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

DOMTokenList.contains — sprawdzanie obecności tokenu

DOMTokenList.contains(token) zwraca informację, czy lista zawiera dokładnie podany token, na przykład klasę CSS w element.classList.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

tokenList.contains(token)

DOMTokenList.contains(token) zwraca true, gdy lista zawiera podany token, a w przeciwnym razie false. Nie zmienia listy. Typowym zastosowaniem jest element.classList.contains('active').

Metoda sprawdza cały token, nie fragment tekstu ani selektor CSS. Rozróżnia wielkość liter: active i Active to różne tokeny. Nie dodawaj kropki przed nazwą klasy.

Pusty ciąg oraz ciąg zawierający białe znaki ASCII dają false, bez wyjątków walidacji znanych z add(). Metoda należy do DOM Web API, nie ECMAScript; przykład wymaga przeglądarkowego DOM, którego sama obecność Node 24 nie zapewnia.

Przykłady

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(''));

Wynik

true
false
false
false
false

Lista zawiera dwa osobne tokeny: `active` i `item`. Tylko pierwsze sprawdzenie zwraca `true`. Wywołanie `tokens.contains('active item')` sprawdza cały ciąg jako jeden token i zwraca `false`, zamiast zgłaszać `SyntaxError`, więc ostatnie sprawdzenie również się wykonuje i zwraca `false`.

Źródła