Dokument: securitypolicyviolation-Ereignis
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit März 2022 browserübergreifend verfügbar.
Das securitypolicyviolation-Ereignis wird ausgelöst, wenn eine Content Security Policy verletzt wird.
Das Ereignis wird auf dem Dokument ausgelöst, wenn dessen CSP-Richtlinie verletzt wird. Es kann auch von Elementen im Dokument nach oben weitergegeben werden.
Dieses Ereignis wird per Bubbling an das Window-Objekt weitergegeben und ist composed.
Hinweis:
Sie sollten den Handler für dieses Ereignis in der Regel einem übergeordneten Objekt hinzufügen (d.h. Window oder Document).
Obwohl HTML-Elemente technisch gesehen das Ziel des securitypolicyviolation-Ereignisses sein können, wird es in der Praxis nicht auf ihnen ausgelöst. Beispielsweise löst eine blockierte <img>-Quelle das Ereignis direkt auf document als Ziel aus, statt es vom <img>-Element aus nach oben weiterzugeben.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("securitypolicyviolation", (event) => { })
Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:
onsecuritypolicyviolation = (event) => { }
Ereignistyp
Ein SecurityPolicyViolationEvent. Erbt von Event.
Beispiele
Der folgende Code zeigt, wie Sie eine Event-Handler-Funktion über die Event-Handler-Eigenschaft onsecuritypolicyviolation oder mit addEventListener() auf dem Document hinzufügen können. Beachten Sie, dass die Zuweisung an onsecuritypolicyviolation gegebenenfalls andere über diese Eigenschaft hinzugefügte Event-Listener ersetzt.
document.onsecuritypolicyviolation = (e) => {
// Handle SecurityPolicyViolationEvent e here
};
document.addEventListener("securitypolicyviolation", (e) => {
// Handle SecurityPolicyViolationEvent e here
});
Spezifikationen
| Spezifikation |
|---|
| HTML # handler-onsecuritypolicyviolation |
Browser-Kompatibilität
Siehe auch
- Das Ereignis
securitypolicyviolationder SchnittstelleElement - Das Ereignis
securitypolicyviolationder SchnittstelleWorkerGlobalScope - HTTP > Content Security Policy