Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes