CKTIS / JavaScript
document.querySelector — prvi podudarajući element
document.querySelector(selectors) traži prvi element koji odgovara CSS selektoru. Vraća element ili null; neispravan selektor uzrokuje iznimku.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
document.querySelector(selectors)document.querySelector(selectors) metoda je DOM-a, a ne dio samog ECMAScripta. Prihvaća niz CSS selektora i vraća prvi podudarajući Element prema redoslijedu stabla dokumenta ili null.
Prije čitanja svojstava rezultata provjerite je li null. Neispravna sintaksa selektora uzrokuje DOMException naziva SyntaxError, umjesto da vrati null. Kod popisa selektora odvojenih zarezima rezultat određuje redoslijed elemenata u stablu, a ne redoslijed selektora.
Nasuprot tome, querySelectorAll() vraća statičan popis svih podudaranja. Primjer poziva querySelector() na objektu document trenutačne stranice, pa podudaranja ovise o HTML kôdu te stranice.
Primjeri
<!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>Rezultat
First true SyntaxError
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.