scripting.RegisteredContentScript

型別

此型別的值是物件。它們包含以下屬性：

allFrames 可選

boolean。如果指定為 true，則指令碼將注入到所有 frame 中，即使該 frame 不是標籤頁中的最頂層 frame。每個 frame 都將獨立檢查 URL 要求；如果 URL 要求不滿足，則不會注入到子 frame 中。預設為 false，表示只匹配頂層 frame。

css 可選

array of string。要注入到匹配頁面的 CSS 檔案列表。這些檔案將按照在此陣列中出現的順序注入。

cssOrigin 可選

string。注入的樣式來源，可以是 "user"，將 CSS 新增為使用者樣式表，或 "author"，將其新增為作者樣式表。預設為 "author"。在 Firefox 和 Safari 中，此屬性不區分大小寫。

excludeMatches 可選

array of string。內容指令碼被排除在外的頁面列表，但否則會被注入其中。

id

string。內容指令碼的 ID，在 API 呼叫中指定。

js 可選

array of string。擴充套件包中 JavaScript 檔案的路徑陣列，用於注入到匹配頁面。指令碼將按照在此陣列中出現的順序注入。

matches 可選

array of string。內容指令碼注入到的頁面陣列。必須為 scripting.registerContentScripts() 指定。

matchOriginAsFallback 可選

boolean。當 about:、data: 和 blob: 頁面的源與 matches 中的模式匹配時，是否將程式碼注入這些頁面，即使文件源是匿名的（由於使用了 CSP 或 iframe sandbox）。matches 中的匹配模式必須指定一個萬用字元路徑 glob。預設為 false。

persistAcrossSessions 可選

boolean。指定此內容指令碼是否跨瀏覽器重啟和更新以及擴充套件重啟持久化。預設為 true。

注意： 當擴充套件更新時，內容指令碼會被清除。要恢復指令碼，請在擴充套件的 runtime.onInstalled 事件處理程式中新增程式碼，以響應 "update" 原因。

runAt 可選

extensionTypes.RunAt。指定 JavaScript 檔案何時注入到網頁中。預設值為 document_idle。在 Firefox 中，runAt 也會影響 CSS 的插入點。在 Chrome 中，runAt 不影響 CSS 的插入點。

world 可選

scripting.ExecutionWorld。指令碼執行的環境。預設值為 ISOLATED。

瀏覽器相容性