Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

document.querySelector — pierwszy pasujący element

document.querySelector(selectors) wyszukuje pierwszy element pasujący do selektora CSS. Zwraca element lub null; niepoprawny selektor powoduje wyjątek.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

document.querySelector(selectors)

document.querySelector(selectors) to metoda DOM, nie funkcja samego ECMAScript. Przyjmuje ciąg selektorów CSS i zwraca pierwszy pasujący Element w kolejności drzewa dokumentu albo null.

Sprawdź null przed odczytem właściwości wyniku. Błędna składnia selektora powoduje DOMException o nazwie SyntaxError, a nie zwrot null. Przy liście selektorów rozdzielonych przecinkami decyduje kolejność elementów w drzewie, nie kolejność selektorów.

W przeciwieństwie do tej metody querySelectorAll() zwraca statyczną listę wszystkich dopasowań. Przykład wywołuje querySelector() na dokumencie (document) bieżącej strony, więc dopasowania zależą od kodu HTML tej strony.

Przykłady

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

Wynik

First
true
SyntaxError

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła