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 v23.0.0-beta.5

Fixes

• Fixed an issue where <datalist> elements were improperly positioned within the page. #36959
• Removed plugin helper checks on macOS gated behind enable_plugins buildflag. #36977 (Also in 22)

Other Changes

• Updated Chromium to 110.0.5481.38. #36955

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 v23.0.0-beta.4

Features

• Added label property to Display objects. #36933 (Also in 21, 22)

Fixes

• Fixed an issue on macOS when trying to switch processes with Cmd+Tab after exiting Kiosk Mode. #36917 (Also in 21, 22)
• Fixed an issue where webViews could have an incorrect initial background color following reloads. #36938 (Also in 21, 22)

Other Changes

• Updated Chromium to 110.0.5481.30. #36819

Release Notes for v22.0.3

Fixes

• Fixed an issue on macOS when trying to switch processes with Cmd+Tab after exiting Kiosk Mode. #36918 (Also in 21, 23)
• Fixed an issue where the setPermissionRequestHandler callback would be invoked twice when using navigator.getUserMedia(...). #36873 (Also in 23)
• Use the process cache to reduce the memory for asar file. #36664 (Also in 21, 23)

Release Notes for v20.3.10

Other Changes

• Security: backported fix for 1395604. #36883
• Security: backported fix for 1399424. #36880
• Security: backported fix for CVE-2022-4174. #36581
• Security: backported fix for CVE-2023-0129. #36886

Release Notes for v21.3.5

Fixes

• Fixed an issue on macOS when trying to switch processes with Cmd+Tab after exiting Kiosk Mode. #36919 (Also in 22, 23)
• Use the process cache to reduce the memory for asar file. #36663 (Also in 22, 23)

Other Changes

• Security: backported fix for 1395604. #36882
• Security: backported fix for 1399424. #36879
• Security: backported fix for CVE-2023-0129. #36885

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 v23.0.0-beta.3

Release Notes for v22.0.2

Fixes

• Fixed an RTL issue that could happen in some locales when calling BrowserWindow.setTrafficLightPosition() on macOS. #36851 (Also in 21, 23)
• Fixed an error when fs.readdir gets null for options. #36849 (Also in 23)
• Fixed missing headers in libcxx_headers bundle. #36865

Other Changes

• Security: backported fix for CVE-2023-0129. #36884
• Updated Chromium to 108.0.5359.179. #36877

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 v23.0.0-beta.2

Fixes

• Fixed an RTL issue that could happen in some locales when calling BrowserWindow.setTrafficLightPosition() on macOS. #36850 (Also in 21, 22)
• Fixed an error when fs.readdir gets null for options. #36848 (Also in 22)
• Fixed an issue where the setPermissionRequestHandler callback would be invoked twice when using navigator.getUserMedia(...). #36874
• Fixed missing headers in libcxx_headers bundle. #36864

Release Notes for v21.3.4

Fixes

• Changed HTML5 Notifications created with the requireInteraction option to not timeout on Linux and Windows. #36503 (Also in 22)
• Fixed a BrowserWindow maxWidth or maxHeight of 0 causing strange resizing behavior. #36510
• Fixed an RTL issue that could happen in some locales when calling BrowserWindow.setTrafficLightPosition() on macOS. #36852 (Also in 22)
• Fixed an issue with incorrect focus ring highlighting when using dialog.showMessageBox(). #36801 (Also in 22, 23)
• Fixed binary stripping for branded release builds on Linux. #36655 (Also in 22, 23)
• Fixed warning about duplicate WebSwapCGLLayer symbols when Electron starts on macOS. #36798 (Also in 22, 23)

Other Changes

• Added node-api: handle no support for external buffers. #36625
• Security: backported fix for 1365082. #36591
• Security: backported fix for 1367993. #36675
• Security: backported fix for 1393177. #36685
• Security: backported fix for CVE-2022-4174. #36580
• Security: backported fix for CVE-2022-4174. #36821
• Security: backported fix for CVE-2022-4175. #36578
• Security: backported fix for CVE-2022-4179. #36584
• Security: backported fix for CVE-2022-4180. #36582
• Security: backported fix for CVE-2022-4181. #36576
• Security: backported fix for CVE-2022-4190. #36589
• Security: backported fix for CVE-2022-4193. #36593
• Security: backported fix for CVE-2022-4436. #36687
• Security: backported fix for CVE-2022-4437. #36677
• Security: backported fix for CVE-2022-4438. #36681
• Security: backported fix for CVE-2022-4439. #36679
• Security: backported fix for [CVE-2022-4262]. #36553
• Security: backported fix for chromium:1393384. #36683

Release Notes for v20.3.9

Other Changes

• Added node-api: handle no support for external buffers. #36626
• Security: backported fix for 1365082. #36592
• Security: backported fix for 1367993. #36676
• Security: backported fix for 1393177. #36686
• Security: backported fix for CVE-2022-4175. #36579
• Security: backported fix for CVE-2022-4178. #36587
• Security: backported fix for CVE-2022-4179. #36585
• Security: backported fix for CVE-2022-4180. #36583
• Security: backported fix for CVE-2022-4181. #36577
• Security: backported fix for CVE-2022-4190. #36590
• Security: backported fix for CVE-2022-4193. #36594
• Security: backported fix for CVE-2022-4436. #36688
• Security: backported fix for CVE-2022-4437. #36678
• Security: backported fix for CVE-2022-4438. #36682
• Security: backported fix for CVE-2022-4439. #36680
• Security: backported fix for [CVE-2022-4262]. #36552
• Security: backported fix for chromium:1393384. #36684

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

Fixes

• Fixed a crash that could occur when running eval in inline scripts in unsandboxed renderer processes. #36667 (Also in 22)
• Fixed an issue with incorrect focus ring highlighting when using dialog.showMessageBox(). #36803 (Also in 21, 22)
• Fixed binary stripping for branded release builds on Linux. #36656 (Also in 21, 22)
• Fixed warning about duplicate WebSwapCGLLayer symbols when Electron starts on macOS. #36799 (Also in 21, 22)
• Use the process cache to reduce the memory for asar file. #36665

Other Changes

• Added node-api: handle no support for external buffers. #36623
• Updated Chromium to 110.0.5478.5. #36574

Release Notes for v22.0.1

Fixes

• Changed HTML5 Notifications created with the requireInteraction option to not timeout on Linux and Windows. #36501 (Also in 21)
• Fixed a crash that could occur when running eval in inline scripts in unsandboxed renderer processes. #36668 (Also in 23)
• Fixed an issue with incorrect focus ring highlighting when using dialog.showMessageBox(). #36802 (Also in 21, 23)
• Fixed binary stripping for branded release builds on Linux. #36654 (Also in 21, 23)
• Fixed warning about duplicate WebSwapCGLLayer symbols when Electron starts on macOS. #36800 (Also in 21, 23)

Other Changes

• Added node-api: handle no support for external buffers. #36624
• Backported fix for chromium:1352405. #36517
• Backported fix for chromium:1352405. #36518
• Removed unneeded --turbo-profiling-input argument from mksnapshot_args for Linux mksnapshot zips. #36782 (Also in 23)
• Updated Chromium to 108.0.5359.99. #36613

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

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

Other Changes

• Updated Chromium to 110.0.5451.0. #36568

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

Features

• Added an app.getPreferredSystemLanguages() API to return the user's system languages. #36035 (Also in 21, 22)
• Added new UtilityProcess API to launch chromium child process with node integration. #34980 (Also in 22)
• Added support for WebUSB. #36289
• Added support for serialPort.forget() as well as a new event serial-port-revoked emitted when a given origin is revoked. #35310 (Also in 22)
• Adds new setHiddenInMissionControl API to allow developers to opt out of mission control on macOS. #36092

Fixes

• Default margin has been added in the code. #36060 (Also in 21, 22)
• Doing require('electron/*') where * is not one of main, common or renderer no longer resolves with the built-in electron module. #35915
• Enable crashpad for ELECTRON_RUN_AS_NODE processes. #36460 (Also in 22)
• Fixed click event and tooltip of Tray not working on Linux. #36333 (Also in 22)
• Fixed a drag-and-drop issue on macOS where items would be incorrectly moved instead of copied in some contexts. #35963 (Also in 20, 21, 22)
• Fixed a potential issue when calling webContents.printToPDF(). #36046 (Also in 21, 22)
• Fixed a potential memory leak. #35932 (Also in 21, 22)
• Fixed an issue where calling app.dock.setIcon(/path/t/icon) would crash when called before the ready event on app. #36279 (Also in 20, 21, 22)
• Fixed an issue where frameless non-resizable windows showed a Windows 7 frame during startup. #35365 (Also in 22)
• Fixed an issue where some options were incorrectly ignored when using webContents.printToPDF(). #35975 (Also in 21, 22)
• Fixed on-screen-keyboard not hiding on input rendered in webview is blurred. #35921 (Also in 20, 21, 22)
• Fixed race condition during update on macOS that could result in TCC and Keychain errors. #36130 (Also in 22)
• Fixed spurious promise rejection in webContents.loadURL when navigating to a hash. #36129 (Also in 20, 21, 22)
• Fixed v8 flags and desktop name in package.json does not hornored when running local app using electron cli. #35997 (Also in 20, 21, 22)
• Removed support for nodeIntegrationInWorker in Service Workers and Shared Workers owing to sandboxing policies. #35919 (Also in 21, 22)
• Removed unneeded --turbo-profiling-input argument from mksnapshot_args. #36378 (Also in 22)
• The keychain account name for MAS and Darwin builds of the same Electron application now differ. #35864
• You can now import the built-in electron module via ESModule loaders, i.e. import('electron') and import 'electron' now work natively. #35930 (Also in 20, 21, 22)

Other Changes

• Enabled out-of-process iframe printing to PDF with webContents.printToPDF().. #36051 (Also in 22)
• Removed unneeded --turbo-profiling-input argument from mksnapshot_args for Linux mksnapshot zips. #36534
• Updated Chromium to 110.0.5415.0. #36186
• Updated Node.js to v18.12.1. #36356
• Upgraded Node.js to v18.10.0. #35999
• Windows 7, Windows 8, and Windows 8.1 are not supported anymore as Chromium 110 dropped support. #36513

Documentation

• Documentation changes: #35894

Release Notes for v21.3.3

Fixes

• Removed unneeded --turbo-profiling-input argument from mksnapshot_args. #36495 (Also in 22)

Other Changes

• Updated Chromium to 106.0.5249.199. #36448

Release Notes for v20.3.8

Other Changes

• Security: backported fix for CVE-2022-4135. #36444

Release Notes for v19.1.9

End of Support for 19.x.y

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

• Security: backported fix for 1333333. #35053
• Security: backported fix for CVE-2022-4135. #36447

Release Notes for v22.0.0

Stack Upgrades

• Chromium 108.0.5359.62.
  • New in 108
  • New in 107
• Node v16.17.1.
  • v16.17.1 release notes
  • v16.17.0 release notes
• V8 v10.8

Breaking Changes

• Added WebContents input-event event.
  • Deprecated BrowserWindow scroll-touch-* events. #35531
• The deprecated new-window event has been removed. #34526

Features

• Added LoadBrowserProcessSpecificV8Snapshot as a new fuse that will let the main/browser process load its v8 snapshot from a file at browser_v8_context_snapshot.bin. Any other process will use the same path as is used today. #35266 (Also in 20, 21)
• Added WebContents.opener to access window opener.
  • Added webContents.fromFrame(frame) to get the WebContents corresponding to a WebFrameMain instance. #35140 (Also in 21)
• Added app.getSystemLocale() method. #35697 (Also in 21)
• Added contextBridge.exposeInIsolatedWorld(worldId, key, api) to expose an API to an isolatedWorld within a renderer from a preload script. #34974
• Added webContents.close() method. #35509
• Added webFrameMain.origin. #35438 (Also in 19, 20, 21)
• Added an app.getPreferredSystemLanguages() API to return the user's system languages. #36291 (Also in 21)
• Added new UtilityProcess API to launch chromium child process with node integration. #36089
• Added new WebContents event content-bounds-updated. #35533
• Added new WebContents.ipc and WebFrameMain.ipc APIs. #34959 (Also in 21)
• Added support for Web Bluetooth pin pairing on Linux and Windows. #35416 (Also in 21)
• Added support for navigator.mediaDevices.getDisplayMedia via a new session handler, ses.setDisplayMediaRequestHandler. #30702
• Added support for serialPort.forget() as well as a new event serial-port-revoked emitted when a given origin is revoked. #36062

Fixes

• Added support for Webauthn discoverable keys (aka resident keys), allowing users to authenticate without first having to select or type a username. #35374
• Enable crashpad for ELECTRON_RUN_AS_NODE processes on linux. #36483
• Fixed click event and tooltip of Tray not working on Linux. #36472
• Fixed an issue where frameless non-resizable windows showed a Windows 7 frame during startup. #36024
• Fixed an issue with incomplete EventEmitter object in sandboxed renderer preload script. #35522
• Fixed race condition during update on macOS that could result in TCC and Keychain errors. #36362
• Removed unneeded --turbo-profiling-input argument from mksnapshot_args. #36463

Also in earlier versions...

• Added a background to the WCO container to avoid rendering glitches. #35569 (Also in 19, 20, 21)
• Added support for Windows drop-down dialog extensions. #35618 (Also in 18, 19, 20, 21)
• Default margin has been added in the code. #36073 (Also in 21)
• Enable WCO maximize button when window enters tablet mode and is not already maximized. #35617 (Also in 19, 20, 21)
• Fixed uv_os_gethostname failing on Windows 7. #35702 (Also in 19, 20, 21)
• Fixed a bug where calling atob in the renderer process could fail under some circumstances. #35415 (Also in 19, 20, 21)
• Fixed a crash that occured when loading non-standard schemes from iframes. #35485 (Also in 21)
• Fixed a crash when switching origins with emulation settings set. #35466 (Also in 21)
• Fixed a drag-and-drop issue on macOS where items would be incorrectly moved instead of copied in some contexts. #35976 (Also in 20, 21)
• Fixed a potential crash on WebWorker destruction. #35422 (Also in 19, 20, 21)
• Fixed a potential issue when calling webContents.printToPDF(). #36065 (Also in 21)
• Fixed a potential memory leak. #35964 (Also in 21)
• Fixed an edge case in app.isInApplicationsFolder() which would return false incorrectly in some cases. #35636 (Also in 19, 20, 21)
• Fixed an issue where DevTools could not be docked with Windows Control Overlay enabled. #35754 (Also in 19, 20, 21)
• Fixed an issue where WCO could occlude DevTools opened in any non-detached mode. #35209 (Also in 18, 19, 20, 21)
• Fixed an issue where screen.getCursorScreenPoint() crashed on Wayland when it was called before a BrowserWindow had been created. #35503 (Also in 21)
• Fixed an issue where serialPort.open() failed with NetworkError: Failed to open serial port.. #35306 (Also in 21)
• Fixed an issue where app.relaunch loses args when execPath is specified. #35108 (Also in 19, 20, 21)
• Fixed an issue where calling app.dock.setIcon(/path/t/icon) would crash when called before the ready event on app. #36293 (Also in 20, 21)
• Fixed an issue where frameless resizable windows showed Window 7 style frames while opening. #35189 (Also in 18, 19, 20, 21)
• Fixed an issue where frameless windows with roundedCorners: false couldn't enter fullscreen without crashing. #35421 (Also in 19, 20, 21)
• Fixed an issue where part of the BrowserView could be cut off when calling setBounds on some windows. #34713 (Also in 19, 20, 21)
• Fixed an issue where some options were incorrectly ignored when using webContents.printToPDF(). #35993 (Also in 21)
• Fixed crash in renderer when resuming system from sleep. #35322 (Also in 18, 19, 20, 21)
• Fixed enable promise support with webFrameMain.executeJavaScript. #35292 (Also in 20, 21)
• Fixed issue with history.back() in sandboxed iframes affecting parent browsing context. #35420 (Also in 19, 20, 21)
• Fixed on-screen-keyboard not hiding on input rendered in webview is blurred. #35983 (Also in 20, 21)
• Fixed session.getBlobData never resolves with blob sizes > 65536. #35277 (Also in 19, 20, 21)
• Fixed spurious promise rejection in webContents.loadURL when navigating to a hash. #36151 (Also in 20, 21)
• Fixed undefined details.requestingUrl from session.setPermissionCheckHandler. #35281 (Also in 20, 21)
• Fixed v8 flags and desktop name in package.json does not hornored when running local app using electron cli. #36049 (Also in 20, 21)
• Fixed: If a custom Electron build contains an electron.d.ts file, it is now being used. #33979 (Also in 20, 21)
• Picture-In-Picture mode no longer becomes a red rectangle on hover. #35034 (Also in 19, 20, 21)
• Provided display_id for desktopCapturer on Linux. #33861 (Also in 19, 20, 21)
• Removed support for nodeIntegrationInWorker in Service Workers and Shared Workers owing to sandboxing policies. #36010 (Also in 21)
• Usage of safeStorage now consistently uses the correct service name on macOS regardless of timing with browser window construction. #34683 (Also in 19, 20)
• You can now import the built-in electron module via ESModule loaders, i.e. import('electron') and import 'electron' now work natively. #35957 (Also in 20, 21)
• Fixed a typo in the section on debugging with VSCode. #35256 (Also in 19, 20, 21)

Other Changes

• Backported fix for chromium:1352405. #36458
• Bumps the minimum required version of Node.js needed to install Electron to 12.20.55. #35301
• Enabled out-of-process iframe printing to PDF with webContents.printToPDF().. #36095
• Fixed win.getBrowserViews() not being updated when a BrowserView was moved to a different window. #35511
• Fixed an issue where some spellcheck functionality would incorrectly throw errors on macOS. #35514 (Also in 21)
• Modified the WCO maximized button style to match Windows 11 more closely. #35370 (Also in 20, 21)
• Updated common.gypi for native modules to support C++17 features in V8. #36369 (Also in 20, 21)

Documentation

• Documentation changes:
  • #35283
  • #35324
  • #35413
  • #35525
  • #35563
  • #35908

Notices

Sunsetting Windows 7/8/8.1

Electron will be ending support for Windows 7/8/8.1 after version 22.x.y following Chromium's plan to end support. Older versions of Electron will continue to work, but no further updates will be made for these operating systems.

End of Support for 19.x.y

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

Release Notes for v19.1.8

Other Changes

• Security: backported fix for 1333333. #35053
• Security: backported fix for CVE-2022-4135. #36447