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.