Document: securitypolicyviolation event

فهرست فصل‌ها دانلود آرشیوناشر

MDN Web Docs · نسخهٔ df622a2a1c1e · CC BY-SA 2.5 و مجوز جداگانهٔ ناشر برای نمونه‌کد

{{APIRef("Reporting API")}}

The **securitypolicyviolation** event is fired when a Content Security Policy is violated.

The event is fired on the document when there is a violation of the document CSP policy (and may also bubble from elements in the document).

This event bubbles to the {{domxref("Window")}} object, and is composed.

توجه: You should generally add the handler for this event to a top-level object (i.e., {{domxref("Window")}} or {{domxref("Document")}}). While HTML elements can technically be the target of the securitypolicyviolation event, in reality this event does not fire on them—for example, a blocked <img> source directly triggers this event on document as the target, instead of bubbling from the <img> element.

Syntax

Use the event name in {{domxref("EventTarget/addEventListener", "addEventListener()")}}:

js-nolint
addEventListener("securitypolicyviolation", (event) => { })

Alternatively, assign to the event handler property of the interface:

js-nolint
onsecuritypolicyviolation = (event) => { }

Event type

A {{domxref("SecurityPolicyViolationEvent")}}. Inherits from {{domxref("Event")}}.

{{InheritanceDiagram("SecurityPolicyViolationEvent")}}

Examples

The code below shows how you might add an event handler function using the onsecuritypolicyviolation event handler property (but note that this replaces other event listeners added using onsecuritypolicyviolation, if any) or addEventListener() on the Document.

js
document.onsecuritypolicyviolation = (e) => {
  // Handle SecurityPolicyViolationEvent e here
};

document.addEventListener("securitypolicyviolation", (e) => {
  // Handle SecurityPolicyViolationEvent e here
});

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

  • The {{domxref("Element/securitypolicyviolation_event", "securitypolicyviolation")}} event of the {{domxref("Element")}} interface
  • The {{domxref("WorkerGlobalScope/securitypolicyviolation_event", "securitypolicyviolation")}} event of the {{domxref("WorkerGlobalScope")}} interface
  • HTTP > Content Security Policy