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.