chrome-types 0.1.325 → 0.1.327

package/_all.d.ts

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-// Generated on Thu Dec 12 2024 13:34:32 GMT+0000 (Coordinated Universal Time)
-// Built at 5d57323b9458e03eef51fe0ccc353e0fc286f545
+// Generated on Fri Dec 20 2024 22:30:26 GMT+0000 (Coordinated Universal Time)
+// Built at 4eee6e3177095e795db1a007571f94f5bcea5ad9
 
 // Includes all types, including MV2 + Platform Apps APIs.
 
@@ -12369,7 +12369,7 @@ declare namespace chrome {
       /**
        * Implements the WebCrypto's [SubtleCrypto](https://www.w3.org/TR/WebCryptoAPI/#subtlecrypto-interface) interface. The cryptographic operations, including key generation, are hardware-backed.
        *
-       * Only non-extractable keys can be generated. The supported key types are RSASSA-PKCS1-V1\_5 and RSA-OAEP with `modulusLength` up to 2048 and ECDSA with `namedCurve` P-256. Each RSASSA-PKCS1-V1\_5 and ECDSA key can be used for signing data at most once, unless the extension is allowlisted through the [KeyPermissions policy](https://chromeenterprise.google/policies/#KeyPermissions), in which case the key can be used indefinitely. RSA-OAEP keys can be used by extensions allowlisted in that same policy to unwrap other keys.
+       * Only non-extractable keys can be generated. The supported key types are RSASSA-PKCS1-V1\_5 and RSA-OAEP (on Chrome versions 134+) with `modulusLength` up to 2048 and ECDSA with `namedCurve` P-256. Each RSASSA-PKCS1-V1\_5 and ECDSA key can be used for signing data at most once, unless the extension is allowlisted through the [KeyPermissions policy](https://chromeenterprise.google/policies/#KeyPermissions), in which case the key can be used indefinitely. RSA-OAEP keys are supported since Chrome version 134 and can be used by extensions allowlisted through that same policy to unwrap other keys.
        *
        * Keys generated on a specific `Token` cannot be used with any other Tokens, nor can they be used with `window.crypto.subtle`. Equally, `Key` objects created with `window.crypto.subtle` cannot be used with this interface.
        */
@@ -12378,7 +12378,7 @@ declare namespace chrome {
       /**
        * Implements the WebCrypto's [SubtleCrypto](https://www.w3.org/TR/WebCryptoAPI/#subtlecrypto-interface) interface. The cryptographic operations, including key generation, are software-backed. Protection of the keys, and thus implementation of the non-extractable property, is done in software, so the keys are less protected than hardware-backed keys.
        *
-       * Only non-extractable keys can be generated. The supported key types are RSASSA-PKCS1-V1\_5 and RSA-OAEP with `modulusLength` up to 2048. Each RSASSA-PKCS1-V1\_5 key can be used for signing data at most once, unless the extension is allowlisted through the [KeyPermissions policy](https://chromeenterprise.google/policies/#KeyPermissions), in which case the key can be used indefinitely. RSA-OAEP keys can be used by extensions allowlisted in that same policy to unwrap other keys.
+       * Only non-extractable keys can be generated. The supported key types are RSASSA-PKCS1-V1\_5 and RSA-OAEP (on Chrome versions 134+) with `modulusLength` up to 2048. Each RSASSA-PKCS1-V1\_5 key can be used for signing data at most once, unless the extension is allowlisted through the [KeyPermissions policy](https://chromeenterprise.google/policies/#KeyPermissions), in which case the key can be used indefinitely. RSA-OAEP keys are supported since Chrome version 134 and can be used by extensions allowlisted through that same policy to unwrap other keys.
        *
        * Keys generated on a specific `Token` cannot be used with any other Tokens, nor can they be used with `window.crypto.subtle`. Equally, `Key` objects created with `window.crypto.subtle` cannot be used with this interface.
        *
@@ -22570,7 +22570,7 @@ declare namespace chrome {
     export function getAll(
 
       /**
-       * @param permissions The extension's active permissions. Note that the `origins` property will contain granted origins from those specified in the `permissions` and `optional_permissions` keys in the manifest and those associated with [Content Scripts](https://developer.chrome.com/docs/extensions/content_scripts).
+       * @param permissions The extension's active permissions. Note that the `origins` property will contain granted origins from those specified in the `permissions` and `optional_permissions` keys in the manifest and those associated with [Content Scripts](https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts).
        */
       callback?: (
         permissions: Permissions,
@@ -24744,6 +24744,7 @@ declare namespace chrome {
      * Retrieves the JavaScript 'window' object for the background page running inside the current extension/app. If the background page is an event page, the system will ensure it is loaded before calling the callback. If there is no background page, an error is set.
      *
      * @chrome-returns-extra since Chrome 99
+     * @deprecated Background pages do not exist in MV3 extensions.
      * @chrome-disallow-service-workers
      */
     export function getBackgroundPage(): Promise<Window | undefined>;
@@ -24751,6 +24752,7 @@ declare namespace chrome {
     /**
      * Retrieves the JavaScript 'window' object for the background page running inside the current extension/app. If the background page is an event page, the system will ensure it is loaded before calling the callback. If there is no background page, an error is set.
      *
+     * @deprecated Background pages do not exist in MV3 extensions.
      * @chrome-disallow-service-workers
      */
     export function getBackgroundPage(
@@ -34524,9 +34526,9 @@ declare namespace chrome {
       excludeGlobs?: string[];
 
       /**
-       * The list of ScriptSource objects defining sources of scripts to be injected into matching pages.
+       * The list of ScriptSource objects defining sources of scripts to be injected into matching pages. This property must be specified for ${ref:register}, and when specified it must be a non-empty array.
        */
-      js: ScriptSource[];
+      js?: ScriptSource[];
 
       /**
        * Specifies which pages this user script will be injected into. See [Match Patterns](https://developer.chrome.com/extensions/develop/concepts/match-patterns) for more details on the syntax of these strings. This property must be specified for ${ref:register}.
@@ -34542,6 +34544,13 @@ declare namespace chrome {
        * The JavaScript execution environment to run the script in. The default is `` `USER_SCRIPT` ``.
        */
       world?: ExecutionWorld;
+
+      /**
+       * If specified, specifies a specific user script world ID to execute in. Only valid if `world` is omitted or is `USER_SCRIPT`. If omitted, the script will execute in the default user script world. Values with leading underscores (`_`) are reserved.
+       *
+       * @since Pending
+       */
+      worldId?: string;
     }
 
     export interface UserScriptFilter {
@@ -34554,6 +34563,13 @@ declare namespace chrome {
 
     export interface WorldProperties {
 
+      /**
+       * Specifies the ID of the specific user script world to update. If not provided, updates the properties of the default user script world. Values with leading underscores (`_`) are reserved.
+       *
+       * @since Pending
+       */
+      worldId?: string;
+
       /**
        * Specifies the world csp. The default is the `` `ISOLATED` `` world csp.
        */
@@ -34681,6 +34697,51 @@ declare namespace chrome {
 
       callback?: () => void,
     ): void;
+
+    /**
+     * Retrieves all registered world configurations.
+     *
+     * @since Pending
+     */
+    export function getWorldConfigurations(): Promise<WorldProperties[]>;
+
+    /**
+     * Retrieves all registered world configurations.
+     *
+     * @param callback Called with the registered world configurations.
+     * @since Pending
+     */
+    export function getWorldConfigurations(
+
+      callback?: (
+        worlds: WorldProperties[],
+      ) => void,
+    ): void;
+
+    /**
+     * Resets the configuration for a user script world. Any scripts that inject into the world with the specified ID will use the default world configuration.
+     *
+     * @param worldId The ID of the user script world to reset. If omitted, resets the default world's configuration.
+     * @since Pending
+     */
+    export function resetWorldConfiguration(
+
+      worldId?: string,
+    ): Promise<void>;
+
+    /**
+     * Resets the configuration for a user script world. Any scripts that inject into the world with the specified ID will use the default world configuration.
+     *
+     * @param worldId The ID of the user script world to reset. If omitted, resets the default world's configuration.
+     * @param callback Called when the configuration is reset.
+     * @since Pending
+     */
+    export function resetWorldConfiguration(
+
+      worldId?: string,
+
+      callback?: () => void,
+    ): void;
   }
 
   /**

package/index.d.ts

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-// Generated on Thu Dec 12 2024 13:34:27 GMT+0000 (Coordinated Universal Time)
-// Built at 5d57323b9458e03eef51fe0ccc353e0fc286f545
+// Generated on Fri Dec 20 2024 22:30:21 GMT+0000 (Coordinated Universal Time)
+// Built at 4eee6e3177095e795db1a007571f94f5bcea5ad9
 
 // Includes MV3+ APIs only.
 
@@ -8489,7 +8489,7 @@ declare namespace chrome {
       /**
        * Implements the WebCrypto's [SubtleCrypto](https://www.w3.org/TR/WebCryptoAPI/#subtlecrypto-interface) interface. The cryptographic operations, including key generation, are hardware-backed.
        *
-       * Only non-extractable keys can be generated. The supported key types are RSASSA-PKCS1-V1\_5 and RSA-OAEP with `modulusLength` up to 2048 and ECDSA with `namedCurve` P-256. Each RSASSA-PKCS1-V1\_5 and ECDSA key can be used for signing data at most once, unless the extension is allowlisted through the [KeyPermissions policy](https://chromeenterprise.google/policies/#KeyPermissions), in which case the key can be used indefinitely. RSA-OAEP keys can be used by extensions allowlisted in that same policy to unwrap other keys.
+       * Only non-extractable keys can be generated. The supported key types are RSASSA-PKCS1-V1\_5 and RSA-OAEP (on Chrome versions 134+) with `modulusLength` up to 2048 and ECDSA with `namedCurve` P-256. Each RSASSA-PKCS1-V1\_5 and ECDSA key can be used for signing data at most once, unless the extension is allowlisted through the [KeyPermissions policy](https://chromeenterprise.google/policies/#KeyPermissions), in which case the key can be used indefinitely. RSA-OAEP keys are supported since Chrome version 134 and can be used by extensions allowlisted through that same policy to unwrap other keys.
        *
        * Keys generated on a specific `Token` cannot be used with any other Tokens, nor can they be used with `window.crypto.subtle`. Equally, `Key` objects created with `window.crypto.subtle` cannot be used with this interface.
        */
@@ -8498,7 +8498,7 @@ declare namespace chrome {
       /**
        * Implements the WebCrypto's [SubtleCrypto](https://www.w3.org/TR/WebCryptoAPI/#subtlecrypto-interface) interface. The cryptographic operations, including key generation, are software-backed. Protection of the keys, and thus implementation of the non-extractable property, is done in software, so the keys are less protected than hardware-backed keys.
        *
-       * Only non-extractable keys can be generated. The supported key types are RSASSA-PKCS1-V1\_5 and RSA-OAEP with `modulusLength` up to 2048. Each RSASSA-PKCS1-V1\_5 key can be used for signing data at most once, unless the extension is allowlisted through the [KeyPermissions policy](https://chromeenterprise.google/policies/#KeyPermissions), in which case the key can be used indefinitely. RSA-OAEP keys can be used by extensions allowlisted in that same policy to unwrap other keys.
+       * Only non-extractable keys can be generated. The supported key types are RSASSA-PKCS1-V1\_5 and RSA-OAEP (on Chrome versions 134+) with `modulusLength` up to 2048. Each RSASSA-PKCS1-V1\_5 key can be used for signing data at most once, unless the extension is allowlisted through the [KeyPermissions policy](https://chromeenterprise.google/policies/#KeyPermissions), in which case the key can be used indefinitely. RSA-OAEP keys are supported since Chrome version 134 and can be used by extensions allowlisted through that same policy to unwrap other keys.
        *
        * Keys generated on a specific `Token` cannot be used with any other Tokens, nor can they be used with `window.crypto.subtle`. Equally, `Key` objects created with `window.crypto.subtle` cannot be used with this interface.
        *
@@ -17315,7 +17315,7 @@ declare namespace chrome {
     export function getAll(
 
       /**
-       * @param permissions The extension's active permissions. Note that the `origins` property will contain granted origins from those specified in the `permissions` and `optional_permissions` keys in the manifest and those associated with [Content Scripts](https://developer.chrome.com/docs/extensions/content_scripts).
+       * @param permissions The extension's active permissions. Note that the `origins` property will contain granted origins from those specified in the `permissions` and `optional_permissions` keys in the manifest and those associated with [Content Scripts](https://developer.chrome.com/docs/extensions/develop/concepts/content-scripts).
        */
       callback?: (
         permissions: Permissions,
@@ -19478,6 +19478,7 @@ declare namespace chrome {
      * Retrieves the JavaScript 'window' object for the background page running inside the current extension/app. If the background page is an event page, the system will ensure it is loaded before calling the callback. If there is no background page, an error is set.
      *
      * @chrome-returns-extra since Chrome 99
+     * @deprecated Background pages do not exist in MV3 extensions.
      * @chrome-disallow-service-workers
      */
     export function getBackgroundPage(): Promise<Window | undefined>;
@@ -19485,6 +19486,7 @@ declare namespace chrome {
     /**
      * Retrieves the JavaScript 'window' object for the background page running inside the current extension/app. If the background page is an event page, the system will ensure it is loaded before calling the callback. If there is no background page, an error is set.
      *
+     * @deprecated Background pages do not exist in MV3 extensions.
      * @chrome-disallow-service-workers
      */
     export function getBackgroundPage(
@@ -27330,9 +27332,9 @@ declare namespace chrome {
       excludeGlobs?: string[];
 
       /**
-       * The list of ScriptSource objects defining sources of scripts to be injected into matching pages.
+       * The list of ScriptSource objects defining sources of scripts to be injected into matching pages. This property must be specified for ${ref:register}, and when specified it must be a non-empty array.
        */
-      js: ScriptSource[];
+      js?: ScriptSource[];
 
       /**
        * Specifies which pages this user script will be injected into. See [Match Patterns](https://developer.chrome.com/extensions/develop/concepts/match-patterns) for more details on the syntax of these strings. This property must be specified for ${ref:register}.
@@ -27348,6 +27350,13 @@ declare namespace chrome {
        * The JavaScript execution environment to run the script in. The default is `` `USER_SCRIPT` ``.
        */
       world?: ExecutionWorld;
+
+      /**
+       * If specified, specifies a specific user script world ID to execute in. Only valid if `world` is omitted or is `USER_SCRIPT`. If omitted, the script will execute in the default user script world. Values with leading underscores (`_`) are reserved.
+       *
+       * @since Pending
+       */
+      worldId?: string;
     }
 
     export interface UserScriptFilter {
@@ -27360,6 +27369,13 @@ declare namespace chrome {
 
     export interface WorldProperties {
 
+      /**
+       * Specifies the ID of the specific user script world to update. If not provided, updates the properties of the default user script world. Values with leading underscores (`_`) are reserved.
+       *
+       * @since Pending
+       */
+      worldId?: string;
+
       /**
        * Specifies the world csp. The default is the `` `ISOLATED` `` world csp.
        */
@@ -27487,6 +27503,51 @@ declare namespace chrome {
 
       callback?: () => void,
     ): void;
+
+    /**
+     * Retrieves all registered world configurations.
+     *
+     * @since Pending
+     */
+    export function getWorldConfigurations(): Promise<WorldProperties[]>;
+
+    /**
+     * Retrieves all registered world configurations.
+     *
+     * @param callback Called with the registered world configurations.
+     * @since Pending
+     */
+    export function getWorldConfigurations(
+
+      callback?: (
+        worlds: WorldProperties[],
+      ) => void,
+    ): void;
+
+    /**
+     * Resets the configuration for a user script world. Any scripts that inject into the world with the specified ID will use the default world configuration.
+     *
+     * @param worldId The ID of the user script world to reset. If omitted, resets the default world's configuration.
+     * @since Pending
+     */
+    export function resetWorldConfiguration(
+
+      worldId?: string,
+    ): Promise<void>;
+
+    /**
+     * Resets the configuration for a user script world. Any scripts that inject into the world with the specified ID will use the default world configuration.
+     *
+     * @param worldId The ID of the user script world to reset. If omitted, resets the default world's configuration.
+     * @param callback Called when the configuration is reset.
+     * @since Pending
+     */
+    export function resetWorldConfiguration(
+
+      worldId?: string,
+
+      callback?: () => void,
+    ): void;
   }
 
   /**

package/package.json

@@ -5,7 +5,7 @@
   "type": "module",
   "name": "chrome-types",
   "config": {
-    "build-hash": "7b1988601b06716b"
+    "build-hash": "2227d32003049f4c"
   },
   "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.325"
+  "version": "0.1.327"
 }