electron-types 43.0.0 → 44.0.0-alpha.1

package/README.md

@@ -1,6 +1,5 @@
 # electron-types
 
-[![CI](https://badgen.net/github/checks/biw/electron-types)](https://github.com/biw/electron-types/actions)
 [![npm version](https://badgen.net/npm/v/electron-types)](https://www.npmjs.com/package/electron-types)
 [![npm downloads](https://badgen.net/npm/dt/electron-types)](https://www.npmjs.com/package/electron-types)
 
@@ -15,11 +14,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@43.0.0
+npm install -D electron-types@44.0.0-alpha.1
 # or
-yarn add -D electron-types@43.0.0
+yarn add -D electron-types@44.0.0-alpha.1
 # or
-pnpm add -D electron-types@43.0.0
+pnpm add -D electron-types@44.0.0-alpha.1
 ```
 
 ## Usage

package/dist/electron.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for Electron 43.0.0
+// Type definitions for Electron 44.0.0-alpha.1
 // Project: http://electronjs.org/
 // Definitions by: The Electron Team <https://github.com/electron/electron>
 // Definitions: https://github.com/electron/typescript-definitions
@@ -1158,7 +1158,7 @@ declare namespace Electron {
     /**
      * The current value displayed in the counter badge.
      *
-     * @platform linux,darwin
+     * @platform darwin
      */
     getBadgeCount(): number;
     /**
@@ -1462,12 +1462,6 @@ declare namespace Electron {
      * @platform darwin
      */
     isSecureKeyboardEntryEnabled(): boolean;
-    /**
-     * Whether the current desktop environment is Unity launcher.
-     *
-     * @platform linux
-     */
-    isUnityRunning(): boolean;
     /**
      * Whether the move was successful. Please note that if the move is successful,
      * your application will quit and relaunch.
@@ -1681,18 +1675,13 @@ declare namespace Electron {
     /**
      * Whether the call succeeded.
      *
-     * Sets the counter badge for current app. Setting the count to `0` will hide the
-     * badge.
-     *
-     * On macOS, it shows on the dock icon. On Linux, it only works for Unity launcher.
-     *
-     * > [!NOTE] Unity launcher requires a `.desktop` file to work. For more
-     * information, please read the Unity integration documentation.
+     * Sets the Dock icon counter badge for current app. Setting the count to `0` will
+     * hide the badge.
      *
-     * > [!NOTE] On macOS, you need to ensure that your application has the permission
-     * to display notifications for this method to work.
+     * > [!NOTE] You need to ensure that your application has the permission to display
+     * notifications for this method to work.
      *
-     * @platform linux,darwin
+     * @platform darwin
      */
     setBadgeCount(count?: number): boolean;
     /**
@@ -1921,18 +1910,13 @@ declare namespace Electron {
     applicationMenu: (Menu) | (null);
     /**
      * An `Integer` property that returns the badge count for current app. Setting the
-     * count to `0` will hide the badge.
-     *
-     * On macOS, setting this with any nonzero integer shows on the dock icon. On
-     * Linux, this property only works for Unity launcher.
-     *
-     * > [!NOTE] Unity launcher requires a `.desktop` file to work. For more
-     * information, please read the Unity integration documentation.
+     * count to `0` will hide the badge. Setting this with any nonzero integer shows
+     * the count on the Dock icon.
      *
-     * > [!NOTE] On macOS, you need to ensure that your application has the permission
-     * to display notifications for this property to take effect.
+     * > [!NOTE] You need to ensure that your application has the permission to display
+     * notifications for this property to take effect.
      *
-     * @platform linux,darwin
+     * @platform darwin
      */
     badgeCount: number;
     /**
@@ -2895,6 +2879,8 @@ declare namespace Electron {
     invalidateShadow(): void;
     /**
      * Whether the window is always on top of other windows.
+     *
+     * Not supported on Wayland (Linux).
      */
     isAlwaysOnTop(): boolean;
     /**
@@ -3146,6 +3132,8 @@ declare namespace Electron {
      * Sets whether the window should show always on top of other windows. After
      * setting this, the window is still a normal window, not a toolbox window which
      * can not be focused on.
+     *
+     * Not supported on Wayland (Linux).
      */
     setAlwaysOnTop(flag: boolean, level?: 'normal' | 'floating' | 'torn-off-menu' | 'modal-panel' | 'main-menu' | 'status' | 'pop-up-menu' | 'screen-saver' | 'dock', relativeLevel?: number): void;
     /**
@@ -3404,13 +3392,11 @@ declare namespace Electron {
      * Remove progress bar when progress < 0; Change to indeterminate mode when
      * progress > 1.
      *
-     * On Linux platform, only supports Unity desktop environment, you need to specify
-     * the `*.desktop` file name to `desktopName` field in `package.json`. By default,
-     * it will assume `{app.name}.desktop`.
-     *
      * On Windows, a mode can be passed. Accepted values are `none`, `normal`,
      * `indeterminate`, `error`, and `paused`. If you call `setProgressBar` without a
      * mode set (but with a value within the valid range), `normal` will be assumed.
+     *
+     * @platform win32,darwin
      */
     setProgressBar(progress: number, options?: ProgressBarOptions): void;
     /**
@@ -3785,7 +3771,7 @@ declare namespace Electron {
     acceptFirstMouse?: boolean;
     /**
      * Whether the window should always stay on top of other windows. Default is
-     * `false`.
+     * `false`. Not supported on Wayland (Linux).
      */
     alwaysOnTop?: boolean;
     /**
@@ -5555,8 +5541,7 @@ declare namespace Electron {
      */
     getNormalBounds(): Rectangle;
     /**
-     * between 0.0 (fully transparent) and 1.0 (fully opaque). On Linux, always returns
-     * 1.
+     * between 0.0 (fully transparent) and 1.0 (fully opaque).
      */
     getOpacity(): number;
     /**
@@ -5622,6 +5607,8 @@ declare namespace Electron {
     invalidateShadow(): void;
     /**
      * Whether the window is always on top of other windows.
+     *
+     * Not supported on Wayland (Linux).
      */
     isAlwaysOnTop(): boolean;
     /**
@@ -5919,6 +5906,8 @@ declare namespace Electron {
      * Sets whether the window should show always on top of other windows. After
      * setting this, the window is still a normal window, not a toolbox window which
      * can not be focused on.
+     *
+     * Not supported on Wayland (Linux).
      */
     setAlwaysOnTop(flag: boolean, level?: 'normal' | 'floating' | 'torn-off-menu' | 'modal-panel' | 'main-menu' | 'status' | 'pop-up-menu' | 'screen-saver' | 'dock', relativeLevel?: number): void;
     /**
@@ -6166,10 +6155,8 @@ declare namespace Electron {
      */
     setMovable(movable: boolean): void;
     /**
-     * Sets the opacity of the window. On Linux, does nothing. Out of bound number
-     * values are clamped to the [0, 1] range.
-     *
-     * @platform win32,darwin
+     * Sets the opacity of the window. Out of bound number values are clamped to the
+     * [0, 1] range.
      */
     setOpacity(opacity: number): void;
     /**
@@ -6196,13 +6183,11 @@ declare namespace Electron {
      * Remove progress bar when progress < 0; Change to indeterminate mode when
      * progress > 1.
      *
-     * On Linux platform, only supports Unity desktop environment, you need to specify
-     * the `*.desktop` file name to `desktopName` field in `package.json`. By default,
-     * it will assume `{app.name}.desktop`.
-     *
      * On Windows, a mode can be passed. Accepted values are `none`, `normal`,
      * `indeterminate`, `error`, and `paused`. If you call `setProgressBar` without a
      * mode set (but with a value within the valid range), `normal` will be assumed.
+     *
+     * @platform win32,darwin
      */
     setProgressBar(progress: number, options?: ProgressBarOptions): void;
     /**
@@ -10241,6 +10226,14 @@ declare namespace Electron {
      *
      */
     readonly online: boolean;
+    /**
+     * > [!NOTE] This property is only available in the main process.
+     *
+     * A `typeof WebSocket` reference to the `WebSocket` class, which can be used to
+     * create WHATWG-compatible WebSocket connections through Chromium's network stack
+     * from the main process.
+     */
+    WebSocket: typeof WebSocket;
   }
 
   interface NetLog {
@@ -18053,6 +18046,10 @@ declare namespace Electron {
      * the current zoom level.
      */
     getZoomLevel(): number;
+    /**
+     * The current zoom mode. Can be `default`, `isolated`, `manual`, or `disabled`.
+     */
+    getZoomMode(): ('default' | 'isolated' | 'manual' | 'disabled');
     /**
      * Makes the browser go back a web page.
      *
@@ -18452,11 +18449,29 @@ declare namespace Electron {
      * limits of 300% and 50% of original size, respectively. The formula for this is
      * `scale := 1.2 ^ level`.
      *
-     * > [!NOTE] The zoom policy at the Chromium level is same-origin, meaning that the
-     * zoom level for a specific domain propagates across all instances of windows with
-     * the same domain. Differentiating the window URLs will make zoom work per-window.
+     * > [!NOTE] The zoom policy at the Chromium level is same-origin by default,
+     * meaning that the zoom level for a specific domain propagates across all
+     * instances of windows with the same domain. To use per-webContents zoom instead,
+     * set the zoom mode to `'isolated'` via `contents.setZoomMode('isolated')`.
      */
     setZoomLevel(level: number): void;
+    /**
+     * Sets the zoom mode for this web contents.
+     *
+     * * `default` - Zoom changes are handled automatically on a per-origin basis.
+     * Other webContents navigated to the same origin will share the same zoom level.
+     * * `isolated` - Zoom changes are handled automatically but on a per-webContents
+     * basis. This webContents will not be affected by zoom changes in other
+     * webContents, and vice versa.
+     * * `manual` - Automatic zoom handling is disabled. The `zoom-changed` event will
+     * still be dispatched, but the page will not actually be zoomed. The zoom level
+     * can be managed manually by the application.
+     * * `disabled` - All zooming in this webContents is disabled. The webContents will
+     * revert to the default zoom level and all zoom changes will be ignored.
+     *
+     * The `isolated` and `manual` zoom modes persist across navigations.
+     */
+    setZoomMode(mode: 'default' | 'isolated' | 'manual' | 'disabled'): void;
     /**
      * Shows pop-up dictionary that searches the selected word on the page.
      *
@@ -18623,6 +18638,12 @@ declare namespace Electron {
      * respectively. The formula for this is `scale := 1.2 ^ level`.
      */
     zoomLevel: number;
+    /**
+     * A `string` property that determines the zoom mode for this web contents.
+     *
+     * See `contents.setZoomMode` for a description of the available modes.
+     */
+    zoomMode: string;
   }
 
   class WebContentsView extends View {
@@ -19321,6 +19342,11 @@ declare namespace Electron {
      * The default zoom factor of the page, `3.0` represents `300%`. Default is `1.0`.
      */
     zoomFactor?: number;
+    /**
+     * The initial zoom mode for the page. See `contents.setZoomMode` for available
+     * modes. Default is `'default'`.
+     */
+    zoomMode?: string;
   }
 
   class WebRequest {
@@ -19455,6 +19481,147 @@ declare namespace Electron {
     urls: string[];
   }
 
+  class WebSocket extends EventTarget {
+
+    // Docs: https://electronjs.org/docs/api/web-socket
+
+    /**
+     * WebSocket
+     */
+    constructor(url: string, protocols?: (string) | (string[]) | (WebSocketOptions));
+    /**
+     * Closes the connection. Calling `close()` while still `CONNECTING` aborts the
+     * handshake.
+     */
+    close(code?: number, reason?: string): void;
+    /**
+     * Enqueues `data` to be transmitted to the server. Throws an `InvalidStateError`
+     * `DOMException` if `readyState` is `CONNECTING`.
+     */
+    send(data: (string) | (ArrayBufferLike) | (ArrayBufferView) | (Blob)): void;
+    /**
+     * A `string` controlling how incoming binary messages are exposed on the `message`
+     * event. Can be `nodebuffer`, `arraybuffer`, or `blob`. The default is
+     * `nodebuffer`.
+     *
+     * `'nodebuffer'` is an Electron extension that delivers binary messages as
+     * `Buffer` objects, which is generally the most convenient representation in the
+     * main process. Set `binaryType` to `'arraybuffer'` or `'blob'` for behavior
+     * identical to the renderer `WebSocket`.
+     */
+    binaryType: ('nodebuffer' | 'arraybuffer' | 'blob');
+    /**
+     * An `Integer` representing the number of bytes of application data that have been
+     * queued via `send()` but not yet handed off to the network.
+     *
+     */
+    readonly bufferedAmount: number;
+    /**
+     * A `string` containing the extensions negotiated by the server (for example
+     * `permessage-deflate`).
+     *
+     */
+    readonly extensions: string;
+    /**
+     * A `Function | null` event handler for the `close` event. Equivalent to calling
+     * `addEventListener('close', ...)`.
+     */
+    onclose: (Function) | (null);
+    /**
+     * A `Function | null` event handler for the `error` event. Equivalent to calling
+     * `addEventListener('error', ...)`.
+     */
+    onerror: (Function) | (null);
+    /**
+     * A `Function | null` event handler for the `message` event. Equivalent to calling
+     * `addEventListener('message', ...)`.
+     */
+    onmessage: (Function) | (null);
+    /**
+     * A `Function | null` event handler for the `open` event. Equivalent to calling
+     * `addEventListener('open', ...)`.
+     */
+    onopen: (Function) | (null);
+    /**
+     * A `string` containing the subprotocol selected by the server. The empty string
+     * until the connection is open or if the server did not select a subprotocol.
+     *
+     */
+    readonly protocol: string;
+    /**
+     * An `Integer` representing the current state of the connection: one of
+     * `WebSocket.CONNECTING` (`0`), `WebSocket.OPEN` (`1`), `WebSocket.CLOSING` (`2`),
+     * or `WebSocket.CLOSED` (`3`).
+     *
+     */
+    readonly readyState: number;
+    /**
+     * A `string` representing the resolved URL of the connection.
+     *
+     */
+    readonly url: string;
+    /**
+     * An `Integer` constant equal to `3`, the `readyState` value once the connection
+     * is closed.
+     *
+     */
+    static readonly CLOSED: number;
+    /**
+     * An `Integer` constant equal to `2`, the `readyState` value while the closing
+     * handshake is in progress.
+     *
+     */
+    static readonly CLOSING: number;
+    /**
+     * An `Integer` constant equal to `0`, the `readyState` value while the opening
+     * handshake is in progress.
+     *
+     */
+    static readonly CONNECTING: number;
+    /**
+     * An `Integer` constant equal to `1`, the `readyState` value once the connection
+     * is established.
+     *
+     */
+    static readonly OPEN: number;
+  }
+
+  interface WebSocketOptions {
+
+    // Docs: https://electronjs.org/docs/api/structures/web-socket-options
+
+    /**
+     * Extra HTTP headers to send with the opening handshake.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Value of the `Origin` header to send with the opening handshake. Defaults to the
+     * `http(s)` equivalent of the WebSocket URL's origin (e.g. connecting to
+     * `wss://api.example.com` sends `Origin: https://api.example.com`), so that the
+     * connection is treated as same-origin by the server and by SameSite cookie rules.
+     */
+    origin?: string;
+    /**
+     * The name of the `partition` the connection is associated with. Defaults to the
+     * empty string, which corresponds to the default session. If `session` is
+     * provided, `partition` is ignored.
+     */
+    partition?: string;
+    /**
+     * Requested WebSocket subprotocols.
+     */
+    protocols?: (string) | (string[]);
+    /**
+     * The `Session` the connection is associated with.
+     */
+    session?: Session;
+    /**
+     * Whether to send cookies from the session with the opening handshake and store
+     * cookies received in the handshake response. Default is `false`.
+     */
+    useSessionCookies?: boolean;
+  }
+
   interface WebSource {
 
     // Docs: https://electronjs.org/docs/api/structures/web-source
@@ -25121,6 +25288,7 @@ declare namespace Electron {
     type WebAuthnAccount = Electron.WebAuthnAccount;
     type WebPreferences = Electron.WebPreferences;
     type WebRequestFilter = Electron.WebRequestFilter;
+    type WebSocketOptions = Electron.WebSocketOptions;
     type WebSource = Electron.WebSource;
     type WindowOpenHandlerResponse = Electron.WindowOpenHandlerResponse;
     type WindowSessionEndEvent = Electron.WindowSessionEndEvent;
@@ -25209,6 +25377,7 @@ declare namespace Electron {
     const webFrameMain: typeof WebFrameMain;
     type WebFrameMain = Electron.WebFrameMain;
     type WebRequest = Electron.WebRequest;
+    class WebSocket extends Electron.WebSocket {}
     type AboutPanelOptionsOptions = Electron.AboutPanelOptionsOptions;
     type AddRepresentationOptions = Electron.AddRepresentationOptions;
     type AdjustSelectionOptions = Electron.AdjustSelectionOptions;
@@ -25528,6 +25697,7 @@ declare namespace Electron {
     type WebAuthnAccount = Electron.WebAuthnAccount;
     type WebPreferences = Electron.WebPreferences;
     type WebRequestFilter = Electron.WebRequestFilter;
+    type WebSocketOptions = Electron.WebSocketOptions;
     type WebSource = Electron.WebSource;
     type WindowOpenHandlerResponse = Electron.WindowOpenHandlerResponse;
     type WindowSessionEndEvent = Electron.WindowSessionEndEvent;
@@ -25863,6 +26033,7 @@ declare namespace Electron {
     type WebAuthnAccount = Electron.WebAuthnAccount;
     type WebPreferences = Electron.WebPreferences;
     type WebRequestFilter = Electron.WebRequestFilter;
+    type WebSocketOptions = Electron.WebSocketOptions;
     type WebSource = Electron.WebSource;
     type WindowOpenHandlerResponse = Electron.WindowOpenHandlerResponse;
     type WindowSessionEndEvent = Electron.WindowSessionEndEvent;
@@ -26197,6 +26368,7 @@ declare namespace Electron {
     type WebAuthnAccount = Electron.WebAuthnAccount;
     type WebPreferences = Electron.WebPreferences;
     type WebRequestFilter = Electron.WebRequestFilter;
+    type WebSocketOptions = Electron.WebSocketOptions;
     type WebSource = Electron.WebSource;
     type WindowOpenHandlerResponse = Electron.WindowOpenHandlerResponse;
     type WindowSessionEndEvent = Electron.WindowSessionEndEvent;
@@ -26303,6 +26475,7 @@ declare namespace Electron {
     const webFrameMain: typeof WebFrameMain;
     type WebFrameMain = Electron.WebFrameMain;
     type WebRequest = Electron.WebRequest;
+    class WebSocket extends Electron.WebSocket {}
     const webUtils: WebUtils;
     type WebUtils = Electron.WebUtils;
     type WebviewTag = Electron.WebviewTag;
@@ -26625,6 +26798,7 @@ declare namespace Electron {
     type WebAuthnAccount = Electron.WebAuthnAccount;
     type WebPreferences = Electron.WebPreferences;
     type WebRequestFilter = Electron.WebRequestFilter;
+    type WebSocketOptions = Electron.WebSocketOptions;
     type WebSource = Electron.WebSource;
     type WindowOpenHandlerResponse = Electron.WindowOpenHandlerResponse;
     type WindowSessionEndEvent = Electron.WindowSessionEndEvent;

package/dist/version.json

@@ -1,4 +1,4 @@
 {
-  "electronVersion": "43.0.0",
-  "extractedAt": "2026-06-30T18:48:03.690Z"
+  "electronVersion": "44.0.0-alpha.1",
+  "extractedAt": "2026-07-03T00:56:43.673Z"
 }

package/package.json

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