跳转到主要内容

Chrome 扩展支持

Electron 支持部分 Chrome 扩展 API，主要用于支持 DevTools 扩展和 Chromium 内部扩展，但它也支持一些其他扩展功能。

注意

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

加载扩展​

Electron 只支持加载未打包的扩展（即 .crx 文件无效）。扩展是按session安装的。要加载扩展，请调用 ses.extensions.loadExtension

const { session } = require('electron')

session.defaultSession.loadExtension('path/to/unpacked/extension').then(({ id }) => {
  // ...
})

加载的扩展在退出时不会被自动记住；如果您在应用程序运行时不调用 loadExtension，该扩展将不会被加载。

请注意，仅在持久化会话中支持加载扩展。尝试将扩展加载到内存会话中将引发错误。

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

支持的扩展 API​

我们支持以下扩展 API，但有一些注意事项。其他 API 可能也支持，但此处未列出的任何 API 的支持都是暂时的，可能会被移除。

支持的 Manifest 键​

  • name
  • version
  • author
  • permissions
  • content_scripts
  • default_locale
  • devtools_page
  • short_name
  • host_permissions (Manifest V3)
  • manifest_version
  • background (Manifest V2)
  • minimum_chrome_version

有关每个可能键的更多信息，请参阅 Manifest 文件格式。

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.management​

支持 chrome.management 的以下方法

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

支持 chrome.management 的以下事件

  • chrome.management.onEnabled
  • chrome.management.onDisabled

有关更多信息，请参阅 官方文档。

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.scripting​

此 API 的所有功能均受支持。

有关更多信息，请参阅 官方文档。

chrome.storage​

支持 chrome.storage 的以下方法

  • chrome.storage.local

chrome.storage.sync 和 chrome.storage.managed不支持。

有关更多信息，请参阅 官方文档。

chrome.tabs​

支持 chrome.tabs 的以下方法

  • chrome.tabs.sendMessage
  • chrome.tabs.reload
  • chrome.tabs.executeScript
  • chrome.tabs.query（部分支持）
    • 支持的属性：url、title、audible、active、muted。
  • chrome.tabs.update（部分支持）
    • 支持的属性：url、muted。
注意

在 Chrome 中，将 -1 作为 tab ID 表示“当前活动 tab”。由于 Electron 没有这样的概念，因此将 -1 作为 tab ID 不受支持，并且会引发错误。

有关更多信息，请参阅 官方文档。

chrome.webRequest​

此 API 的所有功能均受支持。

注意

如果存在冲突的处理程序，Electron 的 webRequest 模块将优先于 chrome.webRequest。

有关更多信息，请参阅 官方文档。