chrome-types 0.1.450 → 0.1.452

package/_all.d.ts

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-// Generated on Wed Sep 23 2026 22:44:09 GMT+0000 (Coordinated Universal Time)
-// Built at 4f6f60a0f126d22f11acf933a69c614504e7e20e
+// Generated on Sat Oct 03 2026 23:12:54 GMT+0000 (Coordinated Universal Time)
+// Built at c04040375dc3eb5fd674c28dfb7bc3d470916b72
 
 // Includes all types, including MV2 + Platform Apps APIs.
 
@@ -945,7 +945,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 91
      */
-    export function clearAll(): Promise<boolean>;
+    export function clearAll(): Promise<boolean | undefined>;
 
     /**
      * Clears all alarms.
@@ -953,7 +953,7 @@ declare namespace chrome {
     export function clearAll(
 
       callback?: (
-        wasCleared: boolean,
+        wasCleared?: boolean,
       ) => void,
     ): void;
   }
@@ -6537,11 +6537,13 @@ declare namespace chrome {
   export namespace contextMenus {
 
     /**
-     * The different contexts a menu can appear in. Specifying 'all' is equivalent to the combination of all other contexts except for 'launcher'. The 'launcher' context is only supported by apps and is used to add menu items to the context menu that appears when clicking the app icon in the launcher/taskbar/dock/etc. Different platforms might put limitations on what is actually supported in a launcher context menu.
+     * The different contexts a menu can appear in. Specifying 'all' is equivalent to the combination of all other contexts except for 'launcher' and 'tab'. The 'launcher' context is only supported by apps and is used to add menu items to the context menu that appears when clicking the app icon in the launcher/taskbar/dock/etc. Different platforms might put limitations on what is actually supported in a launcher context menu.
      *
+     * @chrome-enum "action" Applies to the context menu of the extension's action (its toolbar icon).
+     * @chrome-enum "tab" Applies to the context menu of a tab in the tab strip.
      * @since Chrome 44
      */
-    export type ContextType = "all" | "page" | "frame" | "selection" | "link" | "editable" | "image" | "video" | "audio" | "launcher" | "browser_action" | "page_action" | "action" | "tab";
+    export type ContextType = "all" | "page" | "frame" | "selection" | "link" | "editable" | "image" | "video" | "audio" | "launcher" | "action" | "tab";
 
     /**
      * The type of menu item.
@@ -12084,7 +12086,7 @@ declare namespace chrome {
     export 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?: number;
     }
@@ -12252,7 +12254,7 @@ declare namespace chrome {
     ): 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.
      *
      * @chrome-returns-extra since Chrome 96
      * @param downloadId The identifier for the download.
@@ -12266,7 +12268,7 @@ declare namespace chrome {
     ): Promise<string | undefined>;
 
     /**
-     * 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.
      */
@@ -24748,6 +24750,37 @@ declare namespace chrome {
      */
     export type OnInstalledReason = "install" | "update" | "chrome_update" | "shared_module_update";
 
+    /**
+     * The reason that this event is being dispatched.
+     *
+     * @chrome-enum "install" The extension was newly installed.
+     * @chrome-enum "update" The extension was reloaded after an update.
+     * @chrome-enum "browser\_update" The browser was updated to a new version.
+     * @chrome-enum "enable" The extension was re-enabled from a disabled state.
+     * @chrome-enum "startup" The extension is being loaded during browser startup.
+     * @chrome-enum "reload" The extension was reloaded (e.g. via chrome.runtime.reload() or the user manually reloaded the extension).
+     * @since Pending
+     */
+    export type OnLoadedReason = "install" | "update" | "browser_update" | "enable" | "startup" | "reload";
+
+    /**
+     * Details about the extension load event.
+     *
+     * @since Pending
+     */
+    export interface ExtensionLoadDetails {
+
+      /**
+       * The reason that this event is being dispatched.
+       */
+      reason: OnLoadedReason;
+
+      /**
+       * Indicates the previous version of the extension, which has just been updated. This is present only if 'reason' is 'update'.
+       */
+      previousVersion?: string;
+    }
+
     /**
      * The reason that the event is being dispatched. 'app\_update' is used when the restart is needed because the application is updated to a newer version. 'os\_update' is used when the restart is needed because the browser/OS is updated to a newer version. 'periodic' is used when the system runs for more than the permitted uptime set in the enterprise policy.
      *
@@ -24899,6 +24932,15 @@ declare namespace chrome {
      */
     export const onEnabled: events.Event<() => void>;
 
+    /**
+     * Fired when the extension is added to the set of active extensions. This can occur in multiple scenarios: when an extension is first installed, updated to a new version, re-enabled after being disabled, reloaded, loaded during browser startup, or loaded when the browser is updated to a new version.
+     *
+     * @since Pending
+     */
+    export const onExtensionLoaded: events.Event<(
+      details: ExtensionLoadDetails,
+    ) => 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.
      */
@@ -36177,7 +36219,7 @@ declare namespace chrome {
       filters?: {
 
         /**
-         * 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: events.UrlFilter[],
       },
@@ -36261,7 +36303,7 @@ declare namespace chrome {
       filters?: {
 
         /**
-         * 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: events.UrlFilter[],
       },
@@ -36335,7 +36377,7 @@ declare namespace chrome {
       filters?: {
 
         /**
-         * 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: events.UrlFilter[],
       },
@@ -36409,7 +36451,7 @@ declare namespace chrome {
       filters?: {
 
         /**
-         * 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: events.UrlFilter[],
       },
@@ -36491,7 +36533,7 @@ declare namespace chrome {
       filters?: {
 
         /**
-         * 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: events.UrlFilter[],
       },
@@ -36538,7 +36580,7 @@ declare namespace chrome {
       filters?: {
 
         /**
-         * 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: events.UrlFilter[],
       },
@@ -36622,7 +36664,7 @@ declare namespace chrome {
       filters?: {
 
         /**
-         * 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: events.UrlFilter[],
       },
@@ -36729,7 +36771,7 @@ declare namespace chrome {
       filters?: {
 
         /**
-         * 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: events.UrlFilter[],
       },

package/index.d.ts

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-// Generated on Wed Sep 23 2026 22:44:06 GMT+0000 (Coordinated Universal Time)
-// Built at 4f6f60a0f126d22f11acf933a69c614504e7e20e
+// Generated on Sat Oct 03 2026 23:12:52 GMT+0000 (Coordinated Universal Time)
+// Built at c04040375dc3eb5fd674c28dfb7bc3d470916b72
 
 // Includes MV3+ APIs only.
 
@@ -1003,7 +1003,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 91
      */
-    export function clearAll(): Promise<boolean>;
+    export function clearAll(): Promise<boolean | undefined>;
 
     /**
      * Clears all alarms.
@@ -1011,7 +1011,7 @@ declare namespace chrome {
     export function clearAll(
 
       callback?: (
-        wasCleared: boolean,
+        wasCleared?: boolean,
       ) => void,
     ): void;
   }
@@ -3356,11 +3356,13 @@ declare namespace chrome {
   export namespace contextMenus {
 
     /**
-     * The different contexts a menu can appear in. Specifying 'all' is equivalent to the combination of all other contexts except for 'launcher'. The 'launcher' context is only supported by apps and is used to add menu items to the context menu that appears when clicking the app icon in the launcher/taskbar/dock/etc. Different platforms might put limitations on what is actually supported in a launcher context menu.
+     * The different contexts a menu can appear in. Specifying 'all' is equivalent to the combination of all other contexts except for 'launcher' and 'tab'. The 'launcher' context is only supported by apps and is used to add menu items to the context menu that appears when clicking the app icon in the launcher/taskbar/dock/etc. Different platforms might put limitations on what is actually supported in a launcher context menu.
      *
+     * @chrome-enum "action" Applies to the context menu of the extension's action (its toolbar icon).
+     * @chrome-enum "tab" Applies to the context menu of a tab in the tab strip.
      * @since Chrome 44
      */
-    export type ContextType = "all" | "page" | "frame" | "selection" | "link" | "editable" | "image" | "video" | "audio" | "launcher" | "browser_action" | "page_action" | "action" | "tab";
+    export type ContextType = "all" | "page" | "frame" | "selection" | "link" | "editable" | "image" | "video" | "audio" | "launcher" | "action" | "tab";
 
     /**
      * The type of menu item.
@@ -8283,7 +8285,7 @@ declare namespace chrome {
     export 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?: number;
     }
@@ -8451,7 +8453,7 @@ declare namespace chrome {
     ): 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.
      *
      * @chrome-returns-extra since Chrome 96
      * @param downloadId The identifier for the download.
@@ -8465,7 +8467,7 @@ declare namespace chrome {
     ): Promise<string | undefined>;
 
     /**
-     * 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.
      */
@@ -17552,6 +17554,37 @@ declare namespace chrome {
      */
     export type OnInstalledReason = "install" | "update" | "chrome_update" | "shared_module_update";
 
+    /**
+     * The reason that this event is being dispatched.
+     *
+     * @chrome-enum "install" The extension was newly installed.
+     * @chrome-enum "update" The extension was reloaded after an update.
+     * @chrome-enum "browser\_update" The browser was updated to a new version.
+     * @chrome-enum "enable" The extension was re-enabled from a disabled state.
+     * @chrome-enum "startup" The extension is being loaded during browser startup.
+     * @chrome-enum "reload" The extension was reloaded (e.g. via chrome.runtime.reload() or the user manually reloaded the extension).
+     * @since Pending
+     */
+    export type OnLoadedReason = "install" | "update" | "browser_update" | "enable" | "startup" | "reload";
+
+    /**
+     * Details about the extension load event.
+     *
+     * @since Pending
+     */
+    export interface ExtensionLoadDetails {
+
+      /**
+       * The reason that this event is being dispatched.
+       */
+      reason: OnLoadedReason;
+
+      /**
+       * Indicates the previous version of the extension, which has just been updated. This is present only if 'reason' is 'update'.
+       */
+      previousVersion?: string;
+    }
+
     /**
      * The reason that the event is being dispatched. 'app\_update' is used when the restart is needed because the application is updated to a newer version. 'os\_update' is used when the restart is needed because the browser/OS is updated to a newer version. 'periodic' is used when the system runs for more than the permitted uptime set in the enterprise policy.
      *
@@ -17692,6 +17725,15 @@ declare namespace chrome {
      */
     export const onEnabled: events.Event<() => void>;
 
+    /**
+     * Fired when the extension is added to the set of active extensions. This can occur in multiple scenarios: when an extension is first installed, updated to a new version, re-enabled after being disabled, reloaded, loaded during browser startup, or loaded when the browser is updated to a new version.
+     *
+     * @since Pending
+     */
+    export const onExtensionLoaded: events.Event<(
+      details: ExtensionLoadDetails,
+    ) => 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.
      */
@@ -26114,7 +26156,7 @@ declare namespace chrome {
       filters?: {
 
         /**
-         * 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: events.UrlFilter[],
       },
@@ -26198,7 +26240,7 @@ declare namespace chrome {
       filters?: {
 
         /**
-         * 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: events.UrlFilter[],
       },
@@ -26272,7 +26314,7 @@ declare namespace chrome {
       filters?: {
 
         /**
-         * 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: events.UrlFilter[],
       },
@@ -26346,7 +26388,7 @@ declare namespace chrome {
       filters?: {
 
         /**
-         * 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: events.UrlFilter[],
       },
@@ -26428,7 +26470,7 @@ declare namespace chrome {
       filters?: {
 
         /**
-         * 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: events.UrlFilter[],
       },
@@ -26475,7 +26517,7 @@ declare namespace chrome {
       filters?: {
 
         /**
-         * 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: events.UrlFilter[],
       },
@@ -26559,7 +26601,7 @@ declare namespace chrome {
       filters?: {
 
         /**
-         * 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: events.UrlFilter[],
       },
@@ -26666,7 +26708,7 @@ declare namespace chrome {
       filters?: {
 
         /**
-         * 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: events.UrlFilter[],
       },

package/package.json

@@ -5,7 +5,7 @@
   "type": "module",
   "name": "chrome-types",
   "config": {
-    "build-hash": "b8bdde23a6030112"
+    "build-hash": "eac4cd66d8656705"
   },
   "repository": {
     "type": "git",
@@ -16,5 +16,5 @@
     "url": "https://github.com/GoogleChrome/chrome-types/issues"
   },
   "homepage": "https://github.com/GoogleChrome/chrome-types",
-  "version": "0.1.450"
+  "version": "0.1.452"
 }