@types/chrome 0.1.15 → 0.1.16

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: Tue, 30 Sep 2025 21:32:35 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>;
     }
 
     ////////////////////

chrome/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/chrome",
-    "version": "0.1.15",
+    "version": "0.1.16",
     "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": "3cb748894519c88fdf8bbd53c9b88cde0db71bd0e3a5becf92e9e47bbb21bd6c",
     "typeScriptVersion": "5.2"
 }