WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

document.querySelectorAll — alle passenden Elemente

Sucht Elemente mithilfe von CSS-Selektoren und gibt eine statische NodeList zurück – auch dann, wenn es keine Treffer gibt.

Version: 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.querySelectorAll(selectors)

document.querySelectorAll(selectors) gibt eine statische NodeList der passenden Elemente in der Reihenfolge des Dokumentbaums zurück. Das Argument ist eine CSS-Selektorzeichenfolge, auch eine durch Kommas getrennte Liste.

Gibt es keine Treffer, wird eine leere Liste zurückgegeben, nicht null. Ein ungültiger Selektor löst eine DOMException mit dem Namen SyntaxError aus. Im Gegensatz dazu gibt document.querySelector(selectors) das erste passende Element oder null zurück.

Eine statische Liste behält ihre Elemente auch nach Änderungen am DOM; sie kopiert die Elemente nicht. Führe die Abfrage erneut aus, um aktuelle Ergebnisse zu erhalten. Das Beispiel verwendet ein separates Dokument und verändert daher die geöffnete Seite nicht.

Beispiele

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

Ergebnis

1
2
0

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen