Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła