CKTIS / JavaScript
document.querySelector — první odpovídající prvek
document.querySelector(selectors) vyhledá první prvek odpovídající CSS selektoru. Vrátí prvek nebo null; neplatný selektor vyvolá 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
document.querySelector(selectors)document.querySelector(selectors) je metoda DOM, nikoli součást samotného ECMAScriptu. Přijímá řetězec CSS selektoru a vrací první odpovídající Element v pořadí stromu dokumentu, nebo null.
Než začnete číst vlastnosti výsledku, ověřte, zda není null. Neplatná syntaxe selektoru vyvolá DOMException s názvem SyntaxError, místo aby vrátila null. U seznamu selektorů oddělených čárkami určuje výsledek pořadí prvků ve stromu, nikoli pořadí selektorů.
Naproti tomu querySelectorAll() vrací statický seznam všech shod. Příklad volá querySelector() na objektu document aktuální stránky, takže nalezené shody závisejí na kódu HTML této stránky.
Příklady
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Document.querySelector</title>
</head>
<body>
<h1>First matching element</h1>
<ul>
<li class="item">First</li>
<li class="item">Second</li>
</ul>
<script>
console.log(document.querySelector('.item').textContent);
console.log(document.querySelector('.missing') === null);
try {
document.querySelector('[');
} catch (error) {
console.log(error.name);
}
</script>
</body>
</html>Výsledek
First true SyntaxError
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.