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

CKTIS / JavaScript

HTMLElement.innerHTML : lire et remplacer le contenu d’un élément

En lecture, `innerHTML` renvoie le balisage du contenu d’un élément. En écriture, la propriété remplace ce contenu par de nouveaux nœuds, même avec `+=`.

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

Syntaxe

const markup = element.innerHTML;
element.innerHTML = value; // string or TrustedHTML; null is treated as ""

HTMLElement.innerHTML est une propriété d’instance héritée de Element, pas une méthode statique. La lecture renvoie le contenu actuel du DOM sous forme de chaîne, sans les balises de l’élément lui-même ni les racines du Shadow DOM. C’est une sérialisation de l’arbre, pas une copie du texte source.

L’affectation analyse le balisage dans le contexte de l’élément et remplace ses nœuds enfants, pas l’élément lui-même. Pour template, elle remplace le contenu de template.content. L’accesseur en écriture accepte une chaîne ou un objet TrustedHTML. Web IDL convertit null en chaîne vide ("") avant la vérification Trusted Types. Si la chaîne parvient à l’analyseur sans modification, le contenu est vidé. Lorsque Trusted Types est imposé, une politique par défaut peut toutefois transformer la chaîne vide en balisage non vide : une affectation réussie ne vide donc pas forcément le contenu. L’accesseur en écriture ne crée pas de racines déclaratives du Shadow DOM.

element.innerHTML += markup lit le balisage sérialisé, lui ajoute le nouveau texte, puis analyse de nouveau le tout. Les anciens nœuds sont détachés et les écouteurs d’événements inscrits directement sur eux ne sont pas transférés aux nouveaux nœuds. Pour conserver les nœuds existants, ajoute les nouveaux avec append().

Ne passe pas de données non fiables directement à innerHTML : aucun nettoyage n’est effectué par défaut et les attributs de gestion d’événements peuvent provoquer une XSS, même si les éléments script insérés ne s’exécutent pas. Utilise textContent pour du texte brut et un outil de nettoyage éprouvé si du HTML est nécessaire. Une politique Trusted Types ne garantit pas à elle seule le nettoyage.

Cette API relève de la plateforme web, pas d’ECMAScript 2024. La prise en charge de Trusted Types dépend de l’environnement. Si la CSP impose Trusted Types et qu’aucune politique par défaut n’existe, affecter une chaîne déclenche TypeError. L’analyse HTML récupère après des erreurs de syntaxe, mais dans un document XML, un fragment mal formé peut déclencher SyntaxError à l’affectation, et un contenu impossible à sérialiser en XML bien formé peut déclencher InvalidStateError à la lecture.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>innerHTML example</title>
</head>
<body>
  <script>
    const box = document.createElement("div");
    box.innerHTML = "<strong>Hello</strong>";
    const original = box.firstElementChild;

    box.innerHTML += "<em> again</em>";

    console.log(box.innerHTML);
    console.log(box.textContent);
    console.log(original === box.firstElementChild);
    console.log(original.parentNode === null);
  </script>
</body>
</html>

Résultat

<strong>Hello</strong><em> again</em>
Hello again
false
true

Enregistre l’exemple dans un fichier HTML, ouvre-le dans un navigateur sans imposer Trusted Types et consulte la console de développement. Les deux premières lignes comparent balisage et texte ; les deux dernières montrent que le premier nœud a été remplacé et n’a plus de parent.

Leçons associées

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

Sources