chrome-types 0.1.337 → 0.1.339

package/_all.d.ts

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-// Generated on Tue Feb 04 2025 22:31:15 GMT+0000 (Coordinated Universal Time)
-// Built at a0698282be741d934273bc95ecab6b021562fa6e
+// Generated on Fri Feb 14 2025 22:31:00 GMT+0000 (Coordinated Universal Time)
+// Built at f77835d39ba0b4dabb179df1fe9e02b76e63a36b
 
 // Includes all types, including MV2 + Platform Apps APIs.
 
@@ -28688,7 +28688,7 @@ declare namespace chrome {
       /**
        * Gets one or more items from storage.
        *
-       * @chrome-returns-extra since Chrome 88
+       * @chrome-returns-extra since Chrome 95
        * @param keys A single key to get, list of keys to get, or a dictionary specifying default values (see description of the object). An empty list or object will return an empty result object. Pass in `null` to get the entire contents of storage.
        */
       get(
@@ -28740,7 +28740,7 @@ declare namespace chrome {
       /**
        * Gets the amount of space (in bytes) being used by one or more items.
        *
-       * @chrome-returns-extra since Chrome 88
+       * @chrome-returns-extra since Chrome 95
        * @param keys A single key or list of keys to get the total usage for. An empty list will return 0. Pass in `null` to get the total usage of all of storage.
        */
       getBytesInUse(
@@ -28769,7 +28769,7 @@ declare namespace chrome {
       /**
        * Sets multiple items.
        *
-       * @chrome-returns-extra since Chrome 88
+       * @chrome-returns-extra since Chrome 95
        * @param items
 
       An object which gives each key/value pair to update storage with. Any other key/value pairs in storage will not be affected.
@@ -28801,7 +28801,7 @@ declare namespace chrome {
       /**
        * Removes one or more items from storage.
        *
-       * @chrome-returns-extra since Chrome 88
+       * @chrome-returns-extra since Chrome 95
        * @param keys A single key or a list of keys for items to remove.
        */
       remove(
@@ -28825,7 +28825,7 @@ declare namespace chrome {
       /**
        * Removes all items from storage.
        *
-       * @chrome-returns-extra since Chrome 88
+       * @chrome-returns-extra since Chrome 95
        */
       clear(): Promise<void>;
 
@@ -34618,6 +34618,89 @@ declare namespace chrome {
       ids?: string[];
     }
 
+    /**
+     * @since Pending
+     */
+    export interface InjectionTarget {
+
+      /**
+       * Whether the script should inject into all frames within the tab. Defaults to false. This must not be true if `frameIds` is specified.
+       */
+      allFrames?: boolean;
+
+      /**
+       * The IDs of specific documentIds to inject into. This must not be set if `frameIds` is set.
+       */
+      documentIds?: string[];
+
+      /**
+       * The IDs of specific frames to inject into.
+       */
+      frameIds?: number[];
+
+      /**
+       * The ID of the tab into which to inject.
+       */
+      tabId: number;
+    }
+
+    /**
+     * @since Pending
+     */
+    export interface InjectionResult {
+
+      /**
+       * The document associated with the injection.
+       */
+      documentId: string;
+
+      /**
+       * The frame associated with the injection.
+       */
+      frameId: number;
+
+      /**
+       * The result of the script execution.
+       */
+      result?: any;
+
+      /**
+       * The error, if any. `error` and `result` are mutually exclusive.
+       */
+      error?: string;
+    }
+
+    /**
+     * @since Pending
+     */
+    export interface UserScriptInjection {
+
+      /**
+       * Whether the injection should be triggered in the target as soon as possible. Note that this is not a guarantee that injection will occur prior to page load, as the page may have already loaded by the time the script reaches the target.
+       */
+      injectImmediately?: boolean;
+
+      /**
+       * The list of ScriptSource objects defining sources of scripts to be injected into the target.
+       */
+      js: ScriptSource[];
+
+      /**
+       * Details specifying the target into which to inject the script.
+       */
+      target: InjectionTarget;
+
+      /**
+       * The JavaScript "world" to run the script in. The default is `USER_SCRIPT`.
+       */
+      world?: ExecutionWorld;
+
+      /**
+       * Specifies the user script world ID to execute in. If omitted, the script will execute in the default user script world. Only valid if `world` is omitted or is `USER_SCRIPT`. Values with leading underscores (`_`) are reserved.
+       */
+      worldId?: string;
+    }
+
     export interface WorldProperties {
 
       /**
@@ -34732,6 +34815,30 @@ declare namespace chrome {
       callback?: () => void,
     ): void;
 
+    /**
+     * Injects a script into a target context. By default, the script will be run at `document_idle`, or immediately if the page has already loaded. If the `injectImmediately` property is set, the script will inject without waiting, even if the page has not finished loading. If the script evaluates to a promise, the browser will wait for the promise to settle and return the resulting value.
+     *
+     * @since Pending
+     */
+    export function execute(
+
+      injection: UserScriptInjection,
+    ): Promise<InjectionResult[]>;
+
+    /**
+     * Injects a script into a target context. By default, the script will be run at `document_idle`, or immediately if the page has already loaded. If the `injectImmediately` property is set, the script will inject without waiting, even if the page has not finished loading. If the script evaluates to a promise, the browser will wait for the promise to settle and return the resulting value.
+     *
+     * @since Pending
+     */
+    export function execute(
+
+      injection: UserScriptInjection,
+
+      callback?: (
+        result: InjectionResult[],
+      ) => void,
+    ): void;
+
     /**
      * Configures the `` `USER_SCRIPT` `` execution environment.
      *

package/index.d.ts

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-// Generated on Tue Feb 04 2025 22:31:10 GMT+0000 (Coordinated Universal Time)
-// Built at a0698282be741d934273bc95ecab6b021562fa6e
+// Generated on Fri Feb 14 2025 22:30:55 GMT+0000 (Coordinated Universal Time)
+// Built at f77835d39ba0b4dabb179df1fe9e02b76e63a36b
 
 // Includes MV3+ APIs only.
 
@@ -22146,7 +22146,7 @@ declare namespace chrome {
       /**
        * Gets one or more items from storage.
        *
-       * @chrome-returns-extra since Chrome 88
+       * @chrome-returns-extra since Chrome 95
        * @param keys A single key to get, list of keys to get, or a dictionary specifying default values (see description of the object). An empty list or object will return an empty result object. Pass in `null` to get the entire contents of storage.
        */
       get(
@@ -22198,7 +22198,7 @@ declare namespace chrome {
       /**
        * Gets the amount of space (in bytes) being used by one or more items.
        *
-       * @chrome-returns-extra since Chrome 88
+       * @chrome-returns-extra since Chrome 95
        * @param keys A single key or list of keys to get the total usage for. An empty list will return 0. Pass in `null` to get the total usage of all of storage.
        */
       getBytesInUse(
@@ -22227,7 +22227,7 @@ declare namespace chrome {
       /**
        * Sets multiple items.
        *
-       * @chrome-returns-extra since Chrome 88
+       * @chrome-returns-extra since Chrome 95
        * @param items
 
       An object which gives each key/value pair to update storage with. Any other key/value pairs in storage will not be affected.
@@ -22259,7 +22259,7 @@ declare namespace chrome {
       /**
        * Removes one or more items from storage.
        *
-       * @chrome-returns-extra since Chrome 88
+       * @chrome-returns-extra since Chrome 95
        * @param keys A single key or a list of keys for items to remove.
        */
       remove(
@@ -22283,7 +22283,7 @@ declare namespace chrome {
       /**
        * Removes all items from storage.
        *
-       * @chrome-returns-extra since Chrome 88
+       * @chrome-returns-extra since Chrome 95
        */
       clear(): Promise<void>;
 
@@ -27424,6 +27424,89 @@ declare namespace chrome {
       ids?: string[];
     }
 
+    /**
+     * @since Pending
+     */
+    export interface InjectionTarget {
+
+      /**
+       * Whether the script should inject into all frames within the tab. Defaults to false. This must not be true if `frameIds` is specified.
+       */
+      allFrames?: boolean;
+
+      /**
+       * The IDs of specific documentIds to inject into. This must not be set if `frameIds` is set.
+       */
+      documentIds?: string[];
+
+      /**
+       * The IDs of specific frames to inject into.
+       */
+      frameIds?: number[];
+
+      /**
+       * The ID of the tab into which to inject.
+       */
+      tabId: number;
+    }
+
+    /**
+     * @since Pending
+     */
+    export interface InjectionResult {
+
+      /**
+       * The document associated with the injection.
+       */
+      documentId: string;
+
+      /**
+       * The frame associated with the injection.
+       */
+      frameId: number;
+
+      /**
+       * The result of the script execution.
+       */
+      result?: any;
+
+      /**
+       * The error, if any. `error` and `result` are mutually exclusive.
+       */
+      error?: string;
+    }
+
+    /**
+     * @since Pending
+     */
+    export interface UserScriptInjection {
+
+      /**
+       * Whether the injection should be triggered in the target as soon as possible. Note that this is not a guarantee that injection will occur prior to page load, as the page may have already loaded by the time the script reaches the target.
+       */
+      injectImmediately?: boolean;
+
+      /**
+       * The list of ScriptSource objects defining sources of scripts to be injected into the target.
+       */
+      js: ScriptSource[];
+
+      /**
+       * Details specifying the target into which to inject the script.
+       */
+      target: InjectionTarget;
+
+      /**
+       * The JavaScript "world" to run the script in. The default is `USER_SCRIPT`.
+       */
+      world?: ExecutionWorld;
+
+      /**
+       * Specifies the user script world ID to execute in. If omitted, the script will execute in the default user script world. Only valid if `world` is omitted or is `USER_SCRIPT`. Values with leading underscores (`_`) are reserved.
+       */
+      worldId?: string;
+    }
+
     export interface WorldProperties {
 
       /**
@@ -27538,6 +27621,30 @@ declare namespace chrome {
       callback?: () => void,
     ): void;
 
+    /**
+     * Injects a script into a target context. By default, the script will be run at `document_idle`, or immediately if the page has already loaded. If the `injectImmediately` property is set, the script will inject without waiting, even if the page has not finished loading. If the script evaluates to a promise, the browser will wait for the promise to settle and return the resulting value.
+     *
+     * @since Pending
+     */
+    export function execute(
+
+      injection: UserScriptInjection,
+    ): Promise<InjectionResult[]>;
+
+    /**
+     * Injects a script into a target context. By default, the script will be run at `document_idle`, or immediately if the page has already loaded. If the `injectImmediately` property is set, the script will inject without waiting, even if the page has not finished loading. If the script evaluates to a promise, the browser will wait for the promise to settle and return the resulting value.
+     *
+     * @since Pending
+     */
+    export function execute(
+
+      injection: UserScriptInjection,
+
+      callback?: (
+        result: InjectionResult[],
+      ) => void,
+    ): void;
+
     /**
      * Configures the `` `USER_SCRIPT` `` execution environment.
      *

package/package.json

@@ -5,7 +5,7 @@
   "type": "module",
   "name": "chrome-types",
   "config": {
-    "build-hash": "9ce516266b389ec2"
+    "build-hash": "0aeba0e6c7fed3ab"
   },
   "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.337"
+  "version": "0.1.339"
 }