Electron
Frontend & Mobile:electron: Build cross-platform desktop apps with JavaScript, HTML, and CSS
Release History
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.
v40.0.0-alpha.42 fixesThis alpha release fixes a macOS-specific crash related to the native Window menu and a drawing smoothing issue, while updating Chromium to version 144.
v39.1.03 fixesElectron v39.1.0 addresses UI interaction bugs on Linux and macOS while updating core dependencies to Chromium 142 and Node.js v22.21.1.
v40.0.0-alpha.21 featureElectron v40.0.0-alpha.2 updates the underlying Chromium engine to version 143.0.7499.0.
v38.5.06 fixes1 featureElectron v38.5.0 introduces granular accessibility management and updates Chromium to 140.0.7339.249, alongside several stability fixes for Windows and macOS.
v37.8.03 fixes2 featuresElectron v37.8.0 introduces granular accessibility management and dynamic ESM imports for non-context isolated preloads, alongside stability fixes for Windows dialogs and macOS title bars.
v39.0.0Breaking12 fixes12 featuresElectron v39.0.0 updates the core stack to Chromium 142 and Node 22.20.0, introduces HDR support for offscreen rendering, and implements breaking changes to offscreen texture handles and window.open resizing behavior.
v39.0.0-beta.52 featuresThis beta release introduces Linux support for retrieving system accent colors and adds granular accessibility management methods.
v39.0.0-beta.48 fixes2 featuresElectron v39.0.0-beta.4 introduces HDR support for offscreen rendering and dynamic ESM imports in preloads, alongside several UI and stability fixes for Wayland, Windows, and macOS.
v38.4.03 fixes1 featureElectron v38.4.0 introduces support for dynamic ESM imports in specific preload scenarios and includes several UI and platform-specific bug fixes for Windows and Wayland.
v37.7.14 fixesThis maintenance release of Electron v37.7.1 focuses on UI and rendering bug fixes, including window transparency styling, title bar contrast, and BrowserWindow display issues.
v38.3.05 fixes2 featuresElectron v38.3.0 includes several bug fixes for dialogs, shell operations, and window styling, alongside updates to Chromium 140 and Node.js 22.20.0.
v36.9.51 fixThis maintenance release fixes a default button handling issue in Windows message boxes and marks the end-of-support for Electron 36.
v37.7.04 fixesElectron v37.7.0 focuses on stability with fixes for Windows dialogs, BrowserView management, and websocket authentication crashes, alongside an update to Node.js v22.20.0.
v39.0.0-beta.35 fixesThis beta release of Electron v39 focuses on stability improvements, including fixes for Windows dialogs, shell external opening, websocket authentication crashes, and window styling.
v39.0.0-beta.21 fix1 featureElectron v39.0.0-beta.2 introduces File System API grant persistence, fixes Wayland configuration issues, and updates Node.js to v22.20.0.
v37.6.13 fixesThis maintenance release addresses a runtime crash in GetPackageJSON, window snapping behavior on minimize/unminimize, and AccentColor frame rendering.
v36.9.4This maintenance release includes internal testing improvements, specifically the ability to rerun failed tests individually.
v38.2.23 fixesThis patch release focuses on stability improvements, including a fix for a GetPackageJSON crash and resolving a functional issue with the PDF Viewer's download button.
v39.0.0-beta.11 fixThis is the first beta release of Electron v39.0.0, featuring a fix for Metal toolchain discovery on macOS 26 during development.
v39.0.0-alpha.94 fixesThis alpha release of Electron v39 focuses on stability, fixing crashes related to GetPackageJSON and command-line feature flags, alongside window snapping and accent color UI improvements.
v38.2.11 fixThis patch release addresses a window management bug where snapped windows lost their positioning after being minimized and restored.
v39.0.0-alpha.81 fixThis alpha release of Electron v39 fixes an issue where the download button in the PDF Viewer was non-functional.
v36.9.31 fixThis patch release addresses a performance issue causing high CPU usage on macOS when using input tags.
v38.2.03 fixes1 featureElectron v38.2.0 introduces session-based persistence for File System API grants and addresses performance issues on macOS Tahoe 26 and Wayland.
v39.0.0-alpha.72 fixesElectron v39.0.0-alpha.7 is an alpha release focused on fixing performance regressions (high CPU and GPU usage) on macOS Tahoe 26.
v37.6.02 fixes1 featureThis release introduces session-based persistence for File System API grants and addresses performance issues related to GPU and CPU usage on macOS Tahoe 26.
v36.9.21 fixThis patch release addresses a performance issue involving excessive WindowServer GPU usage on macOS Tahoe 26.
v39.0.0-alpha.6Alpha release of Electron v39.0.0-alpha.6 featuring an update to Chromium 142.0.7417.0.
v39.0.0-alpha.5This is an alpha release of Electron v39.0.0, published to npm for testing purposes.
v39.0.0-alpha.41 fixThis alpha release addresses a specific crash occurring when accessing the session property of webContents.
v38.1.21 featureThis maintenance release introduces Local Execution, Remote Caching (LERC) for fork PRs and includes an update to the V8 engine.
v36.9.11 featureThis maintenance release updates the V8 engine and introduces Local Execution, Remote Caching (LERC) for fork pull requests.
v37.5.11 featureThis maintenance release updates the V8 engine and introduces Local Execution, Remote Caching (LERC) for fork pull requests.
v38.1.1This maintenance release updates the underlying Chromium engine to version 140.0.7339.133.
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