@types/chrome 0.1.14 → 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: Mon, 29 Sep 2025 19:32:00 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

@@ -6881,54 +6881,42 @@ declare namespace chrome {
      * Permissions: "management"
      */
     export namespace management {
+        /**
+         * A reason the item is disabled.
+         * @since Chrome 44
+         */
+        export enum ExtensionDisabledReason {
+            UNKNOWN = "unknown",
+            PERMISSIONS_INCREASE = "permissions_increase",
+        }
+
         /** Information about an installed extension, app, or theme. */
         export interface ExtensionInfo {
-            /**
-             * Optional.
-             * A reason the item is disabled.
-             * @since Chrome 17
-             */
-            disabledReason?: string | undefined;
-            /** Optional. The launch url (only present for apps). */
-            appLaunchUrl?: string | undefined;
-            /**
-             * The description of this extension, app, or theme.
-             * @since Chrome 9
-             */
+            /** A reason the item is disabled. */
+            disabledReason?: `${ExtensionDisabledReason}`;
+            /** The launch url (only present for apps). */
+            appLaunchUrl?: string;
+            /** The description of this extension, app, or theme. */
             description: string;
-            /**
-             * Returns a list of API based permissions.
-             * @since Chrome 9
-             */
+            /** Returns a list of API based permissions. */
             permissions: string[];
-            /**
-             * Optional.
-             * A list of icon information. Note that this just reflects what was declared in the manifest, and the actual image at that url may be larger or smaller than what was declared, so you might consider using explicit width and height attributes on img tags referencing these images. See the manifest documentation on icons for more details.
-             */
-            icons?: IconInfo[] | undefined;
-            /**
-             * Returns a list of host based permissions.
-             * @since Chrome 9
-             */
+            /** A list of icon information. Note that this just reflects what was declared in the manifest, and the actual image at that url may be larger or smaller than what was declared, so you might consider using explicit width and height attributes on img tags referencing these images. See the manifest documentation on icons for more details. */
+            icons?: IconInfo[];
+            /** Returns a list of host based permissions. */
             hostPermissions: string[];
             /** Whether it is currently enabled or disabled. */
             enabled: boolean;
-            /**
-             * Optional.
-             * The URL of the homepage of this extension, app, or theme.
-             * @since Chrome 11
-             */
-            homepageUrl?: string | undefined;
-            /**
-             * Whether this extension can be disabled or uninstalled by the user.
-             * @since Chrome 12
-             */
+            /** The URL of the homepage of this extension, app, or theme. */
+            homepageUrl?: string;
+            /** Whether this extension can be disabled or uninstalled by the user. */
             mayDisable: boolean;
             /**
-             * How the extension was installed.
-             * @since Chrome 22
+             * Whether this extension can be enabled by the user. This is only returned for extensions which are not enabled.
+             * @since Chrome 62
              */
-            installType: string;
+            mayEnable?: boolean;
+            /** How the extension was installed. */
+            installType: `${ExtensionInstallType}`;
             /** The version of this extension, app, or theme. */
             version: string;
             /**
@@ -6938,266 +6926,217 @@ declare namespace chrome {
             versionName?: string;
             /** The extension's unique identifier. */
             id: string;
-            /**
-             * Whether the extension, app, or theme declares that it supports offline.
-             * @since Chrome 15
-             */
+            /** Whether the extension, app, or theme declares that it supports offline. */
             offlineEnabled: boolean;
-            /**
-             * Optional.
-             * The update URL of this extension, app, or theme.
-             * @since Chrome 16
-             */
-            updateUrl?: string | undefined;
-            /**
-             * The type of this extension, app, or theme.
-             * @since Chrome 23
-             */
-            type: string;
+            /** The update URL of this extension, app, or theme. */
+            updateUrl?: string;
+            /** The type of this extension, app, or theme. */
+            type: `${ExtensionType}`;
             /** The url for the item's options page, if it has one. */
             optionsUrl: string;
             /** The name of this extension, app, or theme. */
             name: string;
-            /**
-             * A short version of the name of this extension, app, or theme.
-             * @since Chrome 31
-             */
+            /** A short version of the name of this extension, app, or theme. */
             shortName: string;
             /**
              * True if this is an app.
-             * @deprecated since Chrome 33. Please use management.ExtensionInfo.type.
+             * @deprecated since Chrome 33. Please use {@link management.ExtensionInfo.type}.
              */
             isApp: boolean;
-            /**
-             * Optional.
-             * The app launch type (only present for apps).
-             * @since Chrome 37
-             */
-            launchType?: string | undefined;
-            /**
-             * Optional.
-             * The currently available launch types (only present for apps).
-             * @since Chrome 37
-             */
-            availableLaunchTypes?: string[] | undefined;
+            /** The app launch type (only present for apps). */
+            launchType?: `${LaunchType}`;
+            /** The currently available launch types (only present for apps). */
+            availableLaunchTypes?: `${LaunchType}`[];
+        }
+
+        /**
+         * How the extension was installed
+         * @since Chrome 44
+         */
+        export enum ExtensionInstallType {
+            /** The extension was installed because of an administrative policy. */
+            ADMIN = "admin",
+            /** The extension was loaded unpacked in developer mode. */
+            DEVELOPMENT = "development",
+            /** The extension was installed normally via a .crx file. */
+            NORMAL = "normal",
+            /** The extension was installed by other software on the machine. */
+            SIDELOAD = "sideload",
+            /** The extension was installed by other means. */
+            OTHER = "other",
+        }
+
+        /**
+         * The type of this extension, app, or theme.
+         * @since Chrome 44
+         */
+        export enum ExtensionType {
+            EXTENSION = "extension",
+            HOSTED_APP = "hosted_app",
+            PACKAGE_APP = "package_app",
+            LEGACY_PACKAGED_APP = "legacy_packaged_app",
+            THEME = "theme",
+            LOGIN_SCREEN_EXTENSION = "login_screen_extension",
         }
 
         /** Information about an icon belonging to an extension, app, or theme. */
         export interface IconInfo {
-            /** The URL for this icon image. To display a grayscale version of the icon (to indicate that an extension is disabled, for example), append ?grayscale=true to the URL. */
+            /** The URL for this icon image. To display a grayscale version of the icon (to indicate that an extension is disabled, for example), append `?grayscale=true` to the URL. */
             url: string;
             /** A number representing the width and height of the icon. Likely values include (but are not limited to) 128, 48, 24, and 16. */
             size: number;
         }
 
+        /** These are all possible app launch types. */
+        export enum LaunchType {
+            OPEN_AS_REGULAR_TAB = "OPEN_AS_REGULAR_TAB",
+            OPEN_AS_PINNED_TAB = "OPEN_AS_PINNED_TAB",
+            OPEN_AS_WINDOW = "OPEN_AS_WINDOW",
+            OPEN_FULL_SCREEN = "OPEN_FULL_SCREEN",
+        }
+
+        /**
+         * Options for how to handle the extension's uninstallation.
+         * @since Chrome 88
+         */
         export interface UninstallOptions {
-            /**
-             * Optional.
-             * Whether or not a confirm-uninstall dialog should prompt the user. Defaults to false for self uninstalls. If an extension uninstalls another extension, this parameter is ignored and the dialog is always shown.
-             */
+            /** Whether or not a confirm-uninstall dialog should prompt the user. Defaults to false for self uninstalls. If an extension uninstalls another extension, this parameter is ignored and the dialog is always shown. */
             showConfirmDialog?: boolean | undefined;
         }
 
-        export interface ManagementDisabledEvent extends chrome.events.Event<(info: ExtensionInfo) => void> {}
-
-        export interface ManagementUninstalledEvent extends chrome.events.Event<(id: string) => void> {}
-
-        export interface ManagementInstalledEvent extends chrome.events.Event<(info: ExtensionInfo) => void> {}
-
-        export interface ManagementEnabledEvent extends chrome.events.Event<(info: ExtensionInfo) => void> {}
-
         /**
-         * Enables or disables an app or extension.
-         * @param id This should be the id from an item of management.ExtensionInfo.
+         * Enables or disables an app or extension. In most cases this function must be called in the context of a user gesture (e.g. an onclick handler for a button), and may present the user with a native confirmation UI as a way of preventing abuse.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 88.
+         * @param id This should be the id from an item of {@link management.ExtensionInfo}.
          * @param enabled Whether this item should be enabled or disabled.
-         * @return The `setEnabled` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
          */
         export function setEnabled(id: string, enabled: boolean): Promise<void>;
-        /**
-         * Enables or disables an app or extension.
-         * @param id This should be the id from an item of management.ExtensionInfo.
-         * @param enabled Whether this item should be enabled or disabled.
-         */
         export function setEnabled(id: string, enabled: boolean, callback: () => void): void;
+
         /**
          * Returns a list of permission warnings for the given extension id.
-         * @since Chrome 15
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 88.
          * @param id The ID of an already installed extension.
-         * @return The `getPermissionWarningsById` method provides its result via callback or returned as a `Promise` (MV3 only).
          */
         export function getPermissionWarningsById(id: string): Promise<string[]>;
-        /**
-         * Returns a list of permission warnings for the given extension id.
-         * @since Chrome 15
-         * @param id The ID of an already installed extension.
-         */
         export function getPermissionWarningsById(id: string, callback: (permissionWarnings: string[]) => void): void;
+
         /**
          * Returns information about the installed extension, app, or theme that has the given ID.
-         * @since Chrome 9
-         * @param id The ID from an item of management.ExtensionInfo.
-         * @return The `get` 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 88.
+         * @param id The ID from an item of {@link management.ExtensionInfo}.
          */
         export function get(id: string): Promise<ExtensionInfo>;
-        /**
-         * Returns information about the installed extension, app, or theme that has the given ID.
-         * @since Chrome 9
-         * @param id The ID from an item of management.ExtensionInfo.
-         */
         export function get(id: string, callback: (result: ExtensionInfo) => void): void;
+
         /**
          * Returns a list of information about installed extensions and apps.
-         * @return The `getAll` 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 88.
          */
         export function getAll(): Promise<ExtensionInfo[]>;
-        /**
-         * Returns a list of information about installed extensions and apps.
-         */
         export function getAll(callback: (result: ExtensionInfo[]) => void): void;
+
         /**
          * Returns a list of permission warnings for the given extension manifest string. Note: This function can be used without requesting the 'management' permission in the manifest.
-         * @since Chrome 15
-         * @param manifestStr Extension manifest JSON string.
-         * @return The `getPermissionWarningsByManifest` method provides its result via callback or returned as a `Promise` (MV3 only).
-         */
-        export function getPermissionWarningsByManifest(
-            manifestStr: string,
-        ): Promise<string[]>;
-        /**
-         * Returns a list of permission warnings for the given extension manifest string. Note: This function can be used without requesting the 'management' permission in the manifest.
-         * @since Chrome 15
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 88.
          * @param manifestStr Extension manifest JSON string.
          */
+        export function getPermissionWarningsByManifest(manifestStr: string): Promise<string[]>;
         export function getPermissionWarningsByManifest(
             manifestStr: string,
-            callback: (permissionwarnings: string[]) => void,
+            callback: (permissionWarnings: string[]) => void,
         ): void;
+
         /**
          * Launches an application.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 88.
          * @param id The extension id of the application.
-         * @return The `launchApp` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
          */
         export function launchApp(id: string): Promise<void>;
-        /**
-         * Launches an application.
-         * @param id The extension id of the application.
-         */
         export function launchApp(id: string, callback: () => void): void;
+
         /**
-         * Uninstalls a currently installed app or extension.
-         * @since Chrome 21
-         * @param id This should be the id from an item of management.ExtensionInfo.
-         * @return The `uninstall` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+         * Uninstalls a currently installed app or extension. Note: This function does not work in managed environments when the user is not allowed to uninstall the specified extension/app. If the uninstall fails (e.g. the user cancels the dialog) the promise will be rejected or the callback will be called with {@link runtime.lastError} set.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 88.
+         * @param id This should be the id from an item of {@link management.ExtensionInfo}.
          */
         export function uninstall(id: string, options?: UninstallOptions): Promise<void>;
-        /**
-         * Uninstalls a currently installed app or extension.
-         * @since Chrome 21
-         * @param id This should be the id from an item of management.ExtensionInfo.
-         */
-        export function uninstall(id: string, callback: () => void): void;
-        export function uninstall(id: string, options: UninstallOptions, callback: () => void): void;
-        /**
-         * Uninstalls a currently installed app or extension.
-         * @deprecated since Chrome 21. The options parameter was added to this function.
-         * @param id This should be the id from an item of management.ExtensionInfo.
-         * @return The `uninstall` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
-         */
-        export function uninstall(id: string): Promise<void>;
-        /**
-         * Uninstalls a currently installed app or extension.
-         * @deprecated since Chrome 21. The options parameter was added to this function.
-         * @param id This should be the id from an item of management.ExtensionInfo.
-         */
         export function uninstall(id: string, callback: () => void): void;
+        export function uninstall(id: string, options: UninstallOptions | undefined, callback: () => void): void;
+
         /**
          * Returns information about the calling extension, app, or theme. Note: This function can be used without requesting the 'management' permission in the manifest.
-         * @since Chrome 39
-         * @return The `getSelf` 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 88.
          */
         export function getSelf(): Promise<ExtensionInfo>;
-        /**
-         * Returns information about the calling extension, app, or theme. Note: This function can be used without requesting the 'management' permission in the manifest.
-         * @since Chrome 39
-         */
         export function getSelf(callback: (result: ExtensionInfo) => void): void;
+
         /**
-         * Uninstalls the calling extension.
-         * Note: This function can be used without requesting the 'management' permission in the manifest.
-         * @since Chrome 26
-         * @return The `uninstallSelf` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
-         */
-        export function uninstallSelf(options?: UninstallOptions): Promise<void>;
-        /**
-         * Uninstalls the calling extension.
-         * Note: This function can be used without requesting the 'management' permission in the manifest.
-         * @since Chrome 26
-         */
-        export function uninstallSelf(callback: () => void): void;
-        export function uninstallSelf(options: UninstallOptions, callback: () => void): void;
-        /**
-         * Uninstalls the calling extension.
-         * Note: This function can be used without requesting the 'management' permission in the manifest.
-         * @since Chrome 26
-         * @return The `uninstallSelf` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+         * Launches the replacement_web_app specified in the manifest. Prompts the user to install if not already installed.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 88.
+         * @since Chrome 77
          */
-        export function uninstallSelf(): Promise<void>;
+        export function installReplacementWebApp(): Promise<void>;
+        export function installReplacementWebApp(callback: () => void): void;
+
         /**
-         * Uninstalls the calling extension.
-         * Note: This function can be used without requesting the 'management' permission in the manifest.
-         * @since Chrome 26
+         * Uninstalls the calling extension. Note: This function can be used without requesting the 'management' permission in the manifest. This function does not work in managed environments when the user is not allowed to uninstall the specified extension/app.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 88.
          */
+        export function uninstallSelf(options?: UninstallOptions): Promise<void>;
         export function uninstallSelf(callback: () => void): void;
+        export function uninstallSelf(options: UninstallOptions | undefined, callback: () => void): void;
+
         /**
          * Display options to create shortcuts for an app. On Mac, only packaged app shortcuts can be created.
-         * @since Chrome 37
-         * @return The `createAppShortcut` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 88.
+         * @param id This should be the id from an app item of {@link management.ExtensionInfo}.
          */
         export function createAppShortcut(id: string): Promise<void>;
-        /**
-         * Display options to create shortcuts for an app. On Mac, only packaged app shortcuts can be created.
-         * @since Chrome 37
-         */
         export function createAppShortcut(id: string, callback: () => void): void;
+
         /**
          * Set the launch type of an app.
-         * @since Chrome 37
-         * @param id This should be the id from an app item of management.ExtensionInfo.
-         * @param launchType The target launch type. Always check and make sure this launch type is in ExtensionInfo.availableLaunchTypes, because the available launch types vary on different platforms and configurations.
-         * @return The `setLaunchType` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
-         */
-        export function setLaunchType(id: string, launchType: string): Promise<void>;
-        /**
-         * Set the launch type of an app.
-         * @since Chrome 37
-         * @param id This should be the id from an app item of management.ExtensionInfo.
-         * @param launchType The target launch type. Always check and make sure this launch type is in ExtensionInfo.availableLaunchTypes, because the available launch types vary on different platforms and configurations.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 88.
+         * @param id This should be the id from an app item of {@link management.ExtensionInfo}.
+         * @param launchType The target launch type. Always check and make sure this launch type is in {@link ExtensionInfo.availableLaunchTypes}, because the available launch types vary on different platforms and configurations.
          */
-        export function setLaunchType(id: string, launchType: string, callback: () => void): void;
+        export function setLaunchType(id: string, launchType: `${LaunchType}`): Promise<void>;
+        export function setLaunchType(id: string, launchType: `${LaunchType}`, callback: () => void): void;
+
         /**
          * Generate an app for a URL. Returns the generated bookmark app.
-         * @since Chrome 37
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 88.
          * @param url The URL of a web page. The scheme of the URL can only be "http" or "https".
          * @param title The title of the generated app.
-         * @return The `generateAppForLink` method provides its result via callback or returned as a `Promise` (MV3 only).
          */
         export function generateAppForLink(url: string, title: string): Promise<ExtensionInfo>;
-        /**
-         * Generate an app for a URL. Returns the generated bookmark app.
-         * @since Chrome 37
-         * @param url The URL of a web page. The scheme of the URL can only be "http" or "https".
-         * @param title The title of the generated app.
-         */
         export function generateAppForLink(url: string, title: string, callback: (result: ExtensionInfo) => void): void;
 
         /** Fired when an app or extension has been disabled. */
-        export var onDisabled: ManagementDisabledEvent;
+        export const onDisabled: events.Event<(info: ExtensionInfo) => void>;
+
         /** Fired when an app or extension has been uninstalled. */
-        export var onUninstalled: ManagementUninstalledEvent;
+        export const onUninstalled: events.Event<(id: string) => void>;
+
         /** Fired when an app or extension has been installed. */
-        export var onInstalled: ManagementInstalledEvent;
+        export const onInstalled: events.Event<(info: ExtensionInfo) => void>;
+
         /** Fired when an app or extension has been enabled. */
-        export var onEnabled: ManagementEnabledEvent;
+        export const onEnabled: events.Event<(info: ExtensionInfo) => void>;
     }
 
     ////////////////////
@@ -7648,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;
     }
 
     ////////////////////
@@ -8564,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>;
     }
 
     ////////////////////
@@ -9799,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;
         }
 
@@ -9828,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.14",
+    "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": "2a0e1ced978ad35915b1c262da583e4f3dd9cc4aaa598935e14ee906b8038e3a",
+    "typesPublisherContentHash": "3cb748894519c88fdf8bbd53c9b88cde0db71bd0e3a5becf92e9e47bbb21bd6c",
     "typeScriptVersion": "5.2"
 }