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

CKTIS / JavaScript

Échapper du texte HTML ou assainir la structure avec une liste d’autorisation

L’échappement affiche la saisie comme du texte littéral. L’assainissement structurel conserve certaines mises en forme selon une liste d’éléments et d’attributs autorisés.

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

Syntaxe

element.textContent = input;
element.setHTML(input, { sanitizer: { elements: ["strong"], attributes: [], comments: false, dataAttributes: false } });

Pour insérer une donnée non fiable dans une zone de texte ordinaire du code source HTML, encodez-la pour ce contexte : remplacez par exemple & par &amp; et < par &lt;. L’analyseur lit ces références comme des caractères de texte, non comme de la syntaxe de balise. Si vous manipulez directement le DOM, affectez la valeur brute à textContent d’un élément comme div : son contenu est remplacé par du texte, sans analyse HTML. L’échappement du texte HTML n’est pas une protection générale pour les attributs, les URL, JavaScript ou CSS.

Pour conserver la mise en forme, assainissez la structure. setHTML() analyse le fragment dans le contexte de l’élément de destination, applique la liste des éléments et attributs autorisés et supprime les constructions dangereuses pour la sécurité XSS, même si la configuration les autorise. La politique de l’exemple autorise strong, mais aucun attribut. Filtrez la structure analysée plutôt que de supprimer des balises avec une expression régulière. Si votre politique autorise les liens, définissez séparément les URL que votre application accepte.

textContent et setHTML() sont des API de la plateforme web, pas des fonctionnalités d’ECMAScript 2024. Vérifiez la prise en charge de setHTML() dans les navigateurs ciblés. À défaut, utilisez du texte brut ou un outil d’assainissement HTML éprouvé ; ne passez pas l’entrée brute à innerHTML. Ne supposez pas non plus que le résultat sérialisé peut être réanalysé sans risque dans un autre contexte : assainissez-le lors de son insertion dans l’élément de destination.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTML text escaping and structural sanitization</title>
</head>
<body>
  <pre id="output"></pre>
  <script>
    const input = '<strong title="label">A &amp; B</strong><br>';
    const text = document.createElement('div');
    const rich = document.createElement('div');

    if (typeof rich.setHTML !== 'function') {
      throw new Error('This example requires a browser that supports Element.setHTML().');
    }

    text.textContent = input;
    rich.setHTML(input, {
      sanitizer: {
        elements: ['strong'],
        attributes: [],
        comments: false,
        dataAttributes: false,
      },
    });

    document.getElementById('output').textContent =
      [text.innerHTML, rich.innerHTML].join('\n');
  </script>
</body>
</html>

Résultat

&lt;strong title="label"&gt;A &amp;amp; B&lt;/strong&gt;&lt;br&gt;
<strong>A &amp; B</strong>

La première ligne sérialise le texte littéral : même la notation `&amp;` de la saisie est conservée sous forme de texte. La seconde montre un véritable élément `strong`, sans attribut `title` ni élément `br`. L’exemple utilise `innerHTML` uniquement en lecture.

Leçons associées

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

Sources