chrome.extension

說明

chrome.extension API 提供的公用程式可供任何擴充功能頁面使用。包括支援在擴充功能和內容指令碼之間，或是在擴充功能之間交換訊息，詳情請參閱「訊息傳遞」。

類型

ViewType

Chrome 44 以上版本

擴充功能檢視畫面類型。

列舉

「tab」

「popup」

屬性

inIncognitoContext

如果內容指令碼在無痕分頁中執行，或擴充功能網頁在無痕程序中執行，則為 True。後者僅適用於具有「split」incognito_behavior 的擴充功能。

類型

布林值

方法

getBackgroundPage()

僅限前景 
chrome.extension.getBackgroundPage(): Window | undefined

傳回在目前擴充功能中執行的背景網頁 JavaScript「window」物件。如果擴充功能沒有背景網頁，則傳回空值。

傳回

  • Window | undefined

getViews()

僅限前景 
chrome.extension.getViews(
  fetchProperties?: object,
): Window[]

傳回 JavaScript「window」物件的陣列，適用於目前擴充功能中執行的每個網頁。

參數

  • fetchProperties

    object 選填

    • tabId

      號碼 選填

      Chrome 54 以上版本

      根據分頁 ID 尋找檢視畫面。如果省略這個欄位，系統會傳回所有檢視區塊。

    • 類型

      ViewType 選填

      要取得的檢視畫面類型。如果省略，則會傳回所有檢視區塊 (包括背景網頁和分頁)。

    • windowId

      號碼 選填

      要限制搜尋範圍的視窗。如果省略，則會傳回所有檢視區塊。

傳回

  • Window[]

    全域物件陣列

isAllowedFileSchemeAccess()

chrome.extension.isAllowedFileSchemeAccess(): Promise<boolean>

擷取擴充功能對「file://」配置的存取狀態。這項設定對應於使用者可透過 chrome://extensions 頁面存取的擴充功能層級「允許存取檔案網址」設定。

傳回

  • Promise<boolean>

    Chrome 99 以上版本

isAllowedIncognitoAccess()

chrome.extension.isAllowedIncognitoAccess(): Promise<boolean>

擷取擴充功能在無痕模式中的存取權狀態。這項設定對應於使用者可透過 chrome://extensions 頁面存取的擴充功能「允許在無痕模式中執行」設定。

傳回

  • Promise<boolean>

    Chrome 99 以上版本

setUpdateUrlData()

chrome.extension.setUpdateUrlData(
  data: string,
): void

設定擴充功能更新網址中使用的 ap CGI 參數值。如果擴充功能是由 Chrome 擴充功能庫代管，系統會忽略這個值。

參數

  • 資料

    字串

事件