electron-types 41.0.0-alpha.5 → 41.0.0-beta.1

package/README.md

@@ -11,11 +11,11 @@ The official `electron` package is ~200MB because it includes the Electron binar
 Since this package only provides TypeScript types, install it as a dev dependency. **Install the version that matches your Electron version** (see [Version Matching](#version-matching)):
 
 ```bash
-npm install -D electron-types@41.0.0-alpha.5
+npm install -D electron-types@41.0.0-beta.1
 # or
-yarn add -D electron-types@41.0.0-alpha.5
+yarn add -D electron-types@41.0.0-beta.1
 # or
-pnpm add -D electron-types@41.0.0-alpha.5
+pnpm add -D electron-types@41.0.0-beta.1
 ```
 
 ## Usage

package/dist/electron.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for Electron 41.0.0-alpha.5
+// Type definitions for Electron 41.0.0-beta.1
 // Project: http://electronjs.org/
 // Definitions by: The Electron Team <https://github.com/electron/electron>
 // Definitions: https://github.com/electron/typescript-definitions
@@ -1014,7 +1014,7 @@ declare namespace Electron {
     configureHostResolver(options: ConfigureHostResolverOptions): void;
     /**
      * By default, Chromium disables 3D APIs (e.g. WebGL) until restart on a per domain
-     * basis if the GPU processes crashes too frequently. This function disables that
+     * basis if the GPU process crashes too frequently. This function disables that
      * behavior.
      *
      * This method can only be called before app is ready.
@@ -1124,7 +1124,7 @@ declare namespace Electron {
      *
      * Fetches a path's associated icon.
      *
-     * On _Windows_, there a 2 kinds of icons:
+     * On _Windows_, there are 2 kinds of icons:
      *
      * * Icons associated with certain file extensions, like `.mp3`, `.png`, etc.
      * * Icons inside the file itself, like `.exe`, `.dll`, `.ico`.
@@ -1244,7 +1244,7 @@ declare namespace Electron {
      * A path to a special directory or file associated with `name`. On failure, an
      * `Error` is thrown.
      *
-     * If `app.getPath('logs')` is called without called `app.setAppLogsPath()` being
+     * If `app.getPath('logs')` is called without calling `app.setAppLogsPath()` being
      * called first, a default log directory will be created equivalent to calling
      * `app.setAppLogsPath()` without a `path` parameter.
      */
@@ -1280,7 +1280,7 @@ declare namespace Electron {
      * preferred system language has no country code, and that one of the preferred
      * system languages corresponds with the language used for the regional format. On
      * macOS, the region serves more as a default country code: the user doesn't need
-     * to have Finnish as a preferred language to use Finland as the region,and the
+     * to have Finnish as a preferred language to use Finland as the region, and the
      * country code `FI` is used as the country code for preferred system languages
      * that do not have associated countries in the language name.
      */
@@ -2667,6 +2667,10 @@ declare namespace Electron {
      * height. For example, calling `win.setBounds({ x: 25, y: 20, width: 800, height:
      * 600 })` with a tray height of 38 means that `win.getBounds()` will return `{ x:
      * 25, y: 38, width: 800, height: 600 }`.
+     *
+     * > [!NOTE] On Wayland, this method will return `{ x: 0, y: 0, ... }` as
+     * introspecting or programmatically changing the global window coordinates is
+     * prohibited.
      */
     getBounds(): Rectangle;
     /**
@@ -2730,6 +2734,9 @@ declare namespace Electron {
     getParentWindow(): (BaseWindow) | (null);
     /**
      * Contains the window's current position.
+     *
+     * > [!NOTE] On Wayland, this method will return `[0, 0]` as introspecting or
+     * programmatically changing the global window coordinates is prohibited.
      */
     getPosition(): number[];
     /**
@@ -2923,7 +2930,7 @@ declare namespace Electron {
      * hiding titlebar buttons.
      *
      * This API returns whether the window is in tablet mode, and the `resize` event
-     * can be be used to listen to changes to tablet mode.
+     * can be used to listen to changes to tablet mode.
      *
      * @platform win32
      */
@@ -5353,6 +5360,10 @@ declare namespace Electron {
      * height. For example, calling `win.setBounds({ x: 25, y: 20, width: 800, height:
      * 600 })` with a tray height of 38 means that `win.getBounds()` will return `{ x:
      * 25, y: 38, width: 800, height: 600 }`.
+     *
+     * > [!NOTE] On Wayland, this method will return `{ x: 0, y: 0, ... }` as
+     * introspecting or programmatically changing the global window coordinates is
+     * prohibited.
      */
     getBounds(): Rectangle;
     /**
@@ -5435,6 +5446,9 @@ declare namespace Electron {
     getParentWindow(): (BrowserWindow) | (null);
     /**
      * Contains the window's current position.
+     *
+     * > [!NOTE] On Wayland, this method will return `[0, 0]` as introspecting or
+     * programmatically changing the global window coordinates is prohibited.
      */
     getPosition(): number[];
     /**
@@ -5632,7 +5646,7 @@ declare namespace Electron {
      * hiding titlebar buttons.
      *
      * This API returns whether the window is in tablet mode, and the `resize` event
-     * can be be used to listen to changes to tablet mode.
+     * can be used to listen to changes to tablet mode.
      *
      * @platform win32
      */
@@ -6686,7 +6700,7 @@ declare namespace Electron {
      * Cancels an ongoing HTTP transaction. If the request has already emitted the
      * `close` event, the abort operation will have no effect. Otherwise an ongoing
      * event will emit `abort` and `close` events. Additionally, if there is an ongoing
-     * response object,it will emit the `aborted` event.
+     * response object, it will emit the `aborted` event.
      */
     abort(): void;
     /**
@@ -7094,7 +7108,7 @@ declare namespace Electron {
                                     /**
                                      * The cause of the change with one of the following values:
                                      */
-                                    cause: ('explicit' | 'overwrite' | 'expired' | 'evicted' | 'expired-overwrite'),
+                                    cause: ('inserted' | 'inserted-no-change-overwrite' | 'inserted-no-value-change-overwrite' | 'explicit' | 'overwrite' | 'expired' | 'evicted' | 'expired-overwrite'),
                                     /**
                                      * `true` if the cookie was removed, `false` otherwise.
                                      */
@@ -7107,7 +7121,7 @@ declare namespace Electron {
                                     /**
                                      * The cause of the change with one of the following values:
                                      */
-                                    cause: ('explicit' | 'overwrite' | 'expired' | 'evicted' | 'expired-overwrite'),
+                                    cause: ('inserted' | 'inserted-no-change-overwrite' | 'inserted-no-value-change-overwrite' | 'explicit' | 'overwrite' | 'expired' | 'evicted' | 'expired-overwrite'),
                                     /**
                                      * `true` if the cookie was removed, `false` otherwise.
                                      */
@@ -7120,7 +7134,7 @@ declare namespace Electron {
                                     /**
                                      * The cause of the change with one of the following values:
                                      */
-                                    cause: ('explicit' | 'overwrite' | 'expired' | 'evicted' | 'expired-overwrite'),
+                                    cause: ('inserted' | 'inserted-no-change-overwrite' | 'inserted-no-value-change-overwrite' | 'explicit' | 'overwrite' | 'expired' | 'evicted' | 'expired-overwrite'),
                                     /**
                                      * `true` if the cookie was removed, `false` otherwise.
                                      */
@@ -7133,7 +7147,7 @@ declare namespace Electron {
                                     /**
                                      * The cause of the change with one of the following values:
                                      */
-                                    cause: ('explicit' | 'overwrite' | 'expired' | 'evicted' | 'expired-overwrite'),
+                                    cause: ('inserted' | 'inserted-no-change-overwrite' | 'inserted-no-value-change-overwrite' | 'explicit' | 'overwrite' | 'expired' | 'evicted' | 'expired-overwrite'),
                                     /**
                                      * `true` if the cookie was removed, `false` otherwise.
                                      */
@@ -7146,7 +7160,7 @@ declare namespace Electron {
                                     /**
                                      * The cause of the change with one of the following values:
                                      */
-                                    cause: ('explicit' | 'overwrite' | 'expired' | 'evicted' | 'expired-overwrite'),
+                                    cause: ('inserted' | 'inserted-no-change-overwrite' | 'inserted-no-value-change-overwrite' | 'explicit' | 'overwrite' | 'expired' | 'evicted' | 'expired-overwrite'),
                                     /**
                                      * `true` if the cookie was removed, `false` otherwise.
                                      */
@@ -7452,9 +7466,12 @@ declare namespace Electron {
      * `DesktopCapturerSource` represents a screen or an individual window that can be
      * captured.
      *
-     * > [!NOTE] Capturing the screen contents requires user consent on macOS 10.15
-     * Catalina or higher, which can detected by
-     * `systemPreferences.getMediaAccessStatus`.
+     * > [!NOTE]
+     *
+     * > * Capturing audio requires `NSAudioCaptureUsageDescription` Info.plist key on
+     * macOS 14.2 Sonoma and higher - read more.
+     * * Capturing the screen contents requires user consent on macOS 10.15 Catalina or
+     * higher, which can detected by `systemPreferences.getMediaAccessStatus`.
      */
     getSources(options: SourcesOptions): Promise<Electron.DesktopCapturerSource[]>;
   }
@@ -7543,8 +7560,8 @@ declare namespace Electron {
      *
      * This API can be called safely before the `ready` event the `app` module emits,
      * it is usually used to report errors in early stage of startup. If called before
-     * the app `ready`event on Linux, the message will be emitted to stderr, and no GUI
-     * dialog will appear.
+     * the app `ready` event on Linux, the message will be emitted to stderr, and no
+     * GUI dialog will appear.
      */
     showErrorBox(title: string, content: string): void;
     /**
@@ -7799,9 +7816,9 @@ declare namespace Electron {
      */
     displayFrequency: number;
     /**
-     * Unique identifier associated with the display. A value of of -1 means the
-     * display is invalid or the correct `id` is not yet known, and a value of -10
-     * means the display is a virtual display assigned to a unified desktop.
+     * Unique identifier associated with the display. A value of -1 means the display
+     * is invalid or the correct `id` is not yet known, and a value of -10 means the
+     * display is a virtual display assigned to a unified desktop.
      */
     id: number;
     /**
@@ -8604,9 +8621,9 @@ declare namespace Electron {
     removeListener(event: 'end', listener: () => void): this;
     /**
      * Emitted when an error was encountered while streaming response data events. For
-     * instance, if the server closes the underlying while the response is still
-     * streaming, an `error` event will be emitted on the response object and a `close`
-     * event will subsequently follow on the request object.
+     * instance, if the server closes the underlying connection while the response is
+     * still streaming, an `error` event will be emitted on the response object and a
+     * `close` event will subsequently follow on the request object.
      */
     on(event: 'error', listener: (
                                   /**
@@ -9303,7 +9320,7 @@ declare namespace Electron {
      * opens the associated menu. The indicated character in the button label then gets
      * an underline, and the `&` character is not displayed on the button label.
      *
-     * In order to escape the `&` character in an item name, add a proceeding `&`. For
+     * In order to escape the `&` character in an item name, add a preceding `&`. For
      * example, `&&File` would result in `&File` displayed on the button label.
      *
      * Passing `null` will suppress the default menu. On Windows and Linux, this has
@@ -9354,9 +9371,9 @@ declare namespace Electron {
      */
     constructor(options: MenuItemConstructorOptions);
     /**
-     * An `Accelerator` (optional) indicating the item's accelerator, if set.
+     * An `Accelerator | null` indicating the item's accelerator, if set.
      */
-    accelerator?: Accelerator;
+    accelerator: (Accelerator) | (null);
     /**
      * A `boolean` indicating whether the item is checked. This property can be
      * dynamically changed.
@@ -9766,8 +9783,8 @@ declare namespace Electron {
      */
     readonly inForcedColorsMode: boolean;
     /**
-     * A `boolean` that indicates the whether the user has chosen via system
-     * accessibility settings to reduce transparency at the OS level.
+     * A `boolean` that indicates whether the user has chosen via system accessibility
+     * settings to reduce transparency at the OS level.
      *
      */
     readonly prefersReducedTransparency: boolean;
@@ -12896,8 +12913,8 @@ declare namespace Electron {
     /**
      * Overrides the `userAgent` and `acceptLanguages` for this session.
      *
-     * The `acceptLanguages` must a comma separated ordered list of language codes, for
-     * example `"en-US,fr,de,ko,zh-CN,ja"`.
+     * The `acceptLanguages` must be a comma separated ordered list of language codes,
+     * for example `"en-US,fr,de,ko,zh-CN,ja"`.
      *
      * This doesn't affect existing `WebContents`, and each `WebContents` can use
      * `webContents.setUserAgent` to override the session-wide user agent.
@@ -16248,7 +16265,7 @@ declare namespace Electron {
      * 302 redirect.
      *
      * This event cannot be prevented, if you want to prevent redirects you should
-     * checkout out the `will-redirect` event above.
+     * check out the `will-redirect` event above.
      */
     on(event: 'did-redirect-navigation', listener: (details: Event<WebContentsDidRedirectNavigationEventParams>,
                                                     /**
@@ -17848,7 +17865,8 @@ declare namespace Electron {
     setDevToolsWebContents(devToolsWebContents: WebContents): void;
     /**
      * If _offscreen rendering_ is enabled sets the frame rate to the specified number.
-     * Only values between 1 and 240 are accepted.
+     * When `webPreferences.offscreen.useSharedTexture` is `false` only values between
+     * 1 and 240 are accepted.
      */
     setFrameRate(fps: number): void;
     /**
@@ -17889,10 +17907,10 @@ declare namespace Electron {
      */
     setWebRTCUDPPortRange(udpPortRange: UdpPortRange): void;
     /**
-     * Called before creating a window a new window is requested by the renderer, e.g.
-     * by `window.open()`, a link with `target="_blank"`, shift+clicking on a link, or
-     * submitting a form with `<form target="_blank">`. See `window.open()` for more
-     * details and how to use this in conjunction with `did-create-window`.
+     * Called before creating a window when a new window is requested by the renderer,
+     * e.g. by `window.open()`, a link with `target="_blank"`, shift+clicking on a
+     * link, or submitting a form with `<form target="_blank">`. See `window.open()`
+     * for more details and how to use this in conjunction with `did-create-window`.
      *
      * An example showing how to customize the process of new `BrowserWindow` creation
      * to be `BrowserView` attached to main window instead:
@@ -17978,7 +17996,7 @@ declare namespace Electron {
      */
     readonly debugger: Debugger;
     /**
-     * A `WebContents | null` property that represents the of DevTools `WebContents`
+     * A `WebContents | null` property that represents the DevTools `WebContents`
      * associated with a given `WebContents`.
      *
      * > [!NOTE] Users should never store this object because it may become `null` when
@@ -18628,6 +18646,10 @@ declare namespace Electron {
      * Enables Chromium's experimental features. Default is `false`.
      */
     experimentalFeatures?: boolean;
+    /**
+     * Whether to focus the WebContents when navigating. Default is `true`.
+     */
+    focusOnNavigation?: boolean;
     /**
      * Specifies how to run image animations (E.g. GIFs).  Can be `animate`,
      * `animateOnce` or `noAnimation`.  Default is `animate`.
@@ -18750,7 +18772,7 @@ declare namespace Electron {
     /**
      * When `false`, it will disable the same-origin policy (usually using testing
      * websites by people), and set `allowRunningInsecureContent` to `true` if this
-     * options has not been set by user. Default is `true`.
+     * option has not been set by user. Default is `true`.
      */
     webSecurity?: boolean;
     /**
@@ -26064,14 +26086,14 @@ declare namespace NodeJS {
     /**
      * A `boolean` that controls whether or not deprecations printed to `stderr`
      * include their stack trace. Setting this to `true` will print stack traces for
-     * deprecations. This property is instead of the `--trace-deprecation` command line
-     * flag.
+     * deprecations. This property is used instead of the `--trace-deprecation` command
+     * line flag.
      */
     traceDeprecation: boolean;
     /**
      * A `boolean` that controls whether or not process warnings printed to `stderr`
      * include their stack trace. Setting this to `true` will print stack traces for
-     * process warnings (including deprecations). This property is instead of the
+     * process warnings (including deprecations). This property is used instead of the
      * `--trace-warnings` command line flag.
      */
     traceProcessWarnings: boolean;

package/dist/version.json

@@ -1,4 +1,4 @@
 {
-  "electronVersion": "41.0.0-alpha.5",
-  "extractedAt": "2026-02-02T18:20:30.767Z"
+  "electronVersion": "41.0.0-beta.1",
+  "extractedAt": "2026-02-12T06:34:37.033Z"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "electron-types",
-  "version": "41.0.0-alpha.5",
+  "version": "41.0.0-beta.1",
   "type": "module",
   "description": "TypeScript type definitions extracted from the electron package",
   "types": "./dist/electron.d.ts",