說明
chrome.extension API 提供的公用程式可用於任何擴充功能頁面。包括支援擴充功能與其內容指令碼之間,或擴充功能之間的訊息交換,詳情請參閱「訊息傳遞」。
類型
ViewType
擴充功能檢視畫面的類型。
列舉
"tab"
"popup"
屬性
inIncognitoContext
如果內容指令碼在無痕分頁中執行,且擴充功能頁面在無痕程序中執行,則為 True。後者僅適用於 incognito_behavior 為「split」的擴充功能。
類型
布林值
方法
getBackgroundPage()
browser.extension.getBackgroundPage(): Window | undefined
傳回目前擴充功能中執行的背景網頁 JavaScript「window」物件。如果擴充功能沒有背景頁面,則傳回空值。
傳回
-
視窗 | undefined
getViews()
browser.extension.getViews(
fetchProperties?: object,
): Window[]
針對目前擴充功能中執行的每個頁面,傳回 JavaScript「window」物件的陣列。
參數
-
fetchProperties
物件 選填
-
tabId
數字 選填
Chrome 54+ 瀏覽器。*自 Chrome 148 起根據分頁 ID 尋找檢視畫面。如果省略這個欄位,系統會傳回所有檢視表。
-
類型
ViewType 選填
要取得的檢視畫面類型。如果省略,則會傳回所有檢視畫面 (包括背景頁面和分頁)。
-
windowId
數字 選填
要限制搜尋範圍的視窗。如果省略,則會傳回所有檢視畫面。
-
傳回
-
Window[]
全域物件陣列
isAllowedFileSchemeAccess()
browser.extension.isAllowedFileSchemeAccess(): Promise<boolean>
擷取擴充功能存取「file://」配置的狀態。這項設定對應到使用者控制的個別擴充功能「允許存取檔案網址」設定,可透過 chrome://extensions 頁面存取。
傳回
-
Promise<boolean>
Chrome 99 以上版本 瀏覽器 (自 Chrome 148 起)
isAllowedIncognitoAccess()
browser.extension.isAllowedIncognitoAccess(): Promise<boolean>
擷取擴充功能存取無痕模式的狀態。這項設定對應到使用者控制的個別擴充功能「允許在無痕模式中執行」設定,可透過 chrome://extensions 頁面存取。
傳回
-
Promise<boolean>
Chrome 99 以上版本 瀏覽器 (自 Chrome 148 起)
setUpdateUrlData()
browser.extension.setUpdateUrlData(
data: string,
): void
設定擴充功能更新網址中使用的 ap CGI 參數值。如果擴充功能是由 Chrome 擴充功能庫代管,系統會忽略這個值。
參數
-
資料
字串