●Change8

Migrating to Electron v43.0.0

Version v43.0.0 introduces 4 breaking changes. This guide details how to update your code.

Released: 6/30/2026

4
Breaking Changes
4
Migration Steps
16
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

nativeImagedialogWebContentsapp.getApplicationInfoForProtocolNotificationMenuItemprotocol.registerSchemesAsPrivilegedapp.configureWebAuthnglobalShortcutview.setBackgroundBlurwebContents.copyVideoFrameAtwebContents.saveVideoFrameAsnativeTheme.shouldDifferentiateWithoutColorcontentTracing.enableHeapProfilingcontentTracing moduleapp.getApplicationNameForProtocol

Breaking Changes

●Issue #1

File downloads will now open by default in the user's Downloads folder (or Home directory if Downloads doesn't exist).

●Issue #2

If a `nativeImage` was passed an image with a color profile, its pixel values will now be normalized to SRGB, ensuring visually identical images after color space application receive similar pixel values when converted to a `nativeImage`.

●Issue #3

On Linux, frameless windows now have rounded corners by default. This can be disabled on all platforms by setting `roundedCorners: false` on the window.

●Issue #4

Support for `showHiddenFiles` in the `dialog` API has been removed on Linux.

Migration Steps

  1. 1
    If you rely on file downloads opening in a specific location other than the user's Downloads folder, be aware that they now default there.
  2. 2
    If you were relying on specific pixel values after color profile application on `nativeImage` conversion, re-evaluate your comparison logic due to SRGB normalization.
  3. 3
    If you use frameless windows on Linux, they will now have rounded corners by default. If this is undesirable, set `roundedCorners: false` in the window configuration.
  4. 4
    If you were using `dialog.showOpenDialog({ properties: ['showHiddenFiles'] })` on Linux, this functionality has been removed and must be handled differently.

Release Summary

Version v43.0.0 introduces major stack upgrades and numerous features, including improved app startup performance via Node.js startup snapshots and V8 bytecode caching. Breaking changes include default download folder behavior and rounded corners for Linux frameless windows.

Need More Details?

View the full release notes and all changes for Electron v43.0.0.

View Full Changelog