---
title: ParentNode.querySelectorAll()
slug: Web/API/ParentNode/querySelectorAll
tags:
  - API
  - DOM
  - Méthodes
  - Noeuds
  - Sélecteurs
  - parent
translation_of: Web/API/ParentNode/querySelectorAll
---
<div>{{ApiRef("DOM")}}</div>

<p>Renvoie une {{domxref("NodeList")}} représentant une liste d'éléments avec l'élément courant comme racine et qui correspondent au groupe de sélecteurs spécifiés.</p>

<h2 id="Syntaxe">Syntaxe</h2>

<pre class="syntaxbox"><var>elementList</var> = document.querySelectorAll(<var>selectors</var>);
</pre>

<p>où</p>

<ul>
 <li><code>elementList</code> est une {{domxref("NodeList")}} <a href="https://developer.mozilla.org/fr/docs/Web/API/NodeList#A_sometimes-live_collection">non-directe</a> d'objets {{domxref("element")}}.</li>
 <li><code>selectors</code> est une chaîne de caractères (<em>string</em>) contenant un ou plusieurs <a href="https://developer.mozilla.org/fr/docs/Web/CSS/S%C3%A9lecteurs_CSS">sélecteurs CSS</a> séparés par des virgules.</li>
</ul>

<p>La <code>NodeList</code> retournée contiendra tous les éléments dans le document qui correspondent à l'un des sélecteurs spécifiés. Si la chaîne <code><em>selectors</em></code> contient un <a href="https://developer.mozilla.org/fr/docs/Web/CSS/Pseudo-elements">pseudo-element CSS</a>, la <code><var>elementList</var></code> retournée sera vide.</p>

<h2 id="Exemples">Exemples</h2>

<p>Cet exemple renvoie une liste de tous les éléments <code>div</code> d'un <code>document</code> avec une classe "<code>note</code>" ou "<code>alert</code>" :</p>

<pre class="brush: js">var matches = document.querySelectorAll("div.note, div.alert");
</pre>

<h2 id="Notes">Notes</h2>

<p>Renvoie une <code>NodeList</code> <a href="https://developer.mozilla.org/fr/docs/Web/API/NodeList#A_sometimes-live_collection">non directe</a> de tous les noeuds éléments correspondant.</p>

<p>Lance une exception <code>SYNTAX_ERR</code> si le groupe de sélecteurs spécifié est invalide.</p>

<p><code>querySelectorAll()</code> fut introduite dans l'API WebApps.</p>

<p>L'argument chaîne passé à <code>querySelectorAll()</code> doit suivre la syntaxe CSS. Voir {{domxref("document.querySelector")}} pour des exemples concrets.</p>

<h2 id="Spécifications">Spécifications</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Spécification</th>
   <th scope="col">Statut</th>
   <th scope="col">Commentaire</th>
  </tr>
  <tr>
   <td>{{SpecName("Selectors API Level 2", "#dom-parentnode-queryselectorall", "ParentNode.querySelectorAll()")}}</td>
   <td>{{Spec2("Selectors API Level 2")}}</td>
   <td>Pas de changement.</td>
  </tr>
  <tr>
   <td>{{SpecName("DOM4", "#dom-parentnode-queryselectorall", "ParentNode.querySelectorAll()")}}</td>
   <td>{{Spec2("DOM4")}}</td>
   <td>Définition initiale.</td>
  </tr>
 </tbody>
</table>

<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>



<p>{{Compat("api.ParentNode.querySelectorAll")}}</p>


<h2 id="Voir_aussi">Voir aussi</h2>

<ul>
 <li>{{domxref("Element.querySelectorAll")}}</li>
 <li>{{domxref("Document.querySelectorAll")}}</li>
 <li>{{domxref("DocumentFragment.querySelectorAll")}}</li>
</ul>