@types/chrome 0.3.4 → 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: Tue, 29 Sep 2026 02:43:36 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.
@@ -4671,7 +4684,7 @@ declare namespace chrome {
             /** Matches if the URL (without fragment identifier) ends with a specified string. Port numbers are stripped from the URL if they match the default port number. */
             urlSuffix?: string | undefined;
             /** Matches if the port of the URL is contained in any of the specified port lists. For example `[80, 443, [1000, 1200]]` matches all requests on port 80, 443 and in the range 1000-1200. */
-            ports?: Array<number | number[]> | undefined;
+            ports?: Array<number | [number, number]> | undefined;
             /** Matches if the URL without query segment and fragment identifier matches a specified regular expression. Port numbers are stripped from the URL if they match the default port number. The regular expressions use the RE2 syntax. */
             originAndPathMatches?: string | undefined;
         }
@@ -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>;
     }
 
     ////////////////////
@@ -8943,15 +8956,6 @@ declare namespace chrome {
              */
             referrersEnabled: chrome.types.ChromeSetting<boolean>;
 
-            /**
-             * If disabled, Related Website Sets is deactivated.
-             * The value of this preference is of type boolean, and the default value is `true`.
-             * Extensions may only disable this API by setting the value to `false`. If you try setting this API to `true`, it will throw an error.
-             * @since Chrome 121
-             * @deprecated since Chrome 144. Will be removed around Chrome 153.
-             */
-            relatedWebsiteSetsEnabled: chrome.types.ChromeSetting<boolean>;
-
             /**
              * If disabled, Chrome blocks third-party sites from setting cookies. The value of this preference is of type boolean, and the default value is `true`. Extensions may not enable this API in Incognito mode, where third-party cookies are blocked and can only be allowed at the site level. If you try setting this API to true in Incognito, it will throw an error.
              *
@@ -10003,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<
@@ -10067,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.
@@ -10201,6 +10205,12 @@ declare namespace chrome {
          */
         const onConnectNative: events.Event<(port: Port) => void>;
 
+        /**
+         * Fired when an extension goes from being in a disabled state to an enabled state.
+         * @since Chrome 155
+         */
+        const onEnabled: events.Event<() => void>;
+
         /** Sent to the event page just before it is unloaded. This gives the extension opportunity to do some clean up. Note that since the page is unloading, any asynchronous operations started while handling this event are not guaranteed to complete. If more activity for the event page occurs before it gets unloaded the onSuspendCanceled event will be sent and the page won't be unloaded. */
         const onSuspend: events.Event<() => void>;
 
@@ -10318,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. */
@@ -10404,8 +10414,6 @@ declare namespace chrome {
                 })
             );
 
-        type Awaited<T> = T extends PromiseLike<infer U> ? U : T;
-
         /** @since Chrome 96 */
         type RegisteredContentScript =
             & {
@@ -10784,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[];
             /**
@@ -11697,6 +11705,15 @@ declare namespace chrome {
              * @deprecated since Chrome 33. Please use {@link CreateProperties.active active}.
              */
             selected?: boolean | undefined;
+            /**
+             * The ID of an existing tab to create a split view with. If specified, the split-with tab must meet the following conditions:
+             * *   It must not be an already split tab.
+             * *   It must be in the same window as the newly created tab.
+             * *   If `windowId` is specified, it must be the same as the split-with tab's window ID.
+             * *   If `index` is specified, it must be an index adjacent to the split-with tab and will affect the relative positioning of the newly created tab.
+             * @since Chrome 155
+             */
+            splitWithTabId?: number | undefined;
         }
 
         interface MoveProperties {
@@ -12023,6 +12040,22 @@ declare namespace chrome {
         function create(createProperties: CreateProperties): Promise<Tab>;
         function create(createProperties: CreateProperties, callback: (tab: Tab) => void): void;
 
+        /**
+         * Splits two existing tabs into a Split View.
+         * @param tabIds An array of exactly two tab IDs to pair into a Split View. All tabs must meet the following conditions: They must be adjacent. They must not already be in a split view. They must have matching `windowId`, `pinned`, and `groupId` states.
+         * @since Chrome 155
+         */
+        function createSplit(tabIds: [number, number]): Promise<number>;
+        function createSplit(tabIds: [number, number], callback: (splitViewId: number) => void): void;
+
+        /**
+         * Separates the tabs in a Split View into independent tabs.
+         * @param splitViewId The ID of the Split View to separate.
+         * @since Chrome 155
+         */
+        function unsplit(splitViewId: number): Promise<void>;
+        function unsplit(splitViewId: number, callback: () => void): void;
+
         /**
          * Moves one or more tabs to a new position within its window, or to a new window. Note that tabs can only be moved to and from normal (window.type === "normal") windows.
          * @param tabId The tab ID to move.
@@ -13469,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[];
         }
 
@@ -14605,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;
 
@@ -14771,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;
         }
@@ -15062,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>;
@@ -15325,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.4",
+    "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": "8333a5224a70471d616693cb5beb009d2e8ec64aa705732c9853b5d7a356789f",
+    "typesPublisherContentHash": "5c46d3916b5b2099f0c716d0e5c18fc8b756c5319798989f5e6469e3e4fcc9b6",
     "typeScriptVersion": "5.6"
 }