Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Element.querySelector — prvi ujemajoči se potomec

Element.querySelector poišče prvega potomca, ki ustreza izbirniku CSS. Vrne element ali null; neveljaven izbirnik povzroči izjemo.

Različica: 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 sprejme niz selectors, ki vsebuje izbirnik CSS ali seznam izbirnikov, ločenih z vejicami. Vrne prvega ujemajočega se potomca po vrstnem redu drevesa, ne po vrstnem redu seznama izbirnikov. Element, na katerem je metoda poklicana, sam ni rezultat.

Če ni ujemanja, vrne null. Pred dostopom do lastnosti preverite rezultat. Neveljavna sintaksa izbirnika sproži DOMException z imenom SyntaxError, namesto da bi vrnila null.

Uporabite :scope > .action za izbiro neposrednega otroka. Brez :scope lahko ujemanje izbirnika upošteva prednike zunaj klicanega elementa, čeprav rezultat ostane njegov potomec. querySelectorAll() vrne statičen seznam vseh ujemanj namesto enega elementa.

To je API standarda DOM, ne funkcija jezika ECMAScript. Primer zahteva brskalniško okolje z DOM; prisotnost Node 24 v repozitoriju ne dokazuje podpore za ta API.

Primeri

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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri