Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje