SecurityPolicyViolationEvent

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since October 2018.

* Some parts of this feature may have varying levels of support.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Das SecurityPolicyViolationEvent Interface erbt von Event und repräsentiert das Ereignisobjekt eines securitypolicyviolation-Ereignisses, das auf einem Element, einem Document oder einem worker gesendet wird, wenn seine Content Security Policy (CSP) verletzt wird.

Event SecurityPolicyViolationEvent

Konstruktor

SecurityPolicyViolationEvent()

Erstellt eine neue Instanz des SecurityPolicyViolationEvent-Objekts.

Instanzeigenschaften

SecurityPolicyViolationEvent.blockedURI Schreibgeschützt

Ein String, der die URI der Ressource darstellt, die blockiert wurde, weil sie eine Richtlinie verletzt.

SecurityPolicyViolationEvent.columnNumber Schreibgeschützt

Die Spaltennummer im Dokument oder im Worker, an der die Verletzung aufgetreten ist.

SecurityPolicyViolationEvent.disposition Schreibgeschützt

Ein String, der anzeigt, ob der Benutzeragent so konfiguriert ist, dass er die Richtlinienverletzung durchsetzt oder nur meldet.

SecurityPolicyViolationEvent.documentURI Schreibgeschützt

Ein String, der die URI des Dokuments oder Workers darstellt, in dem die Verletzung aufgetreten ist.

SecurityPolicyViolationEvent.effectiveDirective Schreibgeschützt

Ein String, der die Richtlinie darstellt, die verletzt wurde.

SecurityPolicyViolationEvent.lineNumber Schreibgeschützt

Die Zeilennummer im Dokument oder im Worker, an der die Verletzung aufgetreten ist.

SecurityPolicyViolationEvent.originalPolicy Schreibgeschützt

Ein String, der die Richtlinie enthält, deren Durchsetzung die Verletzung verursacht hat.

SecurityPolicyViolationEvent.referrer Schreibgeschützt

Ein String, der die URL des Referrers der Ressourcen darstellt, deren Richtlinie verletzt wurde, oder null.

SecurityPolicyViolationEvent.sample Schreibgeschützt

Ein String, der ein Beispiel der Ressource darstellt, die die Verletzung verursacht hat, normalerweise die ersten 40 Zeichen. Dies wird nur ausgefüllt, wenn es sich bei der Ressource um ein eingebettetes Skript, einen Ereignishandler oder ein Stil handelt – externe Ressourcen, die eine Verletzung verursachen, generieren kein Beispiel.

SecurityPolicyViolationEvent.sourceFile Schreibgeschützt

Wenn die Verletzung als Ergebnis eines Skripts aufgetreten ist, wird dies die URL des Skripts sein; andernfalls wird es null sein. Sowohl columnNumber als auch lineNumber sollten Nicht-Null-Werte haben, wenn diese Eigenschaft nicht null ist.

SecurityPolicyViolationEvent.statusCode Schreibgeschützt

Eine Zahl, die den HTTP-Statuscode des Dokuments oder Workers darstellt, in dem die Verletzung aufgetreten ist.

SecurityPolicyViolationEvent.violatedDirective Schreibgeschützt

Ein String, der die Richtlinie darstellt, die verletzt wurde. Dies ist ein historisches Alias von effectiveDirective.

Beispiele

js
document.addEventListener("securitypolicyviolation", (e) => {
  console.log(e.blockedURI);
  console.log(e.violatedDirective);
  console.log(e.originalPolicy);
});

Spezifikationen

Specification
Content Security Policy Level 3
# report-violation

Browser-Kompatibilität

Siehe auch