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

CKTIS / JavaScript

Element.querySelectorAll — rechercher des éléments descendants

Element.querySelectorAll renvoie une NodeList statique des descendants correspondant à un sélecteur CSS. Les modifications ultérieures de l’arbre ne mettent pas cette liste à jour.

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

Element.querySelectorAll(selectors) renvoie les descendants correspondants dans l’ordre de l’arbre sous forme de NodeList, et non de tableau. L’élément appelant lui-même n’est pas inclus. En l’absence de correspondance, la liste est vide ; querySelector renvoie plutôt le premier élément ou null.

La liste est statique : les modifications de l’arbre ne mettent pas à jour son contenu, mais les éléments qu’elle contient ne sont pas des copies. Un nouvel appel fournit des résultats à jour. Un sélecteur invalide déclenche une DOMException nommée SyntaxError.

Un sélecteur peut prendre en compte des ancêtres situés en dehors de l’élément appelant ; utilisez :scope > .item pour cibler les enfants directs. Il s’agit d’une API DOM, et non d’une fonctionnalité ECMAScript ; la seule disponibilité de Node.js ne suffit pas à établir sa prise en charge.

Exemples

const root = document.createElement('section');
const first = document.createElement('span');
first.className = 'item';
root.append(first);

const matches = root.querySelectorAll('.item');
const second = document.createElement('span');
second.className = 'item';
root.append(second);

console.log(matches.length);
console.log(root.querySelectorAll('.item').length);
console.log(matches[0] === first);

Résultat

1
2
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