Electron
Frontend & Mobile:electron: Build cross-platform desktop apps with JavaScript, HTML, and CSS
Release History
v42.0.0-beta.38 fixesThis beta release (v42.0.0-beta.3) focuses primarily on bug fixes across various areas including tracing, window resizing, fullscreen behavior, and crash prevention. It also updates the underlying Chromium version.
v42.0.0-beta.29 fixes1 featureThis beta release introduces new methods for managing global shortcuts and resolves numerous bugs across file system operations, PDF rendering, memory management, printing, and macOS crash reporting. It also updates the underlying Chromium version.
v41.2.09 fixes1 featureThis release introduces the ability to allow Chrome extensions on custom protocols via a new privilege flag. It also includes numerous bug fixes across Linux, macOS, and general window/printing behavior.
v39.8.72 fixesVersion v39.8.7 primarily contains backported fixes for previously reported issues.
v42.0.0-beta.112 fixes1 featureThis beta release introduces the `allowExtensions` privilege for custom protocols and includes numerous fixes related to window sizing, printing, crashes during shutdown, and platform-specific rendering issues. It also updates Node.js to v24.14.1.
v39.8.61 fixThis minor release addresses a specific crash issue related to trace buffer usage reporting in the contentTracing module.
v41.1.12 fixesThis patch release fixes a crash related to trace buffer usage and resolves an issue causing printing failures on Linux. It also includes performance improvements via profile-guided optimization for V8 builtins.
v42.0.0-alpha.63 fixesThis alpha release (v42.0.0-alpha.6) focuses on several bug fixes across Linux and Windows platforms, including improvements to process titles and notification icon handling, alongside an update to Chromium.
v41.1.05 fixes2 featuresVersion 41.1.0 introduces new features for macOS native theming and Windows notifications, alongside several critical bug fixes addressing crashes and accessibility issues.
v39.8.52 fixesThis patch release addresses critical stability issues by fixing crashes related to clipboard image reading and offscreen shared texture handling.
v40.8.55 fixesThis patch release (v40.8.5) focuses on stability and bug fixes, addressing issues related to Windows notifications, clipboard reading, texture handling, accessibility events, and app shortcut icons.
v42.0.0-alpha.5Breaking4 fixes2 featuresThis alpha release introduces new features like `nativeTheme.shouldDifferentiateWithoutColor` on macOS and `urgency` support for Windows notifications, alongside several crash and printing fixes. It also removes support for the ELECTRON_SKIP_BINARY_DOWNLOAD environment variable.
v40.8.46 fixes1 featureThis patch release (v40.8.4) focuses on fixing several critical bugs related to window handling, focus tracking, and utility process exit codes, and adds support for proxy usage during yarn install.
v39.8.44 fixes1 featureThis patch release (v39.8.4) focuses primarily on bug fixes related to window handling, focus tracking, and dialog crashes, alongside adding proxy support for yarn installs.
v41.0.46 fixes1 featureThis patch release (v41.0.4) focuses on numerous bug fixes across window management, dialog handling, and utility process exit codes, alongside adding proxy support for yarn installs and updating Chromium.
v42.0.0-alpha.42 fixesThis alpha release addresses critical bugs related to JavaScript dialog handling and utilityProcess exit code reporting on Windows.
v40.8.33 fixesThis patch release (v40.8.3) focuses on bug fixes, including improved ASAR support in fs copy methods, corrected DevTools behavior, and fixing transparent window resizing on Windows.
v41.0.33 fixesThis patch release (v41.0.3) focuses on bug fixes, including improved ASAR support and fixes for DevTools functionality and transparent window resizing on Windows. It also updates the underlying Chromium version.
v39.8.32 fixesVersion v39.8.3 primarily focuses on bug fixes, including enhanced ASAR support for fs copy methods and resolving issues with transparent window resizing on Windows.
v42.0.0-alpha.29 fixes20 featuresThis alpha release introduces significant new APIs for Windows notifications, macOS app state checking, and utility process configuration. It also modernizes binary installation by moving away from postinstall scripts and includes numerous fixes across platform APIs.
v42.0.0-alpha.110 fixes19 featuresThis alpha release introduces significant new APIs for Windows notifications, macOS app state checking, and improved MSIX auto-updating. It also changes binary installation to occur dynamically during first launch rather than via a postinstall script.
v39.8.21 fixThis is a patch release that backports a specific fix related to issue b/491421267.
v41.0.21 fixThis patch release backports a specific bug fix (b/491421267) from a newer development branch.
v40.8.22 fixesThis patch release backports a critical fix and resolves an issue with app icon retrieval on macOS Tahoe.
v41.0.13 fixesThis patch release (v41.0.1) focuses on fixing several platform-specific bugs related to auto-updating on macOS, window restoration behavior on macOS, and message box/child window interaction on Windows. It also includes an update to Chromium.
v39.8.113 fixesThis patch release focuses primarily on bug fixes across various platforms, including validation for protocol names, fixes related to auto-updater, window management, and input handling. Node.js has also been updated to v22.22.1.
v40.8.111 fixesThis patch release focuses on numerous bug fixes across various platforms, including issues with protocol validation, auto-updater behavior on macOS, instance locking on Windows, and rendering glitches on macOS and Wayland.
v41.0.08 fixes1 featureThis release introduces the new webContents.getOrCreateDevToolsTargetId() method and includes numerous bug fixes related to protocol validation, DevTools menus, instance locking, worker integration, Wayland screen point retrieval, header validation, and permission handling.
v38.8.64 fixesThis patch release for v38.8.6 includes several bug fixes related to protocol validation, instance locking data serialization on Windows, header validation, and subframe origin handling for permission requests. Note that Electron 38.x.y is now end-of-support.
v41.0.0-beta.87 fixes1 featureThis beta release introduces a `reason` property to the Notification 'closed' event on Windows and includes several fixes related to Universal Links, contextBridge prototypes, WebContentsView events, build failures, shutdown crashes, and global shortcut reliability on Wayland.
v40.8.01 fix1 featureVersion 40.8.0 introduces a 'reason' property for Windows Notification 'closed' events and resolves a shutdown crash related to hidden titlebars on Windows.
v40.7.09 fixes1 featureVersion 40.7.0 introduces experimental support for --experimental-transform-types and resolves numerous bugs across macOS, Linux, and core rendering/API interactions. Key fixes include improvements to safeStorage, menu updates, and offscreen rendering context.
v39.8.03 fixes1 featureRelease v39.8.0 introduces support for the --experimental-transform-types flag and resolves several bugs related to macOS Universal Links, VideoFrame prototypes, and window opening options.
v41.0.0-beta.75 fixesThis beta release updates Chromium to 146.0.7680.31 and Node.js to v24.14.0, alongside several fixes related to menus and window sizing on Linux.
v41.0.0-beta.64 fixes2 featuresThis beta release introduces experimental support for `--experimental-transform-types` and improves frameless window behavior on Wayland. Several stability fixes address crashes related to macOS tabs, malformed toasts, AltGr key handling, and window zoom settings.
v39.7.04 fixes1 featureRelease v39.7.0 introduces support for long-animation-frame script attribution and resolves several platform-specific bugs related to window resizing, menu handling, and memory leaks.
v40.6.19 fixesThis patch release (v40.6.1) focuses on numerous bug fixes across platforms, including issues with global shortcuts on Wayland, fullscreen state restoration on Windows, menu handling on macOS, and fixes for memory leaks and startup crashes.
v38.8.41 fixThis minor release primarily addresses a memory leak issue encountered when setting icons on Linux/GTK environments.
v41.0.0-beta.55 fixesThis beta release (v41.0.0-beta.5) focuses on bug fixes across platforms, including issues with global shortcuts on Wayland, fullscreen state restoration on Windows, and memory leaks on Linux/GTK. It also updates the underlying Chromium version.
v41.0.0-beta.44 fixes4 featuresThis beta release introduces new features like `usePrinterDefaultPageSize` for printing and extended Windows notification actions. It also includes several bug fixes related to window resizing on macOS and Linux, and updates the underlying Chromium version.
v40.6.01 fix1 featureVersion 40.6.0 introduces a new option to control WebContents auto-focusing on navigation and resolves a resize issue for frameless windows in Mac App Store builds.
v40.5.02 fixes2 featuresVersion 40.5.0 introduces enhanced Windows notification actions and support for long animation frame script attribution, alongside fixes for macOS audio capture and Wayland pointer lock.
v39.6.11 fixThis patch release primarily addresses a bug related to DevTools docking behavior in frameless windows.
v41.0.0-beta.31 fixThis beta release updates the bundled Node.js version and includes a backported bug fix.
v38.8.21 fixThis patch release backports a specific fix (483569511) from a previous development branch.
v39.6.01 fix1 featureThis release introduces a TCC disclaim option for UtilityProcess on macOS and fixes an issue with audio capture related to the CoreAudio Tap API.
v40.4.11 fixThis patch release backports a specific fix and updates the bundled Chromium version.
v41.0.0-beta.21 featureThis beta release introduces the `disclaim` option to the UtilityProcess API for macOS TCC disclaiming.
v41.0.0-beta.11 fixThis beta release (v41.0.0-beta.1) includes a fix enabling the CoreAudio Tap API for audio capture on macOS via desktopCapturer.
v40.4.01 featureVersion 40.4.0 introduces a new disclaim option for the UtilityProcess API on macOS to handle TCC disclaiming.
v38.8.12 fixesThis patch release addresses specific UI inconsistencies on macOS, fixing a duplicate menu item issue and ensuring dock menu properties are respected.
v40.3.02 fixesThis release primarily focuses on bug fixes, including resolving native module compilation issues on MacOS 12 and correcting accelerator property returns for role-based menu items. It also updates Chromium and Node.js dependencies.
v39.5.26 fixesThis patch release (v39.5.2) focuses primarily on bug fixes across various areas including File System Access, context menus, Wayland input, macOS dock menus, and squirrel updates.
v41.0.0-alpha.610 fixes1 featureThis alpha release introduces the option to disable auto-focusing on navigation and resolves numerous bugs across macOS, Linux, and core APIs like File System Access and cookie handling.
v40.2.1This minor release primarily focuses on internal refactoring of the MSIX updater code to align with upstream Chromium patterns.
v40.2.08 fixes2 featuresRelease v40.2.0 introduces NV12 support for shared texture import and adds MSIX auto-updating support. This version also includes numerous bug fixes across macOS menu handling, rendering, and File System Access API stability.
v39.5.11 fixVersion 39.5.1 primarily addresses a rendering glitch issue experienced on macOS systems.
v39.5.02 fixes1 featureVersion v39.5.0 introduces support for MSIX auto-updating and resolves several macOS menu-related bugs concerning accelerators and duplicate items.
v41.0.0-alpha.52 fixes1 featureThis alpha release introduces support for MSIX auto-updating and resolves several macOS menu-related bugs concerning accelerator functionality and duplicate menu items.
v41.0.0-alpha.41 fixThis alpha release updates Chromium to version 146.0.7650.0 and includes a fix for an issue in chrome://accessibility.
v40.1.07 fixes1 featureThis minor release introduces a feature to suppress DevTools error console output and includes numerous bug fixes across macOS, Linux, and general functionality, alongside a Chromium update.
v39.4.04 fixesThis release updates the embedded Node.js version to v22.22.0 and includes several bug fixes related to accessibility, shortcut link creation, Linux Beep functionality, and macOS dialog filtering.
v38.8.03 fixesThis release primarily focuses on bug fixes, including correcting the behavior of `menu-did-close` and fixing color inversion in `systemPreferences.getAccentColor`. It also updates the bundled Node.js version.
v41.0.0-alpha.33 fixesThis alpha release updates Chromium to 146.0.7645.0 and includes several bug fixes related to shortcut link creation, Linux Beep functionality, and startup crashes when the V8 sandbox is disabled.
v41.0.0-alpha.222 fixes8 featuresThis alpha release introduces several new features, including command-line flags for macOS geolocation and enhanced texture import capabilities. It also resolves numerous bugs across various platforms related to crashes, notifications, and menu handling.
v39.3.05 fixes1 featureThis release introduces WebSocket authentication support via the `login` event on `webContents` and includes several bug fixes related to accessibility, DevTools stability, and network requests.
v41.0.0-alpha.123 fixes8 featuresThis alpha release introduces several new features, including command-line flags for macOS geolocation and enhanced texture import capabilities. It also includes numerous bug fixes addressing crashes, platform-specific rendering issues, and network service configurations.
v40.0.0Breaking17 fixes13 featuresVersion 40.0.0 introduces significant stack upgrades including Chromium 144, Node 24, and V8 14.4, alongside numerous features like HDR support and granular accessibility management. This release contains breaking changes related to renderer process clipboard access and symbol compression formats.
v40.0.0-beta.91 fixThis beta release updates Chromium to version 144.0.7559.60 and fixes an issue with cookie encryption logic.
v40.0.0-beta.81 fix1 featureThis beta release introduces WebSocket authentication support via the webContents 'login' event and fixes a cookie encryption key provider issue on Windows and Linux.
v40.0.0-beta.71 fixThis beta release addresses a bug related to cookie encryption provider passing in the network service.
v40.0.0-beta.6v40.0.0-beta.51 fixElectron v40.0.0-beta.5 is a beta release featuring a backported fix for issue 466786677.
v40.0.0-beta.41 fixElectron v40.0.0-beta.4 is a beta release that includes a backported fix for a Chromium issue.
v39.2.7This release updates the underlying Chromium engine to version 142.0.7444.235.
v40.0.0-beta.31 featureElectron v40.0.0-beta.3 updates the underlying Chromium engine to version 144.0.7547.0.
v39.2.61 fixThis patch release fixes window resizing visual artifacts on Windows and updates the underlying Chromium engine to version 142.
v40.0.0-beta.21 fixThis beta release of Electron v40 fixes a critical bug on Windows where clicking native notifications could cause the application to hang.
v39.2.54 fixesThis patch release focuses on stability improvements for Windows, including fixes for notification hangs and window resizing artifacts, alongside a fix for the menu-did-close event.
v40.0.0-beta.11 fixElectron v40.0.0-beta.1 addresses a specific crash occurring during module resolution at process exit.
v37.10.31 fixThis patch release fixes a bug in the systemPreferences module where accent colors were being returned inverted.
v39.2.43 fixesThis maintenance release fixes a crash in the Node.js tls module, resolves menu callback behavior, and updates Chromium to version 142.0.7444.177.
v38.7.22 fixesThis patch release focuses on fixing menu callback behavior and window state management for modal windows.
v40.0.0-alpha.83 fixesElectron v40.0.0-alpha.8 addresses a crash in the Node.js TLS module and fixes behavior issues with menu popup callbacks and DevTools flickering.
v40.0.0-alpha.72 fixesElectron v40.0.0-alpha.7 includes a Node.js update to v24.11.1 and fixes for IPC-related crashes and modal window focus behavior.
v37.10.21 fixThis patch release includes a backported fix for issue 450328966.
v39.2.31 featureThis patch release updates the internal Chromium engine to version 142.0.7444.175.
v38.7.12 fixesVersion 38.7.1 is a maintenance release containing two backported bug fixes.
v37.10.11 fixThis patch release addresses a bug on macOS where menu items failed to disable correctly.
v39.2.21 fixThis patch release addresses a specific crash related to IPC event object creation.
v40.0.0-alpha.6Alpha release v40.0.0-alpha.6 of Electron, published for testing and bug reporting.
v39.2.11 fixThis patch release addresses a critical bug that caused certain applications to crash or throw exceptions immediately upon launch.
v40.0.0-alpha.59 fixes3 featuresElectron v40.0.0-alpha.5 introduces SF Symbol support for native images and a new net.request option, alongside critical fixes for WASM performance, window modality, and path encoding crashes.
v38.7.08 fixes4 featuresElectron v38.7.0 introduces hardware acceleration checks and accent color resetting, while resolving several critical crashes related to Wayland, WASM optimization, and file paths containing CJK or UTF-8 characters.
v37.10.02 fixes2 featuresThis release introduces a new method to check hardware acceleration status and improves DevTools focus behavior, while restoring the window canHide property.
v39.2.04 fixes5 featuresElectron v39.2.0 introduces hardware acceleration checks and SF Symbol support, alongside critical Windows crash fixes and a Chromium engine update.
v39.1.25 fixesVersion 39.1.2 is a maintenance release focusing on window management fixes for GNOME and macOS, WASM optimization stability, and resolving ESM import issues with CJK paths.
v37.9.05 fixesElectron v37.9.0 focuses on stability with several crash fixes for macOS and Linux (Wayland), alongside an update to Node.js v22.21.1.
v38.6.05 fixesThis release focuses on stability fixes for macOS and Linux (Wayland), resolves a drawing issue with rounded corners, and updates Node.js to v22.21.1.
v39.1.12 fixesThis patch release fixes a critical application crash on MacOS related to the native Window menu and resolves a rendering issue with rounded corner smoothing.
Common Errors
SunCertPathBuilderException2 reportsThe "SunCertPathBuilderException" in Electron usually arises from issues with SSL certificate verification when accessing external resources, often because the system's root CA certificates are outdated or missing. To resolve this, either update the system's root CA certificates or, as a less secure workaround for development/testing, disable certificate verification specifically for the problematic request using `app.commandLine.appendSwitch('ignore-certificate-errors')` before the `app.on('ready')` event or by setting `process.env['NODE_TLS_REJECT_UNAUTHORIZED'] = '0'`.
NotReadableError1 reportThe "NotReadableError" during screen sharing in Electron often indicates that the requested media source is temporarily unavailable or blocked by the operating system, particularly due to security restrictions or concurrent access by another application. Try explicitly requesting specific screen sharing permissions in your Electron app (if not already done), and ensure that no other applications are actively using the screen or camera simultaneously. Also, consider implementing a retry mechanism with a short delay to handle transient availability issues.
NotReachedError1 reportThe "NotReachedError" in Electron usually occurs when code execution reaches a point that was expected to be unreachable, often triggered by unexpected state or logic flaws. To fix it, carefully examine the code path leading to the error, identify the faulty assumption that makes the code reachable, and correct the underlying logic or add explicit state checks (e.g., `if` statements) to handle all possible conditions and prevent the unexpected path from being taken. Consider adding debugging statements or breakpoints to pinpoint the exact moment that the unreachable code is hit.
NotSupportedError1 reportThe "NotSupportedError: The user agent does not support public key credentials" in Electron usually occurs because secure context requirements (HTTPS) aren't met, or a necessary feature is disabled. Ensure your Electron app is served over HTTPS, even in development (using a self-signed certificate if needed), and verify that the 'EnableWebAuthnAPI' runtime feature is enabled in your Electron app's Chromium flags via `app.commandLine.appendSwitch('enable-features', 'EnableWebAuthnAPI')`. Restart your Electron application after applying these changes.
Related Frontend & Mobile Packages
The library for web and native user interfaces.
Flutter makes it easy and fast to build beautiful apps for mobile and beyond
The React Framework
A framework for building native applications using React
Build smaller, faster, and more secure desktop and mobile applications with a web frontend.
FastAPI framework, high performance, easy to learn, fast to code, ready for production
Subscribe to Updates
Get notified when new versions are released