CKTIS / JavaScript
document.querySelector — prvý zodpovedajúci prvok
document.querySelector(selectors) vyhľadá prvý prvok zodpovedajúci CSS selektoru. Vráti prvok alebo null; neplatný selektor vyvolá 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
document.querySelector(selectors)document.querySelector(selectors) je metóda DOM, nie súčasť samotného ECMAScriptu. Prijíma reťazec CSS selektora a vracia prvý zodpovedajúci Element v poradí stromu dokumentu alebo null.
Pred čítaním vlastností výsledku skontrolujte, či nie je null. Neplatná syntax selektora vyvolá DOMException s názvom SyntaxError, namiesto toho, aby vrátila null. Pri zozname selektorov oddelených čiarkami určuje výsledok poradie prvkov v strome, nie poradie selektorov.
Na rozdiel od toho querySelectorAll() vracia statický zoznam všetkých zhôd. Príklad volá querySelector() na objekte document aktuálnej stránky, takže nájdené zhody závisia od kódu HTML tejto stránky.
Prí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ýsledok
First true SyntaxError
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.