electron-types 42.0.0-beta.6 → 42.0.0-beta.8

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@42.0.0-beta.6
+npm install -D electron-types@42.0.0-beta.8
 # or
-yarn add -D electron-types@42.0.0-beta.6
+yarn add -D electron-types@42.0.0-beta.8
 # or
-pnpm add -D electron-types@42.0.0-beta.6
+pnpm add -D electron-types@42.0.0-beta.8
 ```
 
 ## Usage

package/dist/electron.d.ts

@@ -1,4 +1,4 @@
-// Type definitions for Electron 42.0.0-beta.6
+// Type definitions for Electron 42.0.0-beta.8
 // Project: http://electronjs.org/
 // Definitions by: The Electron Team <https://github.com/electron/electron>
 // Definitions: https://github.com/electron/typescript-definitions
@@ -7046,6 +7046,34 @@ declare namespace Electron {
 
     // Docs: https://electronjs.org/docs/api/content-tracing
 
+    /**
+     * Resolves once heap profiling has been enabled.
+     *
+     * Enable heap profiling for MemoryInfra traces. Equivalent to the `--memlog`
+     * switch in Chrome.
+     *
+     * Only takes effect if the `disabled-by-default-memory-infra` category is
+     * included.
+     *
+     * Needs to be called before `contentTracing.startRecording()`.
+     *
+     * Usage:
+     *
+     * To view the recorded heap dumps:
+     *
+     * * Download the breakpad symbols for your Electron version from the Electron
+     * GitHub releases
+     * * Clone the Electron source code
+     * * In your Chromium checkout for Electron, run this command to symbolicate the
+     * heap dump:
+     * * Open the symbolicated trace in `chrome://tracing` (the Perfetto UI does not
+     * support memory dumps yet)
+     * * Click on one of the `M` symbols
+     * * Click on a `☰` triple bar icon (e.g., in the `malloc` column)
+     *
+     * @experimental
+     */
+    enableHeapProfiling(options?: EnableHeapProfilingOptions): Promise<void>;
     /**
      * resolves with an array of category groups once all child processes have
      * acknowledged the `getCategories` request
@@ -8226,6 +8254,32 @@ declare namespace Electron {
     savePath: string;
   }
 
+  interface EnableHeapProfilingOptions {
+
+    // Docs: https://electronjs.org/docs/api/structures/enable-heap-profiling-options
+
+    /**
+     * Controls which processes are profiled. Equivalent to `--memlog` in Chrome.
+     * Default is `all`.
+     */
+    mode?: ('all' | 'browser' | 'gpu' | 'minimal' | 'renderer-sampling' | 'all-renderers' | 'utility-sampling' | 'all-utilities' | 'utility-and-browser');
+    /**
+     * Controls the sampling interval in bytes. The lower the interval, the more
+     * precise the profile is. However it comes at the cost of performance. Default is
+     * `100000` (100KB). That is enough to observe allocation sites that make
+     * allocations >500KB total, where total equals to a single allocation size times
+     * the number of such allocations at the same call site. Equivalent to
+     * `--memlog-sampling-rate` in Chrome. Must be an integer between `1000` and
+     * `10000000`.
+     */
+    samplingRate?: number;
+    /**
+     * Controls the type of metadata recorded for each allocation. Equivalent to
+     * `--memlog-stack-mode` in Chrome. Default is `native`.
+     */
+    stackMode?: ('native' | 'native-with-thread-names');
+  }
+
   interface Extension {
 
     // Docs: https://electronjs.org/docs/api/structures/extension
@@ -10341,6 +10395,35 @@ declare namespace Electron {
      * Notification
      */
     constructor(options?: NotificationConstructorOptions);
+    /**
+     * Resolves with an array of `Notification` objects representing all delivered
+     * notifications still present in Notification Center.
+     *
+     * Each returned `Notification` is a live object connected to the corresponding
+     * delivered notification. Interaction events (`click`, `reply`, `action`, `close`)
+     * will fire on these objects when the user interacts with the notification in
+     * Notification Center. This is useful after an app restart to re-attach event
+     * handlers to notifications from a previous session.
+     *
+     * The returned notifications have their `id`, `groupId`, `title`, `subtitle`, and
+     * `body` properties populated from information available in the Notification
+     * Center. Other properties (e.g., `actions`, `silent`, `icon`) are not available
+     * from delivered notifications and will have default values.
+     *
+     * > [!NOTE] Like all macOS notification APIs, this method requires the application
+     * to be code-signed. In unsigned development builds, notifications are not
+     * delivered to Notification Center and this method will resolve with an empty
+     * array.
+     *
+     * > [!NOTE] Unlike notifications created with `new Notification()`, notifications
+     * returned by `getHistory()` will remain visible in Notification Center when the
+     * object is garbage collected. Calling `show()` on a restored notification will
+     * remove the original from Notification Center and post a new one with the same
+     * properties.
+     *
+     * @platform darwin
+     */
+    static getHistory(): Promise<Electron.Notification[]>;
     /**
      * Registers a callback to handle all notification activations. The callback is
      * invoked whenever a notification is clicked, replied to, or has an action button
@@ -10390,6 +10473,10 @@ declare namespace Electron {
      *
      * If the notification has been shown before, this method will dismiss the
      * previously shown notification and create a new one with identical properties.
+     *
+     * On macOS, calling `show()` on a notification returned by
+     * `Notification.getHistory()` will remove the original notification from
+     * Notification Center and post a new one with the same properties.
      */
     show(): void;
     /**
@@ -13409,7 +13496,7 @@ declare namespace Electron {
     /**
      * The pixel format of the texture.
      */
-    pixelFormat: ('bgra' | 'rgba' | 'rgbaf16' | 'nv12' | 'p010le');
+    pixelFormat: ('bgra' | 'rgba' | 'rgbaf16' | 'nv12' | 'nv16' | 'p010le');
     /**
      * A timestamp in microseconds that will be reflected to `VideoFrame`.
      */
@@ -20896,6 +20983,8 @@ declare namespace Electron {
     postBody?: PostBody;
     /**
      * Can be `default`, `foreground-tab`, `background-tab`, `new-window` or `other`.
+     * Corresponds to the manner an associated link was clicked. See Chromium's
+     * WindowOpenDisposition.
      */
     disposition: ('default' | 'foreground-tab' | 'background-tab' | 'new-window' | 'other');
   }
@@ -21227,6 +21316,8 @@ declare namespace Electron {
     features: string;
     /**
      * Can be `default`, `foreground-tab`, `background-tab`, `new-window` or `other`.
+     * Corresponds to the manner an associated link was clicked. See Chromium's
+     * WindowOpenDisposition.
      */
     disposition: ('default' | 'foreground-tab' | 'background-tab' | 'new-window' | 'other');
     /**
@@ -24615,6 +24706,7 @@ declare namespace Electron {
     type CustomScheme = Electron.CustomScheme;
     type DesktopCapturerSource = Electron.DesktopCapturerSource;
     type Display = Electron.Display;
+    type EnableHeapProfilingOptions = Electron.EnableHeapProfilingOptions;
     type Extension = Electron.Extension;
     type ExtensionInfo = Electron.ExtensionInfo;
     type FileFilter = Electron.FileFilter;
@@ -25016,6 +25108,7 @@ declare namespace Electron {
     type CustomScheme = Electron.CustomScheme;
     type DesktopCapturerSource = Electron.DesktopCapturerSource;
     type Display = Electron.Display;
+    type EnableHeapProfilingOptions = Electron.EnableHeapProfilingOptions;
     type Extension = Electron.Extension;
     type ExtensionInfo = Electron.ExtensionInfo;
     type FileFilter = Electron.FileFilter;
@@ -25345,6 +25438,7 @@ declare namespace Electron {
     type CustomScheme = Electron.CustomScheme;
     type DesktopCapturerSource = Electron.DesktopCapturerSource;
     type Display = Electron.Display;
+    type EnableHeapProfilingOptions = Electron.EnableHeapProfilingOptions;
     type Extension = Electron.Extension;
     type ExtensionInfo = Electron.ExtensionInfo;
     type FileFilter = Electron.FileFilter;
@@ -25673,6 +25767,7 @@ declare namespace Electron {
     type CustomScheme = Electron.CustomScheme;
     type DesktopCapturerSource = Electron.DesktopCapturerSource;
     type Display = Electron.Display;
+    type EnableHeapProfilingOptions = Electron.EnableHeapProfilingOptions;
     type Extension = Electron.Extension;
     type ExtensionInfo = Electron.ExtensionInfo;
     type FileFilter = Electron.FileFilter;
@@ -26095,6 +26190,7 @@ declare namespace Electron {
     type CustomScheme = Electron.CustomScheme;
     type DesktopCapturerSource = Electron.DesktopCapturerSource;
     type Display = Electron.Display;
+    type EnableHeapProfilingOptions = Electron.EnableHeapProfilingOptions;
     type Extension = Electron.Extension;
     type ExtensionInfo = Electron.ExtensionInfo;
     type FileFilter = Electron.FileFilter;

package/dist/version.json

@@ -1,4 +1,4 @@
 {
-  "electronVersion": "42.0.0-beta.6",
-  "extractedAt": "2026-04-22T00:55:24.867Z"
+  "electronVersion": "42.0.0-beta.8",
+  "extractedAt": "2026-05-01T12:33:04.482Z"
 }

package/package.json

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