Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources