CKTIS / JavaScript
Element.querySelector — prvi podudarni potomak
Element.querySelector traži prvog potomka koji odgovara CSS selektoru. Vraća element ili null; nevažeći selektor uzrokuje iznimku.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
element.querySelector(selectors)Element.querySelector prihvaća niz selectors koji sadrži CSS selektor ili popis selektora odvojenih zarezima. Vraća prvog podudarnog potomka prema redoslijedu stabla, a ne prema redoslijedu popisa selektora. Element na kojem se metoda poziva sam nije rezultat.
Ako nema podudaranja, vraća se null. Provjerite rezultat prije pristupa njegovim svojstvima. Nevažeća sintaksa selektora uzrokuje DOMException naziva SyntaxError, umjesto da vrati null.
Upotrijebite :scope > .action za odabir izravnog djeteta. Bez :scope podudaranje selektora može uzeti u obzir pretke izvan elementa na kojem se metoda poziva, iako rezultat ostaje njegov potomak. querySelectorAll() vraća statički popis svih podudaranja umjesto jednog elementa.
Ovo je API standarda DOM, a ne značajka jezika ECMAScript. Primjer zahtijeva okruženje preglednika s DOM-om; prisutnost Node 24 u repozitoriju ne dokazuje podršku za ovaj API.
Primjeri
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);Rezultat
First true true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.