Note: This is an alpha release. Please file new issues for any bugs you find in it.

This release is published to npm under the alpha tag and can be installed via npm install electron@alpha, or npm install [email protected].

Release Notes for v32.0.0-alpha.4

Note: This is an alpha release. Please file new issues for any bugs you find in it.

This release is published to npm under the alpha tag and can be installed via npm install electron@alpha, or npm install [email protected].

Release Notes for v32.0.0-alpha.3

Features

• Expose systemPreferences to utilityProcess. #42599 (Also in 30, 31)

Fixes

• Fixed an issue where MessagePorts could close unexpectedly with non-cloneable objects sent via postMessage. #42581 (Also in 30, 31)
• Fixed an issue where fetch-dependent interfaces could be missing in Web Workers with nodeIntegrationInWorker enabled. #42595 (Also in 30, 31)

Other Changes

• Fixed crash in gpu process when software compositing is enabled on linux with x11 platform. #42568 (Also in 29, 30, 31)

Release Notes for v31.0.2

Fixes

• Fixed an issue where navigator.usb.getDevices() could crash in some circumstances. #42462 (Also in 29, 30)

Other Changes

• Fixed crash in gpu process when software compositing is enabled on linux with x11 platform. #42570 (Also in 29, 30, 32)
• Updated Chromium to 126.0.6478.61. #42503

Release Notes for v30.1.2

Fixes

• Fixed an issue where MessagePorts could close unexpectedly with non-cloneable objects sent via postMessage. #42582 (Also in 32)
• Fixed an issue where navigator.usb.getDevices() could crash in some circumstances. #42461 (Also in 29, 31)

Other Changes

• Fixed crash in gpu process when software compositing is enabled on linux with x11 platform. #42567 (Also in 29, 31, 32)

Note: This is an alpha release. Please file new issues for any bugs you find in it.

This release is published to npm under the alpha tag and can be installed via npm install electron@alpha, or npm install [email protected].

Release Notes for v32.0.0-alpha.2

Note: This is an alpha release. Please file new issues for any bugs you find in it.

This release is published to npm under the alpha tag and can be installed via npm install electron@alpha, or npm install [email protected].

Release Notes for v32.0.0-alpha.1

Features

• Added cumulativeCPUUsage to AppMetrics and CPUUsage. #41819
• Added the following existing navigation related APIs to webcontents.navigationHistory: canGoBack, goBack, canGoForward, goForward, canGoToOffset, goToOffset, clear. #41752
• Extended WebContentsView to accept pre-existing webContents object. #42086 (Also in 31)
• Removed nonstandard File.path extension from the Web File API. #42053

Fixes

• BrowserWindow.show() now correctly restores focus to inactive apps on macOS. #42300 (Also in 30, 31)
• Don't check for Desktop Environment in setProgressBar and setBadgeCount. #41211
• Electron doesn't paint on offscreen-render mode after gpu process crashed. #41904 (Also in 29, 30, 31)
• Fixed a crash in addChildView if a view is added as its own child. #42067 (Also in 30, 31)
• Fixed a crash when the same WebContentsView is added via addChildView multiple times. #42085 (Also in 30, 31)
• Fixed an error when calling setAutoResize on a BrowserView. #42056 (Also in 30, 31)
• Fixed an inconsistent crash on maximizing window and relayout in Ubuntu. #42126 (Also in 30, 31)
• Fixed an issue where BrowserView webContents were getting destroyed even when preventDefault was being set on the owning BrowserWindow's close event. #42353 (Also in 30, 31)
• Fixed an issue where app.setLoginItemSettings incorrectly checked against loginItemService. #42380 (Also in 29, 30, 31)
• Fixed an issue where contentWindow.document.fonts.ready would never resolve in some circumstances. #42366 (Also in 30, 31)
• Fixed an issue where document.requestFullscreen didn't work when calling it from a webContents inside WebContentsView. #41966 (Also in 30, 31)
• Fixed an issue where fetch dependent interfaces in Node.js were not defined when nodeIntegration was enabled in some circumstances. #42419 (Also in 30, 31)
• Fixed an issue where navigator.usb.getDevices() could crash in some circumstances. #42443 (Also in 29, 30, 31)
• Fixed an issue where recentDOcuments wasn't populating properly on macOS. #41978 (Also in 29, 30, 31)
• Fixed an issue where setTitleBarOverlay didn't work as expected when called on BaseWindow. #41960 (Also in 29, 30, 31)
• Fixed an issue where webContents.navigationHistory was not an enumerable property. #42139 (Also in 30, 31)
• Fixed an issue where bad flags passed via --js-flags could cause a crash. #42414 (Also in 29, 30, 31)
• Fixed an issue where calling window.center() on Windows and Linux incorrectly centered the window. #42048 (Also in 30, 31)
• Fixed an issue where dialogs did not work if they were parented to a BaseWindow and not a BrowserWindow. #42315 (Also in 30, 31)
• Fixed an issue where some calls to WebUSB methods could crash. #42347 (Also in 29, 31)
• Fixed an issue where the window could be incorrectly centered in some circumstances when calling BrowserWindow.center(). #42195 (Also in 30, 31)
• Fixed crash after upgrade on Linux. #41046 (Also in 29, 30, 31)
• Fixed crash on window maximize on X11. #42179 (Also in 30, 31)
• Fixed data corruption when protocol.handle() processed incoming data asynchronously. #41894 (Also in 30, 31)
• Fixed issue where windows made visible with showInactive were blank. #42226 (Also in 31)
• Fixed nativeImage.createThumbnailFromPath and shell.openExternal not resolving when called in the renderer process. #41875 (Also in 30, 31)
• Fixed potentially incorrect exit code in UtilityProcess. #42297 (Also in 31)
• Fixed support for multiple folder/file selection in //shell_dialogs portal implementation. #42308 (Also in 29, 30, 31)
• Fixed the type of WebviewTag.webpreferences back to string. #42275 (Also in 30, 31)
• Re-adds functionality to check whether or not an app was launched as a login service on macOS. #42411 (Also in 29, 30, 31)
• BrowserWindow.focus() now correctly restore focus to inactive apps on macOS. #42180 (Also in 30, 31)
• originalFs.promises.cp now works. #42132 (Also in 31)

Other Changes

• Backported fix for 336625018. #42304 (Also in 31)
• Backported fix for 339458194. #42120
• Backported fix for 340221135. #42172
• Backported fix for 341663589. #42253
• Fixed partially broken state of chrome://accessibility. #41911 (Also in 31)
• Improved error messages when ses.cookies.set fails. #42362 (Also in 29, 30, 31)
• Updated Chromium to 127.0.6521.0. #42118
• Updated Node.js to v20.14.0. #42329

Documentation

• Documentation changes: #41567, #42027, #42028, #42243

Release Notes for v30.1.1

Fixes

• Fixed an issue where app.setLoginItemSettings incorrectly checked against loginItemService. #42403 (Also in 29, 31)
• Fixed an issue where contentWindow.document.fonts.ready would never resolve in some circumstances. #42384 (Also in 31)
• Fixed an issue where fetch dependent interfaces in Node.js were not defined when nodeIntegration was enabled in some circumstances. #42454 (Also in 31)
• Fixed an issue where bad flags passed via --js-flags could cause a crash. #42440 (Also in 29, 31)
• Fixed support for multiple folder/file selection in //shell_dialogs portal implementation. #42426 (Also in 29, 31)
• Re-adds functionality to check whether or not an app was launched as a login service on macOS. #42423 (Also in 29, 31)

Other Changes

• Improved error messages when ses.cookies.set fails. #42398 (Also in 29, 31)

Release Notes for v31.0.1

Fixes

• Fixed an issue where fetch dependent interfaces in Node.js were not defined when nodeIntegration was enabled in some circumstances. #42453 (Also in 30)
• Fixed an issue where bad flags passed via --js-flags could cause a crash. #42441 (Also in 29, 30)

Release Notes for v31.0.0

Stack Upgrades

• Chromium126.0.6478.36
  • New in 126
  • New in 125
• Node 20.14.0
  • Node 20.14.0 blog post
• V8 12.6

Breaking Changes

• Made window.flashFrame(bool) flash continuously on macOS. #41391
• Updated Chromium to 126.0.6445.0. (Removed: WebSQL support) #41868
• Updated Chromium to 125.0.6412.0. (Behavior Changed: nativeImage.toDataURL will preserve PNG colorspace) #41610

Features

Additions

• Added a new instance property navigationHistory on webContents API with navigationHistory.getEntryAtIndex method, enabling applications to retrieve the URL and title of any navigation entry within the browsing history. #41577 (Also in 29, 30)
• Added options parameter to Session.clearData API. #41355
• Added proxy configuring support for requests made with net module from utility process. #41335 (Also in 28, 29, 30)
• Added support for Bluetooth ports being requested by service class ID in navigator.serial. #41638 (Also in 29, 30)
• Added support for NODE_EXTRA_CA_CERTS. #41689
• Extended webContents.setWindowOpenHandler to support manual creation of BrowserWindow. #41432
• Implemented support for the File System API. #41419 (Also in 30)
• clearData method added to Session. #40983
• Extended WebContentsView to accept pre-existing webContents object. #42319

Improvements

• Extended WebContentsView to accept pre-existing webContents object. #42319
• Improved error messages when ses.cookies.set fails. #42400 (Also in 29, 30)
• Re-adds functionality to check whether or not an app was launched as a login service on macOS. #42422

Removed/Deprecated

• The inputFieldType property in the context-menu params has been removed. #41239 (Also in 30)

Fixes

• Added missing support for the recursive option in fs.{readdir|readdirSync} as well as fs.promises.{readdir|readdirSync}. #41582
• Added support for withFileTypes when calling fs.{readdir|readdirSync} with the recursive in Asar archives. #41627
• Fixed ASAN build on macOS. #41587
• Fixed a bug where a window with maximization disabled and WCO enabled would still show its maximization button. #41793
• Fixed an issue where child views in a BrowserWindow could sometimes be. #41256
• Fixed issue where windows made visible with showInactive were blank. #42227
• Fixed potentially incorrect exit code in UtilityProcess. #42397
• originalFs.promises.cp now works. #42134

Also in earlier versions...

• BrowserWindow.show() now correctly restores focus to inactive apps on macOS. #42305 (Also in 30)
• Electron doesn't paint on offscreen-render mode after gpu process crashed. #41924 (Also in 29, 30)
• Ensured ScreenCaptureKit is used exclusively on macOS 14.4 and higher to avoid permission prompts. #41397 (Also in 29, 30)
• Fixed chrome://process-internals failing to load. #41476 (Also in 28, 29, 30)
• Fixed shell.showItemInFolder not opening Windows Explorer if the passed path contains forward slashes. #41642 (Also in 28, 29, 30)
• Fixed a crash in addChildView if a view is added as its own child. #42108 (Also in 30)
• Fixed a crash when the same WebContentsView is added via addChildView multiple times. #42116 (Also in 30)
• Fixed a potential crash in chrome.scripting on extension unload. #41686 (Also in 29, 30)
• Fixed an error when calling setAutoResize on a BrowserView. #42138 (Also in 30)
• Fixed an inconsistent crash on maximizing window and relayout in Ubuntu. #42146 (Also in 30)
• Fixed an issue on Windows where silent printing resulted in comically tiny renderer output. #41811 (Also in 28, 29, 30)
• Fixed an issue where BrowserView webContents were getting destroyed even when preventDefault was being set on the owning BrowserWindow's close event. #42372 (Also in 30)
• Fixed an issue where app.getLoginItemSettings didn't correctly throw errors. #41647 (Also in 30)
• Fixed an issue where app.setLoginItemSettings incorrectly checked against loginItemService. #42404 (Also in 30)
• Fixed an issue where document.requestFullscreen didn't work when calling it from a webContents inside WebContentsView. #41995 (Also in 30)
• Fixed an issue where recentDOcuments wasn't populating properly on macOS. #41993 (Also in 29, 30)
• Fixed an issue where setTitleBarOverlay didn't work as expected when called on BaseWindow. #42150 (Also in 29, 30)
• Fixed an issue where user-did-{resign|become}-active were not emitted properly on macOS. #41506 (Also in 28, 29, 30)
• Fixed an issue where webContents.navigationHistory was not an enumerable property. #42182 (Also in 30)
• Fixed an issue where webContents.print(options) failed if options was not passed or undefined is passed. #41467 (Also in 28, 29, 30)
• Fixed an issue where badge text set using the Badging API no longer appeared correctly on Windows. #41618 (Also in 29, 30)
• Fixed an issue where calling window.center() on Windows and Linux incorrectly centered the window. #42101 (Also in 30)
• Fixed an issue where dialogs did not work if they were parented to a BaseWindow and not a BrowserWindow. #42326 (Also in 30)
• Fixed an issue where emojis weren't properly handled on Windows. #41673 (Also in 29, 30)
• Fixed an issue where showing or focusing a panel window would activate the app on Mac. #41750 (Also in 30)
• Fixed an issue where some calls to WebUSB methods could crash. #42365 (Also in 29)
• Fixed an issue where the serial-port-added event improperly respected filters set by serial.requestPort(). #41621 (Also in 28, 29, 30)
• Fixed an issue where the window could be incorrectly centered in some circumstances when calling BrowserWindow.center(). #42197 (Also in 30)
• Fixed crash after upgrade on Linux. #42062 (Also in 29, 30)
• Fixed crash in Notification::Close() under libnotify 0.8.x with portal environment. #41691 (Also in 28, 29, 30)
• Fixed crash on window maximize on X11. #42184 (Also in 30)
• Fixed data corruption when protocol.handle() processed incoming data asynchronously. #41932 (Also in 30)
• Fixed missing <__assertion_handler> header when compiling with libc++. #41830 (Also in 29, 30)
• Fixed nativeImage.createThumbnailFromPath and shell.openExternal not resolving when called in the renderer process. #41908 (Also in 30)
• Fixed the type of WebviewTag.webpreferences back to string. #42279 (Also in 30)
• Fixed usage of Storage.{get|set|clear}Cookies via the Chrome DevTools Protocol. #41718 (Also in 28, 29, 30)
• Improved appearance of caption buttons on Windows 11 when using Windows Control Overlay. #41561 (Also in 30)
• BrowserWindow.focus() now correctly restore focus to inactive apps on macOS. #42186 (Also in 30)
• Fixed an issue where BrowserView webContents were getting destroyed even when preventDefault was being set on the owning BrowserWindow's close event. #42372 (Also in 30)
• Fixed an issue where contentWindow.document.fonts.ready would never resolve in some circumstances. #42385
• Fixed support for multiple folder/file selection in //shell_dialogs portal implementation. #42424

Other Changes

• Backported fix for 336625018. #42316
• Backported fix for 339266700. #42095
• Backported fix for 339458194. #42121
• Backported fix for 340221135. #42173
• Backported fix for 341663589. #42254
• Fixed partially broken state of chrome://accessibility. #41948

Documentation

• Documentation change
  • #41723
  • #41882
  • #42309

Notices

End of Support for 28.x.y

Electron 28.x.y has reached end-of-support as per the project's support policy. Developers and applications are encouraged to upgrade to a newer version of Electron.

Note: This is a beta release. Please file new issues for any bugs you find in it.

This release is published to npm under the beta tag and can be installed via npm install electron@beta, or npm install [email protected].

Release Notes for v31.0.0-beta.10

Fixes

• Fixed an issue where app.setLoginItemSettings incorrectly checked against loginItemService. #42404 (Also in 30)
• Fixed potentially incorrect exit code in UtilityProcess. #42397

Other Changes

• Improved error messages when ses.cookies.set fails. #42400 (Also in 29, 30)
• Updated Chromium to 126.0.6478.36. #42167

Note: This is a beta release. Please file new issues for any bugs you find in it.

This release is published to npm under the beta tag and can be installed via npm install electron@beta, or npm install [email protected].

Release Notes for v31.0.0-beta.9

Fixes

• Fixed an issue where some calls to WebUSB methods could crash. #42365 (Also in 29)

Release Notes for v30.1.0

Fixes

• BrowserWindow.show() now correctly restores focus to inactive apps on macOS. #42306 (Also in 31)
• Fixed BrowserWindow vibrancy on macOS. #42263
• Fixed an issue where BrowserView webContents were getting destroyed even when preventDefault was being set on the owning BrowserWindow's close event. #42371
• Fixed an issue where dialogs did not work if they were parented to a BaseWindow and not a BrowserWindow. #42327 (Also in 31)
• Fixed an issue where some calls to WebUSB methods could crash. #42364 (Also in 29, 31)

Other Changes

• Updated Chromium to 124.0.6367.243. #42328
• Updated Node.js to v20.14.0. #42294

Note: This is a beta release. Please file new issues for any bugs you find in it.

This release is published to npm under the beta tag and can be installed via npm install electron@beta, or npm install [email protected].

Release Notes for v31.0.0-beta.8

Fixes

• Fixed an issue where dialogs did not work if they were parented to a BaseWindow and not a BrowserWindow. #42326 (Also in 30)

Other Changes

• Backported fix for 336625018. #42316
• Updated Node.js to v20.14.0. #42295

Documentation

• Documentation changes: #42309

Note: This is a beta release. Please file new issues for any bugs you find in it.

This release is published to npm under the beta tag and can be installed via npm install electron@beta, or npm install [email protected].

Release Notes for v31.0.0-beta.7

Fixes

• BrowserWindow.show() now correctly restores focus to inactive apps on macOS. #42305 (Also in 30)
• Fixed the type of WebviewTag.webpreferences back to string. #42279 (Also in 30)

Other Changes

• Backported fix for 341663589. #42254

Release Notes for v29.4.2

Other Changes

• Backported fix for 341663589. #42256

Release Notes for v30.0.9

Fixes

• Fixed the type of WebviewTag.webpreferences back to string. #42280 (Also in 31)

Other Changes

• Updated Chromium to 124.0.6367.233. #42269

Release Notes for v30.0.8

Other Changes

• Backported fix for 341663589. #42255
• Updated Chromium to 124.0.6367.230. #42246

Release Notes for v28.3.3

End of Support

Electron 28.x.y has reached end-of-support as per the project's support policy. Developers and applications are encouraged to upgrade to a newer version of Electron.

Other Changes

• Backported fix for 341663589. #42257

Note: This is a beta release. Please file new issues for any bugs you find in it.

This release is published to npm under the beta tag and can be installed via npm install electron@beta, or npm install [email protected].

Release Notes for v31.0.0-beta.6

Fixes

• Fixed an issue where setTitleBarOverlay didn't work as expected when called on BaseWindow. #42150 (Also in 29, 30)

Release Notes for v30.0.7

Fixes

• Fixed an issue where non-English IME users would see app hangs on a second monitor. #42249
• Fixed an issue where the window could be incorrectly centered in some circumstances when calling BrowserWindow.center(). #42196 (Also in 31)

Other Changes

• Updated Chromium to 124.0.6367.221. #42208