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