SecurityPolicyViolationEvent
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Oktober 2018 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die SecurityPolicyViolationEvent-Schnittstelle erbt von Event und repräsentiert das Ereignisobjekt eines securitypolicyviolation-Ereignisses, das an ein Element, ein Document oder einen worker gesendet wird, wenn dessen Content Security Policy (CSP) verletzt wird.
Konstruktor
SecurityPolicyViolationEvent()-
Erstellt eine neue Instanz des
SecurityPolicyViolationEvent-Objekts.
Instanz-Eigenschaften
SecurityPolicyViolationEvent.blockedURISchreibgeschützt-
Ein String, der die URI der Ressource darstellt, die blockiert wurde, weil sie gegen eine Richtlinie verstößt.
SecurityPolicyViolationEvent.columnNumberSchreibgeschützt-
Die Spaltennummer im Dokument oder Worker, an der der Verstoß auftrat.
SecurityPolicyViolationEvent.dispositionSchreibgeschützt-
Ein String, der angibt, ob der Benutzeragent so konfiguriert ist, dass er den Richtlinienverstoß durchsetzt oder nur meldet.
SecurityPolicyViolationEvent.documentURISchreibgeschützt-
Ein String, der die URI des Dokuments oder Workers darstellt, in dem der Verstoß auftrat.
SecurityPolicyViolationEvent.effectiveDirectiveSchreibgeschützt-
Ein String, der die Richtlinie darstellt, die verletzt wurde.
SecurityPolicyViolationEvent.lineNumberSchreibgeschützt-
Die Zeilennummer im Dokument oder Worker, an der der Verstoß auftrat.
SecurityPolicyViolationEvent.originalPolicySchreibgeschützt-
Ein String, der die Richtlinie enthält, deren Durchsetzung den Verstoß verursachte.
SecurityPolicyViolationEvent.referrerSchreibgeschützt-
Ein String, der die URL des Referrers der Ressourcen darstellt, deren Richtlinie verletzt wurde, oder
null. SecurityPolicyViolationEvent.sampleSchreibgeschützt-
Ein String, der ein Beispiel der Ressource darstellt, die den Verstoß verursachte, normalerweise die ersten 40 Zeichen. Dies wird nur ausgefüllt, wenn die Ressource ein Inline-Skript, ein Ereignishandler oder ein Stil ist — externe Ressourcen, die einen Verstoß verursachen, generieren kein Beispiel.
SecurityPolicyViolationEvent.sourceFileSchreibgeschützt-
Wenn der Verstoß durch ein Skript verursacht wurde, wird dies die URL des Skripts sein; andernfalls wird es
nullsein. SowohlcolumnNumberals auchlineNumbersollten nicht-null Werte haben, wenn diese Eigenschaft nichtnullist. SecurityPolicyViolationEvent.statusCodeSchreibgeschützt-
Eine Zahl, die den HTTP-Statuscode des Dokuments oder Workers darstellt, in dem der Verstoß auftrat.
SecurityPolicyViolationEvent.violatedDirectiveSchreibgeschützt-
Ein String, der die Richtlinie darstellt, die verletzt wurde. Dies ist ein historisches Alias von
effectiveDirective.
Beispiele
document.addEventListener("securitypolicyviolation", (e) => {
console.log(e.blockedURI);
console.log(e.violatedDirective);
console.log(e.originalPolicy);
});
Spezifikationen
| Spezifikation |
|---|
| Content Security Policy Level 3> # report-violation> |
Browser-Kompatibilität
Siehe auch
- HTTP Content Security Policy (CSP)
CSPViolationReport- Das
securitypolicyviolationEreignis derElementSchnittstelle - Das
securitypolicyviolationEreignis derDocumentSchnittstelle - Das
securitypolicyviolationEreignis derWorkerGlobalScopeSchnittstelle