Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

document.querySelector — prvi ujemajoči se element

document.querySelector(selectors) poišče prvi element, ki ustreza izbirniku CSS. Vrne element ali null; neveljaven izbirnik sproži izjemo.

Različica: 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) je metoda DOM in ni del samega ECMAScripta. Sprejme niz z izbirnikom CSS in vrne prvi ujemajoči se Element glede na vrstni red v drevesu dokumenta ali null.

Pred branjem lastnosti rezultata preverite, ali je null. Neveljavna sintaksa izbirnika sproži DOMException z imenom SyntaxError, namesto da bi vrnila null. Pri seznamu izbirnikov, ločenih z vejicami, rezultat določa vrstni red elementov v drevesu, ne vrstni red izbirnikov.

Nasprotno pa querySelectorAll() vrne statičen seznam vseh ujemanj. Primer pokliče querySelector() na objektu document trenutne strani, zato je od kode HTML te strani odvisno, kateri elementi ustrezajo izbirniku.

Primeri

<!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

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri