文件:securitypolicyviolation 事件

Baseline 已廣泛支援

此特性已經十分成熟,可在許多裝置和瀏覽器版本上使用。自 2022 年 3 月起,它已在各瀏覽器中可用。

內容安全策略 (Content Security Policy) 被違反時,會觸發 securitypolicyviolation 事件。

當文件的 CSP 策略被違反時,該事件會在文件上觸發(也可能從文件中的元素冒泡上來)。

該事件會 冒泡Window 物件,並且是 composed 的。

注意: 通常你應該將此事件的處理程式新增到頂層物件(即 WindowDocument)。雖然 HTML 元素在技術上可以成為 securitypolicyviolation 事件的目標,但實際上該事件不會在它們上面觸發——例如,一個被阻止的 <img> 源會直接在 document 上觸發此事件作為目標,而不是從 <img> 元素冒泡上來。

語法

在諸如 addEventListener() 之類的方法中使用事件名稱,或設定事件處理程式屬性。

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

onsecuritypolicyviolation = (event) => { }

事件型別

一個 SecurityPolicyViolationEvent。繼承自 Event

Event SecurityPolicyViolationEvent

示例

下面的程式碼展示瞭如何使用 Document 上的 onsecuritypolicyviolation 事件處理屬性或 addEventListener() 來新增事件處理函式。

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

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

規範

規範
HTML
# handler-onsecuritypolicyviolation

瀏覽器相容性

另見