Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Escape del testo HTML e sanitizzazione strutturale tramite una lista di elementi e attributi consentiti

L’escape mostra l’input come testo letterale. La sanitizzazione strutturale conserva parte della formattazione secondo una lista di elementi e attributi consentiti.

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

Sintassi

element.textContent = input;
element.setHTML(input, { sanitizer: { elements: ["strong"], attributes: [], comments: false, dataAttributes: false } });

Se inserisci un dato non attendibile in una normale posizione di testo nel sorgente HTML, codificalo per quel contesto: per esempio, sostituisci & con &amp; e < con &lt;. Il parser legge questi riferimenti come caratteri di testo, non come sintassi dei tag. Se lavori direttamente con il DOM, assegna il valore originale a textContent di un elemento come div: il contenuto viene sostituito con testo senza analizzare HTML. L’escape del testo HTML non è una protezione generale per attributi, URL, JavaScript o CSS.

Per conservare la formattazione, sanitizza la struttura. setHTML() analizza il frammento nel contesto dell’elemento di destinazione, applica la lista di elementi e attributi consentiti e rimuove i costrutti che comportano rischi di XSS, anche se la configurazione li consente. La politica dell’esempio consente strong, ma nessun attributo. Filtra la struttura analizzata anziché eliminare tag con un’espressione regolare. Se la politica consente i link, stabilisci separatamente quali URL accetta l’applicazione.

textContent e setHTML() sono API della piattaforma web, non funzionalità di ECMAScript 2024. Verifica il supporto di setHTML() nei browser di destinazione. Se non è disponibile, usa testo semplice o un sanitizzatore HTML affidabile; non passare l’input grezzo a innerHTML. Non dare per scontato che il risultato serializzato sia sicuro da analizzare di nuovo in un altro contesto: sanitizzalo quando lo inserisci nell’elemento di destinazione.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTML text escaping and structural sanitization</title>
</head>
<body>
  <pre id="output"></pre>
  <script>
    const input = '<strong title="label">A &amp; B</strong><br>';
    const text = document.createElement('div');
    const rich = document.createElement('div');

    if (typeof rich.setHTML !== 'function') {
      throw new Error('This example requires a browser that supports Element.setHTML().');
    }

    text.textContent = input;
    rich.setHTML(input, {
      sanitizer: {
        elements: ['strong'],
        attributes: [],
        comments: false,
        dataAttributes: false,
      },
    });

    document.getElementById('output').textContent =
      [text.innerHTML, rich.innerHTML].join('\n');
  </script>
</body>
</html>

Risultato

&lt;strong title="label"&gt;A &amp;amp; B&lt;/strong&gt;&lt;br&gt;
<strong>A &amp; B</strong>

La prima riga serializza testo letterale: perfino la notazione `&amp;` dell’input rimane testo. La seconda mostra un vero elemento `strong`, senza attributo `title` né elemento `br`. L’esempio usa `innerHTML` solo in lettura.

Lezioni correlate

  • JavaScript · Lezione 16 · Avanzato · Versione: 4

Fonti