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

CKTIS / JavaScript

Element.querySelector — първият съвпадащ потомък

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

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

Синтаксис

element.querySelector(selectors)

Element.querySelector приема низ selectors, съдържащ CSS селектор или списък от селектори, разделени със запетаи. Връща първия съвпадащ потомък в реда на дървото, а не в реда на списъка със селектори. Елементът, върху който се извиква методът, сам по себе си не е резултат.

Ако няма съвпадение, се връща null. Проверете резултата, преди да получите достъп до свойствата му. Невалидният синтаксис на селектора предизвиква DOMException с име SyntaxError, вместо да върне null.

Използвайте :scope > .action, за да изберете пряко дете. Без :scope съвпадението на селектора може да отчита предци извън елемента, върху който се извиква методът, въпреки че резултатът остава негов потомък. querySelectorAll() връща статичен списък на всички съвпадения вместо един елемент.

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

Примери

const root = document.createElement('section');
const first = document.createElement('button');
const second = document.createElement('button');
first.className = 'action';
second.className = 'action';
first.textContent = 'First';
second.textContent = 'Second';
root.append(first, second);

console.log(root.querySelector('.action').textContent);
console.log(root.querySelector(':scope > .action') === first);
console.log(root.querySelector('.missing') === null);

Резултат

First
true
true

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

Източници