CKTIS / JavaScript
Element.querySelector — premier descendant correspondant
Element.querySelector recherche le premier descendant correspondant à un sélecteur CSS. La méthode renvoie un élément ou null ; un sélecteur invalide 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
element.querySelector(selectors)Element.querySelector accepte une chaîne selectors contenant un sélecteur CSS ou une liste de sélecteurs séparés par des virgules. La méthode renvoie le premier descendant correspondant dans l’ordre de l’arbre, et non dans l’ordre de la liste des sélecteurs. L’élément sur lequel elle est appelée n’est pas lui-même un résultat.
En l’absence de correspondance, le résultat est null. Vérifiez le résultat avant d’accéder à ses propriétés. Une syntaxe de sélecteur invalide déclenche une DOMException nommée SyntaxError, au lieu de renvoyer null.
Utilisez :scope > .action pour sélectionner un enfant direct. Sans :scope, la recherche du sélecteur peut tenir compte d’ancêtres situés hors de l’élément appelant, même si le résultat reste un descendant de celui-ci. querySelectorAll() renvoie une liste statique de toutes les correspondances au lieu d’un seul élément.
Il s’agit d’une API de la norme DOM, et non d’une fonctionnalité du langage ECMAScript. L’exemple nécessite un environnement de navigateur avec un DOM ; la présence de Node 24 dans un dépôt ne prouve pas la prise en charge de cette API.
Exemples
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);Résultat
First true true
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.