Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Escapowanie tekstu w HTML

Gdy wstawiasz zwykły tekst do generowanego HTML, zakoduj go zgodnie z kontekstem. Jeśli zapisujesz tekst bezpośrednio do elementu DOM, użyj `textContent` bez wcześniejszego kodowania.

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

Składnia

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;

Escapowanie tekstu w HTML to kodowanie przy tworzeniu kodu HTML, które sprawia, że dane w miejscu przeznaczonym na zwykły tekst, na przykład wewnątrz elementu p, nie stają się znacznikami. Surowy znak < może rozpocząć znacznik, a & — odwołanie znakowe. Parser zamienia &lt; na znak < w tekście, ale nie interpretuje tego znaku ponownie jako początku znacznika.

Przy kolejnych wywołaniach replaceAll zamień najpierw & na &amp;, a potem < na &lt;. Dzięki temu pierwsza zamiana nie obejmie znaków & dodanych przez późniejsze zamiany. Przykład zamienia też > na &gt;, choć w tym kontekście nie jest to konieczne; cudzysłowy również nie wymagają kodowania. Koduj surowy tekst raz, w miejscu użycia, i pomiń ręczne kodowanie, jeśli szablon robi to automatycznie.

Aby wpisać tekst do zwykłego elementu DOM, przypisz oryginalny ciąg do textContent. Nie przekazuj go w tym celu do innerHTML, które parsuje kod HTML. Nie używaj tej funkcji do atrybutów, adresów URL, JavaScriptu ani CSS; te konteksty mają inne reguły. Jeśli chcesz zachować część znaczników z niezaufanego HTML, potrzebujesz sanityzacji, a nie escapowania tekstu.

Przykłady

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

Wynik

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

Konsola wypisuje źródło HTML, a nie wyrenderowany tekst. Po sparsowaniu powstaje akapit bez elementu `em`, a końcowe `&lt;` pozostaje dosłownym tekstem.

Powiązane lekcje

  • JavaScript · Lekcja 28 · Zaawansowany · Wersja: 4

Źródła