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

CKTIS / JavaScript

Fronteiras de segurança: escape de texto HTML e sanitização

Uma fronteira de segurança separa dados não fiáveis de operações que lhes atribuem significado ou autoridade. Aprende a diferença entre escape de texto HTML e sanitização por lista de permissões, e conhece os limites de um pequeno exemplo de escape em JavaScript.

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

escapeHtmlText(value); // HTML text context only; not an HTML sanitizer

Uma fronteira de segurança (security boundaries) é um ponto onde dados com menor nível de confiança chegam a uma operação que os pode interpretar como código ou marcação. Uma entrada não se torna fiável apenas por ser uma cadeia JavaScript. O ECMAScript define a linguagem, enquanto a análise de HTML e as proteções do navegador pertencem ao ambiente anfitrião; a especificação fornecida não é uma norma de sanitização HTML.

Escape de texto HTML e sanitização por lista de permissões: o escape substitui caracteres especiais por referências a caracteres, para que o conteúdo seja tratado como texto e não como marcação. A sanitização tem outro objetivo: permite alguma marcação selecionada e remove ou rejeita elementos, atributos e valores de URL não permitidos e inseguros. Não substituas um sanitizador por uma expressão regular simples que remova etiquetas.

A função escapeHtmlText recebe uma cadeia e aplica escape a &, < e > numa única passagem. O seu âmbito limita-se a um contexto normal de texto HTML; não abrange atributos, URL, JavaScript, CSS nem o conteúdo dos elementos script e style. As aspas permanecem intencionalmente inalteradas. O resultado não é «HTML seguro» para utilização arbitrária; voltar a aplicar escape a um resultado já escapado altera-o novamente.

O exemplo verifica apenas uma transformação determinística de uma cadeia e não requer APIs do navegador. Não demonstra a apresentação no navegador nem verifica um sanitizador. Uma aplicação que tenha de preservar a formatação HTML precisa de uma política de sanitização escolhida e verificada separadamente. Executar código em Node.js não comprova a disponibilidade nem a segurança de uma API do navegador.

Exemplos

function escapeHtmlText(value) {
  const entities = { "&": "&amp;", "<": "&lt;", ">": "&gt;" };
  return value.replace(/[&<>]/g, character => entities[character]);
}

const input = '<b>Hello</b> & "friends"';
const actual = escapeHtmlText(input);
const expected = '&lt;b&gt;Hello&lt;/b&gt; &amp; "friends"';
if (actual !== expected) {
  throw new Error("Unexpected escaping result");
}
console.log(actual);

Resultado

&lt;b&gt;Hello&lt;/b&gt; &amp; "friends"

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