@types/chrome 0.1.15 → 0.1.17

chrome/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for chrome (https://developer.chrome.com/
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome.
 
 ### Additional Details
- * Last updated: Tue, 30 Sep 2025 18:02:49 GMT
+ * Last updated: Wed, 01 Oct 2025 18:39:47 GMT
  * Dependencies: [@types/filesystem](https://npmjs.com/package/@types/filesystem), [@types/har-format](https://npmjs.com/package/@types/har-format)
 
 # Credits

chrome/index.d.ts

@@ -7587,15 +7587,11 @@ declare namespace chrome {
 
         /**
          * Saves the content of the tab with given id as MHTML.
-         * @param callback Called when the MHTML has been generated.
-         * Parameter mhtmlData: The MHTML data as a Blob.
-         */
-        export function saveAsMHTML(details: SaveDetails, callback: (mhtmlData?: Blob) => void): void;
-        /**
-         * Saves the content of the tab with given id as MHTML.
-         * @since Chrome 116 MV3
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 116.
          */
         export function saveAsMHTML(details: SaveDetails): Promise<Blob | undefined>;
+        export function saveAsMHTML(details: SaveDetails, callback: (mhtmlData?: Blob) => void): void;
     }
 
     ////////////////////
@@ -8503,57 +8499,48 @@ declare namespace chrome {
 
         /**
          * Adds an entry to the reading list if it does not exist.
-         * @since Chrome 120, MV3
+         *
+         * Can return its result via Promise.
          * @param entry The entry to add to the reading list.
-         * @param callback
          */
         export function addEntry(entry: AddEntryOptions): Promise<void>;
         export function addEntry(entry: AddEntryOptions, callback: () => void): void;
 
         /**
          * Retrieves all entries that match the `QueryInfo` properties. Properties that are not provided will not be matched.
-         * @since Chrome 120, MV3
+         *
+         * Can return its result via Promise.
          * @param info The properties to search for.
-         * @param callback
          */
         export function query(info: QueryInfo): Promise<ReadingListEntry[]>;
         export function query(info: QueryInfo, callback: (entries: ReadingListEntry[]) => void): void;
 
         /**
          * Removes an entry from the reading list if it exists.
-         * @since Chrome 120, MV3
+         *
+         * Can return its result via Promise.
          * @param info The entry to remove from the reading list.
-         * @param callback
          */
         export function removeEntry(info: RemoveOptions): Promise<void>;
         export function removeEntry(info: RemoveOptions, callback: () => void): void;
 
         /**
          * Updates a reading list entry if it exists.
-         * @since Chrome 120, MV3
+         *
+         * Can return its result via Promise.
          * @param info The entry to update.
-         * @param callback
          */
         export function updateEntry(info: UpdateEntryOptions): Promise<void>;
         export function updateEntry(info: UpdateEntryOptions, callback: () => void): void;
 
-        /**
-         * Triggered when a ReadingListEntry is added to the reading list.
-         * @since Chrome 120, MV3
-         */
-        export const onEntryAdded: chrome.events.Event<(entry: ReadingListEntry) => void>;
+        /** Triggered when a `ReadingListEntry` is added to the reading list. */
+        export const onEntryAdded: events.Event<(entry: ReadingListEntry) => void>;
 
-        /**
-         * Triggered when a ReadingListEntry is removed from the reading list.
-         * @since Chrome 120, MV3
-         */
-        export const onEntryRemoved: chrome.events.Event<(entry: ReadingListEntry) => void>;
+        /** Triggered when a `ReadingListEntry` is removed from the reading list. */
+        export const onEntryRemoved: events.Event<(entry: ReadingListEntry) => void>;
 
-        /**
-         * Triggered when a ReadingListEntry is updated in the reading list.
-         * @since Chrome 120, MV3
-         */
-        export const onEntryUpdated: chrome.events.Event<(entry: ReadingListEntry) => void>;
+        /** Triggered when a `ReadingListEntry` is updated in the reading list. */
+        export const onEntryUpdated: events.Event<(entry: ReadingListEntry) => void>;
     }
 
     ////////////////////
@@ -9738,25 +9725,16 @@ declare namespace chrome {
      */
     export namespace sessions {
         export interface Filter {
-            /**
-             * Optional.
-             * The maximum number of entries to be fetched in the requested list. Omit this parameter to fetch the maximum number of entries (sessions.MAX_SESSION_RESULTS).
-             */
+            /** The maximum number of entries to be fetched in the requested list. Omit this parameter to fetch the maximum number of entries ({@link sessions.MAX_SESSION_RESULTS}). */
             maxResults?: number | undefined;
         }
 
         export interface Session {
             /** The time when the window or tab was closed or modified, represented in seconds since the epoch. */
             lastModified: number;
-            /**
-             * Optional.
-             * The tabs.Tab, if this entry describes a tab. Either this or sessions.Session.window will be set.
-             */
+            /** The {@link tabs.Tab}, if this entry describes a tab. Either this or {@link sessions.Session.window} will be set. */
             tab?: tabs.Tab | undefined;
-            /**
-             * Optional.
-             * The windows.Window, if this entry describes a window. Either this or sessions.Session.tab will be set.
-             */
+            /** The {@link windows.Window}, if this entry describes a window. Either this or {@link sessions.Session.tab} will be set. */
             window?: windows.Window | undefined;
         }
 
@@ -9767,69 +9745,39 @@ declare namespace chrome {
             sessions: Session[];
         }
 
-        export interface SessionChangedEvent extends chrome.events.Event<() => void> {}
-
-        /** The maximum number of sessions.Session that will be included in a requested list. */
-        export var MAX_SESSION_RESULTS: number;
+        /** The maximum number of {@link sessions.Session} that will be included in a requested list. */
+        export const MAX_SESSION_RESULTS: 25;
 
         /**
          * Gets the list of recently closed tabs and/or windows.
-         * @return The `getRecentlyClosed` method provides its result via callback or returned as a `Promise` (MV3 only).
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function getRecentlyClosed(filter?: Filter): Promise<Session[]>;
-        /**
-         * Gets the list of recently closed tabs and/or windows.
-         * @param callback
-         * Parameter sessions: The list of closed entries in reverse order that they were closed (the most recently closed tab or window will be at index 0). The entries may contain either tabs or windows.
-         */
-        export function getRecentlyClosed(filter: Filter, callback: (sessions: Session[]) => void): void;
-        /**
-         * Gets the list of recently closed tabs and/or windows.
-         * @param callback
-         * Parameter sessions: The list of closed entries in reverse order that they were closed (the most recently closed tab or window will be at index 0). The entries may contain either tabs or windows.
-         */
         export function getRecentlyClosed(callback: (sessions: Session[]) => void): void;
+        export function getRecentlyClosed(filter: Filter | undefined, callback: (sessions: Session[]) => void): void;
+
         /**
          * Retrieves all devices with synced sessions.
-         * @return The `getDevices` method provides its result via callback or returned as a `Promise` (MV3 only).
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function getDevices(filter?: Filter): Promise<Device[]>;
-        /**
-         * Retrieves all devices with synced sessions.
-         * @param callback
-         * Parameter devices: The list of sessions.Device objects for each synced session, sorted in order from device with most recently modified session to device with least recently modified session. tabs.Tab objects are sorted by recency in the windows.Window of the sessions.Session objects.
-         */
-        export function getDevices(filter: Filter, callback: (devices: Device[]) => void): void;
-        /**
-         * Retrieves all devices with synced sessions.
-         * @param callback
-         * Parameter devices: The list of sessions.Device objects for each synced session, sorted in order from device with most recently modified session to device with least recently modified session. tabs.Tab objects are sorted by recency in the windows.Window of the sessions.Session objects.
-         */
         export function getDevices(callback: (devices: Device[]) => void): void;
+        export function getDevices(filter: Filter | undefined, callback: (devices: Device[]) => void): void;
+
         /**
-         * Reopens a windows.Window or tabs.Tab.
-         * @param sessionId Optional.
-         * The windows.Window.sessionId, or tabs.Tab.sessionId to restore. If this parameter is not specified, the most recently closed session is restored.
-         * @return The `restore` method provides its result via callback or returned as a `Promise` (MV3 only).
+         * Reopens a {@link windows.Window} or {@link tabs.Tab}, with an optional callback to run when the entry has been restored.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
+         * @param sessionId The {@link windows.Window.sessionId}, or {@link tabs.Tab.sessionId} to restore. If this parameter is not specified, the most recently closed session is restored.
          */
         export function restore(sessionId?: string): Promise<Session>;
-        /**
-         * Reopens a windows.Window or tabs.Tab, with an optional callback to run when the entry has been restored.
-         * @param sessionId Optional.
-         * The windows.Window.sessionId, or tabs.Tab.sessionId to restore. If this parameter is not specified, the most recently closed session is restored.
-         * @param callback Optional.
-         * Parameter restoredSession: A sessions.Session containing the restored windows.Window or tabs.Tab object.
-         */
-        export function restore(sessionId: string, callback: (restoredSession: Session) => void): void;
-        /**
-         * Reopens a windows.Window or tabs.Tab, with an optional callback to run when the entry has been restored.
-         * @param callback Optional.
-         * Parameter restoredSession: A sessions.Session containing the restored windows.Window or tabs.Tab object.
-         */
         export function restore(callback: (restoredSession: Session) => void): void;
+        export function restore(sessionId: string | undefined, callback: (restoredSession: Session) => void): void;
 
         /** Fired when recently closed tabs and/or windows are changed. This event does not monitor synced sessions changes. */
-        export var onChanged: SessionChangedEvent;
+        export const onChanged: events.Event<() => void>;
     }
 
     ////////////////////
@@ -14155,27 +14103,26 @@ declare namespace chrome {
              * If specified, the side panel options for the given tab will be returned.
              * Otherwise, returns the default side panel options (used for any tab that doesn't have specific settings).
              */
-            tabId?: number;
+            tabId?: number | undefined;
         }
 
-        /**
-         * @since Chrome 116
-         */
+        /** @since Chrome 116 */
         export type OpenOptions =
             & {
-                /** The tab in which to open the side panel.
+                /**
+                 * The tab in which to open the side panel.
                  * If the corresponding tab has a tab-specific side panel, the panel will only be open for that tab.
                  * If there is not a tab-specific panel, the global panel will be open in the specified tab and any other tabs without a currently-open tab- specific panel.
                  * This will override any currently-active side panel (global or tab-specific) in the corresponding tab.
-                 * At least one of this and windowId must be provided. */
-                tabId?: number;
+                 * At least one of this and `windowId` must be provided. */
+                tabId?: number | undefined;
                 /**
                  * The window in which to open the side panel.
-                 * This is only applicable if the extension has a global (non-tab-specific) side panel or tabId is also specified.
+                 * This is only applicable if the extension has a global (non-tab-specific) side panel or `tabId` is also specified.
                  * This will override any currently-active global side panel the user has open in the given window.
-                 * At least one of this and tabId must be provided.
+                 * At least one of this and `tabId` must be provided.
                  */
-                windowId?: number;
+                windowId?: number | undefined;
             }
             & ({
                 tabId: number;
@@ -14185,7 +14132,7 @@ declare namespace chrome {
 
         export interface PanelBehavior {
             /** Whether clicking the extension's icon will toggle showing the extension's entry in the side panel. Defaults to false. */
-            openPanelOnActionClick?: boolean;
+            openPanelOnActionClick?: boolean | undefined;
         }
 
         /** @since Chrome 140 */
@@ -14195,15 +14142,15 @@ declare namespace chrome {
 
         export interface PanelOptions {
             /** Whether the side panel should be enabled. This is optional. The default value is true. */
-            enabled?: boolean;
+            enabled?: boolean | undefined;
             /** The path to the side panel HTML file to use. This must be a local resource within the extension package. */
-            path?: string;
+            path?: string | undefined;
             /**
              * If specified, the side panel options will only apply to the tab with this id.
              * If omitted, these options set the default behavior (used for any tab that doesn't have specific settings).
              * Note: if the same path is set for this tabId and the default tabId, then the panel for this tabId will be a different instance than the panel for the default tabId.
              */
-            tabId?: number;
+            tabId?: number | undefined;
         }
 
         /**
@@ -14229,84 +14176,48 @@ declare namespace chrome {
 
         /**
          * Returns the active panel configuration.
-         * Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility.
-         * You cannot use both on the same function call.
-         * The promise resolves with the same type that is passed to the callback.
-         */
-        export function getOptions(
-            /** Specifies the context to return the configuration for. */
-            options: GetPanelOptions,
-            callback: (options: PanelOptions) => void,
-        ): void;
-
-        export function getOptions(
-            /** Specifies the context to return the configuration for. */
-            options: GetPanelOptions,
-        ): Promise<PanelOptions>;
+         *
+         * Can return its result via Promise.
+         * @param options Specifies the context to return the configuration for.
+         */
+        export function getOptions(options: GetPanelOptions): Promise<PanelOptions>;
+        export function getOptions(options: GetPanelOptions, callback: (options: PanelOptions) => void): void;
 
         /**
          * Returns the extension's current side panel behavior.
-         * Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility.
-         * You cannot use both on the same function call.
-         * The promise resolves with the same type that is passed to the callback.
+         *
+         * Can return its result via Promise.
          */
-        export function getPanelBehavior(
-            callback: (behavior: PanelBehavior) => void,
-        ): void;
-
         export function getPanelBehavior(): Promise<PanelBehavior>;
+        export function getPanelBehavior(callback: (behavior: PanelBehavior) => void): void;
 
         /**
-         * @since Chrome 116
          * Opens the side panel for the extension. This may only be called in response to a user action.
-         * Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility.
-         * You cannot use both on the same function call.
-         * The promise resolves with the same type that is passed to the callback.
+         *
+         * Can return its result via Promise.
+         * @param options Specifies the context in which to open the side panel.
+         * @since Chrome 116
          */
-        export function open(
-            /** Specifies the context in which to open the side panel. */
-            options: OpenOptions,
-            callback: () => void,
-        ): void;
-
-        export function open(
-            /** Specifies the context in which to open the side panel. */
-            options: OpenOptions,
-        ): Promise<void>;
+        export function open(options: OpenOptions): Promise<void>;
+        export function open(options: OpenOptions, callback: () => void): void;
 
         /**
          * Configures the side panel.
-         * Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility.
-         * You cannot use both on the same function call.
-         * The promise resolves with the same type that is passed to the callback.
+         *
+         * Can return its result via Promise.
+         * @param options The configuration options to apply to the panel.
          */
-        export function setOptions(
-            /** The configuration options to apply to the panel. */
-            options: PanelOptions,
-            callback: () => void,
-        ): void;
-
-        export function setOptions(
-            /** The configuration options to apply to the panel. */
-            options: PanelOptions,
-        ): Promise<void>;
+        export function setOptions(options: PanelOptions): Promise<void>;
+        export function setOptions(options: PanelOptions, callback: () => void): void;
 
         /**
          * Configures the extension's side panel behavior. This is an upsert operation.
-         * Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility.
-         * You cannot use both on the same function call.
-         * The promise resolves with the same type that is passed to the callback.
+         *
+         * Can return its result via Promise.
+         * @param behavior The new behavior to be set.
          */
-        export function setPanelBehavior(
-            /** The new behavior to be set. */
-            behavior: PanelBehavior,
-            callback: () => void,
-        ): void;
-
-        export function setPanelBehavior(
-            /** The new behavior to be set. */
-            behavior: PanelBehavior,
-        ): Promise<void>;
+        export function setPanelBehavior(behavior: PanelBehavior): Promise<void>;
+        export function setPanelBehavior(behavior: PanelBehavior, callback: () => void): void;
     }
 
     ////////////////////

chrome/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/chrome",
-    "version": "0.1.15",
+    "version": "0.1.17",
     "description": "TypeScript definitions for chrome",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome",
     "license": "MIT",
@@ -94,6 +94,6 @@
         "@types/har-format": "*"
     },
     "peerDependencies": {},
-    "typesPublisherContentHash": "764f93eaa7f8d4f7669f091cdfd73ad4db83ad84cfed3c9220152a9a35030761",
+    "typesPublisherContentHash": "6611bcded842c02d684735a90b3b71391663330da30a91d85cffb859330dabea",
     "typeScriptVersion": "5.2"
 }