CKTIS / JavaScript
Element.querySelector — první odpovídající potomek
Element.querySelector vyhledá prvního potomka odpovídajícího CSS selektoru. Vrací element nebo null; neplatný selektor způsobí výjimku.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
element.querySelector(selectors)Element.querySelector přijímá řetězec selectors obsahující CSS selektor nebo seznam selektorů oddělených čárkami. Vrací prvního odpovídajícího potomka v pořadí stromu, nikoli v pořadí seznamu selektorů. Element, na kterém se metoda volá, sám výsledkem není.
Pokud se nic nenajde, vrátí se null. Před přístupem k vlastnostem výsledek zkontrolujte. Neplatná syntaxe selektoru vyvolá DOMException s názvem SyntaxError, místo aby se vrátilo null.
Použijte :scope > .action k výběru přímého potomka. Bez :scope může vyhodnocení selektoru zohlednit předky mimo volající element, přestože výsledek zůstává jeho potomkem. querySelectorAll() vrací statický seznam všech shod namísto jediného elementu.
Jde o API standardu DOM, nikoli o funkci jazyka ECMAScript. Příklad vyžaduje prostředí prohlížeče s DOM; přítomnost Node 24 v repozitáři nedokládá podporu tohoto API.
Pří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ýsledek
First true true
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.