KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / JavaScript

Tekst escapen in HTML

Escape platte tekst bij het genereren van HTML op basis van de invoegpositie. Schrijf je rechtstreeks naar een gewoon DOM-element, gebruik dan `textContent` met de originele tekenreeks.

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

Syntax

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;

Escapen in de HTML-tekstcontext is uitvoercodering voor platte tekst in HTML-broncode, bijvoorbeeld in de inhoud van een p-element. Een onbewerkte < kan een tag openen en & kan een tekenreferentie beginnen. De parser zet &lt; om in een letterlijke < in de tekst, zonder het gedecodeerde teken als tagbegin te behandelen.

Als je replaceAll-aanroepen achter elkaar zet, vervang dan eerst & door &amp; en daarna < door &lt;. Zo escape je niet de &-tekens die latere vervangingen toevoegen. Het voorbeeld vervangt ook > door &gt;, maar dat is hier optioneel; ook aanhalingstekens hoef je hier niet te escapen. Codeer de ruwe tekst één keer bij het invoegen en doe het niet handmatig als de template dat al doet.

Wijs de originele tekenreeks toe aan textContent om de tekst van een gewoon DOM-element in te stellen. Gebruik daarvoor niet innerHTML, want die eigenschap laat de tekenreeks als markup parsen. Hergebruik deze functie niet voor attributen, URL’s, JavaScript of CSS; daarvoor gelden andere regels. Wil je een deel van de markup uit onbetrouwbare HTML behouden, pas dan HTML-sanitatie toe in plaats van de tekst te escapen.

Voorbeelden

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>`);

Resultaat

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

De console toont de HTML-broncode, niet de weergegeven tekst. De parser maakt een alinea zonder `em`-element; het laatste `&lt;` blijft letterlijke tekst.

Gerelateerde lessen

  • JavaScript · Les 28 · Gevorderd · Versie: 4

Bronnen