База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

document.querySelector — първият съвпадащ елемент

document.querySelector(selectors) търси първия елемент, който съвпада с CSS селектор. Връща елемент или null; невалиден селектор предизвиква изключение.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

document.querySelector(selectors)

document.querySelector(selectors) е метод на DOM, а не част от самия ECMAScript. Приема низ със CSS селектор и връща първия съвпадащ Element според реда в дървото на документа или null.

Проверете дали резултатът е null, преди да прочетете свойствата му. Невалидният синтаксис на селектора предизвиква DOMException с име SyntaxError, вместо да върне null. При списък от селектори, разделени със запетаи, резултатът се определя от реда на елементите в дървото, а не от реда на селекторите.

За разлика от него querySelectorAll() връща статичен списък на всички съвпадения. Примерът извиква querySelector() върху обекта document на текущата страница, затова съвпаденията зависят от HTML кода на тази страница.

Примери

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

Резултат

First
true
SyntaxError

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници