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 預先載入腳本以改進擴充功能支援
最初由 RFC #8 中 @samuelmaddock 提出，Electron 35 新增了將預先載入腳本附加到 Service Workers 的能力。隨著 Chrome 的 Manifest V3 擴充功能將大量工作路由到 擴充功能 service workers，此功能填補了 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'),
});
此外，現在可以透過 ServiceWorkerMain.ipc 類別在 Service Worker 及其附加的預先載入腳本之間使用 IPC。預先載入腳本仍將使用 ipcRenderer 模組與其 Service Worker 通訊。有關更多詳細資訊，請參閱原始 RFC。
此功能之前有許多其他變更為其奠定了基礎
- #45329 重新設計了 Session 模組的預先載入 API，以支援註冊和取消註冊個別預先載入腳本。
- #45229 新增了實驗性的
contextBridge.executeInMainWorld(executionScript)腳本，以在 context bridge 上評估主世界中的 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 - 將
frame新增至'console-message'事件。#43617 - 在 Windows 上新增
query-session-end事件並改進session-end事件。#44598 - 新增
view.getVisible()。#45409 - 新增
webContents.navigationHistory.restore(index, entries)API，允許還原導覽歷史記錄。#45583 - 將可選的動畫參數新增至
BrowserWindow.setVibrancy。#35987 - 新增對
document.executeCommand("paste")的權限支援。#45471 (也包含在 v34.1.0 中) - 在 Windows 上新增對
roundedCornersBrowserWindow 建構函式選項的支援。#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 (25 年 3 月) | E36 (25 年 4 月) | E37 (25 年 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 的公開時程表。
有關未來變更的更多資訊，請參閱 計畫的重大變更 頁面。
