Reporting API
The SecurityPolicyViolationEvent interface inherits from Event, and represents the event object of a securitypolicyviolation event sent on an Element/securitypolicyviolation_event, Document/securitypolicyviolation_event, or WorkerGlobalScope/securitypolicyviolation_event when its Content Security Policy (CSP) is violated.
Constructor
- SecurityPolicyViolationEvent.SecurityPolicyViolationEvent
- : Creates a new
SecurityPolicyViolationEventobject instance.
- : Creates a new
Instance properties
- SecurityPolicyViolationEvent.blockedURI
- : A string representing the URI of the resource that was blocked because it violates a policy.
- SecurityPolicyViolationEvent.columnNumber
- : The column number in the document or worker at which the violation occurred.
- SecurityPolicyViolationEvent.disposition
- : A string indicating whether the user agent is configured to enforce or just report the policy violation.
- SecurityPolicyViolationEvent.documentURI
- : A string representing the URI of the document or worker in which the violation occurred.
- SecurityPolicyViolationEvent.effectiveDirective
- : A string representing the directive that was violated.
- SecurityPolicyViolationEvent.lineNumber
- : The line number in the document or worker at which the violation occurred.
- SecurityPolicyViolationEvent.originalPolicy
- : A string containing the policy whose enforcement caused the violation.
- SecurityPolicyViolationEvent.referrer
- : A string representing the URL for the referrer of the resources whose policy was violated, or
null.
- : A string representing the URL for the referrer of the resources whose policy was violated, or
- SecurityPolicyViolationEvent.sample
- : A string representing a sample of the resource that caused the violation, usually the first 40 characters. This will only be populated if the resource is an inline script, event handler, or style — external resources causing a violation will not generate a sample.
- SecurityPolicyViolationEvent.sourceFile
- : If the violation occurred as a result of a script, this will be the URL of the script; otherwise, it will be
null. BothcolumnNumberandlineNumbershould have non-null values if this property is notnull.
- : If the violation occurred as a result of a script, this will be the URL of the script; otherwise, it will be
- SecurityPolicyViolationEvent.statusCode
- : A number representing the HTTP status code of the document or worker in which the violation occurred.
- SecurityPolicyViolationEvent.violatedDirective
- : A string representing the directive that was violated.
This is a historical alias of
effectiveDirective.
- : A string representing the directive that was violated.
This is a historical alias of
Examples
document.addEventListener("securitypolicyviolation", (e) => {
console.log(e.blockedURI);
console.log(e.violatedDirective);
console.log(e.originalPolicy);
});
Specifications
Browser compatibility
See also
- HTTP Content Security Policy (CSP)
- CSPViolationReport
- The Element/securitypolicyviolation_event event of the Element interface
- The Document/securitypolicyviolation_event event of the Document interface
- The WorkerGlobalScope/securitypolicyviolation_event event of the WorkerGlobalScope interface
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
