CKTIS / JavaScript
Element.innerHTML e limites de segurança na inserção de texto
Distingue entre interpretar marcação e inserir texto literal. Aprende a prevenir XSS no DOM e percebe o que muda quando se exige Trusted Types.
Versão: ECMAScript 2024 and the current web platform; runtime support varies
Sintaxe
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.Ler Element.innerHTML devolve o conteúdo serializado do elemento, sem a sua etiqueta exterior. Num documento HTML, atribuir-lhe um valor analisa um fragmento no contexto do elemento e, normalmente, substitui os seus nós filhos. Num elemento HTML <template>, a leitura serializa o conteúdo de template.content e a atribuição substitui os nós filhos desse DocumentFragment, não os do próprio elemento. element.innerHTML += fragment também substitui os nós, em vez de acrescentar novos nós no fim: lê o conteúdo serializado e volta a analisar a cadeia concatenada.
Num elemento, ler Node.textContent devolve o texto combinado dos descendentes, não a sua marcação. Atribuir uma cadeia não vazia substitui os filhos por um único nó de texto; atribuir uma cadeia vazia remove-os. Para manter os filhos existentes, acrescenta uma cadeia no fim com append(text) ou insere-a numa posição à escolha em relação ao elemento com insertAdjacentText(position, text). Nenhuma destas operações de texto interpreta a marcação ou as referências a caracteres na cadeia.
Não passes cadeias não fiáveis a innerHTML: é um ponto de injeção de HTML que pode levar a XSS no DOM. Os elementos script inseridos assim não são executados, mas outros mecanismos, como atributos de tratamento de eventos, podem executar código. Apresenta texto não fiável num elemento normal como div. A inserção como texto não torna os mesmos dados seguros num contexto de script, de estilo ou de URL, nem se forem mais tarde interpretados como HTML.
Se precisares de HTML formatado de uma fonte não fiável, usa setHTML() onde estiver disponível ou higieniza o HTML antes da inserção com uma ferramenta comprovada. Nunca recorras a uma atribuição não filtrada a innerHTML. Se a CSP exigir Trusted Types e não existir uma política predefinida, atribuir uma cadeia normal a innerHTML lança TypeError. TrustedHTML não garante a higienização: a segurança depende da política que o criou. Estas são APIs da plataforma Web, não funcionalidades do ECMAScript; confirma o suporte das proteções que usas.
Exemplos
<!doctype html>
<meta charset="utf-8">
<title>innerHTML and textContent</title>
<script>
{
const sample = "<em>A & 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>Resultado
innerHTML: 1 | A & B textContent: 0 | <em>A & B</em>
Guarda o exemplo como ficheiro HTML, abre-o num navegador sem obrigatoriedade de Trusted Types e consulta a consola do navegador. A cadeia fixa é inofensiva: a análise cria um elemento `em` e descodifica a referência ao carácter para `&`. A inserção como texto conserva toda a cadeia e não cria elementos filhos.
Lições relacionadas
- JavaScript · Lição 15 · Avançado · Versão: 4