Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori