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

CKTIS / JavaScript

Element.innerHTML et limites de sécurité de l’insertion de texte

Choisissez entre l’analyse du balisage et l’insertion de texte littéral. Apprenez à prévenir les XSS dans le DOM et à comprendre l’effet de l’application de Trusted Types.

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

Syntaxe

const markup = element.innerHTML;
element.innerHTML = htmlStringOrTrustedHTML;
const text = element.textContent;
element.textContent = plainText;
element.append(plainText);
element.insertAdjacentText("beforeend", plainText);
element.setHTML(htmlToSanitize); // Where supported.

Lire Element.innerHTML renvoie le contenu sérialisé de l’élément, sans sa propre balise. Dans un document HTML, une affectation analyse un fragment dans le contexte de l’élément et remplace normalement ses nœuds enfants existants. Pour un élément HTML <template>, la lecture sérialise le contenu de template.content et l’affectation remplace les nœuds enfants de ce DocumentFragment, pas ceux de l’élément lui-même. element.innerHTML += fragment remplace également les nœuds au lieu d’en ajouter à la suite : l’expression lit le contenu sérialisé, puis analyse à nouveau la chaîne obtenue par concaténation.

Sur un élément, lire Node.textContent renvoie le texte concaténé de ses descendants, pas leur balisage. Affecter une chaîne non vide remplace les enfants par un seul nœud texte ; affecter une chaîne vide les supprime. Pour conserver les enfants existants, ajoutez la chaîne à la fin avec append(text) ou insérez-la à une position choisie par rapport à l’élément avec insertAdjacentText(position, text). Aucune de ces opérations textuelles n’interprète le balisage ni les références de caractères de la chaîne.

Ne transmettez pas de chaînes non fiables à innerHTML : c’est un point d’injection HTML qui peut entraîner une XSS dans le DOM. Les éléments script insérés ainsi ne s’exécutent pas, mais d’autres mécanismes, comme les attributs de gestionnaires d’événements, peuvent encore exécuter du code. Affichez le texte non fiable dans un élément ordinaire tel que div. L’insertion en tant que texte ne rend pas les mêmes données sûres dans un contexte de script, de style ou d’URL, ni si elles sont ensuite analysées comme du HTML.

Si vous avez besoin de HTML mis en forme provenant d’une source non fiable, utilisez setHTML() lorsqu’il est pris en charge, ou filtrez le HTML avant insertion avec un outil de nettoyage éprouvé. Ne vous rabattez jamais sur une affectation brute à innerHTML. Si la CSP impose Trusted Types et qu’aucune politique par défaut n’est définie, affecter une chaîne ordinaire à innerHTML déclenche une TypeError. TrustedHTML ne garantit pas le nettoyage : la sécurité dépend de la politique qui l’a créé. Il s’agit d’API de la plateforme web, non de fonctionnalités d’ECMAScript ; vérifiez la prise en charge des protections utilisées.

Exemples

<!doctype html>
<meta charset="utf-8">
<title>innerHTML and textContent</title>
<script>
{
  const sample = "<em>A &amp; B</em>";
  const parsed = document.createElement("div");
  const literal = document.createElement("div");

  parsed.innerHTML = sample;
  literal.textContent = sample;

  console.log(`innerHTML: ${parsed.childElementCount} | ${parsed.textContent}`);
  console.log(`textContent: ${literal.childElementCount} | ${literal.textContent}`);
}
</script>

Résultat

innerHTML: 1 | A & B
textContent: 0 | <em>A &amp; B</em>

Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur sans application de Trusted Types et consultez la console du navigateur. La chaîne fixe est inoffensive : l’analyse crée un élément `em` et décode la référence de caractère en `&`. L’insertion textuelle conserve toute la chaîne et ne crée aucun élément enfant.

Leçons associées

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

Sources