CKTIS / JavaScript
document.querySelector — das erste passende Element
document.querySelector(selectors) sucht das erste Element, das zu einem CSS-Selektor passt. 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
document.querySelector(selectors)document.querySelector(selectors) ist eine DOM-Methode und kein Bestandteil von ECMAScript selbst. Sie akzeptiert eine CSS-Selektorzeichenfolge und gibt das erste passende Element in der Reihenfolge des Dokumentbaums oder null zurück.
Prüfe auf null, bevor du Eigenschaften des Ergebnisses ausliest. Eine ungültige Selektorsyntax löst eine DOMException mit dem Namen SyntaxError aus, statt null zurückzugeben. Bei einer durch Kommas getrennten Selektorliste bestimmt die Reihenfolge der Elemente im Baum das Ergebnis, nicht die Reihenfolge der Selektoren.
Im Gegensatz dazu gibt querySelectorAll() eine statische Liste aller Treffer zurück. Das Beispiel ruft querySelector() auf dem document der aktuellen Seite auf. Welche Elemente passen, hängt daher vom HTML-Markup dieser Seite ab.
Beispiele
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>Document.querySelector</title>
</head>
<body>
<h1>First matching element</h1>
<ul>
<li class="item">First</li>
<li class="item">Second</li>
</ul>
<script>
console.log(document.querySelector('.item').textContent);
console.log(document.querySelector('.missing') === null);
try {
document.querySelector('[');
} catch (error) {
console.log(error.name);
}
</script>
</body>
</html>Ergebnis
First true SyntaxError
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.