Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje