WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

Element.querySelector — erster passender Nachfahre

Element.querySelector sucht den ersten Nachfahren, der einem CSS-Selektor entspricht. Die Methode gibt ein Element oder null zurück; bei einem ungültigen Selektor wird eine Ausnahme ausgelöst.

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.querySelector(selectors)

Element.querySelector nimmt eine Zeichenfolge selectors entgegen, die einen CSS-Selektor oder eine durch Kommas getrennte Selektorliste enthält. Die Methode gibt den ersten passenden Nachfahren in Baumreihenfolge zurück, nicht in der Reihenfolge der Selektoren. Das Element, auf dem sie aufgerufen wird, ist selbst kein Ergebnis.

Wenn es keine Übereinstimmung gibt, wird null zurückgegeben. Prüfe das Ergebnis, bevor du auf Eigenschaften zugreifst. Eine ungültige Selektorsyntax löst eine DOMException mit dem Namen SyntaxError aus, statt null zurückzugeben.

Verwende :scope > .action, um ein direktes Kind auszuwählen. Ohne :scope kann die Selektorprüfung Vorfahren außerhalb des aufrufenden Elements berücksichtigen, obwohl das Ergebnis weiterhin ein Nachfahre davon ist. querySelectorAll() gibt statt eines einzelnen Elements eine statische Liste aller Treffer zurück.

Dies ist eine API des DOM-Standards und kein Feature der ECMAScript-Sprache. Das Beispiel benötigt eine Browserumgebung mit DOM; dass Node 24 im Repository vorhanden ist, belegt keine Unterstützung dieser API.

Beispiele

const root = document.createElement('section');
const first = document.createElement('button');
const second = document.createElement('button');
first.className = 'action';
second.className = 'action';
first.textContent = 'First';
second.textContent = 'Second';
root.append(first, second);

console.log(root.querySelector('.action').textContent);
console.log(root.querySelector(':scope > .action') === first);
console.log(root.querySelector('.missing') === null);

Ergebnis

First
true
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