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 sanitizerUma 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 = { "&": "&", "<": "<", ">": ">" };
return value.replace(/[&<>]/g, character => entities[character]);
}
const input = '<b>Hello</b> & "friends"';
const actual = escapeHtmlText(input);
const expected = '<b>Hello</b> & "friends"';
if (actual !== expected) {
throw new Error("Unexpected escaping result");
}
console.log(actual);Resultado
<b>Hello</b> & "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.