Change8

Migrating to Electron v42.0.0

Version v42.0.0 introduces 1 breaking change. This guide details how to update your code.

Released: 5/6/2026

1
Breaking Changes
1
Migration Steps
23
Affected Symbols

⚠️ Check Your Code

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

Notification.handleActivationELECTRON_INSTALL_PLATFORMELECTRON_INSTALL_ARCHNotification.getHistoryprotocol.registerSchemesAsPrivilegedapp.configureWebAuthnapp.isActiveglobalShortcut.setSuspendedglobalShortcut.isSuspendedNotificationwebContents.getOrCreateDevToolsTargetIdUtilityProcess APINotification 'closed' eventwebContents.printview.setBoundsview.setBackgroundBlurnativeTheme.shouldDifferentiateWithoutColorwebPreferences.focusOnNavigationcontentTracing.enableHeapProfilingsafeStorageNSUserNotificationfscontentTracing

Breaking Changes

Issue #1

On Wayland (Linux), frameless windows now have GTK drop shadows and extended resize boundaries. To create fully frameless windows with no decorations, set `hasShadow: false` in the window constructor. This changes the default behavior for frameless windows on Wayland.

Migration Steps

  1. 1
    To create fully frameless windows with no decorations on Wayland (Linux), set `hasShadow: false` in the window constructor.

Release Summary

This release introduces numerous new features including enhanced notification handling on Windows and macOS, improved WebAuthn support, and dynamic binary downloads. It also includes several bug fixes and improvements to existing APIs.

Need More Details?

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

View Full Changelog