Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

Element.querySelector — prvý zodpovedajúci potomok

Element.querySelector vyhľadá prvého potomka, ktorý zodpovedá CSS selektoru. Vráti element alebo null; neplatný selektor spôsobí výnimku.

Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

element.querySelector(selectors)

Element.querySelector prijíma reťazec selectors obsahujúci CSS selektor alebo zoznam selektorov oddelených čiarkami. Vráti prvého zodpovedajúceho potomka v poradí stromu, nie v poradí zoznamu selektorov. Element, na ktorom sa metóda volá, sám nie je výsledkom.

Ak sa nič nenájde, vráti sa null. Pred prístupom k vlastnostiam výsledok skontrolujte. Neplatná syntax selektora vyvolá DOMException s názvom SyntaxError, namiesto toho, aby sa vrátilo null.

Použite :scope > .action na výber priameho potomka. Bez :scope môže vyhodnocovanie selektora zohľadniť predkov mimo volajúceho elementu, hoci výsledok zostáva jeho potomkom. querySelectorAll() vráti statický zoznam všetkých zhôd namiesto jedného elementu.

Ide o API štandardu DOM, nie o funkciu jazyka ECMAScript. Príklad vyžaduje prostredie prehliadača s DOM; prítomnosť Node 24 v repozitári nedokazuje podporu tohto API.

Príklady

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);

Výsledok

First
true
true

Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.

Zdroje