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

CKTIS / JavaScript

Element.matches — проверка на CSS селектор

Element.matches проверява дали даден елемент съответства на CSS селектор. Връща булева стойност, а не елемент; невалидният синтаксис на селектора води до изключение.

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

Синтаксис

element.matches(selectors)

element.matches(selectors) проверява самия element. Аргументът selectors е низ с CSS селектор или списък от селектори, разделени със запетаи. Резултатът е true, ако елементът съответства, и false в противен случай.

Методът не търси сред потомците като querySelector() и не намира съответстващ предшественик като closest(). Не е необходимо елементът да е свързан с документ; селекторите, зависещи от отношенията в дървото, обаче отчитат действителното му обкръжение.

Невалиден селектор предизвиква DOMException с име SyntaxError, вместо да върне false.

Това е DOM API, дефиниран в DOM Standard, а не функция на ECMAScript. Самото наличие на Node 24 не доказва, че този API на браузъра се поддържа.

Примери

const element = document.createElement('button');
element.className = 'action';

console.log(element.matches('button.action'));
console.log(element.matches('.missing'));
console.log(element.matches('.missing, .action'));

try {
  element.matches('[');
} catch (error) {
  console.log(error.name);
}

Резултат

true
false
true
SyntaxError

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници