Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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 sanitizer

Un 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 = { "&": "&amp;", "<": "&lt;", ">": "&gt;" };
  return value.replace(/[&<>]/g, character => entities[character]);
}

const input = '<b>Hello</b> & "friends"';
const actual = escapeHtmlText(input);
const expected = '&lt;b&gt;Hello&lt;/b&gt; &amp; "friends"';
if (actual !== expected) {
  throw new Error("Unexpected escaping result");
}
console.log(actual);

Risultato

&lt;b&gt;Hello&lt;/b&gt; &amp; "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.

Fonti