Electron 4.0.0

Electron 团队很高兴地宣布 Electron 4 的稳定版本现已发布！您可以从 electronjs.org 或通过 npm npm install electron@latest 安装它。此版本包含升级、修复和新功能，我们迫不及待地想看看您将用它们构建什么。阅读更多内容以了解此版本的详细信息，并请分享您在使用过程中遇到的任何反馈！

---

有什么新功能？

Electron 的大部分功能由 Chromium、Node.js 和 V8 提供，它们是构成 Electron 的核心组件。因此，Electron 团队的一个关键目标是尽可能跟上这些项目的变化，为构建 Electron 应用的开发者提供对新 Web 和 JavaScript 功能的访问。为此，Electron 4 在这些组件的每个组件上都有主要的版本更新；Electron v4.0.0 包含 Chromium 69.0.3497.106、Node 10.11.0 和 V8 6.9.427.24。

此外，Electron 4 还包含对 Electron 特定 API 的更改。您可以在下面找到 Electron 4 主要更改的摘要；有关完整更改列表，请查看 Electron v4.0.0 版本说明。

禁用 remote 模块

出于安全原因，您现在可以禁用 remote 模块。该模块可以为 BrowserWindow 和 webview 标签禁用。

// BrowserWindow
new BrowserWindow({
  webPreferences: {
    enableRemoteModule: false
  }
})

// webview tag
<webview src="http://www.google.com/" enableremotemodule="false"></webview>

有关更多信息，请参阅 BrowserWindow 和 <webview> 标签 文档。

过滤 remote.require() / remote.getGlobal() 请求

如果您不想在渲染器进程或 webview 中完全禁用 remote 模块，但又希望对可以通过 remote.require 加载的模块有额外的控制，那么此功能会很有用。

当在渲染器进程中通过 remote.require 要求一个模块时，将在 app 模块 上引发一个 remote-require 事件。您可以对事件（第一个参数）调用 event.preventDefault() 以防止加载该模块。发生要求的 WebContents 实例 作为第二个参数传递，模块名称作为第三个参数传递。相同的事件也会在 WebContents 实例上发出，但在这种情况下，唯一的参数是事件和模块名称。在两种情况下，您都可以通过设置 event.returnValue 的值来返回自定义值。

// Control `remote.require` from all WebContents:
app.on('remote-require', function (event, webContents, requestedModuleName) {
  // ...
});

// Control `remote.require` from a specific WebContents instance:
browserWin.webContents.on(
  'remote-require',
  function (event, requestedModuleName) {
    // ...
  },
);

类似地，当调用 remote.getGlobal(name) 时，会触发一个 remote-get-global 事件。这与 remote-require 事件的工作方式相同：调用 preventDefault() 来阻止返回全局变量，并设置 event.returnValue 来返回自定义值。

// Control `remote.getGlobal` from all WebContents:
app.on(
  'remote-get-global',
  function (event, webContents, requrestedGlobalName) {
    // ...
  },
);

// Control `remote.getGlobal` from a specific WebContents instance:
browserWin.webContents.on(
  'remote-get-global',
  function (event, requestedGlobalName) {
    // ...
  },
);

有关更多信息，请参阅以下文档：

• remote.require
• remote.getGlobal
• app
• WebContents

JavaScript 访问“关于”面板

在 macOS 上，您现在可以通过调用 app.showAboutPanel() 以编程方式显示“关于”面板，就像单击通过 {role: 'about'} 创建的菜单项一样。有关更多信息，请参阅 showAboutPanel 文档

控制 WebContents 后台节流

WebContents 实例现在有一个 setBackgroundThrottling(allowed) 方法，用于在页面处于后台时启用或禁用计时器和动画的节流。

let win = new BrowserWindow(...)
win.webContents.setBackgroundThrottling(enableBackgroundThrottling)

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

破坏性变更

不再支持 macOS 10.9

Chromium 不再支持 macOS 10.9 (OS X Mavericks)，因此 Electron 4.0 及更高版本也不支持它。

单实例锁定

以前，要使您的应用成为单个实例应用程序（确保在任何给定时间只有一个应用实例正在运行），您可以使用 app.makeSingleInstance() 方法。从 Electron 4.0 开始，您必须改用 app.requestSingleInstanceLock()。此方法的返回值表示此应用程序实例是否成功获取了锁。如果未能获取锁，您可以假定您的应用程序的另一个实例已在运行并立即退出。

有关使用 requestSingleInstanceLock() 的示例以及有关不同平台上细微行为的信息，请参阅 app.requestSingleInstanceLock() 和相关方法的文档 以及 second-instance 事件。

win_delay_load_hook

在为 Windows 构建本机模块时，模块的 binding.gyp 中的 win_delay_load_hook 变量必须为 true（默认值）。如果未提供此钩子，则本机模块将在 Windows 上加载失败，并显示类似 Cannot find module 的错误消息。 请参阅本机模块指南以获取更多信息。

弃用

以下重大更改已计划在 Electron 5.0 中进行，因此在 Electron 4.0 中已弃用。

为 nativeWindowOpen 打开的窗口禁用 Node.js 集成

从 Electron 5.0 开始，使用 nativeWindowOpen 选项打开的子窗口将始终禁用 Node.js 集成。

webPreferences 默认值

在使用 webPreferences 选项创建新的 BrowserWindow 时，以下 webPreferences 选项默认值将被弃用，转而使用下面列出的新默认值：

属性	已弃用的默认值	新默认值
contextIsolation	false	true
nodeIntegration	true	false
webviewTag	nodeIntegration 的值（如果已设置），否则为 true	false

请注意：目前存在 一个已知错误 (#9736)，如果 contextIsolation 开启，则会阻止 webview 标签正常工作。请关注 GitHub 问题以获取最新信息！

有关上下文隔离、Node 集成和 webview 标签的更多信息，请参阅 Electron 安全文档。

Electron 4.0 仍将使用当前的默认值，但如果您没有为它们传递显式值，您将看到弃用警告。为了为 Electron 5.0 做好准备，请为这些选项使用显式值。 请参阅 BrowserWindow 文档以获取有关每个选项的详细信息。

webContents.findInPage(text[, options])

medialCapitalAsWordStart 和 wordStart 选项已被弃用，因为它们已在 upstream 中移除。

应用反馈计划

我们于 Electron 3.0 开发期间启动的 应用反馈计划 在 4.0 的开发过程中也取得了成功。我们想衷心感谢 Atlassian、Discord、MS Teams、OpenFin、Slack、Symphony、WhatsApp 和其他计划成员在 4.0 测试周期中的参与。要了解有关应用反馈计划的更多信息以及参与未来的测试版，请 查看我们有关该计划的博客文章。

接下来是什么

从短期来看，团队将继续专注于跟上构成 Electron 的主要组件的开发，包括 Chromium、Node 和 V8。虽然我们小心谨慎，不会对发布日期做出承诺，但我们的计划是大约每季度发布 Electron 的新主要版本，其中包含这些组件的新版本。 请参阅我们的版本文档以获取有关 Electron 中版本控制的更多详细信息。

有关 Electron 未来版本中计划的破坏性更改的信息，请 参阅我们的计划破坏性更改文档。