Electron 35.0.0
Electron 35.0.0 已发布!它包含了对 Chromium 134.0.6998.44、V8 13.5 和 Node 22.14.0 的升级。
Electron 团队激动地宣布发布 Electron 35.0.0!您可以通过 npm 使用 npm install electron@latest
进行安装,或从我们的发布网站下载。继续阅读以了解此版本的详细信息。
如果您有任何反馈,请在 Bluesky 或 Mastodon 上与我们分享,或加入我们的社区 Discord!错误和功能请求可以在 Electron 的 issue 跟踪器中报告。
重要变更
Service Worker 预加载脚本以改进扩展支持
Electron 35 增加了将预加载脚本附加到 Service Worker 的能力,这最初由 @samuelmaddock 在 RFC #8 中提出。随着 Chrome Manifest V3 扩展将大量工作路由到扩展 Service Worker,此功能填补了 Electron 对现代 Chrome 扩展支持方面的空白。
在 Session 级别以编程方式注册预加载脚本时,您现在可以使用 ses.registerPreloadScript(script)
API 将其专门应用于 Service Worker 上下文。
// Add our preload realm script to the session.
session.defaultSession.registerPreloadScript({
// Our script should only run in service worker preload realms.
type: 'service-worker',
// The absolute path to the script.
script: path.join(__dirname, 'extension-sw-preload.js'),
});
此外,Service Worker 与其附加的预加载脚本之间现在可以通过 ServiceWorkerMain.ipc
类进行 IPC 通信。预加载脚本仍将使用 ipcRenderer
模块与其 Service Worker 通信。有关更多详细信息,请参阅原始 RFC。
此功能是在许多其他为其奠定基础的变更之后推出的
- #45329 重新设计了 Session 模块的预加载 API,以支持注册和注销单独的预加载脚本。
- #45229 添加了实验性的
contextBridge.executeInMainWorld(executionScript)
脚本,用于通过上下文桥在主世界中评估 JavaScript。 - #45341 添加了
ServiceWorkerMain
类,用于在主进程中与 Service Worker 进行交互。
技术栈变更
- Chromium
134.0.6998.44
- Node
22.14.0
- V8
13.5
Electron 35 将 Chromium 从 132.0.6834.83
升级到 134.0.6998.44
,Node 从 20.18.1
升级到 22.14.0
,V8 从 13.2
升级到 13.5
。
新特性
- 在
Info.plist
中添加了NSPrefersDisplaySafeAreaCompatibilityMode
=false
,以从应用选项中移除“缩放以适应内建摄像头下方区域”。 #45357 (也在 v34.1.0 中) - 添加了
ServiceWorkerMain
类,用于在主进程中与 service worker 进行交互。 #45341- 在
ServiceWorkers
上添加了running-status-changed
事件,用于指示 service worker 的运行状态何时发生变化。 - 在
ServiceWorkers
上添加了startWorkerForScope
,用于启动之前可能已停止的 worker。
- 在
- 添加了实验性的
contextBridge.executeInMainWorld
,用于安全地跨越世界边界执行代码。 #45330 - 为
'console-message'
事件添加了frame
。 #43617 - 添加了
query-session-end
事件,并改进了 Windows 上的session-end
事件。 #44598 - 添加了
view.getVisible()
。 #45409 - 添加了
webContents.navigationHistory.restore(index, entries)
API,允许恢复导航历史记录。 #45583 - 为
BrowserWindow.setVibrancy
添加了可选的动画参数。 #35987 - 为
document.executeCommand("paste")
添加了权限支持。 #45471 (也在 v34.1.0 中) - 在 Windows 上为
roundedCorners
BrowserWindow 构造函数选项添加了支持。 #45740 (也在 v34.3.0 中) - 添加了对 service worker 预加载脚本的支持。 #45408
- 支持 Portal 的
globalShortcuts
。Electron 必须使用--enable-features=GlobalShortcutsPortal
运行才能使此功能生效。 #45297
重大变更
移除:PrinterInfo
上的 isDefault
和 status
属性
这些属性已从 PrinterInfo
对象中移除,因为它们已从上游 Chromium 中移除。
已弃用:session.serviceWorkers
上的 getFromVersionID
session.serviceWorkers.fromVersionID(versionId)
API 已弃用,取而代之的是 session.serviceWorkers.getInfoFromVersionID(versionId)
。进行此更改是为了随着 session.serviceWorkers.getWorkerFromVersionID(versionId)
API 的引入,更清楚地表明返回的对象类型。
// Deprecated
session.serviceWorkers.fromVersionID(versionId);
// Replace with
session.serviceWorkers.getInfoFromVersionID(versionId);
已弃用:Session
上的 setPreloads
、getPreloads
引入了 registerPreloadScript
、unregisterPreloadScript
和 getPreloadScripts
作为已弃用方法的替代。这些新 API 允许第三方库注册预加载脚本,而不会替换现有脚本。此外,新的 type
选项允许除 frame
之外的其他预加载目标。
// Deprecated
session.setPreloads([path.join(__dirname, 'preload.js')]);
// Replace with:
session.registerPreloadScript({
type: 'frame',
id: 'app-preload',
filePath: path.join(__dirname, 'preload.js'),
});
已弃用:WebContents
上 console-message
事件中的 level
、message
、line
和 sourceId
参数
WebContents
上的 console-message
事件已更新,以在 Event
参数中提供详细信息。
// Deprecated
webContents.on(
'console-message',
(event, level, message, line, sourceId) => {},
);
// Replace with:
webContents.on(
'console-message',
({ level, message, lineNumber, sourceId, frame }) => {},
);
此外,level
现在是一个字符串,其可能值为 info
、warning
、error
和 debug
。
行为变更:WebRequestFilter
的 urls
属性。
之前,空的 urls 数组被解释为包含所有 URL。为了明确包含所有 URL,开发者现在应该使用 <all_urls>
模式,这是一个指定的 URL 模式,匹配所有可能的 URL。此更改明确了意图,并确保了更可预测的行为。
// Deprecated
const deprecatedFilter = {
urls: [],
};
// Replace with
const newFilter = {
urls: ['<all_urls>'],
};
已弃用:systemPreferences.isAeroGlassEnabled()
systemPreferences.isAeroGlassEnabled()
函数已弃用,无替代方案。自 Electron 23 起,它一直返回 true
,因为 Electron 23 及更高版本仅支持 Windows 10+,而 Windows 10+ 中 DWM 组合无法再禁用。
32.x.y 版本终止支持
根据项目的支持政策,Electron 32.x.y 已达到终止支持状态。鼓励开发者和应用程序升级到更新的 Electron 版本。
E35 (2025 年 3 月) | E36 (2025 年 4 月) | E37 (2025 年 6 月) |
---|---|---|
35.x.y | 36.x.y | 37.x.y |
34.x.y | 35.x.y | 36.x.y |
33.x.y | 34.x.y | 35.x.y |
下一步
短期内,您可以期待团队继续专注于跟进构成 Electron 的主要组件(包括 Chromium、Node 和 V8)的开发进展。
您可以在此处找到 Electron 的公开时间线。
有关未来变更的更多信息,请参阅计划中的重大变更页面。