WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Element.querySelectorAll — Nachfahrenelemente finden

Element.querySelectorAll gibt eine statische NodeList der Nachfahren zurück, die einem CSS-Selektor entsprechen. Spätere Änderungen am Baum aktualisieren die Liste nicht.

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

element.querySelectorAll(selectors)

Element.querySelectorAll(selectors) gibt passende Nachfahren in Baumreihenfolge als NodeList zurück, nicht als Array. Das aufrufende Element selbst ist nicht enthalten. Gibt es keine Treffer, ist die Liste leer; querySelector gibt stattdessen das erste Element oder null zurück.

Die Liste ist statisch: Änderungen am Baum aktualisieren ihren Inhalt nicht, die enthaltenen Elemente sind jedoch keine Kopien. Ein erneuter Aufruf liefert aktuelle Ergebnisse. Ein ungültiger Selektor löst eine DOMException namens SyntaxError aus.

Ein Selektor kann Vorfahren außerhalb des aufrufenden Elements berücksichtigen; verwende :scope > .item, um direkte Kinder auszuwählen. Dies ist eine DOM-API und kein ECMAScript-Feature; die Verfügbarkeit von Node.js allein belegt keine Unterstützung.

Beispiele

const root = document.createElement('section');
const first = document.createElement('span');
first.className = 'item';
root.append(first);

const matches = root.querySelectorAll('.item');
const second = document.createElement('span');
second.className = 'item';
root.append(second);

console.log(matches.length);
console.log(root.querySelectorAll('.item').length);
console.log(matches[0] === first);

Ergebnis

1
2
true

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