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

CKTIS / JavaScript

document.querySelectorAll — всички съвпадащи елементи

Търси елементи с CSS селектори и връща статичен NodeList, включително когато няма съвпадения.

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

Синтаксис

document.querySelectorAll(selectors)

document.querySelectorAll(selectors) връща статичен NodeList на съвпадащите елементи в реда на дървото на документа. Аргументът е низ със CSS селектор, който може да бъде и списък, разделен със запетаи.

Ако няма съвпадения, резултатът е празен списък, а не null. Невалиден селектор предизвиква DOMException с име SyntaxError. За разлика от това document.querySelector(selectors) връща първия съвпадащ елемент или null.

Статичният списък запазва елементите си след промени в DOM; той не ги копира. Изпълнете заявката отново, за да получите актуални резултати. Примерът използва отделен документ и не променя отворената страница.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document.querySelectorAll</title>
</head>
<body>
  <h1>All matching elements</h1>
  <ul id="items">
    <li class="item">First item</li>
  </ul>
  <script>
    const matches = document.querySelectorAll('.item');
    const added = document.createElement('li');
    added.className = 'item';
    added.textContent = 'Second item';
    document.getElementById('items').append(added);

    console.log(matches.length);
    console.log(document.querySelectorAll('.item').length);
    console.log(document.querySelectorAll('.missing').length);
  </script>
</body>
</html>

Резултат

1
2
0

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

Източници