CKTIS / JavaScript
Element.querySelector — pierwszy pasujący potomek
Element.querySelector wyszukuje pierwszego potomka pasującego do selektora CSS. Zwraca element albo null; niepoprawny selektor powoduje wyjątek.
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
element.querySelector(selectors)Element.querySelector przyjmuje ciąg selectors zawierający selektor CSS lub listę selektorów rozdzielonych przecinkami. Zwraca pierwszego pasującego potomka w kolejności drzewa, a nie według kolejności selektorów. Sam element wywołujący nie jest wynikiem.
Brak dopasowania daje null. Przed dostępem do właściwości sprawdź wynik. Niepoprawna składnia selektora powoduje DOMException o nazwie SyntaxError, zamiast zwrócić null.
Użyj :scope > .action, aby wybrać bezpośrednie dziecko. Bez :scope dopasowanie selektora może uwzględniać przodków spoza elementu wywołującego, choć wynik pozostaje jego potomkiem. querySelectorAll() zwraca statyczną listę wszystkich dopasowań zamiast pojedynczego elementu.
To API standardu DOM, nie funkcja samego ECMAScript. Przykład wymaga środowiska przeglądarkowego z DOM; obecność Node 24 w repozytorium nie potwierdza obsługi tego API.
Przykłady
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);Wynik
First true true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.