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

CKTIS / HTML

onsecuritypolicyviolation — tratar eventos de violação de CSP

O atributo onsecuritypolicyviolation especifica o código JavaScript que trata o evento securitypolicyviolation associado a uma violação da Content Security Policy (CSP). Não estabelece uma política de segurança e a CSP pode bloquear o seu código inline.

Versão: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaxe

onsecuritypolicyviolation="JavaScript statements"

onsecuritypolicyviolation é um atributo de conteúdo de tratamento de eventos para securitypolicyviolation, um evento associado a uma violação da Content Security Policy (CSP). Pode ser escrito em qualquer elemento HTML, mas a adição do atributo não garante que o elemento receba esse evento. O atributo não define nem aplica a CSP.

O valor do atributo contém instruções JavaScript — o corpo de uma função, e não uma declaração de função. No tratamento, event é o evento recebido e this é o elemento que o trata. Distingue o nome do atributo onsecuritypolicyviolation do nome do evento securitypolicyviolation, que não tem o prefixo on.

A propriedade JavaScript correspondente, por exemplo element.onsecuritypolicyviolation, aceita uma função ou null, e não texto de código. A CSP pode bloquear atributos inline de tratamento de eventos; o código destinado a observar violações também está sujeito a essas restrições. Não enfraqueças a política apenas para executar este atributo.

O exemplo envia um Event sintético sem causar uma violação real de CSP. Verifica apenas a ligação entre o atributo e o nome do evento e apresenta securitypolicyviolation. Este objeto não contém os detalhes de uma violação real.

Exemplos

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>Handler test</title>
<div id="target" onsecuritypolicyviolation="this.textContent = event.type;">Waiting</div>
<script>
  const target = document.getElementById('target');
  target.dispatchEvent(new Event('securitypolicyviolation'));
</script>
</html>

Resultado

securitypolicyviolation

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