@types/chrome 0.3.3 → 0.3.5

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, 28 Sep 2026 21:34:15 GMT
+ * 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)
 
 # Credits

chrome/index.d.ts

@@ -1972,37 +1972,48 @@ declare namespace chrome {
          * Properties of the new context menu item.
          * @since Chrome 123
          */
-        interface CreateProperties {
-            /** The initial state of a checkbox or radio button: `true` for selected, `false` for unselected. Only one radio button can be selected at a time in a given group. */
-            checked?: boolean;
-            /** List of contexts this menu item will appear in. Defaults to `['page']`. */
-            contexts?: [`${ContextType}`, ...`${ContextType}`[]];
-            /** Restricts the item to apply only to documents or frames whose URL matches one of the given patterns. For details on pattern formats, see Match Patterns. */
-            documentUrlPatterns?: string[];
-            /** Whether this context menu item is enabled or disabled. Defaults to `true`. */
-            enabled?: boolean;
-            /** The unique ID to assign to this item. Mandatory for event pages. Cannot be the same as another ID for this extension. */
-            id?: string;
-            /** The ID of a parent menu item; this makes the item a child of a previously added item. */
-            parentId?: number | string;
-            /** Similar to `documentUrlPatterns`, filters based on the `src` attribute of `img`, `audio`, and `video` tags and the `href` attribute of `a` tags. */
-            targetUrlPatterns?: string[];
-            /** The text to display in the item; this is _required_ unless `type` is `separator`. When the context is `selection`, use `%s` within the string to show the selected text. For example, if this parameter's value is "Translate '%s' to Pig Latin" and the user selects the word "cool", the context menu item for the selection is "Translate 'cool' to Pig Latin". */
-            title?: string;
-            /** The type of menu item. Defaults to `normal`. */
-            type?: `${ItemType}`;
-            /** Whether the item is visible in the menu. */
-            visible?: boolean;
-            /**
-             * A function that is called back when the menu item is clicked. This is not available inside of a service worker; instead, you should register a listener for {@link contextMenus.onClicked}.
-             * @param info Information about the item clicked and the context where the click happened.
-             * @param tab The details of the tab where the click took place. This parameter is not present for platform apps.
-             */
-            onclick?: (
-                info: OnClickData,
-                tab: tabs.Tab,
-            ) => void;
-        }
+        type CreateProperties =
+            & ({
+                /** The initial state of a checkbox or radio button: `true` for selected, `false` for unselected. Only one radio button can be selected at a time in a given group. */
+                checked?: boolean;
+                /** List of contexts this menu item will appear in. Defaults to `['page']`. */
+                contexts?: [`${ContextType}`, ...`${ContextType}`[]];
+                /** Restricts the item to apply only to documents or frames whose URL matches one of the given patterns. For details on pattern formats, see Match Patterns. */
+                documentUrlPatterns?: string[];
+                /** Whether this context menu item is enabled or disabled. Defaults to `true`. */
+                enabled?: boolean;
+                /** The unique ID to assign to this item. Mandatory for event pages. Cannot be the same as another ID for this extension. */
+                id?: string;
+                /** The ID of a parent menu item; this makes the item a child of a previously added item. */
+                parentId?: number | string;
+                /** Similar to `documentUrlPatterns`, filters based on the `src` attribute of `img`, `audio`, and `video` tags and the `href` attribute of `a` tags. */
+                targetUrlPatterns?: string[];
+                /** Whether the item is visible in the menu. */
+                visible?: boolean;
+                /**
+                 * A function that is called back when the menu item is clicked. This is not available inside of a service worker; instead, you should register a listener for {@link contextMenus.onClicked}.
+                 * @param info Information about the item clicked and the context where the click happened.
+                 * @param tab The details of the tab where the click took place. This parameter is not present for platform apps.
+                 */
+                onclick?: (
+                    info: OnClickData,
+                    tab: tabs.Tab,
+                ) => void;
+            })
+            & (
+                | {
+                    /** The type of menu item. Defaults to `normal`. */
+                    type: `${ItemType.SEPARATOR}`;
+                    /** The text to display in the item; this is _required_ unless `type` is `separator`. When the context is `selection`, use `%s` within the string to show the selected text. For example, if this parameter's value is "Translate '%s' to Pig Latin" and the user selects the word "cool", the context menu item for the selection is "Translate 'cool' to Pig Latin". */
+                    title?: string;
+                }
+                | {
+                    /** The type of menu item. Defaults to `normal`. */
+                    type?: `${Exclude<ItemType, ItemType.SEPARATOR>}`;
+                    /** The text to display in the item; this is _required_ unless `type` is `separator`. When the context is `selection`, use `%s` within the string to show the selected text. For example, if this parameter's value is "Translate '%s' to Pig Latin" and the user selects the word "cool", the context menu item for the selection is "Translate 'cool' to Pig Latin". */
+                    title: string;
+                }
+            );
 
         /**
          * The type of menu item.
@@ -4060,9 +4071,25 @@ declare namespace chrome {
             size?: 16 | 32 | undefined;
         }
 
+        type DownloadSortableKey = keyof Pick<
+            DownloadItem,
+            | "url"
+            | "bytesReceived"
+            | "danger"
+            | "finalUrl"
+            | "totalBytes"
+            | "filename"
+            | "paused"
+            | "state"
+            | "mime"
+            | "startTime"
+            | "endTime"
+            | "exists"
+        >;
+
         interface DownloadQuery {
             /** Set elements of this array to {@link DownloadItem} properties in order to sort search results. For example, setting `orderBy=['startTime']` sorts the {@link DownloadItem} by their start time in ascending order. To specify descending order, prefix with a hyphen: '-startTime'. */
-            orderBy?: string[] | undefined;
+            orderBy?: Array<DownloadSortableKey | `-${DownloadSortableKey}`> | undefined;
             /** Limits results to {@link DownloadItem} whose `url` matches the given regular expression. */
             urlRegex?: string | undefined;
             /** Limits results to {@link DownloadItem} that ended before the given ms in ISO 8601 format. */
@@ -4081,12 +4108,12 @@ declare namespace chrome {
              * The absolute URL that this download is being made from, after all redirects.
              * @since Chrome 54
              */
-            finalUrl?: string;
+            finalUrl?: string | undefined;
             /**
              * Limits results to {@link DownloadItem} whose `finalUrl` matches the given regular expression.
              * @since Chrome 54
              */
-            finalUrlRegex?: string;
+            finalUrlRegex?: string | undefined;
             /** This array of search terms limits results to {@link DownloadItem} whose `filename` or `url` or `finalUrl` contain all of the search terms that do not begin with a dash '-' and none of the search terms that do begin with a dash. */
             query?: string[] | undefined;
             /** Limits results to {@link DownloadItem} whose `totalBytes` is less than the given integer. */
@@ -4163,7 +4190,7 @@ declare namespace chrome {
         function getFileIcon(downloadId: number, callback: (iconURL?: string) => void): void;
         function getFileIcon(
             downloadId: number,
-            options: GetFileIconOptions,
+            options: GetFileIconOptions | undefined,
             callback: (iconURL?: string) => void,
         ): void;
 
@@ -4644,7 +4671,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;
         }
@@ -8480,7 +8507,7 @@ declare namespace chrome {
             /** Printer capabilities in [CDD format](https://developers.google.com/cloud-print/docs/cdd#cdd-example). The property may be missing. */
             capabilities?: { [key: string]: unknown };
             /** The status of the printer. */
-            status: PrinterStatus;
+            status: `${PrinterStatus}`;
         }
 
         /** Status of the print job. */
@@ -8567,7 +8594,7 @@ declare namespace chrome {
             /** The id of created print job. This is a unique identifier among all print jobs on the device. If status is not OK, jobId will be null. */
             jobId: string | null;
             /** The status of the request. */
-            status: SubmitJobStatus;
+            status: `${SubmitJobStatus}`;
         }
 
         /** The status of submitJob request. */
@@ -8672,7 +8699,7 @@ declare namespace chrome {
             /** Displayed name of the printer. */
             name: string;
             /** The source of the printer. */
-            source: PrinterSource;
+            source: `${PrinterSource}`;
             /** The full path for the printer. Contains protocol, hostname, port, and queue. */
             uri: string;
         }
@@ -8700,15 +8727,15 @@ declare namespace chrome {
              * The status of the printer.
              * @since Chrome 85
              */
-            printer_status: chrome.printing.PrinterStatus;
+            printer_status: `${printing.PrinterStatus}`;
             /** The settings of the print job. */
             settings: PrintSettings;
             /** Source showing who initiated the print job. */
-            source: PrintJobSource;
+            source: `${PrintJobSource}`;
             /** ID of source. Null if source is PRINT_PREVIEW or ANDROID_APP. */
             sourceId: string | null;
             /** The final status of the job. */
-            status: PrintJobStatus;
+            status: `${PrintJobStatus}`;
             /** The title of the document which was printed. */
             title: string;
         }
@@ -8737,11 +8764,11 @@ declare namespace chrome {
 
         interface PrintSettings {
             /** The requested color mode. */
-            color: ColorMode;
+            color: `${ColorMode}`;
             /** The requested number of copies. */
             copies: number;
             /** The requested duplex mode. */
-            duplex: DuplexMode;
+            duplex: `${DuplexMode}`;
             /** The requested media size. */
             mediaSize: MediaSize;
         }
@@ -8772,6 +8799,7 @@ declare namespace chrome {
          * @since Chrome 151
          */
         enum AutofillBlockedType {
+            ALL = "all",
             CONTACT_INFO = "contact_info",
             PAYMENTS = "payments",
             IDENTITY_DOCS = "identity_docs",
@@ -8915,14 +8943,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
-             */
-            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.
              *
@@ -10172,6 +10192,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>;
 
@@ -11668,6 +11694,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 {
@@ -11994,6 +12029,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.

chrome/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/chrome",
-    "version": "0.3.3",
+    "version": "0.3.5",
     "description": "TypeScript definitions for chrome",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome",
     "license": "MIT",
@@ -54,6 +54,6 @@
         "@types/har-format": "*"
     },
     "peerDependencies": {},
-    "typesPublisherContentHash": "80b801f82588bed57c18dbd171e238db1daeb189fb71cc95503f7fc0c400d9bd",
+    "typesPublisherContentHash": "76fc785c0457b56ff51aaa280f9fb73bfa3ddf45f56ffd68266aabb276cfd9d6",
     "typeScriptVersion": "5.6"
 }