@types/chrome 0.0.287 → 0.0.288

chrome/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for chrome (http://developer.chrome.com/e
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome.
 
 ### Additional Details
- * Last updated: Tue, 26 Nov 2024 07:33:59 GMT
+ * Last updated: Thu, 02 Jan 2025 18:37:07 GMT
  * Dependencies: [@types/filesystem](https://npmjs.com/package/@types/filesystem), [@types/har-format](https://npmjs.com/package/@types/har-format)
 
 # Credits

chrome/index.d.ts

@@ -21,53 +21,53 @@ declare namespace chrome {
      */
     export namespace accessibilityFeatures {
         /** **ChromeOS only.** Spoken feedback (text-to-speech). */
-        export var spokenFeedback: chrome.types.ChromeSetting;
+        export var spokenFeedback: chrome.types.ChromeSetting<boolean>;
         /** **ChromeOS only.** Enlarged cursor. */
-        export var largeCursor: chrome.types.ChromeSetting;
+        export var largeCursor: chrome.types.ChromeSetting<boolean>;
         /** **ChromeOS only.** Sticky modifier keys (like shift or alt). */
-        export var stickyKeys: chrome.types.ChromeSetting;
+        export var stickyKeys: chrome.types.ChromeSetting<boolean>;
         /** **ChromeOS only.** High contrast rendering mode. */
-        export var highContrast: chrome.types.ChromeSetting;
+        export var highContrast: chrome.types.ChromeSetting<boolean>;
         /** **ChromeOS only.** Full screen magnification. */
-        export var screenMagnifier: chrome.types.ChromeSetting;
+        export var screenMagnifier: chrome.types.ChromeSetting<boolean>;
         /** **ChromeOS only.** Auto mouse click after mouse stops moving. */
-        export var autoclick: chrome.types.ChromeSetting;
+        export var autoclick: chrome.types.ChromeSetting<boolean>;
         /** **ChromeOS only.** Virtual on-screen keyboard. */
-        export var virtualKeyboard: chrome.types.ChromeSetting;
+        export var virtualKeyboard: chrome.types.ChromeSetting<boolean>;
         /**
          * **ChromeOS only.**
          * Caret highlighting.
          * @since Chrome 51
          */
-        export var caretHighlight: chrome.types.ChromeSetting;
+        export var caretHighlight: chrome.types.ChromeSetting<boolean>;
         /**
          * **ChromeOS only.**
          * Cursor highlighting.
          * @since Chrome 51
          */
-        export var cursorHighlight: chrome.types.ChromeSetting;
+        export var cursorHighlight: chrome.types.ChromeSetting<boolean>;
         /**
          * **ChromeOS only.**
          * Focus highlighting.
          * @since Chrome 51
          */
-        export var focusHighlight: chrome.types.ChromeSetting;
+        export var focusHighlight: chrome.types.ChromeSetting<boolean>;
         /**
          * **ChromeOS only.**
          * Select-to-speak.
          * @since Chrome 51
          */
-        export var selectToSpeak: chrome.types.ChromeSetting;
+        export var selectToSpeak: chrome.types.ChromeSetting<boolean>;
         /**
          * **ChromeOS only.**
          * Switch Access.
          * @since Chrome 51
          */
-        export var switchAccess: chrome.types.ChromeSetting;
+        export var switchAccess: chrome.types.ChromeSetting<boolean>;
         /**
          * @since Chrome 42
          */
-        export var animationPolicy: chrome.types.ChromeSetting;
+        export var animationPolicy: chrome.types.ChromeSetting<"allowed" | "once" | "none">;
     }
 
     ////////////////////
@@ -7237,46 +7237,49 @@ declare namespace chrome {
      * @since Chrome 18
      */
     export namespace privacy {
+        /**
+         * The IP handling policy of WebRTC.
+         * @since Chrome 48
+         */
+        export type IPHandlingPolicy =
+            | "default"
+            | "default_public_and_private_interfaces"
+            | "default_public_interface_only"
+            | "disable_non_proxied_udp";
+
         export interface Services {
             /** @since Chrome 20 */
-            spellingServiceEnabled: chrome.types.ChromeSetting;
-            searchSuggestEnabled: chrome.types.ChromeSetting;
-            instantEnabled: chrome.types.ChromeSetting;
-            alternateErrorPagesEnabled: chrome.types.ChromeSetting;
-            safeBrowsingEnabled: chrome.types.ChromeSetting;
+            spellingServiceEnabled: chrome.types.ChromeSetting<boolean>;
+            searchSuggestEnabled: chrome.types.ChromeSetting<boolean>;
+            alternateErrorPagesEnabled: chrome.types.ChromeSetting<boolean>;
+            safeBrowsingEnabled: chrome.types.ChromeSetting<boolean>;
             /** @deprecated since Chrome 70. Please use privacy.services.autofillAddressEnabled and privacy.services.autofillCreditCardEnabled. */
-            autofillEnabled: chrome.types.ChromeSetting;
-            translationServiceEnabled: chrome.types.ChromeSetting;
+            autofillEnabled: chrome.types.ChromeSetting<boolean>;
+            translationServiceEnabled: chrome.types.ChromeSetting<boolean>;
             /** @since Chrome 38 */
-            passwordSavingEnabled: chrome.types.ChromeSetting;
+            passwordSavingEnabled: chrome.types.ChromeSetting<boolean>;
             /** @since Chrome 42 */
-            hotwordSearchEnabled: chrome.types.ChromeSetting;
-            /** @since Chrome 42 */
-            safeBrowsingExtendedReportingEnabled: chrome.types.ChromeSetting;
+            safeBrowsingExtendedReportingEnabled: chrome.types.ChromeSetting<boolean>;
             /** @since Chrome 70 */
-            autofillAddressEnabled: chrome.types.ChromeSetting;
+            autofillAddressEnabled: chrome.types.ChromeSetting<boolean>;
             /** @since Chrome 70 */
-            autofillCreditCardEnabled: chrome.types.ChromeSetting;
+            autofillCreditCardEnabled: chrome.types.ChromeSetting<boolean>;
         }
 
         export interface Network {
-            networkPredictionEnabled: chrome.types.ChromeSetting;
-            /** @deprecated since Chrome 48. Please use privacy.network.webRTCIPHandlingPolicy. */
-            webRTCMultipleRoutesEnabled: chrome.types.ChromeSetting;
-            /** @deprecated since Chrome 48. Please use privacy.network.webRTCIPHandlingPolicy. */
-            webRTCNonProxiedUdpEnabled: chrome.types.ChromeSetting;
+            networkPredictionEnabled: chrome.types.ChromeSetting<boolean>;
             /** @since Chrome 48 */
-            webRTCIPHandlingPolicy: chrome.types.ChromeSetting;
+            webRTCIPHandlingPolicy: chrome.types.ChromeSetting<IPHandlingPolicy>;
         }
 
         export interface Websites {
-            thirdPartyCookiesAllowed: chrome.types.ChromeSetting;
-            referrersEnabled: chrome.types.ChromeSetting;
-            hyperlinkAuditingEnabled: chrome.types.ChromeSetting;
+            thirdPartyCookiesAllowed: chrome.types.ChromeSetting<boolean>;
+            referrersEnabled: chrome.types.ChromeSetting<boolean>;
+            hyperlinkAuditingEnabled: chrome.types.ChromeSetting<boolean>;
             /** @since Chrome 21. Available on Windows and ChromeOS only. */
-            protectedContentEnabled: chrome.types.ChromeSetting;
+            protectedContentEnabled: chrome.types.ChromeSetting<boolean>;
             /** @since Chrome 65 */
-            doNotTrackEnabled: chrome.types.ChromeSetting;
+            doNotTrackEnabled: chrome.types.ChromeSetting<boolean>;
         }
 
         /** Settings that enable or disable features that require third-party network services provided by Google and your default search provider. */
@@ -7359,7 +7362,7 @@ declare namespace chrome {
 
         export interface ProxyErrorEvent extends chrome.events.Event<(details: ErrorDetails) => void> {}
 
-        export var settings: chrome.types.ChromeSetting;
+        export var settings: chrome.types.ChromeSetting<ProxyConfig>;
         /** Notifies about proxy errors. */
         export var onProxyError: ProxyErrorEvent;
     }
@@ -11526,93 +11529,107 @@ declare namespace chrome {
      * @since Chrome 13
      */
     export namespace types {
-        type settingsScope = "regular" | "regular_only" | "incognito_persistent" | "incognito_session_only" | undefined;
+        /**
+         * The scope of the ChromeSetting. One of
+         * * `regular`: setting for the regular profile (which is inherited by the incognito profile if not overridden elsewhere),
+         * * `regular_only`: setting for the regular profile only (not inherited by the incognito profile),
+         * * `incognito_persistent`: setting for the incognito profile that survives browser restarts (overrides regular preferences)
+         * * `incognito_session_only`: setting for the incognito profile that can only be set during an incognito session and is deleted when the incognito session ends (overrides regular and incognito_persistent preferences).
+         * @since Chrome 44
+         */
+        export type ChromeSettingScope = "regular" | "regular_only" | "incognito_persistent" | "incognito_session_only";
 
-        export interface ChromeSettingClearDetails {
-            /**
-             * Optional.
-             * The scope of the ChromeSetting. One of
-             * • regular: setting for the regular profile (which is inherited by the incognito profile if not overridden elsewhere),
-             * • regular_only: setting for the regular profile only (not inherited by the incognito profile),
-             * • incognito_persistent: setting for the incognito profile that survives browser restarts (overrides regular preferences),
-             * • incognito_session_only: setting for the incognito profile that can only be set during an incognito session and is deleted when the incognito session ends (overrides regular and incognito_persistent preferences).
-             */
-            scope?: settingsScope;
-        }
+        /**
+         * One of
+         * * `not_controllable`: cannot be controlled by any extension
+         * * `controlled_by_other_extensions`: controlled by extensions with higher precedence
+         * * `controllable_by_this_extension`: can be controlled by this extension
+         * * `controlled_by_this_extension`: controlled by this extension
+         * @since Chrome 44
+         */
+        export type LevelOfControl =
+            | "not_controllable"
+            | "controlled_by_other_extensions"
+            | "controllable_by_this_extension"
+            | "controlled_by_this_extension";
 
-        export interface ChromeSettingSetDetails extends ChromeSettingClearDetails {
+        /** Which setting to change. */
+        export interface ChromeSettingSetDetails<T> {
             /**
              * 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: any;
-            /**
-             * Optional.
-             * The scope of the ChromeSetting. One of
-             * • regular: setting for the regular profile (which is inherited by the incognito profile if not overridden elsewhere),
-             * • regular_only: setting for the regular profile only (not inherited by the incognito profile),
-             * • incognito_persistent: setting for the incognito profile that survives browser restarts (overrides regular preferences),
-             * • incognito_session_only: setting for the incognito profile that can only be set during an incognito session and is deleted when the incognito session ends (overrides regular and incognito_persistent preferences).
-             */
-            scope?: settingsScope;
+            value: T;
+            /** Where to set the setting (default: regular). */
+            scope?: ChromeSettingScope;
         }
 
+        /** Which setting to consider. */
         export interface ChromeSettingGetDetails {
-            /** Optional. Whether to return the value that applies to the incognito session (default false). */
-            incognito?: boolean | undefined;
+            /** Whether to return the value that applies to the incognito session (default false). */
+            incognito?: boolean;
         }
 
-        /**
-         * @param details Details of the currently effective value.
-         */
-        export type DetailsCallback = (details: ChromeSettingGetResultDetails) => void;
-
-        export interface ChromeSettingGetResultDetails {
-            /**
-             * One of
-             * • not_controllable: cannot be controlled by any extension
-             * • controlled_by_other_extensions: controlled by extensions with higher precedence
-             * • controllable_by_this_extension: can be controlled by this extension
-             * • controlled_by_this_extension: controlled by this extension
-             */
-            levelOfControl:
-                | "not_controllable"
-                | "controlled_by_other_extensions"
-                | "controllable_by_this_extension"
-                | "controlled_by_this_extension";
+        /** Details of the currently effective value */
+        export interface ChromeSettingGetResult<T> {
+            /** The level of control of the setting. */
+            levelOfControl: LevelOfControl;
             /** The value of the setting. */
-            value: any;
+            value: T;
             /**
-             * Optional.
              * 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 | undefined;
+            incognitoSpecific?: boolean;
+        }
+
+        /** Which setting to clear. */
+        export interface ChromeSettingClearDetails {
+            /** Where to clear the setting (default: regular). */
+            scope?: ChromeSettingScope;
         }
 
-        export interface ChromeSettingChangedEvent extends chrome.events.Event<DetailsCallback> {}
+        /** Details of the currently effective value. */
+        export interface ChromeSettingOnChangeDetails<T> {
+            /**
+             * Whether the effective value is specific to the incognito session. T
+             * his property will only be present if the incognito property in the details parameter of get() was true.
+             */
+            incognitoSpecific?: boolean;
+            /** The value of the setting. */
+            value: T;
+            /** The level of control of the setting. */
+            levelOfControl: LevelOfControl;
+        }
 
-        /** An interface that allows access to a Chrome browser setting. See accessibilityFeatures for an example. */
-        export interface ChromeSetting {
+        /**
+         * An interface that allows access to a Chrome browser setting.
+         * See {@link chrome.accessibilityFeatures} for an example.
+         */
+        export interface ChromeSetting<T> {
             /**
              * Sets the value of a setting.
-             * @param details Which setting to change.
-             * @param callback Optional. Called at the completion of the set operation.
+             * Can return its result via Promise in Manifest V3 or later since Chrome 96.
              */
-            set(details: ChromeSettingSetDetails, callback?: Function): void;
+            set(details: ChromeSettingSetDetails<T>, callback: () => void): void;
+            set(details: ChromeSettingSetDetails<T>): Promise<void>;
+
             /**
              * Gets the value of a setting.
-             * @param details Which setting to consider.
+             * Can return its result via Promise in Manifest V3 or later since Chrome 96.
              */
-            get(details: ChromeSettingGetDetails, callback?: DetailsCallback): void;
+            get(details: ChromeSettingGetDetails, callback: (details: ChromeSettingGetResult<T>) => void): void;
+            get(details: ChromeSettingGetDetails): Promise<ChromeSettingGetResult<T>>;
+
             /**
              * Clears the setting, restoring any default value.
-             * @param details Which setting to clear.
-             * @param callback Optional. Called at the completion of the clear operation.
+             * Can return its result via Promise in Manifest V3 or later since Chrome 96.
              */
-            clear(details: ChromeSettingClearDetails, callback?: Function): void;
+            clear(details: ChromeSettingClearDetails, callback: () => void): void;
+            clear(details: ChromeSettingClearDetails): Promise<void>;
+
             /** Fired after the setting changes. */
-            onChange: ChromeSettingChangedEvent;
+            onChange: chrome.events.Event<(details: ChromeSettingOnChangeDetails<T>) => void>;
         }
     }
 

chrome/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/chrome",
-    "version": "0.0.287",
+    "version": "0.0.288",
     "description": "TypeScript definitions for chrome",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome",
     "license": "MIT",
@@ -94,6 +94,6 @@
         "@types/har-format": "*"
     },
     "peerDependencies": {},
-    "typesPublisherContentHash": "93718a3e0ce89514577fd2476b8b954fad422c79dda8f5cab5509b57e4a7da16",
+    "typesPublisherContentHash": "115546e2b199f5d8b21729e4d49bada5c8b5d60ee6eb0fdb5688219cb24d1fe2",
     "typeScriptVersion": "5.0"
 }