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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.