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('&', '&').replaceAll('<', '<').replaceAll('>', '>');
// 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 < na znak < w tekście, ale nie interpretuje tego znaku ponownie jako początku znacznika.
Przy kolejnych wywołaniach replaceAll zamień najpierw & na &, a potem < na <. Dzięki temu pierwsza zamiana nie obejmie znaków & dodanych przez późniejsze zamiany. Przykład zamienia też > na >, 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('&', '&')
.replaceAll('<', '<')
.replaceAll('>', '>');
}
const text = 'A & B <em>demo</em> <';
console.log(`<p>${escapeHtmlText(text)}</p>`);Wynik
<p>A & B <em>demo</em> &lt;</p>
Konsola wypisuje źródło HTML, a nie wyrenderowany tekst. Po sparsowaniu powstaje akapit bez elementu `em`, a końcowe `<` pozostaje dosłownym tekstem.
Powiązane lekcje
- JavaScript · Lekcja 28 · Zaawansowany · Wersja: 4