CKTIS / HTML
onsecuritypolicyviolation — CSP-schendingsevenementen afhandelen
Het kenmerk onsecuritypolicyviolation geeft JavaScript op dat het securitypolicyviolation-event afhandelt, dat verband houdt met een schending van het Content Security Policy (CSP). Het stelt zelf geen beveiligingsbeleid in, en CSP kan de inline-code blokkeren.
Versie: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onsecuritypolicyviolation="JavaScript statements"onsecuritypolicyviolation is een event-handler-contentattribuut voor securitypolicyviolation, een event dat verband houdt met een schending van het Content Security Policy (CSP). Je kunt het op elk HTML-element schrijven, maar door het attribuut toe te voegen ontvangt het element niet gegarandeerd zo’n event. Het attribuut definieert of handhaaft geen CSP.
De attribuutwaarde bevat JavaScript-instructies: de functie-inhoud, niet een functiedeclaratie. In de handler is event het ontvangen event en this het element dat het afhandelt. Maak onderscheid tussen de attribuutnaam onsecuritypolicyviolation en de eventnaam securitypolicyviolation, die geen voorvoegsel on heeft.
De bijbehorende JavaScript-eigenschap, bijvoorbeeld element.onsecuritypolicyviolation, accepteert een functie of null, geen codetekst. CSP kan inline event-handlerattributen blokkeren; ook code die schendingen moet observeren valt onder die beperkingen. Verzwak het beleid niet alleen om dit attribuut uit te voeren.
Het voorbeeld verzendt een synthetisch Event zonder een echte CSP-schending te veroorzaken. Het controleert alleen de koppeling tussen het attribuut en de eventnaam en toont securitypolicyviolation. Dit object bevat niet de details van een echte schending.
Voorbeelden
<!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>Resultaat
securitypolicyviolation
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.