contentScripts

使用此 API 註冊 content script。註冊 content script 會指示瀏覽器將指定的 content script 插入到與給定 URL 模式匹配的頁面中。

注意:在使用 Manifest V3 或更高版本時,請使用 scripting.registerContentScripts() 來註冊指令碼。

此 API 與 "content_scripts" manifest.json 鍵非常相似,不同之處在於,使用 "content_scripts" 時,content script 集及其關聯模式在安裝時是固定的。而使用 contentScripts API 時,擴充套件可以在執行時註冊和登出指令碼。

要使用此 API,請呼叫 contentScripts.register(),並傳入一個定義要註冊的指令碼、URL 模式和其他選項的物件。此呼叫會返回一個 Promise,該 Promise 會解析為一個 contentScripts.RegisteredContentScript 物件。

RegisteredContentScript 物件代表在 register() 呼叫中註冊的指令碼。它定義了一個 unregister() 方法,您可以使用它來登出 content script。content script 在建立它們的頁面被銷燬時也會被自動登出。例如,如果它們是從背景頁面註冊的,則在背景頁面被銷燬時會自動登出;如果它們是從側邊欄或彈出視窗註冊的,則在側邊欄或彈出視窗關閉時會自動登出。

沒有 contentScripts API 許可權,但擴充套件必須為其傳遞給 register() 的任何模式擁有相應的 host 許可權

型別

contentScripts.RegisteredContentScript

此型別的物件由 contentScripts.register() 函式返回。它代表該呼叫註冊的 content script,並可用於登出 content script。

函式

contentScripts.register()

註冊給定的 content script。

擴充套件程式示例

瀏覽器相容性