chrome-types 0.1.223 → 0.1.225

package/_all.d.ts

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-// Generated on Tue Aug 15 2023 22:32:57 GMT+0000 (Coordinated Universal Time)
-// Built at 805a5a4b71b6902844392777181234f012fca060
+// Generated on Mon Aug 21 2023 13:07:06 GMT+0000 (Coordinated Universal Time)
+// Built at 8e2cf1aa296431da9cb31e9ab935b3e37801ee10
 
 // Includes all types, including MV2 + Platform Apps APIs.
 
@@ -1894,7 +1894,7 @@ declare namespace chrome {
     /**
      * Gets a list of audio devices filtered based on `filter`.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param filter Device properties by which to filter the list of returned audio devices. If the filter is not set or set to `{}`, returned device list will contain all available audio devices.
      */
     export function getDevices(
@@ -1920,7 +1920,7 @@ declare namespace chrome {
     /**
      * Sets lists of active input and/or output devices.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param ids
 
     Specifies IDs of devices that should be active. If either the input or output list is not set, devices in that category are unaffected.
@@ -1951,7 +1951,7 @@ declare namespace chrome {
     /**
      * Sets the properties for the input or output device.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      */
     export function setProperties(
 
@@ -1975,7 +1975,7 @@ declare namespace chrome {
     /**
      * Gets the system-wide mute state for the specified stream type.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param streamType Stream type for which mute state should be fetched.
      */
     export function getMute(
@@ -2001,7 +2001,7 @@ declare namespace chrome {
     /**
      * Sets mute state for a stream type. The mute state will apply to all audio devices with the specified audio stream type.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param streamType Stream type for which mute state should be set.
      * @param isMuted New mute value.
      */
@@ -4566,7 +4566,7 @@ declare namespace chrome {
     /**
      * Sets the icon for the browser action. The icon can be specified as the path to an image file, as the pixel data from a canvas element, or as a dictionary of one of those. Either the `path` or the `imageData` property must be specified.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      */
     export function setIcon(
 
@@ -8543,6 +8543,56 @@ declare namespace chrome {
       ) => void,
     ): void;
 
+    /**
+     * Disables and enables individual static rules in a {@link Ruleset}. Changes to rules belonging to a disabled {@link Ruleset} will take effect the next time that it becomes enabled.
+     *
+     * @since Pending
+     */
+    export function updateStaticRules(
+
+      options: UpdateStaticRulesOptions,
+    ): Promise<void>;
+
+    /**
+     * Disables and enables individual static rules in a {@link Ruleset}. Changes to rules belonging to a disabled {@link Ruleset} will take effect the next time that it becomes enabled.
+     *
+     * @param callback Called once the update is complete. In case of an error, {@link runtime.lastError} will be set and no change will be made to the enabled static rules.
+     * @since Pending
+     */
+    export function updateStaticRules(
+
+      options: UpdateStaticRulesOptions,
+
+      callback?: () => void,
+    ): void;
+
+    /**
+     * Returns the list of static rules in the given {@link Ruleset} that are currently disabled.
+     *
+     * @param options Specifies the ruleset to query.
+     * @since Pending
+     */
+    export function getDisabledRuleIds(
+
+      options: GetDisabledRuleIdsOptions,
+    ): Promise<number[]>;
+
+    /**
+     * Returns the list of static rules in the given {@link Ruleset} that are currently disabled.
+     *
+     * @param options Specifies the ruleset to query.
+     * @param callback Called with a list of ids that correspond to the disabled rules in that ruleset.
+     * @since Pending
+     */
+    export function getDisabledRuleIds(
+
+      options: GetDisabledRuleIdsOptions,
+
+      callback?: (
+        disabledRuleIds: number[],
+      ) => void,
+    ): void;
+
     /**
      * Returns all rules matched for the extension. Callers can optionally filter the list of matched rules by specifying a `filter`. This method is only available to extensions with the `declarativeNetRequestFeedback` permission or having the `activeTab` permission granted for the `tabId` specified in `filter`. Note: Rules not associated with an active document that were matched more than five minutes ago will not be returned.
      *
@@ -14468,7 +14518,7 @@ declare namespace chrome {
     /**
      * Registers the application with FCM. The registration ID will be returned by the `callback`. If `register` is called again with the same list of `senderIds`, the same registration ID will be returned.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param senderIds A list of server IDs that are allowed to send messages to the application. It should contain at least one and no more than 100 sender IDs.
      */
     export function register(
@@ -14497,7 +14547,7 @@ declare namespace chrome {
     /**
      * Unregisters the application from FCM.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      */
     export function unregister(): Promise<void>;
 
@@ -14514,7 +14564,7 @@ declare namespace chrome {
     /**
      * Sends a message according to its contents.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param message A message to send to the other party via FCM.
      */
     export function send(
@@ -15742,7 +15792,7 @@ declare namespace chrome {
     /**
      * Returns "locked" if the system is locked, "idle" if the user has not generated any input for a specified number of seconds, or "active" otherwise.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param detectionIntervalInSeconds The system is considered idle if detectionIntervalInSeconds seconds have elapsed since the last user input detected.
      */
     export function queryState(
@@ -15777,7 +15827,7 @@ declare namespace chrome {
     /**
      * Gets the time, in seconds, it takes until the screen is locked automatically while idle. Returns a zero duration if the screen is never locked automatically. Currently supported on Chrome OS only.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @since Chrome 73
      * @chrome-platform chromeos
      * @chrome-platform lacros
@@ -18188,7 +18238,7 @@ declare namespace chrome {
     /**
      * Get the media galleries configured in this user agent. If none are configured or available, the callback will receive an empty array.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      */
     export function getMediaFileSystems(
 
@@ -18229,7 +18279,7 @@ declare namespace chrome {
     /**
      * Gets the media-specific metadata for a media file. This should work for files in media galleries as well as other DOM filesystems.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      */
     export function getMetadata(
 
@@ -18255,7 +18305,7 @@ declare namespace chrome {
     /**
      * Adds a gallery watch for the gallery with the specified gallery ID. The given callback is then fired with a success or failure result.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      */
     export function addGalleryWatch(
 
@@ -20334,7 +20384,7 @@ declare namespace chrome {
     /**
      * Creates and displays a notification.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param notificationId
 
     Identifier of the notification. If not set or empty, an ID will automatically be generated. If it matches an existing notification, this method first clears that notification before proceeding with the create operation. The identifier may not be longer than 500 characters.
@@ -20352,7 +20402,7 @@ declare namespace chrome {
     /**
      * Creates and displays a notification.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param options Contents of the notification.
      */
     export function create(
@@ -20408,7 +20458,7 @@ declare namespace chrome {
     /**
      * Updates an existing notification.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param notificationId The id of the notification to be updated. This is returned by {@link notifications.create} method.
      * @param options Contents of the notification to update to.
      */
@@ -20444,7 +20494,7 @@ declare namespace chrome {
     /**
      * Clears the specified notification.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param notificationId The id of the notification to be cleared. This is returned by {@link notifications.create} method.
      */
     export function clear(
@@ -20474,7 +20524,7 @@ declare namespace chrome {
     /**
      * Retrieves all the notifications of this app or extension.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      */
     export function getAll(): Promise<{[name: string]: any}>;
 
@@ -20493,7 +20543,7 @@ declare namespace chrome {
     /**
      * Retrieves whether the user has enabled notifications from this app or extension.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      */
     export function getPermissionLevel(): Promise<PermissionLevel>;
 
@@ -21028,7 +21078,7 @@ declare namespace chrome {
     /**
      * Saves the content of the tab with given id as MHTML.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      */
     export function saveAsMHTML(
 
@@ -23489,7 +23539,7 @@ declare namespace chrome {
      * Fetches information about active contexts associated with this extension
      *
      * @param filter A filter to find matching contexts. A context matches if it matches all specified fields in the filter. Any unspecified field in the filter matches all contexts.
-     * @since Pending
+     * @since Chrome 116
      * @chrome-min-manifest MV3
      */
     export function getContexts(
@@ -23502,7 +23552,7 @@ declare namespace chrome {
      *
      * @param filter A filter to find matching contexts. A context matches if it matches all specified fields in the filter. Any unspecified field in the filter matches all contexts.
      * @param callback Invoked with the matching contexts, if any.
-     * @since Pending
+     * @since Chrome 116
      * @chrome-min-manifest MV3
      */
     export function getContexts(
@@ -24777,7 +24827,7 @@ declare namespace chrome {
     }
 
     /**
-     * @since Pending
+     * @since Chrome 116
      */
     export interface OpenOptions {
 
@@ -24884,7 +24934,7 @@ declare namespace chrome {
      * Opens the side panel for the extension. This may only be called in response to a user action.
      *
      * @param options Specifies the context in which to open the side panel.
-     * @since Pending
+     * @since Chrome 116
      */
     export function open(
 
@@ -24896,7 +24946,7 @@ declare namespace chrome {
      *
      * @param options Specifies the context in which to open the side panel.
      * @param callback Called when the side panel has been opened.
-     * @since Pending
+     * @since Chrome 116
      */
     export function open(
 
@@ -28389,7 +28439,7 @@ declare namespace chrome {
     /**
      * Returns a list of tabs that have requested capture or are being captured, i.e. status != stopped and status != error. This allows extensions to inform the user that there is an existing tab capture that would prevent a new tab capture from succeeding (or to prevent redundant requests for the same tab).
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      */
     export function getCapturedTabs(): Promise<CaptureInfo[]>;
 
@@ -28408,7 +28458,7 @@ declare namespace chrome {
     /**
      * Creates a stream ID to capture the target tab. Similar to chrome.tabCapture.capture() method, but returns a media stream ID, instead of a media stream, to the consumer tab.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @since Chrome 71
      */
     export function getMediaStreamId(
@@ -31870,7 +31920,7 @@ declare namespace chrome {
     /**
      * Enumerates connected USB devices.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param options The properties to search for on target devices.
      */
     export function getDevices(
@@ -31895,7 +31945,7 @@ declare namespace chrome {
     /**
      * Presents a device picker to the user and returns the {@link Device}s selected. If the user cancels the picker devices will be empty. A user gesture is required for the dialog to display. Without a user gesture, the callback will run as though the user cancelled.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param options Configuration of the device picker dialog box.
      */
     export function getUserSelectedDevices(
@@ -31921,7 +31971,7 @@ declare namespace chrome {
     /**
      * Returns the full set of device configuration descriptors.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param device The {@link Device} to fetch descriptors from.
      * @since Chrome 47
      */
@@ -31948,7 +31998,7 @@ declare namespace chrome {
     /**
      * Requests access from the permission broker to a device claimed by Chrome OS if the given interface on the device is not claimed.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param device The {@link Device} to request access to.
      * @param interfaceId The particular interface requested.
      * @deprecated This function was Chrome OS specific and calling it on other platforms would fail. This operation is now implicitly performed as part of {@link openDevice} and this function will return `true` on all platforms.
@@ -31981,7 +32031,7 @@ declare namespace chrome {
     /**
      * Opens a USB device returned by {@link getDevices}.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param device The {@link Device} to open.
      */
     export function openDevice(
@@ -32010,7 +32060,7 @@ declare namespace chrome {
      *
      * Calling this method is equivalent to calling {@link getDevices} followed by {@link openDevice} for each device.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param options The properties to search for on target devices.
      */
     export function findDevices(
@@ -32039,7 +32089,7 @@ declare namespace chrome {
     /**
      * Closes a connection handle. Invoking operations on a handle after it has been closed is a safe operation but causes no action to be taken.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param handle The {@link ConnectionHandle} to close.
      */
     export function closeDevice(
@@ -32064,7 +32114,7 @@ declare namespace chrome {
      *
      * This function effectively resets the device by selecting one of the device's available configurations. Only configuration values greater than `0` are valid however some buggy devices have a working configuration `0` and so this value is allowed.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param handle An open connection to the device.
      */
     export function setConfiguration(
@@ -32093,7 +32143,7 @@ declare namespace chrome {
     /**
      * Gets the configuration descriptor for the currently selected configuration.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param handle An open connection to the device.
      */
     export function getConfiguration(
@@ -32118,7 +32168,7 @@ declare namespace chrome {
     /**
      * Lists all interfaces on a USB device.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param handle An open connection to the device.
      */
     export function listInterfaces(
@@ -32145,7 +32195,7 @@ declare namespace chrome {
      *
      * {@link releaseInterface} should be called when the interface is no longer needed.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param handle An open connection to the device.
      * @param interfaceNumber The interface to be claimed.
      */
@@ -32176,7 +32226,7 @@ declare namespace chrome {
     /**
      * Releases a claimed interface.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param handle An open connection to the device.
      * @param interfaceNumber The interface to be released.
      */
@@ -32205,7 +32255,7 @@ declare namespace chrome {
     /**
      * Selects an alternate setting on a previously claimed interface.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param handle An open connection to the device where this interface has been claimed.
      * @param interfaceNumber The interface to configure.
      * @param alternateSetting The alternate setting to configure.
@@ -32242,7 +32292,7 @@ declare namespace chrome {
      *
      * Control transfers refer to either the device, an interface or an endpoint. Transfers to an interface or endpoint require the interface to be claimed.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param handle An open connection to the device.
      */
     export function controlTransfer(
@@ -32273,7 +32323,7 @@ declare namespace chrome {
     /**
      * Performs a bulk transfer on the specified device.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param handle An open connection to the device.
      * @param transferInfo The transfer parameters.
      */
@@ -32304,7 +32354,7 @@ declare namespace chrome {
     /**
      * Performs an interrupt transfer on the specified device.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param handle An open connection to the device.
      * @param transferInfo The transfer parameters.
      */
@@ -32335,7 +32385,7 @@ declare namespace chrome {
     /**
      * Performs an isochronous transfer on the specific device.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param handle An open connection to the device.
      */
     export function isochronousTransfer(
@@ -32364,7 +32414,7 @@ declare namespace chrome {
     /**
      * Tries to reset the USB device. If the reset fails, the given connection handle will be closed and the USB device will appear to be disconnected then reconnected. In this case {@link getDevices} or {@link findDevices} must be called again to acquire the device.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param handle A connection handle to reset.
      */
     export function resetDevice(
@@ -32387,6 +32437,86 @@ declare namespace chrome {
     ): void;
   }
 
+  /**
+   * Use the `userScripts` API to execute user scripts in the User Scripts context.
+   *
+   * @alpha
+   * @chrome-permission userScripts
+   * @chrome-channel trunk
+   * @chrome-min-manifest MV3
+   */
+  export namespace userScripts {
+
+    export interface ScriptSource {
+
+      /**
+       * A string containing the JavaScript code to inject. Exactly one of `file` or `code` must be specified.
+       */
+      code?: string;
+
+      /**
+       * The path of the JavaScript file to inject relative to the extension's root directory. Exactly one of `file` or `code` must be specified.
+       */
+      file?: string;
+    }
+
+    export interface RegisteredUserScript {
+
+      /**
+       * If true, it will inject into all frames, even if the frame is not the top-most frame in the tab. Each frame is checked independently for URL requirements; it will not inject into child frames if the URL requirements are not met. Defaults to false, meaning that only the top frame is matched.
+       */
+      allFrames?: boolean;
+
+      /**
+       * Excludes pages that this content script would otherwise be injected into. See [Match Patterns](https://developer.chrome.com/docs/extensions/match_patterns) for more details on the syntax of these strings.
+       */
+      excludeMatches?: string[];
+
+      /**
+       * The ID of the user script specified in the API call. This property must not start with a '\_' as it's reserved as a prefix for generated script IDs.
+       */
+      id: string;
+
+      /**
+       * The list of ScriptSource objects defining sources of scripts to be injected into matching pages.
+       */
+      js: ScriptSource[];
+
+      /**
+       * Specifies which pages this content script will be injected into. See [Match Patterns](https://developer.chrome.com/docs/extensions/match_patterns) for more details on the syntax of these strings.
+       */
+      matches?: string[];
+
+      /**
+       * Specifies when JavaScript files are injected into the web page. The preferred and default value is `document_idle`.
+       */
+      runAt?: extensionTypes.RunAt;
+    }
+
+    /**
+     * Registers one or more user scripts for this extension.
+     *
+     * @param scripts Contains a list of user scripts to be registered.
+     */
+    export function register(
+
+      scripts: RegisteredUserScript[],
+    ): Promise<void>;
+
+    /**
+     * Registers one or more user scripts for this extension.
+     *
+     * @param scripts Contains a list of user scripts to be registered.
+     * @param callback Called once scripts have been fully registered or if an error has ocurred.
+     */
+    export function register(
+
+      scripts: RegisteredUserScript[],
+
+      callback?: () => void,
+    ): void;
+  }
+
   /**
    * The `chrome.virtualKeyboard` API is a kiosk only API used to configure virtual keyboard layout and behavior in kiosk sessions.
    *
@@ -35225,7 +35355,7 @@ declare namespace chrome {
     /**
      * Needs to be called when the behavior of the webRequest handlers has changed to prevent incorrect handling due to caching. This function call is expensive. Don't call it often.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      */
     export function handlerBehaviorChanged(): Promise<void>;
 

package/index.d.ts

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-// Generated on Tue Aug 15 2023 22:32:50 GMT+0000 (Coordinated Universal Time)
-// Built at 805a5a4b71b6902844392777181234f012fca060
+// Generated on Mon Aug 21 2023 13:07:01 GMT+0000 (Coordinated Universal Time)
+// Built at 8e2cf1aa296431da9cb31e9ab935b3e37801ee10
 
 // Includes MV3+ APIs only.
 
@@ -1128,7 +1128,7 @@ declare namespace chrome {
     /**
      * Gets a list of audio devices filtered based on `filter`.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param filter Device properties by which to filter the list of returned audio devices. If the filter is not set or set to `{}`, returned device list will contain all available audio devices.
      */
     export function getDevices(
@@ -1154,7 +1154,7 @@ declare namespace chrome {
     /**
      * Sets lists of active input and/or output devices.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param ids
 
     Specifies IDs of devices that should be active. If either the input or output list is not set, devices in that category are unaffected.
@@ -1185,7 +1185,7 @@ declare namespace chrome {
     /**
      * Sets the properties for the input or output device.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      */
     export function setProperties(
 
@@ -1209,7 +1209,7 @@ declare namespace chrome {
     /**
      * Gets the system-wide mute state for the specified stream type.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param streamType Stream type for which mute state should be fetched.
      */
     export function getMute(
@@ -1235,7 +1235,7 @@ declare namespace chrome {
     /**
      * Sets mute state for a stream type. The mute state will apply to all audio devices with the specified audio stream type.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param streamType Stream type for which mute state should be set.
      * @param isMuted New mute value.
      */
@@ -5289,6 +5289,56 @@ declare namespace chrome {
       ) => void,
     ): void;
 
+    /**
+     * Disables and enables individual static rules in a {@link Ruleset}. Changes to rules belonging to a disabled {@link Ruleset} will take effect the next time that it becomes enabled.
+     *
+     * @since Pending
+     */
+    export function updateStaticRules(
+
+      options: UpdateStaticRulesOptions,
+    ): Promise<void>;
+
+    /**
+     * Disables and enables individual static rules in a {@link Ruleset}. Changes to rules belonging to a disabled {@link Ruleset} will take effect the next time that it becomes enabled.
+     *
+     * @param callback Called once the update is complete. In case of an error, {@link runtime.lastError} will be set and no change will be made to the enabled static rules.
+     * @since Pending
+     */
+    export function updateStaticRules(
+
+      options: UpdateStaticRulesOptions,
+
+      callback?: () => void,
+    ): void;
+
+    /**
+     * Returns the list of static rules in the given {@link Ruleset} that are currently disabled.
+     *
+     * @param options Specifies the ruleset to query.
+     * @since Pending
+     */
+    export function getDisabledRuleIds(
+
+      options: GetDisabledRuleIdsOptions,
+    ): Promise<number[]>;
+
+    /**
+     * Returns the list of static rules in the given {@link Ruleset} that are currently disabled.
+     *
+     * @param options Specifies the ruleset to query.
+     * @param callback Called with a list of ids that correspond to the disabled rules in that ruleset.
+     * @since Pending
+     */
+    export function getDisabledRuleIds(
+
+      options: GetDisabledRuleIdsOptions,
+
+      callback?: (
+        disabledRuleIds: number[],
+      ) => void,
+    ): void;
+
     /**
      * Returns all rules matched for the extension. Callers can optionally filter the list of matched rules by specifying a `filter`. This method is only available to extensions with the `declarativeNetRequestFeedback` permission or having the `activeTab` permission granted for the `tabId` specified in `filter`. Note: Rules not associated with an active document that were matched more than five minutes ago will not be returned.
      *
@@ -10180,7 +10230,7 @@ declare namespace chrome {
     /**
      * Registers the application with FCM. The registration ID will be returned by the `callback`. If `register` is called again with the same list of `senderIds`, the same registration ID will be returned.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param senderIds A list of server IDs that are allowed to send messages to the application. It should contain at least one and no more than 100 sender IDs.
      */
     export function register(
@@ -10209,7 +10259,7 @@ declare namespace chrome {
     /**
      * Unregisters the application from FCM.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      */
     export function unregister(): Promise<void>;
 
@@ -10226,7 +10276,7 @@ declare namespace chrome {
     /**
      * Sends a message according to its contents.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param message A message to send to the other party via FCM.
      */
     export function send(
@@ -11103,7 +11153,7 @@ declare namespace chrome {
     /**
      * Returns "locked" if the system is locked, "idle" if the user has not generated any input for a specified number of seconds, or "active" otherwise.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param detectionIntervalInSeconds The system is considered idle if detectionIntervalInSeconds seconds have elapsed since the last user input detected.
      */
     export function queryState(
@@ -11138,7 +11188,7 @@ declare namespace chrome {
     /**
      * Gets the time, in seconds, it takes until the screen is locked automatically while idle. Returns a zero duration if the screen is never locked automatically. Currently supported on Chrome OS only.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @since Chrome 73
      * @chrome-platform chromeos
      * @chrome-platform lacros
@@ -15378,7 +15428,7 @@ declare namespace chrome {
     /**
      * Creates and displays a notification.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param notificationId
 
     Identifier of the notification. If not set or empty, an ID will automatically be generated. If it matches an existing notification, this method first clears that notification before proceeding with the create operation. The identifier may not be longer than 500 characters.
@@ -15396,7 +15446,7 @@ declare namespace chrome {
     /**
      * Creates and displays a notification.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param options Contents of the notification.
      */
     export function create(
@@ -15452,7 +15502,7 @@ declare namespace chrome {
     /**
      * Updates an existing notification.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param notificationId The id of the notification to be updated. This is returned by {@link notifications.create} method.
      * @param options Contents of the notification to update to.
      */
@@ -15488,7 +15538,7 @@ declare namespace chrome {
     /**
      * Clears the specified notification.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @param notificationId The id of the notification to be cleared. This is returned by {@link notifications.create} method.
      */
     export function clear(
@@ -15518,7 +15568,7 @@ declare namespace chrome {
     /**
      * Retrieves all the notifications of this app or extension.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      */
     export function getAll(): Promise<{[name: string]: any}>;
 
@@ -15537,7 +15587,7 @@ declare namespace chrome {
     /**
      * Retrieves whether the user has enabled notifications from this app or extension.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      */
     export function getPermissionLevel(): Promise<PermissionLevel>;
 
@@ -15792,7 +15842,7 @@ declare namespace chrome {
     /**
      * Saves the content of the tab with given id as MHTML.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      */
     export function saveAsMHTML(
 
@@ -18242,7 +18292,7 @@ declare namespace chrome {
      * Fetches information about active contexts associated with this extension
      *
      * @param filter A filter to find matching contexts. A context matches if it matches all specified fields in the filter. Any unspecified field in the filter matches all contexts.
-     * @since Pending
+     * @since Chrome 116
      * @chrome-min-manifest MV3
      */
     export function getContexts(
@@ -18255,7 +18305,7 @@ declare namespace chrome {
      *
      * @param filter A filter to find matching contexts. A context matches if it matches all specified fields in the filter. Any unspecified field in the filter matches all contexts.
      * @param callback Invoked with the matching contexts, if any.
-     * @since Pending
+     * @since Chrome 116
      * @chrome-min-manifest MV3
      */
     export function getContexts(
@@ -18916,7 +18966,7 @@ declare namespace chrome {
     }
 
     /**
-     * @since Pending
+     * @since Chrome 116
      */
     export interface OpenOptions {
 
@@ -19023,7 +19073,7 @@ declare namespace chrome {
      * Opens the side panel for the extension. This may only be called in response to a user action.
      *
      * @param options Specifies the context in which to open the side panel.
-     * @since Pending
+     * @since Chrome 116
      */
     export function open(
 
@@ -19035,7 +19085,7 @@ declare namespace chrome {
      *
      * @param options Specifies the context in which to open the side panel.
      * @param callback Called when the side panel has been opened.
-     * @since Pending
+     * @since Chrome 116
      */
     export function open(
 
@@ -21652,7 +21702,7 @@ declare namespace chrome {
     /**
      * Returns a list of tabs that have requested capture or are being captured, i.e. status != stopped and status != error. This allows extensions to inform the user that there is an existing tab capture that would prevent a new tab capture from succeeding (or to prevent redundant requests for the same tab).
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      */
     export function getCapturedTabs(): Promise<CaptureInfo[]>;
 
@@ -21671,7 +21721,7 @@ declare namespace chrome {
     /**
      * Creates a stream ID to capture the target tab. Similar to chrome.tabCapture.capture() method, but returns a media stream ID, instead of a media stream, to the consumer tab.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      * @since Chrome 71
      */
     export function getMediaStreamId(
@@ -25259,6 +25309,86 @@ declare namespace chrome {
     ): void;
   }
 
+  /**
+   * Use the `userScripts` API to execute user scripts in the User Scripts context.
+   *
+   * @alpha
+   * @chrome-permission userScripts
+   * @chrome-channel trunk
+   * @chrome-min-manifest MV3
+   */
+  export namespace userScripts {
+
+    export interface ScriptSource {
+
+      /**
+       * A string containing the JavaScript code to inject. Exactly one of `file` or `code` must be specified.
+       */
+      code?: string;
+
+      /**
+       * The path of the JavaScript file to inject relative to the extension's root directory. Exactly one of `file` or `code` must be specified.
+       */
+      file?: string;
+    }
+
+    export interface RegisteredUserScript {
+
+      /**
+       * If true, it will inject into all frames, even if the frame is not the top-most frame in the tab. Each frame is checked independently for URL requirements; it will not inject into child frames if the URL requirements are not met. Defaults to false, meaning that only the top frame is matched.
+       */
+      allFrames?: boolean;
+
+      /**
+       * Excludes pages that this content script would otherwise be injected into. See [Match Patterns](https://developer.chrome.com/docs/extensions/match_patterns) for more details on the syntax of these strings.
+       */
+      excludeMatches?: string[];
+
+      /**
+       * The ID of the user script specified in the API call. This property must not start with a '\_' as it's reserved as a prefix for generated script IDs.
+       */
+      id: string;
+
+      /**
+       * The list of ScriptSource objects defining sources of scripts to be injected into matching pages.
+       */
+      js: ScriptSource[];
+
+      /**
+       * Specifies which pages this content script will be injected into. See [Match Patterns](https://developer.chrome.com/docs/extensions/match_patterns) for more details on the syntax of these strings.
+       */
+      matches?: string[];
+
+      /**
+       * Specifies when JavaScript files are injected into the web page. The preferred and default value is `document_idle`.
+       */
+      runAt?: extensionTypes.RunAt;
+    }
+
+    /**
+     * Registers one or more user scripts for this extension.
+     *
+     * @param scripts Contains a list of user scripts to be registered.
+     */
+    export function register(
+
+      scripts: RegisteredUserScript[],
+    ): Promise<void>;
+
+    /**
+     * Registers one or more user scripts for this extension.
+     *
+     * @param scripts Contains a list of user scripts to be registered.
+     * @param callback Called once scripts have been fully registered or if an error has ocurred.
+     */
+    export function register(
+
+      scripts: RegisteredUserScript[],
+
+      callback?: () => void,
+    ): void;
+  }
+
   /**
    * The `chrome.virtualKeyboard` API is a kiosk only API used to configure virtual keyboard layout and behavior in kiosk sessions.
    *
@@ -28094,7 +28224,7 @@ declare namespace chrome {
     /**
      * Needs to be called when the behavior of the webRequest handlers has changed to prevent incorrect handling due to caching. This function call is expensive. Don't call it often.
      *
-     * @chrome-returns-extra since Pending
+     * @chrome-returns-extra since Chrome 116
      */
     export function handlerBehaviorChanged(): Promise<void>;
 

package/package.json

@@ -5,7 +5,7 @@
   "type": "module",
   "name": "chrome-types",
   "config": {
-    "build-hash": "33da048ef2f51094"
+    "build-hash": "c716e7b0ba2370ae"
   },
   "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.223"
+  "version": "0.1.225"
 }