Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Element.innerHTML e limiti di sicurezza nell’inserimento di testo

Distingui tra analisi del markup e inserimento di testo letterale. Scopri come prevenire XSS nel DOM e cosa cambia quando Trusted Types è obbligatorio.

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

Sintassi

const markup = element.innerHTML;
element.innerHTML = htmlStringOrTrustedHTML;
const text = element.textContent;
element.textContent = plainText;
element.append(plainText);
element.insertAdjacentText("beforeend", plainText);
element.setHTML(htmlToSanitize); // Where supported.

La lettura di Element.innerHTML restituisce il contenuto serializzato dell’elemento, senza il suo tag esterno. In un documento HTML, l’assegnazione analizza un frammento nel contesto dell’elemento e di norma ne sostituisce i nodi figli. Per un elemento HTML <template>, la lettura serializza il contenuto di template.content e l’assegnazione sostituisce i nodi figli di quel DocumentFragment, non quelli dell’elemento stesso. Anche element.innerHTML += fragment sostituisce i nodi anziché aggiungerne in coda: legge il contenuto serializzato e analizza di nuovo la stringa concatenata.

Su un elemento, la lettura di Node.textContent restituisce il testo complessivo dei discendenti, non il loro markup. Una stringa non vuota sostituisce i figli con un solo nodo di testo; una stringa vuota li rimuove. Per conservare i figli esistenti, aggiungi una stringa in coda con append(text) o inseriscila in una posizione scelta rispetto all’elemento con insertAdjacentText(position, text). Nessuna di queste operazioni testuali interpreta il markup o i riferimenti a caratteri presenti nella stringa.

Non passare stringhe non attendibili a innerHTML: è un punto di iniezione HTML che può causare XSS nel DOM. Gli elementi script inseriti in questo modo non vengono eseguiti, ma altri meccanismi, come gli attributi dei gestori di eventi, possono ancora eseguire codice. Mostra il testo non attendibile in un elemento comune come div. L’inserimento come testo non rende gli stessi dati sicuri in un contesto di script, di stile o di URL, né se poi vengono interpretati come HTML.

Se ti serve HTML formattato da una fonte non attendibile, usa setHTML() dove è supportato oppure usa un sanitizzatore HTML collaudato prima dell’inserimento. Non ripiegare mai su un’assegnazione a innerHTML senza sanitizzazione. Se la CSP impone Trusted Types e non c’è una policy predefinita, assegnare una normale stringa a innerHTML genera TypeError. TrustedHTML non garantisce la sanitizzazione: la sicurezza dipende dalla policy che lo ha creato. Sono API della piattaforma web, non funzionalità di ECMAScript: verifica il supporto delle protezioni che usi.

Esempi

<!doctype html>
<meta charset="utf-8">
<title>innerHTML and textContent</title>
<script>
{
  const sample = "<em>A &amp; B</em>";
  const parsed = document.createElement("div");
  const literal = document.createElement("div");

  parsed.innerHTML = sample;
  literal.textContent = sample;

  console.log(`innerHTML: ${parsed.childElementCount} | ${parsed.textContent}`);
  console.log(`textContent: ${literal.childElementCount} | ${literal.textContent}`);
}
</script>

Risultato

innerHTML: 1 | A & B
textContent: 0 | <em>A &amp; B</em>

Salva l’esempio come file HTML, aprilo in un browser senza imposizione di Trusted Types e controlla la console del browser. La stringa fissa è innocua: l’analisi crea un elemento `em` e decodifica il riferimento al carattere in `&`. L’inserimento come testo conserva l’intera stringa e non crea elementi figli.

Lezioni correlate

  • JavaScript · Lezione 15 · Avanzato · Versione: 4

Fonti