Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori