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

CKTIS / JavaScript

document.querySelectorAll — tous les éléments correspondants

Recherche des éléments à l’aide de sélecteurs CSS et renvoie une NodeList statique, même lorsqu’aucun élément ne correspond.

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

document.querySelectorAll(selectors) renvoie une NodeList statique des éléments correspondants, dans l’ordre de l’arbre du document. L’argument est une chaîne de sélecteur CSS, qui peut aussi être une liste séparée par des virgules.

En l’absence de correspondance, le résultat est une liste vide, et non null. Un sélecteur invalide déclenche une DOMException nommée SyntaxError. En revanche, document.querySelector(selectors) renvoie le premier élément correspondant ou null.

Une liste statique conserve les mêmes éléments après les modifications du DOM ; elle ne copie pas les éléments. Relancez la requête pour obtenir des résultats à jour. L’exemple utilise un document distinct et ne modifie donc pas la page ouverte.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Document.querySelectorAll</title>
</head>
<body>
  <h1>All matching elements</h1>
  <ul id="items">
    <li class="item">First item</li>
  </ul>
  <script>
    const matches = document.querySelectorAll('.item');
    const added = document.createElement('li');
    added.className = 'item';
    added.textContent = 'Second item';
    document.getElementById('items').append(added);

    console.log(matches.length);
    console.log(document.querySelectorAll('.item').length);
    console.log(document.querySelectorAll('.missing').length);
  </script>
</body>
</html>

Résultat

1
2
0

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