runtime

此模組提供有關您的擴充套件程式及其執行環境的資訊。

它還提供訊息傳遞 API,使您能夠

型別

runtime.Port

表示兩個特定上下文之間連線的一端,可用於交換訊息。

runtime.MessageSender

包含有關訊息或連線請求傳送者的資訊。

runtime.PlatformOs

標識瀏覽器的作業系統。

runtime.PlatformArch

標識瀏覽器的處理器架構。

runtime.PlatformInfo

包含有關瀏覽器執行平臺的資訊。

runtime.PlatformNaclArch

原生客戶端架構。在某些平臺上,這可能與PlatformArch不同。

runtime.RequestUpdateCheckStatus

呼叫runtime.requestUpdateCheck()的結果。

runtime.OnInstalledReason

分發runtime.onInstalled事件的原因。

runtime.OnPerformanceWarningCategory

分發runtime.onPerformanceWarning事件的警告類別。

runtime.OnPerformanceWarningSeverity

分發runtime.onPerformanceWarning事件的警告嚴重性。

runtime.OnRestartRequiredReason

分發runtime.onRestartRequired事件的原因。

屬性

runtime.lastError

當非同步函數出現需要向其呼叫者報告的錯誤條件時,將設定此值。

runtime.id

擴充套件程式的 ID。

函式

runtime.getBackgroundPage()

檢索當前擴充套件程式中執行的後臺頁面的Window物件。

runtime.openOptionsPage()

開啟擴充套件程式的選項頁面

runtime.getContexts()

獲取與擴充套件程式關聯的上下文的詳細資訊。

runtime.getFrameId()

獲取任何視窗全域性或框架元素的框架 ID。

runtime.getManifest()

獲取完整的manifest.json檔案,序列化為物件。

runtime.getURL()

給定從manifest.json到隨擴充套件程式打包的資源的相對路徑,返回一個完全限定的 URL。

runtime.setUninstallURL()

設定解除安裝擴充套件程式時要訪問的 URL。

runtime.reload()

重新載入擴充套件程式。

runtime.requestUpdateCheck()

檢查此擴充套件程式的更新。

runtime.connect()

從內容指令碼建立與主擴充套件程式程序的連線,或建立一個擴充套件程式與另一個擴充套件程式的連線。

runtime.connectNative()

將擴充套件程式連線到使用者計算機上的原生應用程式。

runtime.sendMessage()

將訊息傳送到您的擴充套件程式或另一個擴充套件程式內的事件偵聽器。類似於runtime.connect,但僅傳送一條訊息,並可選擇響應。

runtime.sendNativeMessage()

將訊息從擴充套件程式傳送到原生應用程式。

runtime.getPlatformInfo()

返回有關當前平臺的資訊。

runtime.getBrowserInfo()

返回有關安裝了此擴充套件程式的瀏覽器資訊。

runtime.getPackageDirectoryEntry()

返回包目錄的 DirectoryEntry。

事件

runtime.onStartup

在安裝了此擴充套件程式的配置檔案首次啟動時觸發。啟動隱身配置檔案時不會觸發此事件。

runtime.onInstalled

在擴充套件程式首次安裝、更新到新版本以及瀏覽器更新到新版本時觸發。

runtime.onSuspend

在擴充套件程式解除安裝前傳送到事件頁面。這給了擴充套件程式進行一些清理的機會。

runtime.onSuspendCanceled

runtime.onSuspend之後傳送,以指示擴充套件程式不會被解除安裝。

runtime.onUpdateAvailable

當有可用更新但由於擴充套件程式當前正在執行而未立即安裝時觸發。

runtime.onBrowserUpdateAvailable 已棄用

當瀏覽器有可用更新但由於需要重啟瀏覽器而未立即安裝時觸發。

runtime.onConnect

當與擴充套件程式程序或內容指令碼建立連線時觸發。

runtime.onConnectExternal

當與另一個擴充套件程式建立連線時觸發。

runtime.onUserScriptConnect

當與擴充套件程式註冊的使用者指令碼建立連線時觸發。

runtime.onMessage

當從擴充套件程式程序或內容指令碼傳送訊息時觸發。

runtime.onMessageExternal

當從另一個擴充套件程式傳送訊息時觸發。不能在內容指令碼中使用。

runtime.onUserScriptMessage

當從擴充套件程式註冊的使用者指令碼傳送訊息時觸發。

runtime.onPerformanceWarning

當檢測到擴充套件程式的執行時效能問題時觸發。

runtime.onRestartRequired

當裝置需要重啟時觸發。

擴充套件程式示例

瀏覽器相容性

注意:此 API 基於 Chromium 的chrome.runtime API。本文件源自 Chromium 程式碼中的runtime.json