Release Notes for v24.2.0

Features

• Added thermal management information to powerMonitor. #38027 (Also in 25)

Fixes

• Fixed a potential crash when right-clicking on macOS windows with draggable regions. #38136 (Also in 25)
• Fixed an issue where default background color for windows might be incorrect. #38158 (Also in 25)
• Fixed an perceived failure when when using Accessibility attribute AXManualAccessibility to enable a11y features in Electron. #38147 (Also in 23)

Release Notes for v22.3.8

Fixes

• Fixed crash when executing eval in the utility process. #38156 (Also in 23, 24, 25)

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 v25.0.0-beta.1

Fixes

• Fixed a potential crash when right-clicking on macOS windows with draggable regions. #38115 (Also in 24)

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 v25.0.0-alpha.6

Fixes

• Fixed a potential crash when right-clicking on macOS windows with draggable regions. #38115

Release Notes for v23.3.0

Features

• Added httpOnly to the cookie filter. #38043 (Also in 24)

Fixes

• Fixed broken defaults in shell.openExternal() options. #38091 (Also in 22, 24, 25)
• Fixed crash when executing eval in the utility process. #38040 (Also in 24, 25)

Other Changes

• Backported fix for 1408315. #38011
• Security: backported fix for 1360571. #38061
• Security: backported fix for 1404790. #38063
• Security: backported fix for 1427388. #37982
• Security: backported fix for 1428820.
  • Security: backported fix for CVE-2023-2133.
  • Security: backported fix for CVE-2023-2134.
  • Security: backported fix for CVE-2023-2136.
  • Security: backported fix for CVE-2023-2135. #38083
• Security: backported fix for 1428820. #38067
• Security: backported fix for CVE-2023-2033. #37981
• Security: backported fix for CVE-2023-2133. #38057
• Security: backported fix for CVE-2023-2136. #38065

Release Notes for v24.1.3

Fixes

• Fixed broken defaults in shell.openExternal() options. #38072 (Also in 22, 23, 25)
• Fixed crash when executing eval in the utility process. #38041 (Also in 23, 25)

Other Changes

• Security: backported fix for CVE-2023-2136. #38082
• Updated Chromium to 112.0.5615.165. #38047

Release Notes for v22.3.7

Fixes

• Fixed an issue which made defaultFontFamily in webPreferences have no effect. #37970 (Also in 23, 24, 25)
• Fixed broken defaults in shell.openExternal() options. #38092 (Also in 23, 24, 25)
• Fixed the active background color for top-level menu items on Windows. #37991 (Also in 23, 24)

Other Changes

• Security: backported fix for 1360571. #38062
• Security: backported fix for 1404790. #38064
• Security: backported fix for 1417317. #37665
• Security: backported fix for 1427388. #37983
• Security: backported fix for 1428820. #38068
• Security: backported fix for CVE-2023-2033. #37980
• Security: backported fix for CVE-2023-2133. #38058
• Security: backported fix for CVE-2023-2134. #38056
• Security: backported fix for CVE-2023-2135. #38060
• Security: backported fix for CVE-2023-2136. #38066

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 v25.0.0-alpha.5

Features

• Added new 'did-resign-active' event on app. #38018
• Added thermal management information to powerMonitor. #38028

Fixes

• Fixed broken defaults in shell.openExternal() options. #38071 (Also in 22, 23, 24)
• Fixed crash when executing eval in the utility process. #38039 (Also in 23, 24)

Other Changes

• Updated Chromium to 114.0.5719.0. #38034

Documentation

• Documentation changes: #38095

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 v25.0.0-alpha.4

Fixes

• Fixed an issue which made defaultFontFamily in webPreferences have no effect. #37967 (Also in 22, 23, 24)

Release Notes for v23.2.4

Fixes

• Fixed an issue on Linux where menus would not open after resizing/maximizing/unmaximizing a window. #37908 (Also in 24, 25)
• Fixed an issue which made defaultFontFamily in webPreferences have no effect. #37969 (Also in 22, 24, 25)

Release Notes for v24.1.2

Fixes

• Fixed an issue on Linux where menus would not open after resizing/maximizing/unmaximizing a window. #37906 (Also in 23, 25)
• Fixed an issue where the 'swipe' event wasn't being emitted properly on macOS. #37965 (Also in 25)
• Fixed an issue which made defaultFontFamily in webPreferences have no effect. #37968 (Also in 22, 23, 25)

Other Changes

• Updated Chromium to 112.0.5615.87. #37974

Release Notes for v22.3.6

Fixes

• Fixed recommended node-gyp version in node.h error. #37942 (Also in 23, 24, 25)
• Security: Fixed an issue with Content-Security-Policy not being correctly enforced when sandbox: false and contextIsolation: false. (CVE-2023-23623). #37843 (Also in 24)

Other Changes

• Fixed a memory leak in v8.serialize() when running Node.js within Electron. #37774 (Also in 23)
• Security: backported fix for CVE-2023-1810. #37850
• Security: backported fix for CVE-2023-1811. #37848

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 v25.0.0-alpha.3

Fixes

• Fixed an issue where the 'swipe' event wasn't being emitted properly on macOS. #37966
• Fixed recommended node-gyp version in node.h error. #37926 (Also in 22, 23, 24)

Other Changes

• Updated Chromium to 114.0.5710.0. #37957

Documentation

• Documentation changes: #37956

Release Notes for v23.2.3

Fixes

• Added about panel for menu role about on Linux as well. #37874 (Also in 24, 25)
• Fixed an issue on macOS where entering fullscreen with the Fn+F system shortcut would fail or create strange window side effects. #37822 (Also in 24)
• Fixed an issue where certain buttons in the PDF viewer didn't work. #37919 (Also in 24, 25)
• Fixed recommended node-gyp version in node.h error. #37941 (Also in 22, 24, 25)
• Fixed the active background color for top-level menu items on Windows. #37784 (Also in 24)
• Security: Fixed an issue with Content-Security-Policy not being correctly enforced when sandbox: false and contextIsolation: false. (CVE-2023-23623). #37844 (Also in 24)

Other Changes

• Security: backported fix for CVE-2023-1810. #37851
• Security: backported fix for CVE-2023-1811. #37849

Release Notes for v24.1.1

Fixes

• Fixed recommended node-gyp version in node.h error. #37927 (Also in 22, 23, 25)

Release Notes for v24.1.0

Features

• Introduced session.resolveHost for resolving hostnames with Chromium's DNS resolver. #37847

Fixes

• Added about panel for menu role about on Linux as well. #37872 (Also in 23, 25)
• Fixed an issue on macOS where entering fullscreen with the Fn+F system shortcut would fail or create strange window side effects. #37823 (Also in 23)
• Fixed an issue where certain buttons in the PDF viewer didn't work. #37918 (Also in 25)
• Security: Fixed an issue with Content-Security-Policy not being correctly enforced when sandbox: false and contextIsolation: false. (CVE-2023-23623). #37839

Other Changes

• Updated Chromium to 112.0.5615.50. #37833

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 v25.0.0-alpha.2

Features

• Added BrowserWindow.set/getWindowButtonPosition APIs. #37094
• Added httpOnly to the cookie filter. #37255 (Also in 24)
• Added logUsage to shell.openExternal() options, which allows passing the SEE_MASK_FLAG_LOG_USAGE flag to ShellExecuteEx on Windows. #37139 (Also in 24)
• Added net.fetch(). #36733
• Added protocol.handle, replacing and deprecating protocol.{register,intercept}{String,Buffer,Stream,Http,File}Protocol. #36674
• Added types to webRequest filter. #30914 (Also in 24)
• Added a will-frame-navigate event to webContents and the <webview> tag, which fires whenever any frame within the frame hierarchy attempts to navigate. #34418
• Added initiator information to navigator events. #37085
• Added several standard page size options to webContents.print(). #37159 (Also in 22, 23, 24)
• Added the enableLocalEcho flag to the session handler ses.setDisplayMediaRequestHandler() callback for allowing remote audio input to be echoed in the local output stream when audio is a WebFrameMain. #37315 (Also in 23, 24)
• Allows an absolute path to be passed to the session.fromPath() API. #37604
• Changed net.fetch to support requests to file: URLs and custom protocols registered with protocol.register*Protocol. #36606
• Exposes the audio-state-changed event on webContents. #37366
• Feat: introduce session.resolveHost for resolving hostnames with Chromium's DNS resolver. #37690 (Also in 24)

Fixes

• Added about panel for menu role about on Linux as well. #37873 (Also in 23, 24)
• Corrects an issue with HTML fullscreen when BrowserWindow fullscreening is disabled. #37348 (Also in 23, 24)
• Fixed WebUSB on ARM64 macs. #37441 (Also in 23, 24)
• Fixed destroyed event not emitted on close for BrowserView.webContents. #37420 (Also in 23, 24)
• Fixed a crash on capturing sources when using desktopCapturer API on Wayland. #37511 (Also in 23, 24)
• Fixed a crash when BrowserViews are present and a user attempts to prevent beforeunload in the renderer process. #37205 (Also in 22, 23, 24)
• Fixed an incorrect result returned when using secure as a cookies filter. #37203 (Also in 22, 23, 24)
• Fixed an issue on Linux where menus would not open after resizing/maximizing/unmaximizing a window. #37905
• Fixed an issue on macOS where entering fullscreen with the Fn+F system shortcut would fail or create strange window side effects. #37803 (Also in 23, 24)
• Fixed an issue where BroadcastChannel did not work correctly when contextIsolation: false. #37421 (Also in 23, 24)
• Fixed an issue where minWidth/minHeight and maxWidth/maxHeight would not be enforced if the user set an aspectRatio on macOS. #37306 (Also in 22, 23, 24)
• Fixed an issue where calling port.postMessage in MessagePortMain with some invalid parameters could cause a crash. #37585 (Also in 22, 23, 24)
• Fixed an issue where certain buttons in the PDF viewer didn't work. #37920 (Also in 24)
• Fixed an issue where draggable regions incorrectly captured clicks in framed windows. #37594 (Also in 23, 24)
• Fixed an issue where passing both hasReply and actions to a main process Notification on macOS resulted in the first action being obscured and unavailable. #37381 (Also in 22, 23, 24)
• Fixed an issue where successfully loaded media documents emitted did-fail-load. #37824
• Fixed an issue where unhandled rejections could cause duplicate logs in some cases. #37464 (Also in 22, 23, 24)
• Fixed an issue with potential dock icon duplication on macOS. #37599 (Also in 22, 23, 24)
• Fixed canceling of bluetooth requests when no devices are returned. #37601 (Also in 23, 24)
• Fixed draggable regions not working in Mac App Store builds. #37466 (Also in 23, 24)
• Fixed issue with BrowserWindow not updating after call to previewFile. #37530 (Also in 22, 23, 24)
• Fixed potential private API usage for MAS builds on macOS. #37309 (Also in 23, 24)
• Fixed right-click events not being delivered in frameless window draggable regions. #37386 (Also in 23, 24)
• Fixed the active background color for top-level menu items on Windows. #37766 (Also in 23, 24)
• Fixed window could not go back to maximized state when restored on Linux. #37346 (Also in 22, 23, 24)
• Improved error messages on session.cookies.set failure. #37586 (Also in 22, 23, 24)
• Security: Fixed an issue with Content-Security-Policy not being correctly enforced when sandbox: false and contextIsolation: false. (CVE-2023-23623). #37756 (Also in 24)
• Setting the about panel's options no longer crashes. #37373 (Also in 24)
• app.showAboutPanel() no longer blocks the main thread on Windows or Linux, thus matching macOS. #37440 (Also in 24)

Other Changes

• Improved error messages for contents.takeHeapSnapshot. #37434 (Also in 22, 23, 24)
• Updated Chromium to 114.0.5694.0. #37820
• Updated Node.js to v18.15.0. #37532
• nativeImage.createThumbnailFromPath() now takes size instead of maxSize. #37362 (Also in 24)

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 v25.0.0-alpha.1

Features

• Added BrowserWindow.set/getWindowButtonPosition APIs. #37094
• Added httpOnly to the cookie filter. #37255 (Also in 24)
• Added logUsage to shell.openExternal() options, which allows passing the SEE_MASK_FLAG_LOG_USAGE flag to ShellExecuteEx on Windows. #37139 (Also in 24)
• Added net.fetch(). #36733
• Added protocol.handle, replacing and deprecating protocol.{register,intercept}{String,Buffer,Stream,Http,File}Protocol. #36674
• Added types to webRequest filter. #30914 (Also in 24)
• Added a will-frame-navigate event to webContents and the <webview> tag, which fires whenever any frame within the frame hierarchy attempts to navigate. #34418
• Added initiator information to navigator events. #37085
• Added several standard page size options to webContents.print(). #37159 (Also in 22, 23, 24)
• Added the enableLocalEcho flag to the session handler ses.setDisplayMediaRequestHandler() callback for allowing remote audio input to be echoed in the local output stream when audio is a WebFrameMain. #37315 (Also in 23, 24)
• Allows an absolute path to be passed to the session.fromPath() API. #37604
• Changed net.fetch to support requests to file: URLs and custom protocols registered with protocol.register*Protocol. #36606
• Exposes the audio-state-changed event on webContents. #37366
• Feat: introduce session.resolveHost for resolving hostnames with Chromium's DNS resolver. #37690 (Also in 24)

Fixes

• Corrects an issue with HTML fullscreen when BrowserWindow fullscreening is disabled. #37348 (Also in 23, 24)
• Fixed WebUSB on ARM64 macs. #37441 (Also in 23, 24)
• Fixed destroyed event not emitted on close for BrowserView.webContents. #37420 (Also in 23, 24)
• Fixed a crash on capturing sources when using desktopCapturer API on Wayland. #37511 (Also in 23, 24)
• Fixed a crash when BrowserViews are present and a user attempts to prevent beforeunload in the renderer process. #37205 (Also in 22, 23, 24)
• Fixed an incorrect result returned when using secure as a cookies filter. #37203 (Also in 22, 23, 24)
• Fixed an issue on macOS where entering fullscreen with the Fn+F system shortcut would fail or create strange window side effects. #37803 (Also in 23, 24)
• Fixed an issue where BroadcastChannel did not work correctly when contextIsolation: false. #37421 (Also in 23, 24)
• Fixed an issue where minWidth/minHeight and maxWidth/maxHeight would not be enforced if the user set an aspectRatio on macOS. #37306 (Also in 22, 23, 24)
• Fixed an issue where calling port.postMessage in MessagePortMain with some invalid parameters could cause a crash. #37585 (Also in 22, 23, 24)
• Fixed an issue where draggable regions incorrectly captured clicks in framed windows. #37594 (Also in 23, 24)
• Fixed an issue where passing both hasReply and actions to a main process Notification on macOS resulted in the first action being obscured and unavailable. #37381 (Also in 22, 23, 24)
• Fixed an issue where successfully loaded media documents emitted did-fail-load. #37824
• Fixed an issue where unhandled rejections could cause duplicate logs in some cases. #37464 (Also in 22, 23, 24)
• Fixed an issue with potential dock icon duplication on macOS. #37599 (Also in 22, 23, 24)
• Fixed canceling of bluetooth requests when no devices are returned. #37601 (Also in 23, 24)
• Fixed draggable regions not working in Mac App Store builds. #37466 (Also in 23, 24)
• Fixed issue with BrowserWindow not updating after call to previewFile. #37530 (Also in 22, 23, 24)
• Fixed potential private API usage for MAS builds on macOS. #37309 (Also in 23, 24)
• Fixed right-click events not being delivered in frameless window draggable regions. #37386 (Also in 23, 24)
• Fixed the active background color for top-level menu items on Windows. #37766 (Also in 23, 24)
• Fixed window could not go back to maximized state when restored on Linux. #37346 (Also in 22, 23, 24)
• Improved error messages on session.cookies.set failure. #37586 (Also in 22, 23, 24)
• Security: Fixed an issue with Content-Security-Policy not being correctly enforced when sandbox: false and contextIsolation: false. (CVE-2023-23623). #37756 (Also in 24)
• Setting the about panel's options no longer crashes. #37373 (Also in 24)
• app.showAboutPanel() no longer blocks the main thread on Windows or Linux, thus matching macOS. #37440 (Also in 24)

Other Changes

• Improved error messages for contents.takeHeapSnapshot. #37434 (Also in 22, 23, 24)
• Updated Chromium to 114.0.5694.0. #37820
• Updated Node.js to v18.15.0. #37532
• nativeImage.createThumbnailFromPath() now takes size instead of maxSize. #37362 (Also in 24)

Release Notes for v21.4.4

End of Support for 21.x.y

Electron 21.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.

Fixes

• Fixed race condition during update on macOS that could result in TCC and Keychain errors. #37794 (Also in 22)

Other Changes

• Backported fix for CVE-2023-1219. #37738
• Security: backported fix for 1412991. #37660
• Security: backported fix for 1415249. #37672
• Security: backported fix for 1416916. #37658
• Security: backported fix for 1417317. #37666
• Security: backported fix for 1417585. #37664
• Security: backported fix for 1418734. #37662
• Security: backported fix for CVE-2023-1214. #37655
• Security: backported fix for CVE-2023-1215. #37649
• Security: backported fix for CVE-2023-1217. #37653
• Security: backported fix for CVE-2023-1218. #37651
• Security: backported fix for CVE-2023-1219. #37670
• Security: backported fix for CVE-2023-1220. #37668
• Security: backported fix for CVE-2023-1529. #37695
• Security: backported fix for CVE-2023-1530. #37699
• Security: backported fix for CVE-2023-1531. #37697
• Security: backported fix for CVE-2023-1534. #37692

Release Notes for v24.0.0

Stack Upgrades

• Chromium 112.0.5615.49
  • New in Chrome 112
  • New in Chrome 111
• Node.js 18.14.0
  • Node 18.14.0 blog post
• V8 11.2

Breaking Changes

• nativeImage.createThumbnailFromPath() now takes size instead of maxSize. #37796

Features

• Added httpOnly to the cookie filter. #37365
• Added logUsage to shell.openExternal() options, which allows passing the SEE_MASK_FLAG_LOG_USAGE flag to ShellExecuteEx on Windows. #37291
• Added types to webRequest filter. #37427
• Added several standard page size options to webContents.print(). #37265 (Also in 22, 23)
• Added the enableLocalEcho flag to the session handler ses.setDisplayMediaRequestHandler() callback for allowing remote audio input to be echoed in the local output stream when audio is a WebFrameMain. #37528 (Also in 23)

Fixes

• Corrects an issue with HTML fullscreen when BrowserWindow fullscreening is disabled. #37368 (Also in 23)
• Fixed WebUSB on ARM64 macs. #37522 (Also in 23)
• Fixed destroyed event not emitted on close for BrowserView.webContents. #37450 (Also in 23)
• Fixed a crash on capturing sources when using desktopCapturer API on Wayland. #37527 (Also in 23)
• Fixed a crash when BrowserViews are present and a user attempts to prevent beforeunload in the renderer process. #37268 (Also in 22, 23)
• Fixed an incorrect result returned when using secure as a cookies filter. #37246 (Also in 22, 23)
• Fixed an issue where BroadcastChannel did not work correctly when contextIsolation: false. #37443 (Also in 23)
• Fixed an issue where minWidth/minHeight and maxWidth/maxHeight would not be enforced if the user set an aspectRatio on macOS. #37456 (Also in 22, 23)
• Fixed an issue where calling port.postMessage in MessagePortMain with some invalid parameters could cause a crash. #37726 (Also in 22, 23)
• Fixed an issue where draggable regions incorrectly captured clicks in framed windows. #37741 (Also in 23)
• Fixed an issue where passing both hasReply and actions to a main process Notification on macOS resulted in the first action being obscured and unavailable. #37449 (Also in 22, 23)
• Fixed an issue where unhandled rejections could cause duplicate logs in some cases. #37500 (Also in 22, 23)
• Fixed an issue with potential dock icon duplication on macOS. #37625 (Also in 22, 23)
• Fixed canceling of bluetooth requests when no devices are returned. #37717 (Also in 23)
• Fixed draggable regions not working in Mac App Store builds. #37474 (Also in 23)
• Fixed issue with BrowserWindow not updating after call to previewFile. #37578 (Also in 22, 23)
• Fixed potential private API usage for MAS builds on macOS. #37364 (Also in 23)
• Fixed right-click events not being delivered in frameless window draggable regions. #37395 (Also in 23)
• Fixed the active background color for top-level menu items on Windows. #37785
• Fixed window could not go back to maximized state when restored on Linux. #37358 (Also in 22, 23)
• Improved error messages on session.cookies.set failure. #37597 (Also in 22, 23)
• Setting the about panel's options no longer crashes. #37442
• app.showAboutPanel() no longer blocks the main thread on Windows or Linux, thus matching macOS. #37508

Other Changes

• Improved error messages for contents.takeHeapSnapshot. #37461 (Also in 22, 23)
• Updated Chromium to 112.0.5615.49. Fixed performance regression. #37767

Documentation

• Documentation changes: #37288