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()，以防止加载模块。发生 require 的 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 问题以获取最新信息！

在 Electron 安全文档中了解有关上下文隔离、Node 集成和 webview 标签的更多信息。

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

webContents.findInPage(text[, options])

medialCapitalAsWordStart 和 wordStart 选项已被弃用，因为它们已在上游删除。

应用程序反馈计划

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

下一步是什么

在短期内，您可以期望团队继续专注于跟上构成 Electron 的主要组件（包括 Chromium、Node 和 V8）的开发。尽管我们小心翼翼，不对发布日期做出承诺，但我们的计划是大约每季度发布带有这些组件新版本的 Electron 主要版本。 有关 Electron 版本控制的更多详细信息，请参阅我们的版本控制文档。

有关 Electron 即将发布的版本中计划的重大更改的信息，请参阅我们的计划重大更改文档。