База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

DOMTokenList.contains — проверка за наличие на токен

DOMTokenList.contains(token) показва дали списъкът съдържа точно посочения токен, например CSS клас в element.classList.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

tokenList.contains(token)

DOMTokenList.contains(token) връща true, когато списъкът съдържа посочения токен, и false в противен случай. Методът не променя списъка. Типична употреба е element.classList.contains('active').

Методът проверява цял токен, а не част от текст или CSS селектор. Главните и малките букви се различават: active и Active са различни токени. Не поставяйте точка пред името на класа.

При празен низ или низ, съдържащ интервални знаци от ASCII, методът връща false, без да предизвиква изключения при проверката за валидност, каквито има при add(). Методът е част от DOM Web API, а не от ECMAScript. Примерът изисква DOM на браузър, който Node 24 сам по себе си не предоставя.

Примери

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

Резултат

true
false
false
false
false

Списъкът съдържа два отделни токена: `active` и `item`. Само първата проверка връща `true`. Извикването `tokens.contains('active item')` търси целия низ като един токен и връща `false`, вместо да предизвика изключение `SyntaxError`. Затова последната проверка се изпълнява и връща `false`.

Източници