chrome-types 0.1.338 → 0.1.340

package/_all.d.ts

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-// Generated on Tue Feb 11 2025 14:08:31 GMT+0000 (Coordinated Universal Time)
-// Built at 7d5769cb15c2d16b6175718d023167d0f86ff767
+// Generated on Sat Feb 15 2025 22:30:48 GMT+0000 (Coordinated Universal Time)
+// Built at 70733890e6ccd273c88472fd5823612501a5d0fe
 
 // Includes all types, including MV2 + Platform Apps APIs.
 
@@ -26292,7 +26292,7 @@ declare namespace chrome {
     export interface Session {
 
       /**
-       * The time when the window or tab was closed or modified, represented in milliseconds since the epoch.
+       * The time when the window or tab was closed or modified, represented in seconds since the epoch.
        */
       lastModified: number;
 
@@ -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 11 2025 14:08:26 GMT+0000 (Coordinated Universal Time)
-// Built at 7d5769cb15c2d16b6175718d023167d0f86ff767
+// Generated on Sat Feb 15 2025 22:30:44 GMT+0000 (Coordinated Universal Time)
+// Built at 70733890e6ccd273c88472fd5823612501a5d0fe
 
 // Includes MV3+ APIs only.
 
@@ -20412,7 +20412,7 @@ declare namespace chrome {
     export interface Session {
 
       /**
-       * The time when the window or tab was closed or modified, represented in milliseconds since the epoch.
+       * The time when the window or tab was closed or modified, represented in seconds since the epoch.
        */
       lastModified: number;
 
@@ -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": "208112edae23d540"
+    "build-hash": "aae1e01036f12fe0"
   },
   "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.338"
+  "version": "0.1.340"
 }