CKTIS / HTML
onsecuritypolicyviolation — gestionar eventos de infracción de CSP
El atributo onsecuritypolicyviolation especifica el código JavaScript que gestiona el evento securitypolicyviolation asociado a una infracción de la Content Security Policy (CSP). No establece una política de seguridad y CSP puede bloquear su código en línea.
Versión: WHATWG HTML Living Standard; index snapshot date recorded separately
Sintaxis
onsecuritypolicyviolation="JavaScript statements"onsecuritypolicyviolation es un atributo de contenido de controlador de eventos para securitypolicyviolation, un evento asociado a una infracción de la Content Security Policy (CSP). Puede escribirse en cualquier elemento HTML, pero añadir el atributo no garantiza que el elemento reciba ese evento. El atributo no define ni aplica CSP.
El valor del atributo contiene instrucciones JavaScript: el cuerpo de una función, no una declaración de función. Dentro del controlador, event es el evento recibido y this es el elemento que lo gestiona. Hay que distinguir el nombre del atributo onsecuritypolicyviolation del nombre del evento securitypolicyviolation, que no lleva el prefijo on.
La propiedad JavaScript correspondiente, por ejemplo, element.onsecuritypolicyviolation, acepta una función o null, no texto de código. CSP puede bloquear los atributos de controladores de eventos en línea; el código destinado a observar infracciones también está sujeto a esas restricciones. No debilites la política solo para ejecutar este atributo.
El ejemplo envía un Event sintético sin provocar una infracción real de CSP. Solo comprueba la conexión entre el atributo y el nombre del evento, y muestra securitypolicyviolation. Este objeto no contiene los detalles de una infracción real.
Ejemplos
<!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
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.