@types/chrome 0.1.13 → 0.1.15

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:02:13 GMT
+ * Last updated: Tue, 30 Sep 2025 18:02:49 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>;
     }
 
     ////////////////////
@@ -8627,29 +8566,42 @@ declare namespace chrome {
      * @since Chrome 87
      */
     export namespace search {
-        export type Disposition = "CURRENT_TAB" | "NEW_TAB" | "NEW_WINDOW";
-
-        export interface QueryInfo {
-            /** Location where search results should be displayed. CURRENT_TAB is the default.  */
-            disposition?: Disposition | undefined;
-            /** Location where search results should be displayed. tabIdcannot be used with disposition. */
-            tabId?: number | undefined;
-            /** String to query with the default search provider. */
-            text?: string | undefined;
+        export enum Disposition {
+            /** Specifies that the search results display in the calling tab or the tab from the active browser. */
+            CURRENT_TAB = "CURRENT_TAB",
+            /** Specifies that the search results display in a new tab. */
+            NEW_TAB = "NEW_TAB",
+            /** Specifies that the search results display in a new window. */
+            NEW_WINDOW = "NEW_WINDOW",
         }
 
-        /**
-         * Used to query the default search provider. In case of an error, runtime.lastError will be set.
-         * @param options search configuration options.
-         */
-        export function query(options: QueryInfo, callback: () => void): void;
+        export type QueryInfo =
+            & {
+                /** String to query with the default search provider. */
+                text?: string | undefined;
+            }
+            & (
+                | {
+                    /** Location where search results should be displayed. `CURRENT_TAB` is the default. */
+                    disposition?: `${Disposition}` | undefined;
+                    /** Location where search results should be displayed. `tabId` cannot be used with `disposition`. */
+                    tabId?: undefined;
+                }
+                | {
+                    /** Location where search results should be displayed. `CURRENT_TAB` is the default. */
+                    disposition?: undefined;
+                    /** Location where search results should be displayed. `tabId` cannot be used with `disposition`. */
+                    tabId?: number | undefined;
+                }
+            );
 
         /**
-         * Used to query the default search provider. In case of an error, runtime.lastError will be set.
-         * @param options search configuration options.
-         * @return The `query` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+         * Used to query the default search provider. In case of an error, {@link runtime.lastError} will be set.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function query(options: QueryInfo): Promise<void>;
+        export function query(options: QueryInfo, callback: () => void): void;
     }
 
     ////////////////////

chrome/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/chrome",
-    "version": "0.1.13",
+    "version": "0.1.15",
     "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": "e9a8cff02c9f22c9b5091b4453e8560fb0f276e53c0fda367c1d5ff929553b95",
+    "typesPublisherContentHash": "764f93eaa7f8d4f7669f091cdfd73ad4db83ad84cfed3c9220152a9a35030761",
     "typeScriptVersion": "5.2"
 }