CKTIS / JavaScript
Escape del testo in HTML
Quando generi HTML, applica l’escape al testo semplice in base alla posizione in cui lo inserisci. Se invece scrivi direttamente in un normale elemento DOM, assegna la stringa originale a `textContent`.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
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;L’escape nel contesto testuale di HTML è una codifica in uscita per il testo semplice inserito nel sorgente HTML, per esempio nel contenuto di un elemento p. Un < non codificato può aprire un tag, mentre & può iniziare un riferimento a carattere. Il parser converte < in un < letterale nel testo, senza interpretare il carattere decodificato come l’inizio di un tag.
Quando concateni chiamate a replaceAll, sostituisci & con & prima di sostituire < con <, per non codificare i caratteri & introdotti dalle sostituzioni successive. L’esempio sostituisce anche > con >, ma qui è facoltativo; nemmeno le virgolette richiedono l’escape in questo contesto. Codifica il testo originale una sola volta al momento dell’inserimento e non farlo manualmente se il template lo fa già.
Per impostare il testo di un normale elemento DOM, assegna la stringa originale a textContent. Non usare innerHTML per questo scopo: interpreta il markup. Non riutilizzare questa funzione per attributi, URL, JavaScript o CSS, che hanno regole diverse. Se devi conservare parte del markup proveniente da HTML non attendibile, usa la sanitizzazione dell’HTML anziché l’escape del testo.
Esempi
function escapeHtmlText(text) {
return text.replaceAll('&', '&')
.replaceAll('<', '<')
.replaceAll('>', '>');
}
const text = 'A & B <em>demo</em> <';
console.log(`<p>${escapeHtmlText(text)}</p>`);Risultato
<p>A & B <em>demo</em> &lt;</p>
La console stampa il sorgente HTML, non il testo visualizzato. Il parser produce un paragrafo senza elementi `em`; il `<` finale rimane testo letterale.
Lezioni correlate
- JavaScript · Lezione 28 · Avanzato · Versione: 4