Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje