@types/chrome 0.3.5 → 0.3.6

chrome/README.md

@@ -8,8 +8,8 @@ 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: Fri, 09 Oct 2026 18:42:20 GMT
- * Dependencies: [@types/filesystem](https://npmjs.com/package/@types/filesystem), [@types/har-format](https://npmjs.com/package/@types/har-format)
+ * Last updated: Wed, 21 Oct 2026 06:51:40 GMT
+ * Dependencies: [@types/har-format](https://npmjs.com/package/@types/har-format)
 
 # Credits
 These definitions were written by [MatCarlson](https://github.com/MatCarlson), [Jason Xian](https://github.com/JasonXian), [userTim](https://github.com/usertim), [Nicolas Rodriguez](https://github.com/nicolas377), [Ido Salomon](https://github.com/idosal), [Federico Brigante](https://github.com/fregante), and [Erwan Jugand](https://github.com/erwanjugand).

chrome/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="filesystem" />
 /// <reference path="./har-format/index.d.ts" />
 /// <reference path="./chrome-cast/index.d.ts" />
 
@@ -496,8 +495,8 @@ declare namespace chrome {
          *
          * Can return its result via Promise in Manifest V3 or later since Chrome 91.
          */
-        function clearAll(): Promise<boolean>;
-        function clearAll(callback: (wasCleared: boolean) => void): void;
+        function clearAll(): Promise<boolean | undefined>;
+        function clearAll(callback: (wasCleared?: boolean) => void): void;
 
         /**
          * Clears the alarm with the given name.
@@ -1961,10 +1960,16 @@ declare namespace chrome {
             VIDEO = "video",
             AUDIO = "audio",
             LAUNCHER = "launcher",
+            /** MV2 only */
             BROWSER_ACTION = "browser_action",
+            /** MV2 only */
             PAGE_ACTION = "page_action",
+            /** Applies to the context menu of the extension's action (its toolbar icon). */
             ACTION = "action",
-            /** @since Chrome 150 */
+            /**
+             * Applies to the context menu of a tab in the tab strip.
+             * @since Chrome 150
+             */
             TAB = "tab",
         }
 
@@ -2319,8 +2324,8 @@ declare namespace chrome {
          *
          * Can return its result via Promise in Manifest V3 or later.
          */
-        function set(details: SetDetails): Promise<Cookie | null>;
-        function set(details: SetDetails, callback: (cookie: Cookie | null) => void): void;
+        function set(details: SetDetails): Promise<Cookie | undefined>;
+        function set(details: SetDetails, callback: (cookie?: Cookie) => void): void;
 
         /**
          * Deletes a cookie by name.
@@ -2328,15 +2333,15 @@ declare namespace chrome {
          * Can return its result via Promise in Manifest V3 or later.
          */
         function remove(details: CookieDetails): Promise<CookieDetails>;
-        function remove(details: CookieDetails, callback?: (details: CookieDetails) => void): void;
+        function remove(details: CookieDetails, callback: (details: CookieDetails) => void): void;
 
         /**
          * Retrieves information about a single cookie. If more than one cookie of the same name exists for the given URL, the one with the longest path will be returned. For cookies with the same path length, the cookie with the earliest creation time will be returned.
          *
          * Can return its result via Promise in Manifest V3 or later.
          */
-        function get(details: CookieDetails): Promise<Cookie | null>;
-        function get(details: CookieDetails, callback: (cookie: Cookie | null) => void): void;
+        function get(details: CookieDetails): Promise<Cookie | null | undefined>;
+        function get(details: CookieDetails, callback: (cookie?: Cookie | null) => void): void;
 
         /** Fired when a cookie is set or removed. As a special case, note that updating a cookie's properties is implemented as a two step process: the cookie to be updated is first removed entirely, generating a notification with "cause" of "overwrite" . Afterwards, a new cookie is written with the updated values, generating a second notification with "cause" "explicit". */
         const onChanged: events.Event<(changeInfo: CookieChangeInfo) => void>;
@@ -2443,16 +2448,22 @@ declare namespace chrome {
          *
          * Can return its result via Promise since Chrome 96.
          */
-        function sendCommand(
+        function sendCommand<
+            T extends object = { [key: string]: any },
+            U extends object = { [key: string]: unknown },
+        >(
             target: DebuggerSession,
             method: string,
-            commandParams?: { [key: string]: unknown },
-        ): Promise<object | undefined>;
-        function sendCommand(
+            commandParams?: T,
+        ): Promise<U | undefined>;
+        function sendCommand<
+            T extends object = { [key: string]: any },
+            U extends object = { [key: string]: unknown },
+        >(
             target: DebuggerSession,
             method: string,
-            commandParams?: { [key: string]: unknown },
-            callback?: (result?: object) => void,
+            commandParams: T | undefined,
+            callback: (result?: U) => void,
         ): void;
 
         /**
@@ -2464,9 +2475,11 @@ declare namespace chrome {
         function getTargets(callback: (result: TargetInfo[]) => void): void;
 
         /** Fired when browser terminates debugging session for the tab. This happens when either the tab is being closed or Chrome DevTools is being invoked for the attached tab. */
-        const onDetach: chrome.events.Event<(source: Debuggee, reason: `${DetachReason}`) => void>;
+        const onDetach: events.Event<(source: Debuggee, reason: `${DetachReason}`) => void>;
         /** Fired whenever debugging target issues instrumentation event. */
-        const onEvent: chrome.events.Event<(source: DebuggerSession, method: string, params?: object) => void>;
+        const onEvent: events.Event<
+            (source: DebuggerSession, method: string, params?: { [key: string]: unknown }) => void
+        >;
     }
 
     export { _debugger as debugger };
@@ -4067,7 +4080,7 @@ declare namespace chrome {
         }
 
         interface GetFileIconOptions {
-            /** The size of the returned icon. The icon will be square with dimensions size * size pixels. The default and largest size for the icon is 32x32 pixels. The only supported sizes are 16 and 32. It is an error to specify any other size. */
+            /** The size of the returned icon in density-independent pixels (DIPs). Must be either 16 or 32 (defaults to 32). On high-DPI displays, the returned image scales with the device scale factor (e.g., 64x64 px for size 32 on a 2x display). Calls from background service workers default to 1x scale. */
             size?: 16 | 32 | undefined;
         }
 
@@ -4181,7 +4194,7 @@ declare namespace chrome {
         function pause(downloadId: number, callback: () => void): void;
 
         /**
-         * Retrieve an icon for the specified download. For new downloads, file icons are available after the {@link onCreated} event has been received. The image returned by this function while a download is in progress may be different from the image returned after the download is complete. Icon retrieval is done by querying the underlying operating system or toolkit depending on the platform. The icon that is returned will therefore depend on a number of factors including state of the download, platform, registered file types and visual theme. If a file icon cannot be determined, {@link runtime.lastError} will contain an error message.
+         * Retrieve an icon for the specified download. For new downloads, file icons are available after the download's target filename has been determined (for example, when {@link onChanged} fires with a `filename` change). Attempting to retrieve the icon before the filename is determined will result in an error through {@link runtime.lastError}. The image returned by this function while a download is in progress may be different from the image returned after the download is complete. Icon retrieval is done by querying the underlying operating system or toolkit depending on the platform. The icon that is returned will therefore depend on a number of factors including state of the download, platform, registered file types and visual theme. If a file icon cannot be determined, {@link runtime.lastError} will contain an error message.
          * @param downloadId The identifier for the download.
          *
          * Can return its result via Promise in Manifest V3 or later since Chrome 96.
@@ -4982,7 +4995,7 @@ declare namespace chrome {
             /** The ID of the tab that raised this event. Tab IDs are unique within a browser session. */
             tab_id?: number;
             /** Array of Entry instances representing files that are targets of this action (selected in ChromeOS file browser). */
-            entries: any[];
+            entries: FileSystemFileEntry[];
         }
 
         /** Fired when file system action is executed from ChromeOS file browser. */
@@ -6025,10 +6038,10 @@ declare namespace chrome {
          * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         function getDefaultFontSize(details?: { [key: string]: unknown }): Promise<FontSizeResult>;
-        function getDefaultFontSize(callback: (options: FontSizeResult) => void): void;
+        function getDefaultFontSize(callback: (details: FontSizeResult) => void): void;
         function getDefaultFontSize(
             details: { [key: string]: unknown } | undefined,
-            callback: (options: FontSizeResult) => void,
+            callback: (details: FontSizeResult) => void,
         ): void;
 
         /**
@@ -6038,10 +6051,10 @@ declare namespace chrome {
          * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         function getMinimumFontSize(details?: { [key: string]: unknown }): Promise<FontSizeResult>;
-        function getMinimumFontSize(callback: (options: FontSizeResult) => void): void;
+        function getMinimumFontSize(callback: (details: FontSizeResult) => void): void;
         function getMinimumFontSize(
             details: { [key: string]: unknown } | undefined,
-            callback: (options: FontSizeResult) => void,
+            callback: (details: FontSizeResult) => void,
         ): void;
 
         /**
@@ -6166,7 +6179,7 @@ declare namespace chrome {
             /** Time-to-live of the message in seconds. If it is not possible to send the message within that time, an onSendError event will be raised. A time-to-live of 0 indicates that the message should be sent immediately or fail if it's not possible. The default value of time-to-live is 86,400 seconds (1 day) and the maximum value is 2,419,200 seconds (28 days). */
             timeToLive?: number | undefined;
             /** Message data to send to the server. Case-insensitive `goog.` and `google`, as well as case-sensitive `collapse_key` are disallowed as key prefixes. Sum of all key/value pairs should not exceed {@link gcm.MAX_MESSAGE_SIZE}. */
-            data: { [key: string]: unknown };
+            data: { [key: string]: string };
         }
 
         /** The maximum size (in bytes) of all key/value pairs in a message. */
@@ -6204,7 +6217,7 @@ declare namespace chrome {
                 /** The collapse key of a message. See the Non-collapsible and collapsible messages for details. */
                 collapseKey?: string;
                 /** The message data. */
-                data: { [key: string]: unknown };
+                data: { [key: string]: string };
                 /** The sender who issued the message. */
                 from?: string;
             }) => void
@@ -6217,7 +6230,7 @@ declare namespace chrome {
         const onSendError: events.Event<
             (error: {
                 /** Additional details related to the error, when available. */
-                details: { [key: string]: unknown };
+                details: { [key: string]: string };
                 /** The error message describing the problem. */
                 errorMessage: string;
                 /** The ID of the message with this error, if error is related to a specific message. */
@@ -6591,7 +6604,7 @@ declare namespace chrome {
          */
         function getProfileUserInfo(details?: ProfileDetails): Promise<ProfileUserInfo>;
         function getProfileUserInfo(
-            details: ProfileDetails,
+            details: ProfileDetails | undefined,
             callback: (userInfo: ProfileUserInfo) => void,
         ): void;
         function getProfileUserInfo(callback: (userInfo: ProfileUserInfo) => void): void;
@@ -6629,7 +6642,7 @@ declare namespace chrome {
         function getRedirectURL(path?: string): string;
 
         /** Fired when signin state changes for an account on the user's profile. */
-        const onSignInChanged: chrome.events.Event<(account: AccountInfo, signedIn: boolean) => void>;
+        const onSignInChanged: events.Event<(account: AccountInfo, signedIn: boolean) => void>;
     }
 
     ////////////////////
@@ -9994,7 +10007,7 @@ declare namespace chrome {
             /** Enables use of particular extension APIs. */
             permissions?: ManifestPermission[] | undefined;
             /** Identifies an HTML file to display in a sidePanel. */
-            side_panel?: { default_path: string } | undefined;
+            side_panel?: sidePanel.SidePanel | undefined;
             /** Defines files within the extension that can be accessed by web pages or other extensions. */
             web_accessible_resources?:
                 | Array<
@@ -10058,8 +10071,8 @@ declare namespace chrome {
          *
          * Can return its result via Promise in Manifest V3 or later since Chrome 122.
          */
-        function getPackageDirectoryEntry(): Promise<DirectoryEntry>;
-        function getPackageDirectoryEntry(callback: (directoryEntry: DirectoryEntry) => void): void;
+        function getPackageDirectoryEntry(): Promise<FileSystemDirectoryEntry>;
+        function getPackageDirectoryEntry(callback: (directoryEntry: FileSystemDirectoryEntry) => void): void;
 
         /**
          * Returns information about the current platform.
@@ -10315,7 +10328,7 @@ declare namespace chrome {
                      */
                     documentIds?: never | undefined;
                     /** The IDs of specific frames to inject into. */
-                    frameIds: number[] | undefined;
+                    frameIds?: number[] | undefined;
                 }
                 | {
                     /** Whether the script should inject into all frames within the tab. Defaults to false. This must not be true if `frameIds` or `documentIds` is specified. */
@@ -10401,8 +10414,6 @@ declare namespace chrome {
                 })
             );
 
-        type Awaited<T> = T extends PromiseLike<infer U> ? U : T;
-
         /** @since Chrome 96 */
         type RegisteredContentScript =
             & {
@@ -10781,7 +10792,7 @@ declare namespace chrome {
              * A set of feature codes indicating some of the processor's capabilities.
              * The currently supported codes are "mmx", "sse", "sse2", "sse3", "ssse3", "sse4_1", "sse4_2", and "avx".
              */
-            features: string[];
+            features: Array<"mmx" | "sse" | "sse2" | "sse3" | "ssse3" | "sse4_1" | "sse4_2" | "avx">;
             /** Information about each logical processor. */
             processors: ProcessorInfo[];
             /**
@@ -13491,7 +13502,7 @@ declare namespace chrome {
         }
 
         interface WebNavigationEventFilter {
-            /** Conditions that the URL being navigated to must satisfy. The 'schemes' and 'ports' fields of UrlFilter are ignored for this event. */
+            /** Conditions that the URL being navigated to must satisfy. */
             url: chrome.events.UrlFilter[];
         }
 
@@ -14627,6 +14638,7 @@ declare namespace chrome {
              * List of HTTP request methods which the rule can match. An empty list is not allowed.
              *
              * Note: Specifying a `requestMethods` rule condition will also exclude non-HTTP(s) requests, whereas specifying `excludedRequestMethods` will not.
+             * @since Chrome 91
              */
             requestMethods?: `${RequestMethod}`[] | undefined;
 
@@ -14793,7 +14805,7 @@ declare namespace chrome {
             /** Add, remove or replace query key-value pairs. */
             queryTransform?: QueryTransform | undefined;
             /** The new scheme for the request. Allowed values are "http", "https", "ftp" and "chrome-extension". */
-            scheme?: string | undefined;
+            scheme?: "http" | "https" | "ftp" | "chrome-extension" | undefined;
             /** The new username for the request. */
             username?: string | undefined;
         }
@@ -15084,7 +15096,7 @@ declare namespace chrome {
          * @since Chrome 111
          */
         function updateStaticRules(options: UpdateStaticRulesOptions): Promise<void>;
-        function updateStaticRules(options: UpdateStaticRulesOptions, callback?: () => void): void;
+        function updateStaticRules(options: UpdateStaticRulesOptions, callback: () => void): void;
 
         /** Fired when a rule is matched with a request. Only available for unpacked extensions with the `declarativeNetRequestFeedback` permission as this is intended to be used for debugging purposes only. */
         const onRuleMatchedDebug: events.Event<(info: MatchedRuleInfoDebug) => void>;
@@ -15347,25 +15359,25 @@ declare namespace chrome {
             }
             & (
                 | {
-                    /** Whether the script should inject into all frames within the tab. Defaults to false. */
+                    /** Whether the script should inject into all frames within the tab. Defaults to false. This must not be true if `frameIds` or `documentIds` is specified. */
                     allFrames?: boolean | undefined;
-                    /** The IDs of specific documentIds to inject into. */
+                    /** The IDs of specific documentIds to inject into. This must not be set if `frameIds` is set. */
                     documentIds?: never;
                     /** The IDs of specific frames to inject into. */
                     frameIds?: never;
                 }
                 | {
-                    /** Whether the script should inject into all frames within the tab. Defaults to false. */
+                    /** Whether the script should inject into all frames within the tab. Defaults to false. This must not be true if `frameIds` or `documentIds` is specified. */
                     allFrames?: false | undefined;
-                    /** The IDs of specific documentIds to inject into. */
+                    /** The IDs of specific documentIds to inject into. This must not be set if `frameIds` is set. */
                     documentIds?: never;
                     /** The IDs of specific frames to inject into. */
-                    frameIds: number[] | undefined;
+                    frameIds?: number[] | undefined;
                 }
                 | {
-                    /** Whether the script should inject into all frames within the tab. Defaults to false. */
+                    /** Whether the script should inject into all frames within the tab. Defaults to false. This must not be true if `frameIds` or `documentIds` is specified. */
                     allFrames?: false | undefined;
-                    /** The IDs of specific documentIds to inject into. */
+                    /** The IDs of specific documentIds to inject into. This must not be set if `frameIds` is set. */
                     documentIds?: string[] | undefined;
                     /** The IDs of specific frames to inject into. */
                     frameIds?: never;

chrome/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/chrome",
-    "version": "0.3.5",
+    "version": "0.3.6",
     "description": "TypeScript definitions for chrome",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome",
     "license": "MIT",
@@ -50,10 +50,9 @@
     },
     "scripts": {},
     "dependencies": {
-        "@types/filesystem": "*",
         "@types/har-format": "*"
     },
     "peerDependencies": {},
-    "typesPublisherContentHash": "76fc785c0457b56ff51aaa280f9fb73bfa3ddf45f56ffd68266aabb276cfd9d6",
+    "typesPublisherContentHash": "5c46d3916b5b2099f0c716d0e5c18fc8b756c5319798989f5e6469e3e4fcc9b6",
     "typeScriptVersion": "5.6"
 }