Release Notes for v12.1.2

Other Changes

• Backported fix for CVE-2021-30632. #30940
• Security: backported fix for CVE-2021-30625. #30965

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 v15.0.0-beta.7

Documentation

• Documentation changes: #30977

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 v15.0.0-beta.6

Features

• Added an Electron Fuse for enforcing code signatures on the app.asar file your application loads. Requires the latest asar module. #30900

Fixes

• Fixed a crash when selecting and opening files in a native file dialog on Mac. #30936

Release Notes for v12.1.1

Fixes

• Fixed transparent frameless windows having an opaque background when opened in a maximized state. #30863 (Also in 13, 14, 15)

Other Changes

• Backported fix for chromium:1206289. #30822
• Backported fix for chromium:1227228. #30816
• Security: Backported fix for 1231134. #30762 (Also in 11)
• Security: backported fix for chromium:1221047. #30818

Release Notes for v14.0.1

Features

• Fixed crash that occasionally happens when closing or opening BrowserWindows. #30820 (Also in 13, 15)

Fixes

• Fixed BrowserWindow's backgroundColor option not having an effect. #30819
• Fixed an issue where undocked devtools was not resizable on Windows. #30847 (Also in 15)
• Fixed transparent frameless windows having an opaque background when opened in a maximized state. #30864 (Also in 12, 13, 15)

Other Changes

• Updated Chromium to 93.0.4577.63. #30794

Documentation

• Documentation changes: #30849

Release Notes for v13.4.0

Features

• Added webContents.fromDevToolsTargetId(targetId) to lookup a WebContents instance from an associated Chrome DevTools Protocol TargetID. #30731 (Also in 14, 15)
• Fixed crash that occasionally happens when closing or opening BrowserWindows. #30834 (Also in 15)

Fixes

• Fixed crash when launching app with systemd v249. #30893
• Fixed transparent frameless windows having an opaque background when opened in a maximized state. #30862 (Also in 12, 14, 15)

Other Changes

• Backported fix for chromium:1206289. #30821
• Backported fix for chromium:1227228. #30815
• Security: Backported fix for 1230767. #30638
• Security: backported fix for chromium:1216595. #30824
• Security: backported fix for chromium:1221047. #30817

Documentation

• Documentation changes: #30850

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

Fixes

• Fixed a crash when selecting files in a native file dialog on Windows and Linux. #30927

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

Fixes

• Fixed transparent frameless windows having an opaque background when opened in a maximized state. #30865 (Also in 12, 13, 14)

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

Features

• Added <webview> 'did-redirect-navigation' event. #30664
• Added webContents.fromDevToolsTargetId(targetId) to lookup a WebContents instance from an associated Chrome DevTools Protocol TargetID. #30733 (Also in 14)

Fixes

• Fixed BrowserWindow's backgroundColor option not having an effect. #30777 (Also in 14)
• Fixed an issue where undocked devtools was not resizable on Windows. #30848 (Also in 14)

Other Changes

• Updated Chromium to 94.0.4606.31. #30813

Documentation

• Documentation changes: #30851

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

Features

• Added 'dom-ready' event to WebFrameMain which emits when the frame's document is ready.
  • Added 'frame-created' event to WebContents which emits when a frame is created in the page. #30801
• Added <webview>.sendToFrame() / frameId to 'ipc-message' event. #30704
• Added app.configureHostResolver API for configuring DNS-over-HTTPS. #30775

Fixes

• Fixed a crash in the repl when SharedArrayBuffer is disabled. #30483 (Also in 14)

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

Other Changes

• Updated Chromium to 94.0.4606.20. #30715

Release Notes for v13.3.0

Other Changes

• Security: Backported fix for 1228036. #30639
• Security: Backported fix for 1231134. #30637 (Also in 11)
• Security: Backported fix for 1233564. #30636 (Also in 11)
• Security: Backported fix for 1234009. #30635 (Also in 11)

Release Notes for v12.1.0

Other Changes

• Security: Backported fix for 1234764. #30660 (Also in 11)
• Security: Backported fix for 1234770. #30634
• Security: Backported fix for 1234829. #30624

Release Notes for v11.5.0

Other Changes

• Security: Backported fix for 1227933. #30614 (Also in 12)
• Security: Backported fix for 1231134. #30761
• Security: Backported fix for 1233564. #30755
• Security: Backported fix for 1234009. #30751
• Security: Backported fix for 1234764. #30659 (Also in 12)

End of Support for 11.x.y

Electron 11.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 v14.0.0

Stack Upgrades

• Chromium 93.0.4577.58.
  • New in 93
  • New in 92
• Node v14.17.0.
  • v14.17.0 release notes
• V8
  • v9.3 blog post
  • v9.2 blog post

Breaking Changes

• Child windows no longer inherit BrowserWindow construction options from their parents. #28550
• Deprecated worldSafeExecuteJavaScript option was removed from webPreferences. #28456
• Removed deprecated additionalFeatures property from new-window and did-create-window WebContents events. #28548
• Removed the deprecated app.allowRendererProcessReuse and BrowserWindow affinity options. #26874

Features

Additions

• Added BrowserWindow.isFocusable() to determine whether a window is focusable. #28642
• Added WebFrameMain.visibilityState instance property. #28706
• Added disposition, referrer and postBody to the details object passed to the window open handler registered with setWindowOpenHandler. #28518 (Also in 13)
• Added process.contextId used by @electron/remote. #28007 (Also in 13)
• Added experimental cookie encryption support behind an Electron Fuse. #29492 (Also in 13)
• Added missing resourceType conversions for webRequest listener details: font, ping, cspReport, media, webSocket. #30050
• Added new session.storagePath API to get the path on disk for session-specific data. #28665 (Also in 13)
• Added webContents.fromDevToolsTargetId(targetId) to lookup a WebContents instance from an associated Chrome DevTools Protocol TargetID. #30732
• Added support for Windows Control Overlay on macOS. #29986
• Added support for Windows Control Overlay on Windows. #30678 (Also in 15)
• Added support for debug URLs such as chrome://gpucrash. #29466 (Also in 13)
• Added support for directing Chromium logging to a file with --log-file=.../path/to/file.log. Also, it's now possible to enable logging from JavaScript by appending command-line switches during the first JS tick. #29963
• Added support for the des-ede3 cipher in node crypto. #27897 (Also in 11, 12, 13)
• Adding ContextBridgeMutability feature that skips context bridge DeepFreeze and SetReadOnlyNonConfigurable when exposing a value. #27348

Improvements

• Improved performance characteristics of functions being sent back and forth over the contextBridge. #28285
• Improved performance of napi_threadsafe_function. #29021 (Also in 12, 13)

Removed/Deprecated

• The submitURL option for crashReporter.start is no longer a required argument when uploadToServer is false. #28105 (Also in 13)

Fixes

• Allow Node.js to manage microtasks queue by using explicit microtasks policy before calling uv_run(). #28957 (Also in 11, 12, 13)
• Allow loading source maps from custom protocols and asar bundles. #28573 (Also in 12, 13)
• Child windows with specified background colors or transpency now work as intended. #28054 (Also in 12, 13)
• Colors returned from systemPreferences.getAccentColor(), getSystemColor and getColor are now correctly converted into the devices color space. Previously the color would have been subtly incorrect. #28121 (Also in 11, 12, 13)
• Electron Fuses are now in a consistent order across platforms. #29616 (Also in 13)
• Fixed an issue where fs.promises.readFile would improperly error when passing a FileHandle to the path argument. #29577 (Also in 12, 13)
• Fixed CORS preflight request always being cancelled when connecting via proxy requiring authentication for apps that had registered WebRequest listeners. #29812 (Also in 12, 13)
• Fixed <webview> focus / blur events not working with contextIsolation enabled. #29004 (Also in 10, 11, 12, 13)
• Fixed desktopCapturer.getSources() promise result sometimes never resolving. #28273 (Also in 10, 11, 12, 13)
• Fixed documentEdited status not updating close button for frameless window on macOS. #30391 (Also in 13, 15)
• Fixed postData parameter missing from new-window event. #28513 (Also in 12, 13)
• Fixed requestFullscreen inside webview does not make the element take fullscreen. #29989 (Also in 12, 13)
• Fixed select-bluetooth-device firing on Windows. #29613 (Also in 12, 13)
• Fixed webFrame spell checker APIs crashing when called in sandboxed renderer. #29053 (Also in 12, 13)
• Fixed will-resize and will-move events not scaling the emitted newBounds rectangle to the appropriate Windows display scale factor. #29162 (Also in 11, 12, 13)
• Fixed a bug where, when a JumpList task description exceeded 260 characters, the JumpList was empty, despite valid entries. #28485 (Also in 11, 12, 13)
• Fixed a crash in the repl when SharedArrayBuffer is disabled. #30484
• Fixed a crash when process.exit is called and nativeWindowOpen is enabled. #30235 (Also in 15)
• Fixed a crash when calling shell.trashItem() from the renderer process. #28748 (Also in 12, 13)
• Fixed a crash when calling the webContents.on('login') callback synchronously. #30090 (Also in 12, 13)
• Fixed a feature flag issue where spellchecker methods returned empty suggestion lists on Windows. #29705 (Also in 13)
• Fixed a hang when denying a window.open using setWindowOpenHandler when nativeWindowOpen: false. #29883 (Also in 12, 13)
• Fixed a network process crash that could happen when using setCertificateVerifyProc with many concurrent verification requests. #28358 (Also in 11, 12, 13)
• Fixed a potential crash that would occur with draggable regions on Windows. #30327 (Also in 13, 15)
• Fixed a potential crash when calling app.quit() on macOS. #29962 (Also in 12, 13)
• Fixed a potential crash when setting vibrancy on macOS. #29723 (Also in 13)
• Fixed an issue on Mac where an application could not capture its own window using the desktop capture or getMediaSourceId APIs. #30524 (Also in 13, 15)
• Fixed an issue on Windows where empty console windows were appearing when --enable-logging was present. #30385 (Also in 15)
• Fixed an issue present in webView where the leave-html-full-screen event is not emitted if the user exits fullscreen with esc instead of by clicking into the webView. #30561 (Also in 12, 13, 15)
• Fixed an issue where background color would not be correctly applied to BrowserViews on Windows when either the x or y coordinate is negative (off-screen). #30541 (Also in 13, 15)
• Fixed an issue where BrowserWindows would not properly honor transparency: true or a backgroundColor being set in their constructor options. #30159
• Fixed an issue where Electron would sometimes not honor the user-defined Downloads directory. #29967 (Also in 12, 13)
• Fixed an issue where BrowserView webContents would appear not to load in some circumstances. #30335 (Also in 15)
• Fixed an issue where beforeunload and unload weren't firing properly in BrowserViews. #28382
• Fixed an issue where illegal access error could be thrown when nodeIntegrationInSubFrames is enabled. #29093 (Also in 12, 13)
• Fixed an issue where select-serial-port callback crashes when called with an invalid serial port ID. #28602 (Also in 12, 13)
• Fixed an issue where self.module.paths wouldn't work in Workers. #30014 (Also in 12, 13)
• Fixed an issue where the TouchBarScrubber crashes when showArrowButtons is enabled if items is an empty array. #30679 (Also in 13, 15)
• Fixed an issue where toggling documentEdited status on macOS with titlebarStyle: 'hiddenInset' inadvertently moves the traffic light location. #30605 (Also in 13, 15)
• Fixed an issue where win.capturePage() never called back after calling hide() for a hidden window on some platforms. #27883 (Also in 11, 12, 13)
• Fixed an issue where window.print() did not work properly when printing a pdf from the pdf plugin. #28328 (Also in 12, 13)
• Fixed an issue where a specified aspect ratio could become incorrect when maximizing a window on macOS. #30331 (Also in 12, 13, 15)
• Fixed an issue where custom traffic lights could be covered by BrowserViews on macOS. #29628 (Also in 13)
• Fixed an issue where drag regions on macOS would be offset incorrectly when no drag regions were set,. #28984 (Also in 11, 12, 13)
• Fixed an issue where draggable regions sometimes did not work properly when DevTools is open. #29735 (Also in 12, 13)
• Fixed an issue where dropdown menus did not work in DevTools when contextIsolation was enabled. #29886 (Also in 13)
• Fixed an issue where errors thrown in functions passed over the contextBridge could be displayed incorrectly. #28346 (Also in 12, 13)
• Fixed an issue where extensions without a background page might not have file access. #29123 (Also in 12, 13)
• Fixed an issue where multiple calls to window.setFullScreen could cause problems. #25470 (Also in 11, 12, 13)
• Fixed an issue where request headers were cleared if the optional "requestHeaders" parameter was not included in the webRequest.onBeforeSendHeaders callback response object. #29835 (Also in 12, 13)
• Fixed an issue where right-clicking in the devtools console throws an error. #29472
• Fixed an issue where some Node.js modules would hang on page reload on Windows. #28175 (Also in 11, 12, 13)
• Fixed an issue where some dialogs would stop working on macOS if window.hide() was called while they were open. #28671 (Also in 11, 12, 13)
• Fixed an issue where the setAlwaysOnTop value would sometimes not be preserved for child windows on macOS. #29855 (Also in 12, 13)
• Fixed an issue where the drag regions in BrowserViews on macOS could be off in their y-axis. #28268 (Also in 10, 11, 12, 13)
• Fixed an issue where the thumbar disappeared after win.hide() on Windows. #28366 (Also in 10, 11, 12, 13)
• Fixed an issue where the traffic lights would get double-drawn when exiting fullscreen and adding a BrowserView on macOS. #30150 (Also in 13)
• Fixed an issue where the user-data directory was incorrect in unpackaged apps. #30142
• Fixed an issue where the void function Menu.setApplicationMenu would return a value on some platforms. #29118 (Also in 12, 13)
• Fixed an issue where the window couldn't be closed if a user tried to quit with a message box showing. #28967 (Also in 12, 13)
• Fixed an issue where windows in simpleFullscreen mode were not properly resizing when display metrics changed. #28150 (Also in 11, 12, 13)
• Fixed an issue with PDF loading on Windows, where metadata was not loading correctly and causing the PDF to load as a blank page. #29831 (Also in 13)
• Fixed app.getPath('logs') returning the wrong path on Linux and Windows. #29865
• Fixed beta-only bug that caused mouse clicks to not be processed in frameless windows. #30459 (Also in 15)
• Fixed context menus not being positioned correctly when near the edge of the screen. #28224 (Also in 11, 12, 13)
• Fixed corner radius for vibrancy view in macOS 11. #28655 (Also in 11, 12, 13)
• Fixed crash when an exception occurs within the event emitter. #28971 (Also in 13)
• Fixed crash when calling getBackgroundColor on a transparent window with no assigned background color. #28120 (Also in 11, 12, 13)
• Fixed crash when clicking links with target=_blank from webview. #29949 (Also in 12, 13)
• Fixed crashes in debug builds caused by microtasks policy mismatch. #29809 (Also in 12, 13)
• Fixed crashes on latest gen Intel and Ryzen processors. #29688
• Fixed crashes on macOS when Geolocation was used. #29914 (Also in 13)
• Fixed failing to request file:// resources when web security is disabled. #28489 (Also in 11, 12, 13)
• Fixed frameless window having wrong traffic lights position on macOS 11. #30269 (Also in 13, 15)
• Fixed hover state not clear bug when BrowserWindow is not resizable. #29801 (Also in 12, 13)
• Fixed incorrect value of document.focus when opening multiple windows on macOS. #29204 (Also in 12, 13)
• Fixed intensive I/O from asar files causing ERR_FILE_NOT_FOUND after a while. #28137 (Also in 11, 12, 13)
• Fixed issue where the update permission prompt would cause 100% CPU spin while the prompt was open. #29806 (Also in 13)
• Fixed key window status on mac when opening panels or using custom window switchers. #30066 (Also in 12)
• Fixed media key globalShortcuts on macOS. #30569 (Also in 15)
• Fixed memory leak when creating notification on macOS. #30008 (Also in 12, 13)
• Fixed memory leak when requesting files in ASAR archive from renderer. #29536 (Also in 12, 13)
• Fixed missing 'fetch' event in service workers for requests using a registered protocol. #29440 (Also in 12, 13)
• Fixed native module compilation with AsyncCleanupHooks on windows. #28067 (Also in 11, 12, 13)
• Fixed page title not being updated on child windows without navigation entries under nativeWindowOpen. #29959 (Also in 12, 13)
• Fixed permissions issue that was preventing the PDF viewer from displaying. #29210 (Also in 13)
• Fixed potential corruption of piped response data when using interceptHttpProtocol/registerHttpProtocol. #29670 (Also in 11, 12, 13)
• Fixed pressing Alt with mouse click results in toggling menu bar. #29452 (Also in 12, 13)
• Fixed pressing ESC not exiting fullscreen from webview. #30127 (Also in 12, 13)
• Fixed pressing Alt+Shift and Alt+Ctrl toggling menu bar on KDE. #29444 (Also in 12, 13)
• Fixed rare crash in UpdateDraggableRegions. #30559 (Also in 13, 15)
• Fixed rare crash when initializing the internal PDF extension. #28432 (Also in 12, 13)
• Fixed redirects between locations in custom protocols. #30156
• Fixed sending intermediate certificates with 'select-client-certificate' event callback. #29570 (Also in 12, 13)
• Fixed service worker not working with custom protocol. #28326 (Also in 11, 12, 13)
• Fixed shifted character getting changed in menu accelerator. #29481 (Also in 12, 13)
• Fixed some console messages still being printed to logs when the LogJsConsoleMessages feature was disabled. #30355 (Also in 15)
• Fixed stack overflow crash in v8 on windows 32-bit builds. #30242 (Also in 12, 13, 15)
• Fixed systemPreferences.getSystemColor returning colors missing alpha values. #30087 (Also in 13)
• Fixed the 'did-fail-load' event not being emitted when the 'certificate-error' handler allowed an error through. #29870
• Fixed the <select> element dropdown not appearing on Windows or Linux. #29771
• Fixed the color select eyedropper not working within DevTools. #29752 (Also in 13)
• Fixed the handler set with setWindowOpenHandler not being invoked when a link was middle-clicked or shift-clicked. #28498 (Also in 12, 13)
• Fixed the possibility for incorrect visual artifacts when using vibrancy and making frameless windows fullscreen on macOS. #29084 (Also in 13)
• Fixed the spelling of 'attachment' in 'Content-Disposition' header when using the webRequest module. #29673 (Also in 12, 13)
• Fixed the window-all-closed event being emitted while the last BrowserWindow was still in the process of being closed. #28867 (Also in 11, 12, 13)
• Fixed titlebar showing under simple fullscreen mode. #30707 (Also in 13, 15)
• Fixed tray.setTitle not respecting ANSI colors if a font type was specified. #30164 (Also in 13)
• Fixed using custom v8 snapshots on Apple Silicon. #29338 (Also in 12, 13)
• Fixed using navigator.setAppBadge and navigator.clearAppBadge from a service worker in Electron. #27950 (Also in 12)
• Fixed using vibrancy with titleBarStyle together resulting in weird window shadow on macOS. #29114 (Also in 13)
• No longer set backgroundColor in default-app when opening custom files / URLs. #28792 (Also in 10, 11, 12, 13)
• Restored cross-platform noop implementation of app.setAppUserModelId. #28915 (Also in 13)
• Support wasm-eval csp behind WebAssemblyCSP flag. #28535 (Also in 11, 12, 13)
• Transparent windows cannot be maximized using the Windows system menu or by double clicking the title bar. #28207 (Also in 12, 13)
• URLS passed to shell.openExternal on windows are now correctly URI encoded. This was already occurring on macOS and Linux. #28334 (Also in 10, 11, 12, 13)

Other Changes

• Backported fix for 1216190. #30101 (Also in 12, 13)
• Refactored <webview> using contextBridge to make it safer to use when contextIsolation is enabled. #29037
• Updated community discussions link in default Electron menu. #28449 (Also in 12, 13)
• Web Serial API is no longer experimental. #30333 (Also in 15)

Documentation

• Documentation changes:
  • #27888 - api/auto-updater
  • #27958 - api/power-monitor
  • #28189 - api/browser-window
  • #28315 - docs
  • #29073
  • #29295 - tutorial/support
  • #29429 - tutorial/introduction
  • #29727 - api/window-open
  • #30058

End of Support for 11.x.y

Electron 11.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 v14.0.0-beta.25

Release Notes for v12.0.18

Fixes

• Fixed an issue present in webView where the leave-html-full-screen event is not emitted if the user exits fullscreen with esc instead of by clicking into the webView. #30669 (Also in 13, 14, 15)

Other Changes

• Security: Backported fix for 1196853. #30581
• Security: Backported fix for 1227933. #30615
• Security: backported fix for 1229298. #30580

Release Notes for v13.2.3

Fixes

• Fixed an issue where the TouchBarScrubber crashes when showArrowButtons is enabled if items is an empty array. #30680 (Also in 14, 15)
• Fixed titlebar showing under simple fullscreen mode. #30706 (Also in 14, 15)

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 v15.0.0-alpha.10

Features

• Added safeStorage string encryption API. #30430
• Added support for Windows Control Overlay on Windows. #30497

Fixes

• Fixed an issue where the TouchBarScrubber crashes when showArrowButtons is enabled if items is an empty array. #30681 (Also in 13, 14)
• Fixed titlebar showing under simple fullscreen mode. #30708 (Also in 13, 14)

Other Changes

• Updated Chromium to 94.0.4606.12. #30370

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 v14.0.0-beta.24

Fixes

• Fixed an issue where the TouchBarScrubber crashes when showArrowButtons is enabled if items is an empty array. #30679 (Also in 13, 15)
• Fixed media key globalShortcuts on macOS. #30569 (Also in 15)
• Fixed titlebar showing under simple fullscreen mode. #30707 (Also in 13, 15)

Other Changes

• Updated Chromium to 93.0.4577.51. #30520