CKTIS / JavaScript
Element.innerHTML — ler e substituir o conteúdo HTML
Element.innerHTML lê o conteúdo de um elemento como marcação HTML ou substitui-o por nós criados a partir da marcação fornecida. Não limpa dados não fiáveis e pode provocar XSS.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
const markup = element.innerHTML;
element.innerHTML = markup;Element.innerHTML é uma propriedade da Web API, não faz parte do próprio ECMAScript. A leitura serializa o conteúdo do elemento sem a etiqueta externa nem as árvores shadow DOM. O resultado não tem necessariamente de corresponder exatamente ao texto de origem original.
A atribuição analisa a marcação no contexto do elemento e substitui o conteúdo anterior; não substitui o próprio elemento. Em template, altera o conteúdo do modelo. Num documento XML, XML mal formado provoca um SyntaxError.
Segurança: por predefinição, a atribuição não remove elementos ou atributos perigosos. O facto de os elementos script inseridos não serem executados não impede XSS, por exemplo através de atributos de tratamento de eventos. Não passes HTML não fiável diretamente. Quando Trusted Types é imposto, a atribuição de uma cadeia de texto normal pode ser rejeitada.
O exemplo usa apenas marcação fixa e fiável. A segunda atribuição substitui o primeiro conteúdo, deixando um único filho. Executa-o num navegador; a presença de Node 24 num repositório não comprova a disponibilidade desta API.
Exemplos
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);Resultado
<strong>Hello</strong> <em>Bye</em> 1
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.