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.