Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Element.innerHTML — leggere e sostituire il contenuto HTML

Element.innerHTML legge il contenuto di un elemento come markup HTML oppure lo sostituisce con nodi creati dal markup fornito. Non bonifica i dati non attendibili e può causare XSS.

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

const markup = element.innerHTML;
element.innerHTML = markup;

Element.innerHTML è una proprietà della Web API, non fa parte di ECMAScript in sé. La lettura serializza il contenuto dell’elemento senza il suo tag esterno e senza gli alberi shadow DOM. Il risultato non deve necessariamente corrispondere esattamente al testo sorgente originale.

L’assegnazione analizza il markup nel contesto dell’elemento e ne sostituisce il contenuto precedente; non sostituisce l’elemento stesso. Per template, modifica il contenuto del modello. In un documento XML, un XML non valido causa un SyntaxError.

Sicurezza: per impostazione predefinita, l’assegnazione non rimuove elementi o attributi pericolosi. Il fatto che gli elementi script inseriti non vengano eseguiti non impedisce XSS, ad esempio tramite attributi di gestione degli eventi. Non passare direttamente HTML non attendibile. Quando Trusted Types è applicato, l’assegnazione di una normale stringa può essere rifiutata.

L’esempio usa solo markup fisso e attendibile. La seconda assegnazione sostituisce il primo contenuto, lasciando un solo figlio. Eseguilo in un browser; la presenza di Node 24 in un repository non dimostra che questa API sia disponibile.

Esempi

const box = document.createElement('div');
box.innerHTML = '<strong>Hello</strong>';
console.log(box.innerHTML);
box.innerHTML = '<em>Bye</em>';
console.log(box.innerHTML);
console.log(box.children.length);

Risultato

<strong>Hello</strong>
<em>Bye</em>
1

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