Chrome 扩展支持

Electron 支持 Chrome 扩展API的子集, 主要是支持 DevTools 扩展和 Chromium-internal 扩展,但它同时也支持一些其他扩展能。

注意:Electron 不支持商店中的任意 Chrome 扩展,Electron 项目的目标不是与 Chrome 的扩展实现完全兼容。

加载扩展

Electron 只支持加载未打包的扩展 (即不能使用 .crx 文件)。 插件会被安装到每一个会话。 要加载扩展,请调用 ses.loadextension

  1. const { session } = require('electron')
  2. session.defaultSession.loadExtension('path/to/unpacked/extension').then(({ id }) => {
  3. // ...
  4. })

加载的扩展将不会被自动记住;如果在应用程序运行时未调用 loadExtension,则不会加载扩展。

注意,仅能在持久 session 中加载扩展。 尝试将扩展加载到内存 session 中会出现错误。

有关加载、卸载和查询活动扩展的更多信息,请查阅 session 文档。

支持的扩展 API

我们支持以下扩展 API,并需要注意一些警告。 其他API可能会得到额外支持,但对此处未列出的任何API的支持都是临时的,可能会被删除。

chrome.devtools.inspectedWindow

支持这些 API 的所有功能。

chrome.devtools.network

支持这些 API 的所有功能。

chrome.devtools.panels

支持这些 API 的所有功能。

chrome.extension

支持 chrome.extension 的以下属性:

  • chrome.extension.lastError

支持 chrome.extension 的以下方法:

  • chrome.extension.getURL
  • chrome.extension.getBackgroundPage

chrome.runtime

支持 chrome.runtime 的以下属性:

  • chrome.runtime.lastError
  • chrome.runtime.id

支持 chrome.runtime 的以下方法:

  • chrome.runtime.getBackgroundPage
  • chrome.runtime.getManifest
  • chrome.runtime.getPlatformInfo
  • chrome.runtime.getURL
  • chrome.runtime.connect
  • chrome.runtime.sendMessage
  • chrome.runtime.reload

支持 chrome.runtime 的以下事件:

  • chrome.runtime.onStartup
  • chrome.runtime.onInstalled
  • chrome.runtime.onSuspend
  • chrome.runtime.onSuspendCanceled
  • chrome.runtime.onConnect
  • chrome.runtime.onMessage

chrome.storage

仅支持 chrome.storage.localchrome.storage.syncchrome.storage.manage.manage 不支持。

chrome.tabs

支持 chrome.tab 的以下方法:

  • chrome.tabs.sendMessage
  • chrome.tabs.reload
  • chrome.tabs.executeScript
  • chrome.tabs.update (部分支持)
    • 支持的属性:urlmuted

注意: 在 Chrome 中,通过 -1 作为标签ID表示“当前活动的标签”。 因为 Electron 没有这样的概念,通过 -1 作为选项卡ID不支持而且会报错。

chrome.management

支持 chrome.management 的以下方法:

  • chrome.management.getAll
  • chrome.management.get
  • chrome.management.getSelf
  • chrome.management.getPermissionWarningsById
  • chrome.management.getPermissionWarningsByManifest
  • chrome.management.onEnabled
  • chrome.management.onDisabled

chrome.webRequest

支持这些 API 的所有功能。

注意: 如果有冲突需要处理,Electron 的 webRequest 模块将优先于 chrome.web