@types/chrome 0.0.250 → 0.0.252

chrome/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for chrome (http://developer.chrome.com/e
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome.
 
 ### Additional Details
- * Last updated: Mon, 06 Nov 2023 22:41:05 GMT
+ * Last updated: Mon, 20 Nov 2023 23:36:23 GMT
  * Dependencies: [@types/filesystem](https://npmjs.com/package/@types/filesystem), [@types/har-format](https://npmjs.com/package/@types/har-format)
 
 # Credits

chrome/chrome-cast/index.d.ts

@@ -95,7 +95,7 @@ declare namespace chrome.cast {
     /**
      * @see https://developers.google.com/cast/docs/reference/chrome/chrome.cast#.VERSION
      */
-    export var VERSION: Array<number>;
+    export var VERSION: number[];
 
     /**
      * @see https://developers.google.com/cast/docs/reference/chrome/chrome.cast#.isAvailable
@@ -156,7 +156,7 @@ declare namespace chrome.cast {
      * @param errorCallback
      */
     export function setCustomReceivers(
-        receivers: Array<chrome.cast.Receiver>,
+        receivers: chrome.cast.Receiver[],
         successCallback: Function,
         errorCallback: (error: chrome.cast.Error) => void,
     ): void;
@@ -247,10 +247,10 @@ declare namespace chrome.cast {
          * @param opt_timeout
          * @see https://developers.google.com/cast/docs/reference/chrome/chrome.cast.SessionRequest
          */
-        constructor(appId: string, capabilities?: Array<chrome.cast.Capability>, timeout?: number);
+        constructor(appId: string, capabilities?: chrome.cast.Capability[], timeout?: number);
 
         appId: string;
-        capabilities: Array<chrome.cast.Capability>;
+        capabilities: chrome.cast.Capability[];
         requestSessionTimeout: number;
         language: string | null;
     }
@@ -268,18 +268,18 @@ declare namespace chrome.cast {
             sessionId: string,
             appId: string,
             displayName: string,
-            appImages: Array<chrome.cast.Image>,
+            appImages: chrome.cast.Image[],
             receiver: chrome.cast.Receiver,
         );
 
         sessionId: string;
         appId: string;
         displayName: string;
-        appImages: Array<chrome.cast.Image>;
+        appImages: chrome.cast.Image[];
         receiver: chrome.cast.Receiver;
-        senderApps: Array<chrome.cast.SenderApplication>;
+        senderApps: chrome.cast.SenderApplication[];
         namespaces: Array<{ name: string }>;
-        media: Array<chrome.cast.media.Media>;
+        media: chrome.cast.media.Media[];
         status: chrome.cast.SessionStatus;
         statusText: string | null;
         transportId: string;
@@ -397,13 +397,13 @@ declare namespace chrome.cast {
         constructor(
             label: string,
             friendlyName: string,
-            capabilities?: Array<chrome.cast.Capability>,
+            capabilities?: chrome.cast.Capability[],
             volume?: chrome.cast.Volume,
         );
 
         label: string;
         friendlyName: string;
-        capabilities: Array<chrome.cast.Capability>;
+        capabilities: chrome.cast.Capability[];
         volume: chrome.cast.Volume;
         receiverType: chrome.cast.ReceiverType;
         displayStatus: chrome.cast.ReceiverDisplayStatus;
@@ -415,10 +415,10 @@ declare namespace chrome.cast {
          * @param appImages
          * @see https://developers.google.com/cast/docs/reference/chrome/chrome.cast.ReceiverDisplayStatus
          */
-        constructor(statusText: string, appImages: Array<chrome.cast.Image>);
+        constructor(statusText: string, appImages: chrome.cast.Image[]);
 
         statusText: string;
-        appImages: Array<chrome.cast.Image>;
+        appImages: chrome.cast.Image[];
     }
 
     export class Volume {
@@ -512,7 +512,7 @@ declare namespace chrome.cast.media {
          */
         constructor(mediaInfo: chrome.cast.media.MediaInfo);
 
-        activeTrackIds: Array<Number>;
+        activeTrackIds: Number[];
         autoplay: boolean;
         customData: Object;
         itemId: number;
@@ -526,10 +526,10 @@ declare namespace chrome.cast.media {
          * @param items
          * @see https://developers.google.com/cast/docs/reference/chrome/chrome.cast.media.QueueLoadRequest
          */
-        constructor(items: Array<chrome.cast.media.QueueItem>);
+        constructor(items: chrome.cast.media.QueueItem[]);
 
         customData: Object;
-        items: Array<chrome.cast.media.QueueItem>;
+        items: chrome.cast.media.QueueItem[];
         repeatMode: chrome.cast.media.RepeatMode;
         startIndex: number;
     }
@@ -539,11 +539,11 @@ declare namespace chrome.cast.media {
          * @param itemsToInsert
          * @see https://developers.google.com/cast/docs/reference/chrome/chrome.cast.media.QueueInsertItemsRequest
          */
-        constructor(itemsToInsert: Array<chrome.cast.media.QueueItem>);
+        constructor(itemsToInsert: chrome.cast.media.QueueItem[]);
 
         customData: Object;
         insertBefore: number;
-        items: Array<chrome.cast.media.QueueItem>;
+        items: chrome.cast.media.QueueItem[];
     }
 
     export class QueueRemoveItemsRequest {
@@ -551,10 +551,10 @@ declare namespace chrome.cast.media {
          * @param itemIdsToRemove
          * @see https://developers.google.com/cast/docs/reference/chrome/chrome.cast.media.QueueRemoveItemsRequest
          */
-        constructor(itemIdsToRemove: Array<number>);
+        constructor(itemIdsToRemove: number[]);
 
         customData: Object;
-        itemIds: Array<number>;
+        itemIds: number[];
     }
 
     export class QueueReorderItemsRequest {
@@ -562,11 +562,11 @@ declare namespace chrome.cast.media {
          * @param itemIdsToReorder
          * @see https://developers.google.com/cast/docs/reference/chrome/chrome.cast.media.QueueReorderItemsRequest
          */
-        constructor(itemIdsToReorder: Array<number>);
+        constructor(itemIdsToReorder: number[]);
 
         customData: Object;
         insertBefore: number;
-        itemIds: Array<number>;
+        itemIds: number[];
     }
 
     export class QueueUpdateItemsRequest {
@@ -574,10 +574,10 @@ declare namespace chrome.cast.media {
          * @param itemsToUpdate
          * @see https://developers.google.com/cast/docs/reference/chrome/chrome.cast.media.QueueUpdateItemsRequest
          */
-        constructor(itemsToUpdate: Array<chrome.cast.media.QueueItem>);
+        constructor(itemsToUpdate: chrome.cast.media.QueueItem[]);
 
         customData: Object;
-        item: Array<chrome.cast.media.QueueItem>;
+        item: chrome.cast.media.QueueItem[];
     }
 
     /**
@@ -708,7 +708,7 @@ declare namespace chrome.cast.media {
          */
         constructor(mediaInfo: chrome.cast.media.MediaInfo);
 
-        activeTrackIds: Array<number>;
+        activeTrackIds: number[];
         autoplay: boolean;
         currentTime: number;
         customData: Object;
@@ -722,14 +722,14 @@ declare namespace chrome.cast.media {
          * @param opt_textTrackStyle
          * @see https://developers.google.com/cast/docs/reference/chrome/chrome.cast.media.EditTracksInfoRequest
          */
-        constructor(activeTrackIds?: Array<number>, textTrackStyle?: chrome.cast.media.TextTrackStyle);
+        constructor(activeTrackIds?: number[], textTrackStyle?: chrome.cast.media.TextTrackStyle);
 
-        activeTrackIds: Array<number>;
+        activeTrackIds: number[];
         textTrackStyle: chrome.cast.media.TextTrackStyle;
     }
 
     export class GenericMediaMetadata {
-        images: Array<chrome.cast.Image>;
+        images: chrome.cast.Image[];
         metadataType: chrome.cast.media.MetadataType;
         releaseDate: string;
         /** @deprecated Use releaseDate instead. */
@@ -746,7 +746,7 @@ declare namespace chrome.cast.media {
          */
         constructor();
 
-        images: Array<chrome.cast.Image>;
+        images: chrome.cast.Image[];
         metadataType: chrome.cast.media.MetadataType;
         releaseDate: string;
         /** @deprecated Use releaseDate instead. */
@@ -769,7 +769,7 @@ declare namespace chrome.cast.media {
         title: string;
         season: number;
         episode: number;
-        images: Array<chrome.cast.Image>;
+        images: chrome.cast.Image[];
         originalAirdate: string;
 
         /** @deprecated Use metadataType instead. */
@@ -799,7 +799,7 @@ declare namespace chrome.cast.media {
         songName: string;
         trackNumber: number;
         discNumber: number;
-        images: Array<chrome.cast.Image>;
+        images: chrome.cast.Image[];
         releaseDate: string;
 
         /** @deprecated Use metadataType instead. */
@@ -820,7 +820,7 @@ declare namespace chrome.cast.media {
         title: string;
         artist: string;
         location: string;
-        images: Array<chrome.cast.Image>;
+        images: chrome.cast.Image[];
         latitude: number;
         longitude: number;
         width: number;
@@ -844,7 +844,7 @@ declare namespace chrome.cast.media {
         contentType: string;
         metadata: any;
         duration: number;
-        tracks: Array<chrome.cast.media.Track>;
+        tracks: chrome.cast.media.Track[];
         textTrackStyle: chrome.cast.media.TextTrackStyle;
         customData: Object;
     }
@@ -857,11 +857,11 @@ declare namespace chrome.cast.media {
          */
         constructor(sessionId: string, mediaSessionId: number);
 
-        activeTrackIds: Array<number>;
+        activeTrackIds: number[];
         currentItemId: number;
         customData: Object;
         idleReason: chrome.cast.media.IdleReason | null;
-        items: Array<chrome.cast.media.QueueItem>;
+        items: chrome.cast.media.QueueItem[];
         liveSeekableRange?: chrome.cast.media.LiveSeekableRange | undefined;
         loadingItemId: number;
         media: chrome.cast.media.MediaInfo;
@@ -871,7 +871,7 @@ declare namespace chrome.cast.media {
         preloadedItemId: number;
         repeatMode: chrome.cast.media.RepeatMode;
         sessionId: string;
-        supportedMediaCommands: Array<chrome.cast.media.MediaCommand>;
+        supportedMediaCommands: chrome.cast.media.MediaCommand[];
         volume: chrome.cast.Volume;
 
         /** @deprecated Use getEstimatedTime instead */

chrome/index.d.ts

@@ -2166,7 +2166,7 @@ declare namespace chrome.declarativeContent {
         /** Optional. Matches if the scheme of the URL is equal to any of the schemes specified in the array.  */
         schemes?: string[] | undefined;
         /** Optional. 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?: (number | number[])[] | undefined;
+        ports?: Array<number | number[]> | undefined;
     }
 
     export class PageStateMatcherProperties {
@@ -3411,7 +3411,7 @@ declare namespace chrome.events {
         /** Optional. 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;
         /** Optional. 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?: (number | number[])[] | undefined;
+        ports?: Array<number | number[]> | undefined;
         /**
          * Optional.
          * Since Chrome 28.
@@ -7270,37 +7270,45 @@ declare namespace chrome.runtime {
             matches?: string[] | undefined;
             permissions?: string[] | undefined;
         } | undefined;
-        content_scripts?: {
-            matches?: string[] | undefined;
-            exclude_matches?: string[] | undefined;
-            css?: string[] | undefined;
-            js?: string[] | undefined;
-            run_at?: string | undefined;
-            all_frames?: boolean | undefined;
-            match_about_blank?: boolean | undefined;
-            include_globs?: string[] | undefined;
-            exclude_globs?: string[] | undefined;
-        }[] | undefined;
+        content_scripts?:
+            | Array<{
+                matches?: string[] | undefined;
+                exclude_matches?: string[] | undefined;
+                css?: string[] | undefined;
+                js?: string[] | undefined;
+                run_at?: string | undefined;
+                all_frames?: boolean | undefined;
+                match_about_blank?: boolean | undefined;
+                include_globs?: string[] | undefined;
+                exclude_globs?: string[] | undefined;
+            }>
+            | undefined;
         converted_from_user_script?: boolean | undefined;
         current_locale?: string | undefined;
         devtools_page?: string | undefined;
-        event_rules?: {
-            event?: string | undefined;
-            actions?: {
-                type: string;
-            }[] | undefined;
-            conditions?: chrome.declarativeContent.PageStateMatcherProperties[] | undefined;
-        }[] | undefined;
+        event_rules?:
+            | Array<{
+                event?: string | undefined;
+                actions?:
+                    | Array<{
+                        type: string;
+                    }>
+                    | undefined;
+                conditions?: chrome.declarativeContent.PageStateMatcherProperties[] | undefined;
+            }>
+            | undefined;
         externally_connectable?: {
             ids?: string[] | undefined;
             matches?: string[] | undefined;
             accepts_tls_channel_id?: boolean | undefined;
         } | undefined;
-        file_browser_handlers?: {
-            id?: string | undefined;
-            default_title?: string | undefined;
-            file_filters?: string[] | undefined;
-        }[] | undefined;
+        file_browser_handlers?:
+            | Array<{
+                id?: string | undefined;
+                default_title?: string | undefined;
+                file_filters?: string[] | undefined;
+            }>
+            | undefined;
         file_system_provider_capabilities?: {
             configurable?: boolean | undefined;
             watchable?: boolean | undefined;
@@ -7308,29 +7316,35 @@ declare namespace chrome.runtime {
             source?: string | undefined;
         } | undefined;
         homepage_url?: string | undefined;
-        import?: {
-            id: string;
-            minimum_version?: string | undefined;
-        }[] | undefined;
+        import?:
+            | Array<{
+                id: string;
+                minimum_version?: string | undefined;
+            }>
+            | undefined;
         export?: {
             whitelist?: string[] | undefined;
         } | undefined;
         incognito?: string | undefined;
-        input_components?: {
-            name?: string | undefined;
-            type?: string | undefined;
-            id?: string | undefined;
-            description?: string | undefined;
-            language?: string[] | string | undefined;
-            layouts?: string[] | undefined;
-            indicator?: string | undefined;
-        }[] | undefined;
+        input_components?:
+            | Array<{
+                name?: string | undefined;
+                type?: string | undefined;
+                id?: string | undefined;
+                description?: string | undefined;
+                language?: string[] | string | undefined;
+                layouts?: string[] | undefined;
+                indicator?: string | undefined;
+            }>
+            | undefined;
         key?: string | undefined;
         minimum_chrome_version?: string | undefined;
-        nacl_modules?: {
-            path: string;
-            mime_type: string;
-        }[] | undefined;
+        nacl_modules?:
+            | Array<{
+                path: string;
+                mime_type: string;
+            }>
+            | undefined;
         oauth2?: {
             client_id: string;
             scopes?: string[] | undefined;
@@ -7345,13 +7359,17 @@ declare namespace chrome.runtime {
             chrome_style?: boolean | undefined;
             open_in_tab?: boolean | undefined;
         } | undefined;
-        platforms?: {
-            nacl_arch?: string | undefined;
-            sub_package_path: string;
-        }[] | undefined;
-        plugins?: {
-            path: string;
-        }[] | undefined;
+        platforms?:
+            | Array<{
+                nacl_arch?: string | undefined;
+                sub_package_path: string;
+            }>
+            | undefined;
+        plugins?:
+            | Array<{
+                path: string;
+            }>
+            | undefined;
         requirements?: {
             "3D"?: {
                 features?: string[] | undefined;
@@ -7375,12 +7393,12 @@ declare namespace chrome.runtime {
             managed_schema: string;
         } | undefined;
         tts_engine?: {
-            voices: {
+            voices: Array<{
                 voice_name: string;
                 lang?: string | undefined;
                 gender?: string | undefined;
                 event_types?: string[] | undefined;
-            }[];
+            }>;
         } | undefined;
         update_url?: string | undefined;
         version_name?: string | undefined;
@@ -7421,18 +7439,20 @@ declare namespace chrome.runtime {
                 type?: "module"; // If the service worker uses ES modules
             }
             | undefined;
-        content_scripts?: {
-            matches?: string[] | undefined;
-            exclude_matches?: string[] | undefined;
-            css?: string[] | undefined;
-            js?: string[] | undefined;
-            run_at?: string | undefined;
-            all_frames?: boolean | undefined;
-            match_about_blank?: boolean | undefined;
-            include_globs?: string[] | undefined;
-            exclude_globs?: string[] | undefined;
-            world?: "ISOLATED" | "MAIN" | undefined;
-        }[] | undefined;
+        content_scripts?:
+            | Array<{
+                matches?: string[] | undefined;
+                exclude_matches?: string[] | undefined;
+                css?: string[] | undefined;
+                js?: string[] | undefined;
+                run_at?: string | undefined;
+                all_frames?: boolean | undefined;
+                match_about_blank?: boolean | undefined;
+                include_globs?: string[] | undefined;
+                exclude_globs?: string[] | undefined;
+                world?: "ISOLATED" | "MAIN" | undefined;
+            }>
+            | undefined;
         content_security_policy?: {
             extension_pages?: string;
             sandbox?: string;
@@ -7440,7 +7460,7 @@ declare namespace chrome.runtime {
         host_permissions?: string[] | undefined;
         optional_permissions?: ManifestPermissions[] | undefined;
         permissions?: ManifestPermissions[] | undefined;
-        web_accessible_resources?: { resources: string[]; matches: string[] }[] | undefined;
+        web_accessible_resources?: Array<{ resources: string[]; matches: string[] }> | undefined;
     }
 
     export type Manifest = ManifestV2 | ManifestV3;
@@ -7781,7 +7801,7 @@ declare namespace chrome.scripting {
      */
     export function executeScript<Args extends any[], Result>(
         injection: ScriptInjection<Args, Result>,
-    ): Promise<InjectionResult<Awaited<Result>>[]>;
+    ): Promise<Array<InjectionResult<Awaited<Result>>>>;
 
     /**
      * Injects a script into a target context. The script will be run at document_end.
@@ -7792,7 +7812,7 @@ declare namespace chrome.scripting {
      */
     export function executeScript<Args extends any[], Result>(
         injection: ScriptInjection<Args, Result>,
-        callback: (results: InjectionResult<Awaited<Result>>[]) => void,
+        callback: (results: Array<InjectionResult<Awaited<Result>>>) => void,
     ): void;
 
     /**
@@ -12565,31 +12585,139 @@ declare namespace chrome.declarativeNetRequest {
  */
 declare namespace chrome.sidePanel {
     export interface GetPanelOptions {
+        /**
+         * If specified, the side panel options for the given tab will be returned.
+         * Otherwise, returns the default side panel options (used for any tab that doesn't have specific settings).
+         */
         tabId?: number;
     }
 
+    /**
+     * @since Chrome 116
+     */
+    export type OpenOptions =
+        & {
+            /** The tab in which to open the side panel.
+             * If the corresponding tab has a tab-specific side panel, the panel will only be open for that tab.
+             * If there is not a tab-specific panel, the global panel will be open in the specified tab and any other tabs without a currently-open tab- specific panel.
+             * This will override any currently-active side panel (global or tab-specific) in the corresponding tab.
+             * At least one of this and windowId must be provided. */
+            tabId?: number;
+            /**
+             * The window in which to open the side panel.
+             * This is only applicable if the extension has a global (non-tab-specific) side panel or tabId is also specified.
+             * This will override any currently-active global side panel the user has open in the given window.
+             * At least one of this and tabId must be provided.
+             */
+            windowId?: number;
+        }
+        & ({
+            tabId: number;
+        } | {
+            windowId: number;
+        });
+
     export interface PanelBehavior {
+        /** Whether clicking the extension's icon will toggle showing the extension's entry in the side panel. Defaults to false. */
         openPanelOnActionClick?: boolean;
     }
 
     export interface PanelOptions {
+        /** Whether the side panel should be enabled. This is optional. The default value is true. */
         enabled?: boolean;
+        /** The path to the side panel HTML file to use. This must be a local resource within the extension package. */
         path?: string;
+        /**
+         * If specified, the side panel options will only apply to the tab with this id.
+         * If omitted, these options set the default behavior (used for any tab that doesn't have specific settings).
+         * Note: if the same path is set for this tabId and the default tabId, then the panel for this tabId will be a different instance than the panel for the default tabId.
+         */
         tabId?: number;
     }
 
     export interface SidePanel {
+        /** Developer specified path for side panel display. */
         default_path: string;
     }
 
+    /**
+     * Returns the active panel configuration.
+     * Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility.
+     * You cannot use both on the same function call.
+     * The promise resolves with the same type that is passed to the callback.
+     */
+    export function getOptions(
+        /** Specifies the context to return the configuration for. */
+        options: GetPanelOptions,
+        callback: (options: PanelOptions) => void,
+    ): void;
+
     export function getOptions(
+        /** Specifies the context to return the configuration for. */
         options: GetPanelOptions,
-        callback?: (options: PanelOptions) => void,
     ): Promise<PanelOptions>;
 
-    export function getPanelBehavior(callback?: (behavior: PanelBehavior) => void): Promise<PanelBehavior>;
+    /**
+     * Returns the extension's current side panel behavior.
+     * Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility.
+     * You cannot use both on the same function call.
+     * The promise resolves with the same type that is passed to the callback.
+     */
+    export function getPanelBehavior(
+        callback: (behavior: PanelBehavior) => void,
+    ): void;
 
-    export function setOptions(options: PanelOptions, callback?: () => void): Promise<void>;
+    export function getPanelBehavior(): Promise<PanelBehavior>;
+
+    /**
+     * @since Chrome 116
+     * Opens the side panel for the extension. This may only be called in response to a user action.
+     * Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility.
+     * You cannot use both on the same function call.
+     * The promise resolves with the same type that is passed to the callback.
+     */
+    export function open(
+        /** Specifies the context in which to open the side panel. */
+        options: OpenOptions,
+        callback: () => void,
+    ): void;
+
+    export function open(
+        /** Specifies the context in which to open the side panel. */
+        options: OpenOptions,
+    ): Promise<void>;
+
+    /**
+     * Configures the side panel.
+     * Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility.
+     * You cannot use both on the same function call.
+     * The promise resolves with the same type that is passed to the callback.
+     */
+    export function setOptions(
+        /** The configuration options to apply to the panel. */
+        options: PanelOptions,
+        callback: () => void,
+    ): void;
+
+    export function setOptions(
+        /** The configuration options to apply to the panel. */
+        options: PanelOptions,
+    ): Promise<void>;
+
+    /**
+     * Configures the extension's side panel behavior. This is an upsert operation.
+     * Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility.
+     * You cannot use both on the same function call.
+     * The promise resolves with the same type that is passed to the callback.
+     */
+    export function setPanelBehavior(
+        /** The new behavior to be set. */
+        behavior: PanelBehavior,
+        callback: () => void,
+    ): void;
 
-    export function setPanelBehavior(behavior: PanelBehavior, callback?: () => void): Promise<void>;
+    export function setPanelBehavior(
+        /** The new behavior to be set. */
+        behavior: PanelBehavior,
+    ): Promise<void>;
 }

chrome/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/chrome",
-    "version": "0.0.250",
+    "version": "0.0.252",
     "description": "TypeScript definitions for chrome",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome",
     "license": "MIT",
@@ -93,6 +93,6 @@
         "@types/filesystem": "*",
         "@types/har-format": "*"
     },
-    "typesPublisherContentHash": "fdaf6bc6c342ccc5d05b899da4d2df9a2bd3c7db066915240b7f1d92956d1b2b",
+    "typesPublisherContentHash": "dca1bd9e1bd607c199132d09e1051c5c05dd3351ac7400b5749a5775f7daf4e5",
     "typeScriptVersion": "4.5"
 }