@types/chrome 0.1.28 → 0.1.30

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, 11 Nov 2025 22:02:08 GMT
+ * Last updated: Mon, 17 Nov 2025 22:35:44 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

@@ -2524,6 +2524,7 @@ declare namespace chrome {
         }
 
         /** Declarative event action that redirects a network request to an empty document. */
+        // eslint-disable-next-line @typescript-eslint/no-empty-interface
         export interface RedirectToEmptyDocument {}
 
         /** Declarative event action that redirects a network request. */
@@ -2566,6 +2567,7 @@ declare namespace chrome {
         }
 
         /** Declarative event action that cancels a network request. */
+        // eslint-disable-next-line @typescript-eslint/no-empty-interface
         export interface CancelRequest {}
 
         /** Removes the request header of the specified name. Do not use SetRequestHeader and RemoveRequestHeader with the same header name on the same request. Each request header name occurs only once in each request. */
@@ -2633,6 +2635,7 @@ declare namespace chrome {
         }
 
         /** Declarative event action that redirects a network request to a transparent image. */
+        // eslint-disable-next-line @typescript-eslint/no-empty-interface
         export interface RedirectToTransparentImage {}
 
         /** Adds a cookie to the request or overrides a cookie, in case another cookie of the same name exists already. Note that it is preferred to use the Cookies API because this is computationally less expensive. */
@@ -3015,6 +3018,12 @@ declare namespace chrome {
             onHidden: events.Event<() => void>;
         }
 
+        /**
+         * Theme used by DevTools.
+         * @since Chrome 99
+         */
+        export type Theme = "default" | "dark";
+
         /** Elements panel. */
         export const elements: ElementsPanel;
 
@@ -3047,6 +3056,12 @@ declare namespace chrome {
             ) => void,
         ): void;
 
+        /**
+         * Specifies the function to be called when the current theme changes in DevTools. To unset the handler, either call the method with no parameters or pass `null` as the parameter.
+         * @since Chrome 99
+         */
+        export function setThemeChangeHandler(callback?: (theme: Theme) => void): void;
+
         /**
          * Requests DevTools to open a URL in a Developer Tools panel.
          * @param url The URL of the resource to open.
@@ -3065,7 +3080,7 @@ declare namespace chrome {
          * The name of the color theme set in user's DevTools settings.
          * @since Chrome 59
          */
-        export const themeName: "default" | "dark";
+        export const themeName: Theme;
     }
 
     ////////////////////
@@ -3743,6 +3758,7 @@ declare namespace chrome {
             SAFE = "safe",
             /** The user has accepted the dangerous download. */
             ACCEPTED = "accepted",
+            /** Enterprise-related values. */
             ALLOWLISTED_BY_POLICY = "allowlistedByPolicy",
             ASYNC_SCANNING = "asyncScanning",
             ASYNC_LOCAL_PASSWORD_SCANNING = "asyncLocalPasswordScanning",
@@ -3757,6 +3773,8 @@ declare namespace chrome {
             PROMPT_FOR_LOCAL_PASSWORD_SCANNING = "promptForLocalPasswordScanning",
             ACCOUNT_COMPROMISE = "accountCompromise",
             BLOCKED_SCAN_FAILED = "blockedScanFailed",
+            /** For use by the Secure Enterprise Browser extension. When required, Chrome will block the download to disc and download the file directly to Google Drive. */
+            FORCE_SAVE_TO_GDRIVE = "forceSaveToGdrive",
         }
 
         export interface DownloadItem {
@@ -10025,209 +10043,157 @@ declare namespace chrome {
         export interface StorageArea {
             /**
              * Gets the amount of space (in bytes) being used by one or more items.
-             * @param keys Optional. A single key or list of keys to get the total usage for. An empty list will return 0. Pass in null to get the total usage of all of storage.
-             * @return A Promise that resolves with a number
-             * @since MV3
+             * @param keys A single key or list of keys to get the total usage for. An empty list will return 0. Pass in `null` to get the total usage of all of storage.
+             *
+             * Can return its result via Promise in Manifest V3 or later since Chrome 95.
              */
+            getBytesInUse(keys: never[]): Promise<0>;
             getBytesInUse<T = { [key: string]: any }>(keys?: keyof T | Array<keyof T> | null): Promise<number>;
-            /**
-             * Gets the amount of space (in bytes) being used by one or more items.
-             * @param keys Optional. A single key or list of keys to get the total usage for. An empty list will return 0. Pass in null to get the total usage of all of storage.
-             * @param callback Callback with the amount of space being used by storage, or on failure (in which case runtime.lastError will be set).
-             * Parameter bytesInUse: Amount of space being used in storage, in bytes.
-             */
+            getBytesInUse<T = { [key: string]: any }>(callback: (bytesInUse: number) => void): void;
+            getBytesInUse(keys: never[], callback: (bytesInUse: 0) => void): void;
             getBytesInUse<T = { [key: string]: any }>(
-                keys: keyof T | Array<keyof T> | null,
+                keys: keyof T | Array<keyof T> | null | undefined,
                 callback: (bytesInUse: number) => void,
             ): void;
-            /**
-             * Gets the amount of space (in bytes) being used by one or more items.
-             * @param callback Callback with the amount of space being used by storage, or on failure (in which case runtime.lastError will be set).
-             * Parameter bytesInUse: Amount of space being used in storage, in bytes.
-             */
-            getBytesInUse(callback: (bytesInUse: number) => void): void;
+
             /**
              * Removes all items from storage.
-             * @return A void Promise
-             * @since MV3
+             *
+             * Can return its result via Promise in Manifest V3 or later since Chrome 95.
              */
             clear(): Promise<void>;
-            /**
-             * Removes all items from storage.
-             * @param callback Optional.
-             * Callback on success, or on failure (in which case runtime.lastError will be set).
-             */
             clear(callback: () => void): void;
+
             /**
              * Sets multiple items.
-             * @param items An object which gives each key/value pair to update storage with. Any other key/value pairs in storage will not be affected.
-             * Primitive values such as numbers will serialize as expected. Values with a typeof "object" and "function" will typically serialize to {}, with the exception of Array (serializes as expected), Date, and Regex (serialize using their String representation).
-             * @return A void Promise
-             * @since MV3
+             * @param items An object which gives each key/value pair to update storage with. Any other key/value pairs in storage will not be affected. Primitive values such as numbers will serialize as expected. Values with a `typeof` `object` and `function` will typically serialize to `{}`, with the exception of `Array` (serializes as expected), `Date`, and `Regex` (serialize using their `String` representation).
+             *
+             * Can return its result via Promise in Manifest V3 or later since Chrome 95.
              */
             set<T = { [key: string]: any }>(items: Partial<T>): Promise<void>;
-            /**
-             * Sets multiple items.
-             * @param items An object which gives each key/value pair to update storage with. Any other key/value pairs in storage will not be affected.
-             * Primitive values such as numbers will serialize as expected. Values with a typeof "object" and "function" will typically serialize to {}, with the exception of Array (serializes as expected), Date, and Regex (serialize using their String representation).
-             * @param callback Optional.
-             * Callback on success, or on failure (in which case runtime.lastError will be set).
-             */
             set<T = { [key: string]: any }>(items: Partial<T>, callback: () => void): void;
+
             /**
              * Removes one or more items from storage.
              * @param keys A single key or a list of keys for items to remove.
-             * @param callback Optional.
-             * @return A void Promise
-             * @since MV3
+             *
+             * Can return its result via Promise in Manifest V3 or later since Chrome 95.
              */
             remove<T = { [key: string]: any }>(keys: keyof T | Array<keyof T>): Promise<void>;
-            /**
-             * Removes one or more items from storage.
-             * @param keys A single key or a list of keys for items to remove.
-             * @param callback Optional.
-             * Callback on success, or on failure (in which case runtime.lastError will be set).
-             */
             remove<T = { [key: string]: any }>(keys: keyof T | Array<keyof T>, callback: () => void): void;
+
             /**
              * Gets one or more items from storage.
-             * @param keys A single key to get, list of keys to get, or a dictionary specifying default values.
-             * An empty list or object will return an empty result object. Pass in null to get the entire contents of storage.
-             * @return A Promise that resolves with an object containing items
-             * @since MV3
+             * @param keys A single key to get, list of keys to get, or a dictionary specifying default values (see description of the object). An empty list or object will return an empty result object. Pass in `null` to get the entire contents of storage.
+             *
+             * Can return its result via Promise in Manifest V3 or later since Chrome 95.
              */
-            get<T = { [key: string]: any }>(
+            get(keys: never[] | Record<string, never>): Promise<{ [key: string]: never }>;
+            get<T = { [key: string]: unknown }>(
                 keys?: NoInferX<keyof T> | Array<NoInferX<keyof T>> | Partial<NoInferX<T>> | null,
             ): Promise<T>;
-            /**
-             * Gets one or more items from storage.
-             * @param keys A single key to get, list of keys to get, or a dictionary specifying default values.
-             * An empty list or object will return an empty result object. Pass in null to get the entire contents of storage.
-             * @param callback Callback with storage items, or on failure (in which case runtime.lastError will be set).
-             * Parameter items: Object with items in their key-value mappings.
-             */
-            get<T = { [key: string]: any }>(
-                keys: NoInferX<keyof T> | Array<NoInferX<keyof T>> | Partial<NoInferX<T>> | null,
+            get<T = { [key: string]: unknown }>(callback: (items: T) => void): void;
+            get(keys: never[] | Record<string, never>, callback: (items: { [key: string]: never }) => void): void;
+            get<T = { [key: string]: unknown }>(
+                keys: NoInferX<keyof T> | Array<NoInferX<keyof T>> | Partial<NoInferX<T>> | null | undefined,
                 callback: (items: T) => void,
             ): void;
+
             /**
-             * Gets the entire contents of storage.
-             * @param callback Callback with storage items, or on failure (in which case runtime.lastError will be set).
-             * Parameter items: Object with items in their key-value mappings.
-             */
-            get<T = { [key: string]: any }>(callback: (items: T) => void): void;
-            /**
-             * Sets the desired access level for the storage area. By default, session storage is restricted to trusted contexts (extension pages and service workers), while managed, local, and sync storage allow access from both trusted and untrusted contexts.
-             * @param accessOptions An object containing an accessLevel key which contains the access level of the storage area.
-             * @return A void Promise.
-             * @since Chrome 102
-             */
-            setAccessLevel(accessOptions: { accessLevel: AccessLevel }): Promise<void>;
-            /**
-             * Sets the desired access level for the storage area. By default, session storage is restricted to trusted contexts (extension pages and service workers), while managed, local, and sync storage allow access from both trusted and untrusted contexts.
-             * @param accessOptions An object containing an accessLevel key which contains the access level of the storage area.
-             * @param callback Optional.
+             * Sets the desired access level for the storage area. By default, session storage is restricted to trusted contexts (extension pages and service workers), while `managed`, `local`, and `sync` storage allow access from both trusted and untrusted contexts.
+             * @param accessOptions The access level of the storage area.
+             *
+             * Can return its result via Promise in Manifest V3 or later.
              * @since Chrome 102
              */
-            setAccessLevel(accessOptions: { accessLevel: AccessLevel }, callback: () => void): void;
-            /**
-             * Fired when one or more items change within this storage area.
-             * @param keys A single key to get, list of keys to get, or a dictionary specifying default values.
-             * An empty list or object will return an empty result object. Pass in null to get the entire contents of storage.
-             * @param callback Callback with storage items, or on failure (in which case runtime.lastError will be set).
-             * Parameter items: Object with items in their key-value mappings.
-             */
-            onChanged: StorageAreaChangedEvent;
+            setAccessLevel(accessOptions: { accessLevel: `${AccessLevel}` }): Promise<void>;
+            setAccessLevel(accessOptions: { accessLevel: `${AccessLevel}` }, callback: () => void): void;
+
+            /** Fired when one or more items change. */
+            onChanged: events.Event<(changes: { [key: string]: StorageChange }) => void>;
+
             /**
              * Gets all keys from storage.
-             * @return A Promise that resolves with an array of keys.
+             *
+             * Can return its result via Promise in Manifest V3 or later.
              * @since Chrome 130
              */
             getKeys(): Promise<string[]>;
-            /**
-             * Gets all keys from storage.
-             * @param callback Callback with storage keys.
-             * Parameter keys: Array of keys in storage.
-             * @since Chrome 130
-             */
             getKeys(callback: (keys: string[]) => void): void;
         }
 
         export interface StorageChange {
-            /** Optional. The new value of the item, if there is a new value. */
-            newValue?: any;
-            /** Optional. The old value of the item, if there was an old value. */
-            oldValue?: any;
+            /** The new value of the item, if there is a new value. */
+            newValue?: unknown;
+            /** The old value of the item, if there was an old value. */
+            oldValue?: unknown;
         }
 
         export interface LocalStorageArea extends StorageArea {
-            /** The maximum amount (in bytes) of data that can be stored in local storage, as measured by the JSON stringification of every value plus every key's length. This value will be ignored if the extension has the unlimitedStorage permission. Updates that would cause this limit to be exceeded fail immediately and set runtime.lastError. */
-            QUOTA_BYTES: number;
+            /** The maximum amount (in bytes) of data that can be stored in local storage, as measured by the JSON stringification of every value plus every key's length. This value will be ignored if the extension has the unlimitedStorage permission. Updates that would cause this limit to be exceeded fail immediately and set runtime.lastError when using a callback, or a rejected Promise if using async/await. */
+            QUOTA_BYTES: 10485760;
         }
 
         export interface SyncStorageArea extends StorageArea {
-            /** @deprecated since Chrome 40. The storage.sync API no longer has a sustained write operation quota. */
-            MAX_SUSTAINED_WRITE_OPERATIONS_PER_MINUTE: number;
-            /** The maximum total amount (in bytes) of data that can be stored in sync storage, as measured by the JSON stringification of every value plus every key's length. Updates that would cause this limit to be exceeded fail immediately and set runtime.lastError. */
-            QUOTA_BYTES: number;
-            /** The maximum size (in bytes) of each individual item in sync storage, as measured by the JSON stringification of its value plus its key length. Updates containing items larger than this limit will fail immediately and set runtime.lastError. */
-            QUOTA_BYTES_PER_ITEM: number;
-            /** The maximum number of items that can be stored in sync storage. Updates that would cause this limit to be exceeded will fail immediately and set runtime.lastError. */
-            MAX_ITEMS: number;
-            /**
-             * The maximum number of set, remove, or clear operations that can be performed each hour. This is 1 every 2 seconds, a lower ceiling than the short term higher writes-per-minute limit.
-             * Updates that would cause this limit to be exceeded fail immediately and set runtime.lastError.
+            /** @deprecated The storage.sync API no longer has a sustained write operation quota. */
+            MAX_SUSTAINED_WRITE_OPERATIONS_PER_MINUTE: 1000000;
+            /** The maximum total amount (in bytes) of data that can be stored in sync storage, as measured by the JSON stringification of every value plus every key's length. Updates that would cause this limit to be exceeded fail immediately and set runtime.lastError when using a callback, or when a Promise is rejected. */
+            QUOTA_BYTES: 102400;
+            /** The maximum size (in bytes) of each individual item in sync storage, as measured by the JSON stringification of its value plus its key length. Updates containing items larger than this limit will fail immediately and set runtime.lastError when using a callback, or when a Promise is rejected. */
+            QUOTA_BYTES_PER_ITEM: 8192;
+            /** The maximum number of items that can be stored in sync storage. Updates that would cause this limit to be exceeded will fail immediately and set runtime.lastError when using a callback, or when a Promise is rejected. */
+            MAX_ITEMS: 512;
+            /**
+             * The maximum number of `set`, `remove`, or `clear` operations that can be performed each hour. This is 1 every 2 seconds, a lower ceiling than the short term higher writes-per-minute limit.
+             *
+             * Updates that would cause this limit to be exceeded fail immediately and set runtime.lastError when using a callback, or when a Promise is rejected.
              */
-            MAX_WRITE_OPERATIONS_PER_HOUR: number;
+            MAX_WRITE_OPERATIONS_PER_HOUR: 1800;
             /**
-             * The maximum number of set, remove, or clear operations that can be performed each minute. This is 2 per second, providing higher throughput than writes-per-hour over a shorter period of time.
-             * Updates that would cause this limit to be exceeded fail immediately and set runtime.lastError.
-             * @since Chrome 40
+             * The maximum number of `set`, `remove`, or `clear` operations that can be performed each minute. This is 2 per second, providing higher throughput than writes-per-hour over a shorter period of time.
+             *
+             * Updates that would cause this limit to be exceeded fail immediately and set runtime.lastError when using a callback, or when a Promise is rejected.
              */
-            MAX_WRITE_OPERATIONS_PER_MINUTE: number;
+            MAX_WRITE_OPERATIONS_PER_MINUTE: 120;
         }
 
         export interface SessionStorageArea extends StorageArea {
-            /** The maximum amount (in bytes) of data that can be stored in memory, as measured by estimating the dynamically allocated memory usage of every value and key. Updates that would cause this limit to be exceeded fail immediately and set runtime.lastError. */
-            QUOTA_BYTES: number;
+            /** The maximum amount (in bytes) of data that can be stored in memory, as measured by estimating the dynamically allocated memory usage of every value and key. Updates that would cause this limit to be exceeded fail immediately and set runtime.lastError when using a callback, or when a Promise is rejected. */
+            QUOTA_BYTES: 10485760;
         }
 
-        export interface StorageAreaChangedEvent
-            extends chrome.events.Event<(changes: { [key: string]: StorageChange }) => void>
-        {}
+        export type AreaName = "sync" | "local" | "managed" | "session";
 
-        export type AreaName = keyof Pick<typeof chrome.storage, "sync" | "local" | "managed" | "session">;
-        export interface StorageChangedEvent
-            extends chrome.events.Event<(changes: { [key: string]: StorageChange }, areaName: AreaName) => void>
-        {}
-
-        export type AccessLevel = keyof typeof AccessLevel;
+        /**
+         * The storage area's access level.
+         * @since Chrome 102
+         */
+        export enum AccessLevel {
+            /** Specifies contexts originating from the extension itself. */
+            TRUSTED_CONTEXTS = "TRUSTED_CONTEXTS",
+            /** Specifies contexts originating from outside the extension. */
+            TRUSTED_AND_UNTRUSTED_CONTEXTS = "TRUSTED_AND_UNTRUSTED_CONTEXTS",
+        }
 
-        /** The storage area's access level. */
-        export var AccessLevel: {
-            TRUSTED_AND_UNTRUSTED_CONTEXTS: "TRUSTED_AND_UNTRUSTED_CONTEXTS";
-            TRUSTED_CONTEXTS: "TRUSTED_CONTEXTS";
-        };
+        /** Items in the `local` storage area are local to each machine. */
+        export const local: LocalStorageArea;
 
-        /** Items in the local storage area are local to each machine. */
-        export var local: LocalStorageArea;
-        /** Items in the sync storage area are synced using Chrome Sync. */
-        export var sync: SyncStorageArea;
+        /** Items in the `sync` storage area are synced using Chrome Sync. */
+        export const sync: SyncStorageArea;
 
-        /**
-         * Items in the managed storage area are set by the domain administrator, and are read-only for the extension; trying to modify this namespace results in an error.
-         * @since Chrome 33
-         */
-        export var managed: StorageArea;
+        /** Items in the `managed` storage area are set by an enterprise policy configured by the domain administrator, and are read-only for the extension; trying to modify this namespace results in an error. For information on configuring a policy, see Manifest for storage areas. */
+        export const managed: StorageArea;
 
         /**
-         * Items in the session storage area are stored in-memory and will not be persisted to disk.
+         * Items in the `session` storage area are stored in-memory and will not be persisted to disk.
+         *
+         * MV3 only
          * @since Chrome 102
          */
-        export var session: SessionStorageArea;
+        export const session: SessionStorageArea;
 
         /** Fired when one or more items change. */
-        export var onChanged: StorageChangedEvent;
+        export const onChanged: events.Event<(changes: { [key: string]: StorageChange }, areaName: AreaName) => void>;
     }
 
     ////////////////////
@@ -10251,6 +10217,7 @@ declare namespace chrome {
         }
 
         /** @deprecated Use {@link CpuTime} instead. */
+        // eslint-disable-next-line @typescript-eslint/no-empty-interface
         interface ProcessorUsage extends CpuTime {}
 
         export interface ProcessorInfo {
@@ -12475,6 +12442,7 @@ declare namespace chrome {
         }
 
         /** @deprecated Use {@link Parameters} instead */
+        // eslint-disable-next-line @typescript-eslint/no-empty-interface
         interface VpnSessionParameters extends Parameters {}
 
         /** The enum is used by the platform to notify the client of the VPN session status. */

chrome/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/chrome",
-    "version": "0.1.28",
+    "version": "0.1.30",
     "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": "27f80367b3fa7447dd13ccd50fb050b324ddad2357beb3628dacba26011615a9",
+    "typesPublisherContentHash": "6e0942666b668f34563db277f484e8bff1e6f66a63e0d550837119256368d7dc",
     "typeScriptVersion": "5.2"
 }