chrome-types 0.1.35 → 0.1.39

package/index.d.ts

@@ -80,7 +80,7 @@ declare namespace browserAction {
 
 }
 
-// Generated on Tue Aug 31 2021 22:23:42 GMT+0000 (Coordinated Universal Time)
+// Generated on Wed Sep 15 2021 22:23:37 GMT+0000 (Coordinated Universal Time)
 
 
 declare namespace chrome {
@@ -925,7 +925,7 @@ declare namespace chrome {
     /**
      * A text boundary associated with an {@link automation.AutomationIntent}.
      */
-    export type IntentTextBoundaryType = "character" | "format" | "lineEnd" | "lineStart" | "lineStartOrEnd" | "object" | "pageEnd" | "pageStart" | "pageStartOrEnd" | "paragraphEnd" | "paragraphStart" | "paragraphStartSkippingEmptyParagraphs" | "paragraphStartOrEnd" | "sentenceEnd" | "sentenceStart" | "sentenceStartOrEnd" | "webPage" | "wordEnd" | "wordStart" | "wordStartOrEnd";
+    export type IntentTextBoundaryType = "character" | "formatEnd" | "formatStart" | "formatStartOrEnd" | "lineEnd" | "lineStart" | "lineStartOrEnd" | "object" | "pageEnd" | "pageStart" | "pageStartOrEnd" | "paragraphEnd" | "paragraphStart" | "paragraphStartSkippingEmptyParagraphs" | "paragraphStartOrEnd" | "sentenceEnd" | "sentenceStart" | "sentenceStartOrEnd" | "webPage" | "wordEnd" | "wordStart" | "wordStartOrEnd";
 
     /**
      * A move direction associated with an {@link automation.AutomationIntent}.
@@ -1200,10 +1200,20 @@ declare namespace chrome {
 
       moveToPreviousLineEndPosition(): void;
 
+      /**
+       * @chrome-unknown-version
+       */
+      moveToNextFormatStartPosition(): void;
+
       moveToPreviousFormatStartPosition(): void;
 
       moveToNextFormatEndPosition(): void;
 
+      /**
+       * @chrome-unknown-version
+       */
+      moveToPreviousFormatEndPosition(): void;
+
       moveToNextParagraphStartPosition(): void;
 
       moveToPreviousParagraphStartPosition(): void;
@@ -3653,6 +3663,20 @@ declare namespace chrome {
 
     export interface ContentSetting<T> {
 
+      /**
+       * Clear all content setting rules set by this extension.
+       *
+       * @param details
+       */
+      clear(
+        details: {
+          /**
+           * Where to clear the setting (default: regular).
+           */
+          scope?: Scope,
+        },
+      ): Promise<{}>;
+
       /**
        * Clear all content setting rules set by this extension.
        *
@@ -3669,6 +3693,42 @@ declare namespace chrome {
         callback?: () => void,
       ): void;
 
+      /**
+       * Gets the current content setting for a given pair of URLs.
+       *
+       * @param details
+       */
+      get(
+        details: {
+          /**
+           * The primary URL for which the content setting should be retrieved. Note that the meaning of a primary URL depends on the content type.
+           */
+          primaryUrl: string,
+
+          /**
+           * The secondary URL for which the content setting should be retrieved. Defaults to the primary URL. Note that the meaning of a secondary URL depends on the content type, and not all content types use secondary URLs.
+           */
+          secondaryUrl?: string,
+
+          /**
+           * A more specific identifier of the type of content for which the settings should be retrieved.
+           */
+          resourceIdentifier?: ResourceIdentifier,
+
+          /**
+           * Whether to check the content settings for an incognito session. (default false)
+           */
+          incognito?: boolean,
+        },
+      ): Promise<{
+        details: {
+          /**
+           * The content setting. See the description of the individual ContentSetting objects for the possible values.
+           */
+          setting: T,
+        },
+      }>;
+
       /**
        * Gets the current content setting for a given pair of URLs.
        *
@@ -3707,6 +3767,40 @@ declare namespace chrome {
         ) => void,
       ): void;
 
+      /**
+       * Applies a new content setting rule.
+       *
+       * @param details
+       */
+      set(
+        details: {
+          /**
+           * The pattern for the primary URL. For details on the format of a pattern, see [Content Setting Patterns](https://developer.chrome.com/docs/extensions/reference/contentSettings/#patterns).
+           */
+          primaryPattern: string,
+
+          /**
+           * The pattern for the secondary URL. Defaults to matching all URLs. For details on the format of a pattern, see [Content Setting Patterns](https://developer.chrome.com/docs/extensions/reference/contentSettings/#patterns).
+           */
+          secondaryPattern?: string,
+
+          /**
+           * The resource identifier for the content type.
+           */
+          resourceIdentifier?: ResourceIdentifier,
+
+          /**
+           * The setting applied by this rule. See the description of the individual ContentSetting objects for the possible values.
+           */
+          setting: T,
+
+          /**
+           * Where to set the setting (default: regular).
+           */
+          scope?: Scope,
+        },
+      ): Promise<{}>;
+
       /**
        * Applies a new content setting rule.
        *
@@ -3743,6 +3837,13 @@ declare namespace chrome {
         callback?: () => void,
       ): void;
 
+      getResourceIdentifiers(): Promise<{
+        /**
+         * A list of resource identifiers for this content type, or undefined if this content type does not use resource identifiers.
+         */
+        resourceIdentifiers?: ResourceIdentifier[],
+      }>;
+
       /**
        * @param callback
        */
@@ -4846,21 +4947,19 @@ declare namespace chrome {
    * The `chrome.declarativeNetRequest` API is used to block or modify network requests by specifying declarative rules. This lets extensions modify network requests without intercepting them and viewing their content, thus providing more privacy.
    *
    * @chrome-permission declarativeNetRequest
-   * @since Chrome 84
+   * @chrome-permission declarativeNetRequestWithHostAccess
+   * @chrome-channel trunk
+   * @alpha
    */
   export namespace declarativeNetRequest {
 
     /**
      * The minimum number of static rules guaranteed to an extension across its enabled static rulesets. Any rules above this limit will count towards the [global rule limit](https://developer.chrome.com/docs/extensions/reference/declarativeNetRequest/#global-rule-limit).
-     *
-     * @since Chrome 89
      */
     export const GUARANTEED_MINIMUM_STATIC_RULES: 30000;
 
     /**
      * The maximum number of combined dynamic and session scoped rules an extension can add.
-     *
-     * @since Chrome 90
      */
     export const MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES: 5000;
 
@@ -4898,8 +4997,6 @@ declare namespace chrome {
 
     /**
      * Ruleset ID for the session-scoped rules added by the extension.
-     *
-     * @since Chrome 90
      */
     export const SESSION_RULESET_ID: "_session";
 
@@ -4958,7 +5055,6 @@ declare namespace chrome {
      * *   These rules are not persisted across sessions and are backed in memory.
      * *   {@link MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES} is the maximum number of combined dynamic and session rules an extension can add.
      *
-     * @since Chrome 90
      * @param options
      */
     export function updateSessionRules(
@@ -4972,7 +5068,6 @@ declare namespace chrome {
      * *   These rules are not persisted across sessions and are backed in memory.
      * *   {@link MAX_NUMBER_OF_DYNAMIC_AND_SESSION_RULES} is the maximum number of combined dynamic and session rules an extension can add.
      *
-     * @since Chrome 90
      * @param options
      * @param callback Called once the update is complete or has failed. In case of an error, {@link runtime.lastError} will be set and no change will be made to the rule set. This can happen for multiple reasons, such as invalid rule format, duplicate rule ID, rule count limit exceeded, and others.
      */
@@ -4983,8 +5078,6 @@ declare namespace chrome {
 
     /**
      * Returns the current set of session scoped rules for the extension.
-     *
-     * @since Chrome 90
      */
     export function getSessionRules(): Promise<{
       rules: Rule[],
@@ -4993,7 +5086,6 @@ declare namespace chrome {
     /**
      * Returns the current set of session scoped rules for the extension.
      *
-     * @since Chrome 90
      * @param callback Called with the set of session scoped rules.
      */
     export function getSessionRules(
@@ -5080,7 +5172,6 @@ declare namespace chrome {
     /**
      * Configures if the action count for tabs should be displayed as the extension action's badge text and provides a way for that action count to be incremented.
      *
-     * @since Chrome 88
      * @param options
      */
     export function setExtensionActionOptions(
@@ -5090,7 +5181,6 @@ declare namespace chrome {
     /**
      * Configures if the action count for tabs should be displayed as the extension action's badge text and provides a way for that action count to be incremented.
      *
-     * @since Chrome 88
      * @param options
      * @param callback
      */
@@ -5102,7 +5192,6 @@ declare namespace chrome {
     /**
      * Checks if the given regular expression will be supported as a `regexFilter` rule condition.
      *
-     * @since Chrome 87
      * @param regexOptions The regular expression to check.
      */
     export function isRegexSupported(
@@ -5114,7 +5203,6 @@ declare namespace chrome {
     /**
      * Checks if the given regular expression will be supported as a `regexFilter` rule condition.
      *
-     * @since Chrome 87
      * @param regexOptions The regular expression to check.
      * @param callback Called with details consisting of whether the regular expression is supported and the reason if not.
      */
@@ -5127,8 +5215,6 @@ declare namespace chrome {
 
     /**
      * Returns the number of static rules an extension can enable before the [global static rule limit](https://developer.chrome.com/docs/extensions/reference/declarativeNetRequest/#global-rule-limit) is reached.
-     *
-     * @since Chrome 89
      */
     export function getAvailableStaticRuleCount(): Promise<{
       count: number,
@@ -5137,7 +5223,6 @@ declare namespace chrome {
     /**
      * Returns the number of static rules an extension can enable before the [global static rule limit](https://developer.chrome.com/docs/extensions/reference/declarativeNetRequest/#global-rule-limit) is reached.
      *
-     * @since Chrome 89
      * @param callback
      */
     export function getAvailableStaticRuleCount(
@@ -5153,8 +5238,6 @@ declare namespace chrome {
 
     /**
      * This describes the HTTP request method of a network request.
-     *
-     * @since Chrome 91
      */
     export type RequestMethod = "delete" | "get" | "head" | "options" | "patch" | "post" | "put";
 
@@ -5165,8 +5248,6 @@ declare namespace chrome {
 
     /**
      * This describes the possible operations for a "modifyHeaders" rule.
-     *
-     * @since Chrome 86
      */
     export type HeaderOperation = "append" | "set" | "remove";
 
@@ -5177,8 +5258,6 @@ declare namespace chrome {
 
     /**
      * Describes the reason why a given regular expression isn't supported.
-     *
-     * @since Chrome 87
      */
     export type UnsupportedRegexReason = "syntaxError" | "memoryLimitExceeded";
 
@@ -5377,15 +5456,11 @@ declare namespace chrome {
        * List of HTTP request methods which the rule can match. An empty list is not allowed.
        *
        * Note: Specifying a `requestMethods` rule condition will also exclude non-HTTP(s) requests, whereas specifying `excludedRequestMethods` will not.
-       *
-       * @since Chrome 91
        */
       requestMethods?: RequestMethod[];
 
       /**
        * List of request methods which the rule won't match. Only one of `requestMethods` and `excludedRequestMethods` should be specified. If neither of them is specified, all request methods are matched.
-       *
-       * @since Chrome 91
        */
       excludedRequestMethods?: RequestMethod[];
 
@@ -5396,22 +5471,15 @@ declare namespace chrome {
 
       /**
        * List of {@link tabs.Tab.id} which the rule should match. An ID of {@link tabs.TAB_ID_NONE} matches requests which don't originate from a tab. An empty list is not allowed. Only supported for session-scoped rules.
-       *
-       * @since Chrome 92
        */
       tabIds?: number[];
 
       /**
        * List of {@link tabs.Tab.id} which the rule should not match. An ID of {@link tabs.TAB_ID_NONE} excludes requests which don't originate from a tab. Only supported for session-scoped rules.
-       *
-       * @since Chrome 92
        */
       excludedTabIds?: number[];
     }
 
-    /**
-     * @since Chrome 86
-     */
     export interface ModifyHeaderInfo {
 
       /**
@@ -5444,15 +5512,11 @@ declare namespace chrome {
 
       /**
        * The request headers to modify for the request. Only valid if RuleActionType is "modifyHeaders".
-       *
-       * @since Chrome 86
        */
       requestHeaders?: ModifyHeaderInfo[];
 
       /**
        * The response headers to modify for the request. Only valid if RuleActionType is "modifyHeaders".
-       *
-       * @since Chrome 86
        */
       responseHeaders?: ModifyHeaderInfo[];
     }
@@ -5582,9 +5646,6 @@ declare namespace chrome {
       request: RequestDetails;
     }
 
-    /**
-     * @since Chrome 87
-     */
     export interface RegexOptions {
 
       /**
@@ -5603,9 +5664,6 @@ declare namespace chrome {
       requireCapturing?: boolean;
     }
 
-    /**
-     * @since Chrome 87
-     */
     export interface IsRegexSupportedResult {
 
       isSupported: boolean;
@@ -5616,9 +5674,6 @@ declare namespace chrome {
       reason?: UnsupportedRegexReason;
     }
 
-    /**
-     * @since Chrome 87
-     */
     export interface UpdateRuleOptions {
 
       /**
@@ -5632,9 +5687,6 @@ declare namespace chrome {
       addRules?: Rule[];
     }
 
-    /**
-     * @since Chrome 87
-     */
     export interface UpdateRulesetOptions {
 
       /**
@@ -5648,9 +5700,6 @@ declare namespace chrome {
       enableRulesetIds?: string[];
     }
 
-    /**
-     * @since Chrome 89
-     */
     export interface TabActionCountUpdate {
 
       /**
@@ -5664,9 +5713,6 @@ declare namespace chrome {
       increment: number;
     }
 
-    /**
-     * @since Chrome 88
-     */
     export interface ExtensionActionOptions {
 
       /**
@@ -5676,8 +5722,6 @@ declare namespace chrome {
 
       /**
        * Details of how the tab's action count should be adjusted.
-       *
-       * @since Chrome 89
        */
       tabUpdate?: TabActionCountUpdate;
     }
@@ -5690,8 +5734,6 @@ declare namespace chrome {
     export const onRuleMatchedDebug: events.Event<(
       /**
        * The rule that has been matched along with information about the associated request.
-       *
-       * @since Chrome 85
        */
       info: MatchedRuleInfoDebug,
     ) => void>;
@@ -14254,6 +14296,13 @@ declare namespace chrome {
      */
     export type StyleOrigin = "AUTHOR" | "USER";
 
+    /**
+     * The JavaScript world for a script to execute within.
+     *
+     * @chrome-unknown-version
+     */
+    export type ExecutionWorld = "ISOLATED" | "MAIN";
+
     export interface InjectionTarget {
 
       /**
@@ -14297,6 +14346,13 @@ declare namespace chrome {
        * Details specifying the target into which to inject the script.
        */
       target: InjectionTarget;
+
+      /**
+       * The JavaScript "world" to run the script in. Defaults to `ISOLATED`.
+       *
+       * @chrome-unknown-version
+       */
+      world?: ExecutionWorld;
     }
 
     export interface CSSInjection {
@@ -18408,6 +18464,41 @@ declare namespace chrome {
      */
     export interface ChromeSetting<T> {
 
+      /**
+       * Gets the value of a setting.
+       *
+       * @param details Which setting to consider.
+       */
+      get(
+        details: {
+          /**
+           * Whether to return the value that applies to the incognito session (default false).
+           */
+          incognito?: boolean,
+        },
+      ): Promise<{
+        /**
+         * Details of the currently effective value.
+         */
+        details: {
+          /**
+           * The value of the setting.
+           */
+          value: T,
+
+          /**
+           * The level of control of the setting.
+           */
+          levelOfControl: LevelOfControl,
+
+          /**
+           * Whether the effective value is specific to the incognito session.
+           * This property will _only_ be present if the incognito property in the details parameter of `get()` was true.
+           */
+          incognitoSpecific?: boolean,
+        },
+      }>;
+
       /**
        * Gets the value of a setting.
        *
@@ -18445,6 +18536,26 @@ declare namespace chrome {
         ) => void,
       ): void;
 
+      /**
+       * Sets the value of a setting.
+       *
+       * @param details Which setting to change.
+       */
+      set(
+        details: {
+          /**
+           * The value of the setting.
+           * Note that every setting has a specific value type, which is described together with the setting. An extension should _not_ set a value of a different type.
+           */
+          value: T,
+
+          /**
+           * Where to set the setting (default: regular).
+           */
+          scope?: ChromeSettingScope,
+        },
+      ): Promise<{}>;
+
       /**
        * Sets the value of a setting.
        *
@@ -18467,6 +18578,20 @@ declare namespace chrome {
         callback?: () => void,
       ): void;
 
+      /**
+       * Clears the setting, restoring any default value.
+       *
+       * @param details Which setting to clear.
+       */
+      clear(
+        details: {
+          /**
+           * Where to clear the setting (default: regular).
+           */
+          scope?: ChromeSettingScope,
+        },
+      ): Promise<{}>;
+
       /**
        * Clears the setting, restoring any default value.
        *

package/package.json

@@ -4,7 +4,7 @@
   "types": "index.d.ts",
   "type": "module",
   "name": "chrome-types",
-  "version": "0.1.35",
+  "version": "0.1.39",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/GoogleChrome/chrome-types.git"