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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.