CKTIS / HTML
onsecuritypolicyviolation — gérer les événements de violation CSP
L’attribut onsecuritypolicyviolation définit le code JavaScript qui gère l’événement securitypolicyviolation associé à une violation de la Content Security Policy (CSP). Il ne définit pas lui-même une politique de sécurité, et la CSP peut bloquer son code intégré.
Version : WHATWG HTML Living Standard; index snapshot date recorded separately
Syntaxe
onsecuritypolicyviolation="JavaScript statements"onsecuritypolicyviolation est un attribut de contenu de gestionnaire d’événement pour securitypolicyviolation, un événement associé à une violation de la Content Security Policy (CSP). Il peut être écrit sur n’importe quel élément HTML, mais l’ajout de l’attribut ne garantit pas que l’élément recevra un tel événement. L’attribut ne définit ni n’applique la CSP.
La valeur de l’attribut contient des instructions JavaScript — le corps d’une fonction, et non une déclaration de fonction. Dans le gestionnaire, event désigne l’événement transmis et this l’élément qui le gère. Il faut distinguer le nom d’attribut onsecuritypolicyviolation du nom d’événement securitypolicyviolation, qui n’a pas de préfixe on.
La propriété JavaScript correspondante, par exemple element.onsecuritypolicyviolation, accepte une fonction ou null, et non du texte de code. La CSP peut bloquer les attributs de gestionnaire d’événement intégrés ; le code destiné à observer les violations est lui aussi soumis à ces restrictions. N’affaiblissez pas la politique dans le seul but d’exécuter cet attribut.
L’exemple déclenche un Event synthétique sans provoquer de véritable violation de la CSP. Il vérifie uniquement le lien entre l’attribut et le nom de l’événement et affiche securitypolicyviolation. Cet objet ne contient pas les détails d’une véritable violation.
Exemples
<!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>Résultat
securitypolicyviolation
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.