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

CKTIS / JavaScript

Sélectionner un descendant avec querySelector() et modifier son contenu avec innerHTML

Trouvez le premier descendant qui correspond à un sélecteur CSS, gérez l’absence de résultat, puis lisez ou remplacez le balisage de l’élément sélectionné.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

const target = root.querySelector(selectors);
if (target !== null) {
  const previousMarkup = target.innerHTML;
  target.innerHTML = markup;
}

Element.querySelector/innerHTML associe deux opérations : trouver un élément et agir sur son contenu. root.querySelector(selectors) accepte une chaîne contenant un sélecteur CSS ou une liste de sélecteurs séparés par des virgules. La méthode renvoie le premier élément descendant correspondant dans l’ordre de l’arbre DOM, quel que soit l’ordre des sélecteurs dans la liste. Elle ne renvoie jamais root lui-même. En l’absence de correspondance, elle renvoie null ; une syntaxe de sélecteur invalide lève une DOMException nommée SyntaxError. Vérifiez le résultat avant de lire ou d’affecter une propriété.

Le résultat doit être un descendant de root, mais la correspondance peut tenir compte d’ancêtres extérieurs à ce sous-arbre. Avec :scope > .message, seuls les enfants directs de root ayant la classe message peuvent correspondre. La recherche ne renvoie donc pas de résultats dans tout le document comme document.querySelector().

La lecture de target.innerHTML renvoie le contenu sérialisé sous forme de chaîne, sans les balises de l’élément lui-même ni les racines du Shadow DOM. Une affectation analyse un fragment dans le contexte de l’élément et remplace ses enfants, pas l’élément lui-même. Pour un élément template, elle remplace le contenu du modèle. Les références conservées et les écouteurs restent liés aux anciens nœuds détachés, et non aux nouveaux. Dans un document XML, l’affectation d’un fragment mal formé lève SyntaxError ; la lecture peut lever InvalidStateError si la sérialisation XML échoue. Les deux sont des DOMException.

N’affectez pas directement de données non fiables à innerHTML : le balisage n’est pas assaini par défaut, ce qui peut entraîner une attaque XSS. Pour du texte brut, utilisez textContent. Si vous avez besoin de balisage d’une source non fiable, assainissez-le d’abord. Trusted Types ne réalise pas cet assainissement à lui seul. Si l’environnement prend en charge Trusted Types et qu’une CSP les impose, affecter une chaîne ordinaire sans politique par défaut appropriée lève TypeError. Fournissez plutôt une valeur TrustedHTML produite par une politique d’assainissement.

Ces API relèvent de la plateforme web, et non d’ECMAScript 2024. Vérifiez que l’environnement d’exécution fournit un DOM et prend en charge les mécanismes de sécurité nécessaires.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>querySelector() and innerHTML</title>
</head>
<body>
  <script>
    {
      const panel = document.createElement("div");
      panel.innerHTML = '<p class="message"><em>Before</em></p><p class="message">Unchanged</p>';

      const target = panel.querySelector(".message");
      if (target !== null) {
        const oldChild = target.firstElementChild;
        console.log(target.innerHTML);
        target.innerHTML = "<strong>After</strong>";
        console.log(target.innerHTML);
        console.log(oldChild.parentNode === null);
        console.log(target.nextElementSibling.textContent);
      }
      console.log(panel.querySelector(".missing") === null);
    }
  </script>
</body>
</html>

Résultat

<em>Before</em>
<strong>After</strong>
true
Unchanged
true

Enregistrez l’exemple dans un fichier `.html` et ouvrez-le dans un navigateur sans CSP imposant Trusted Types. Consultez la sortie dans la console du navigateur. Seul le premier élément correspondant change. Son ancien enfant n’a plus de parent, le second élément conserve le texte `Unchanged` et la recherche sans correspondance renvoie `null`.

Leçons associées

  • JavaScript · Leçon 18 · Avancé · Version : 4

Sources