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。