CKTIS / JavaScript
document.querySelector — le premier élément correspondant
document.querySelector(selectors) recherche le premier élément correspondant à un sélecteur CSS. La méthode renvoie un élément ou null ; un sélecteur incorrect déclenche une exception.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
document.querySelector(selectors)document.querySelector(selectors) est une méthode du DOM, et non une partie d’ECMAScript en soi. Elle accepte une chaîne de sélecteur CSS et renvoie le premier Element correspondant selon l’ordre de l’arbre du document, ou null.
Vérifiez que le résultat n’est pas null avant d’en lire les propriétés. Une syntaxe de sélecteur incorrecte déclenche une DOMException nommée SyntaxError au lieu de renvoyer null. Pour une liste de sélecteurs séparés par des virgules, c’est l’ordre des éléments dans l’arbre qui détermine le résultat, et non l’ordre des sélecteurs.
À l’inverse, querySelectorAll() renvoie une liste statique de toutes les correspondances. L’exemple appelle querySelector() sur le document de la page actuelle : les éléments qui correspondent au sélecteur dépendent donc du balisage HTML de cette page.
Exemples
<!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>Résultat
First true SyntaxError
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.