CKTIS / JavaScript
Confini di sicurezza: escaping del testo HTML e sanitizzazione
Un confine di sicurezza separa i dati non attendibili dalle operazioni che attribuiscono loro significato o autorità. Scopri la differenza tra escaping del testo HTML e sanitizzazione con allowlist, e i limiti di un piccolo esempio JavaScript di escaping.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
escapeHtmlText(value); // HTML text context only; not an HTML sanitizerUn confine di sicurezza (security boundaries) è un punto in cui dati meno attendibili raggiungono un’operazione che può interpretarli come codice o markup. Un input non diventa attendibile solo perché è una stringa JavaScript. ECMAScript definisce il linguaggio, mentre il parsing HTML e le protezioni del browser appartengono all’ambiente host; la specifica fornita non è uno standard di sanitizzazione HTML.
Escaping del testo HTML e sanitizzazione con allowlist: l’escaping sostituisce i caratteri speciali con riferimenti a caratteri, affinché il contenuto venga trattato come testo e non come markup. La sanitizzazione ha uno scopo diverso: consente markup selezionato e rimuove o rifiuta elementi, attributi e valori URL non consentiti e non sicuri. Non sostituire un sanitizzatore con una semplice espressione regolare che elimina i tag.
La funzione escapeHtmlText accetta una stringa e fa l’escaping di &, < e > in un solo passaggio. Il suo ambito è esclusivamente un normale contesto di testo HTML, non attributi, URL, JavaScript, CSS o il contenuto di elementi script e style. Le virgolette restano intenzionalmente invariate. Il risultato non è «HTML sicuro» per usi arbitrari; fare di nuovo l’escaping di un risultato già escapato lo modifica ancora.
L’esempio verifica soltanto una trasformazione deterministica di stringa e non richiede API del browser. Non dimostra il rendering né verifica un sanitizzatore. Un’applicazione che deve conservare la formattazione HTML necessita di una politica di sanitizzazione scelta e verificata separatamente. Eseguire il codice in Node.js non dimostra la disponibilità o la sicurezza di un’API del browser.
Esempi
function escapeHtmlText(value) {
const entities = { "&": "&", "<": "<", ">": ">" };
return value.replace(/[&<>]/g, character => entities[character]);
}
const input = '<b>Hello</b> & "friends"';
const actual = escapeHtmlText(input);
const expected = '<b>Hello</b> & "friends"';
if (actual !== expected) {
throw new Error("Unexpected escaping result");
}
console.log(actual);Risultato
<b>Hello</b> & "friends"
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.