CKTIS / HTML
onsecuritypolicyviolation — CSP-Verletzungsereignisse behandeln
Das Attribut onsecuritypolicyviolation legt JavaScript fest, das das Ereignis securitypolicyviolation im Zusammenhang mit einer Verletzung der Content Security Policy (CSP) behandelt. Es legt selbst keine Sicherheitsrichtlinie fest, und CSP kann seinen Inline-Code blockieren.
Version: WHATWG HTML Living Standard; index snapshot date recorded separately
Syntax
onsecuritypolicyviolation="JavaScript statements"onsecuritypolicyviolation ist ein Event-Handler-Content-Attribut für securitypolicyviolation, ein Ereignis im Zusammenhang mit einer Verletzung der Content Security Policy (CSP). Es kann auf jedem HTML-Element stehen, aber durch das Hinzufügen des Attributs ist nicht garantiert, dass das Element ein solches Ereignis empfängt. Das Attribut definiert oder erzwingt CSP nicht.
Der Attributwert enthält JavaScript-Anweisungen – den Funktionsrumpf und keine Funktionsdeklaration. Im Handler ist event das übermittelte Ereignis und this das Element, das es behandelt. Unterscheide den Attributnamen onsecuritypolicyviolation vom Ereignisnamen securitypolicyviolation, der kein Präfix on hat.
Die entsprechende JavaScript-Eigenschaft, zum Beispiel element.onsecuritypolicyviolation, akzeptiert eine Funktion oder null, keinen Code-Text. CSP kann Inline-Event-Handler-Attribute blockieren; auch Code, der Verstöße beobachten soll, unterliegt diesen Einschränkungen. Schwäche die Richtlinie nicht ab, nur um dieses Attribut auszuführen.
Das Beispiel löst ein synthetisches Event aus, ohne eine echte CSP-Verletzung zu verursachen. Es prüft nur die Verbindung zwischen dem Attribut und dem Ereignisnamen und zeigt securitypolicyviolation an. Dieses Objekt enthält keine Details zu einer echten Verletzung.
Beispiele
<!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>Ergebnis
securitypolicyviolation
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.