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