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

CKTIS / JavaScript

Échappement du texte en HTML

Lors de la génération de HTML, échappez le texte brut selon son emplacement. Pour écrire directement dans un élément ordinaire du DOM, affectez plutôt la chaîne d’origine à `textContent`.

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

Syntaxe

const escapeHtmlText = (text) => text.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');
// Use escaped text only in the ordinary text position of trusted HTML markup.
const markup = `<p>${escapeHtmlText(text)}</p>`;
// If writing directly to an ordinary DOM element, use the original string instead.
element.textContent = text;

L’échappement en contexte de texte HTML consiste à encoder du texte brut au moment de l’insérer dans du code HTML, par exemple dans le contenu d’un élément p. Un < non échappé peut ouvrir une balise, et & peut amorcer une référence de caractère. L’analyseur transforme &lt; en un < littéral dans le texte sans interpréter le caractère décodé comme le début d’une balise.

Si vous enchaînez des appels à replaceAll, remplacez & par &amp; avant de remplacer < par &lt;, pour ne pas échapper les & introduits par les remplacements suivants. L’exemple remplace aussi > par &gt;, ce qui est facultatif ici ; les guillemets n’ont pas non plus besoin d’être échappés. Encodez le texte brut une seule fois, à l’insertion, et ne le faites pas manuellement si le moteur de modèles s’en charge déjà.

Pour définir le texte d’un élément ordinaire du DOM, affectez la chaîne d’origine à textContent. N’utilisez pas innerHTML à cette fin : cette propriété fait analyser le balisage. Ne réutilisez pas cette fonction pour les attributs, les URL, JavaScript ou CSS, qui obéissent à d’autres règles. Pour conserver une partie du balisage HTML non fiable, nettoyez le HTML plutôt que de l’échapper comme du texte.

Exemples

function escapeHtmlText(text) {
  return text.replaceAll('&', '&amp;')
    .replaceAll('<', '&lt;')
    .replaceAll('>', '&gt;');
}

const text = 'A & B <em>demo</em> &lt;';
console.log(`<p>${escapeHtmlText(text)}</p>`);

Résultat

<p>A &amp; B &lt;em&gt;demo&lt;/em&gt; &amp;lt;</p>

La console affiche le code source HTML, pas le texte rendu. Son analyse produit un paragraphe sans élément `em` ; la séquence finale `&lt;` reste du texte littéral.

Leçons associées

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

Sources