runtime
此模組提供有關您的擴充套件程式及其執行環境的資訊。
它還提供訊息傳遞 API,使您能夠
- 在擴充套件的不同部分之間進行通訊。有關選擇訊息傳遞選項的建議,請參閱選擇一次性訊息與基於連線的訊息。
- 與其他擴充套件程式通訊。
- 與原生應用程式通訊。
型別
runtime.Port-
表示兩個特定上下文之間連線的一端,可用於交換訊息。
runtime.MessageSender-
包含有關訊息或連線請求傳送者的資訊。
runtime.PlatformOs-
標識瀏覽器的作業系統。
runtime.PlatformArch-
標識瀏覽器的處理器架構。
runtime.PlatformInfo-
包含有關瀏覽器執行平臺的資訊。
runtime.PlatformNaclArch-
原生客戶端架構。在某些平臺上,這可能與
PlatformArch不同。 runtime.RequestUpdateCheckStatusruntime.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。