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
进行 require 有更多的控制,此功能将非常有用。
当在渲染进程中通过 remote.require
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) {
// ...
},
);
有关更多信息,请参见以下文档
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(这是默认值)。如果不存在此 hook,则原生模块在 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 issue 以获取最新信息!
在Electron 安全文档中了解更多关于 context isolation、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 未来版本中计划的重大更改的信息,请参见我们的计划的重大更改文档。