@types/chrome 0.2.9 → 0.3.1

chrome/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for chrome (https://developer.chrome.com/
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome.
 
 ### Additional Details
- * Last updated: Sat, 05 Sep 2026 20:03:40 GMT
+ * Last updated: Mon, 28 Sep 2026 17:35:53 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

@@ -11,8 +11,20 @@ type SetPartial<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
 ////////////////////
 interface Window {
     chrome: typeof chrome;
+
+    /**
+     * Cross-browser alias of {@link chrome}.
+     * @since Chrome 148 (Chrome 152 for extensions declaring a `devtools_page` in manifest)
+     */
+    browser: typeof chrome;
 }
 
+/**
+ * Cross-browser alias of {@link chrome}.
+ * @since Chrome 148 (Chrome 152 for extensions declaring a `devtools_page` in manifest)
+ */
+declare var browser: typeof chrome;
+
 declare namespace chrome {
     ////////////////////
     // Accessibility Features
@@ -525,7 +537,7 @@ declare namespace chrome {
             /** Device name */
             deviceName: string;
             /** Type of the device */
-            deviceType: DeviceType;
+            deviceType: `${DeviceType}`;
             /** The user-friendly name (e.g. "USB Microphone"). */
             displayName: string;
             /** The unique identifier of the audio device. */
@@ -537,14 +549,14 @@ declare namespace chrome {
             /** The stable/persisted device id string when available. */
             stableDeviceId?: string;
             /** Stream type associated with this device. */
-            streamType: StreamType;
+            streamType: `${StreamType}`;
         }
 
         interface DeviceFilter {
             /** If set, only audio devices whose active state matches this value will satisfy the filter. */
             isActive?: boolean;
             /** If set, only audio devices whose stream type is included in this list will satisfy the filter. */
-            streamTypes?: StreamType[];
+            streamTypes?: `${StreamType}`[];
         }
 
         interface DeviceIdLists {
@@ -600,7 +612,7 @@ declare namespace chrome {
             /** Whether or not the stream is now muted. */
             isMuted: boolean;
             /** The type of the stream for which the mute value changed. The updated mute value applies to all devices with this stream type. */
-            streamType: StreamType;
+            streamType: `${StreamType}`;
         }
 
         /** Type of stream an audio device provides. */
@@ -611,14 +623,17 @@ declare namespace chrome {
 
         /**
          * Gets a list of audio devices filtered based on filter.
+         * @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.
+         *
          * Can return its result via Promise in Manifest V3 or later since Chrome 116.
          */
         function getDevices(filter?: DeviceFilter): Promise<AudioDeviceInfo[]>;
-        function getDevices(filter: DeviceFilter, callback: (devices: AudioDeviceInfo[]) => void): void;
         function getDevices(callback: (devices: AudioDeviceInfo[]) => void): void;
+        function getDevices(filter: DeviceFilter | undefined, callback: (devices: AudioDeviceInfo[]) => void): void;
 
         /**
          * Gets the system-wide mute state for the specified stream type.
+         *
          * Can return its result via Promise in Manifest V3 or later since Chrome 116.
          */
         function getMute(streamType: `${StreamType}`): Promise<boolean>;
@@ -626,6 +641,7 @@ declare namespace chrome {
 
         /**
          * Sets lists of active input and/or output devices.
+         *
          * Can return its result via Promise in Manifest V3 or later since Chrome 116.
          */
         function setActiveDevices(ids: DeviceIdLists): Promise<void>;
@@ -633,6 +649,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.
+         *
          * Can return its result via Promise in Manifest V3 or later since Chrome 116.
          */
         function setMute(streamType: `${StreamType}`, isMuted: boolean): Promise<void>;
@@ -640,6 +657,7 @@ declare namespace chrome {
 
         /**
          * Sets the properties for the input or output device.
+         *
          * Can return its result via Promise in Manifest V3 or later since Chrome 116.
          */
         function setProperties(id: string, properties: DeviceProperties): Promise<void>;
@@ -648,18 +666,18 @@ declare namespace chrome {
         /**
          * Fired when audio devices change, either new devices being added, or existing devices being removed.
          */
-        const onDeviceListChanged: chrome.events.Event<(devices: AudioDeviceInfo[]) => void>;
+        const onDeviceListChanged: events.Event<(devices: AudioDeviceInfo[]) => void>;
 
         /**
          * Fired when sound level changes for an active audio device.
          */
-        const onLevelChanged: chrome.events.Event<(event: LevelChangedEvent) => void>;
+        const onLevelChanged: events.Event<(event: LevelChangedEvent) => void>;
 
         /**
          * Fired when the mute state of the audio input or output changes.
          * Note that mute state is system-wide and the new value applies to every audio device with specified stream type.
          */
-        const onMuteChanged: chrome.events.Event<(event: MuteChangedEvent) => void>;
+        const onMuteChanged: events.Event<(event: MuteChangedEvent) => void>;
     }
 
     ////////////////////
@@ -8971,6 +8989,43 @@ declare namespace chrome {
         const onProxyError: events.Event<(details: ErrorDetails) => void>;
     }
 
+    ////////////////////
+    // PublicSuffix
+    ////////////////////
+    /**
+     * Use the `chrome.publicSuffix` API to query the browser's Public Suffix List (PSL).
+     *
+     * Permissions: "publicSuffix"
+     * @since Chrome 153
+     */
+    export namespace publicSuffix {
+        /** The encoding to use for returned domains. */
+        enum DomainEncoding {
+            DISPLAY = "display",
+            PUNYCODE = "punycode",
+        }
+
+        interface DomainOptions {
+            /** Whether IP addresses may be returned as domains. Defaults to false. Note: When allowed, IP addresses are returned without being looked up in the Public Suffix List. */
+            allowIPAddress?: boolean | undefined;
+            /** Whether known public suffixes may be returned as domains. Defaults to false. */
+            allowPlainSuffix?: boolean | undefined;
+            /** Whether unknown TLDs should be considered as a public suffix. For example, for non-public hostnames like `printer.internal-network`. Defaults to false. */
+            allowUnknownSuffix?: boolean | undefined;
+            /** The encoding to use for the returned domain. Defaults to "punycode", but pass "display" if displaying the domain to the user. Generally, "display" will use Unicode, except in cases where that would be unsafe due to ["Unicode confusables"](https://www.unicode.org/reports/tr39/#Confusable_Detection). */
+            encoding?: `${DomainEncoding}` | undefined;
+        }
+
+        /** Gets the registrable domain for `hostname`, if any. */
+        function getDomain(hostname: string, options?: DomainOptions): string | null;
+
+        /** Gets the known public suffix for `hostname`, if any. */
+        function getKnownSuffix(hostname: string): string | null;
+
+        /** Determines whether `hostname` is itself a known public suffix. */
+        function isKnownSuffix(hostname: string): boolean;
+    }
+
     ////////////////////
     // ReadingList
     ////////////////////
@@ -10001,7 +10056,7 @@ declare namespace chrome {
          * Send a single message to a native application. This method requires the `"nativeMessaging"` permission
          *
          * Can return its result via Promise in Manifest V3 or later since Chrome 99.
-         * @param application The name of the native messaging host.
+         * @param application The name of the native messaging host, or target details.
          * @param message The message that will be passed to the native messaging host.
          */
         function sendNativeMessage(application: string, message: object): Promise<any>;
@@ -10964,7 +11019,7 @@ declare namespace chrome {
             /** The user-friendly name (e.g. 'HP LCD monitor'). */
             name: string;
             /**
-             * @platform ChromeOS and Web UI only
+             * @platform ChromeOS only
              * @since Chrome 67
              */
             edid?: Edid;
@@ -11075,7 +11130,7 @@ declare namespace chrome {
         /**
          * Requests the layout info for all displays
          * Can return its result via Promise in Manifest V3 or later since Chrome 91.
-         * @platform ChromeOS and Web UI only
+         * @platform ChromeOS only
          * @since Chrome 53
          */
         function getDisplayLayout(callback: (layouts: DisplayLayout[]) => void): void;
@@ -11087,7 +11142,7 @@ declare namespace chrome {
          * Updates the properties for the display specified by `id`,
          * according to the information provided in `info`.
          * On failure, `runtime.lastError` will be set.
-         * @platform ChromeOS and Web UI only
+         * @platform ChromeOS only
          * @param id The display's unique identifier.
          * @param info The information about display properties that should be changed. A property will be changed only if a new value for it is specified in `info`.
          */
@@ -11100,7 +11155,7 @@ declare namespace chrome {
          * If a layout would overlap or be otherwise invalid it will be adjusted to a valid layout.
          * After layout is resolved, an onDisplayChanged event will be triggered.
          * Can return its result via Promise in Manifest V3 or later since Chrome 91.
-         * @platform ChromeOS and Web UI only
+         * @platform ChromeOS only
          * @since Chrome 53
          * @param layouts The layout information, required for all displays except the primary display.
          */
@@ -11111,8 +11166,8 @@ declare namespace chrome {
          * Enables/disables the unified desktop feature.
          * If enabled while mirroring is active, the desktop mode will not change until mirroring is turned off.
          * Otherwise, the desktop mode will switch to unified immediately.
+         * @platform ChromeOS only
          * @since Chrome 46
-         * @platform ChromeOS and Web UI only
          * @param enabled True if unified desktop should be enabled.
          */
         function enableUnifiedDesktop(enabled: boolean): void;
@@ -11121,6 +11176,7 @@ declare namespace chrome {
          * Starts overscan calibration for a display.
          * This will show an overlay on the screen indicating the current overscan insets.
          * If overscan calibration for display `id` is in progress this will reset calibration.
+         * @platform ChromeOS only
          * @since Chrome 53
          * @param id The display's unique identifier.
          */
@@ -11131,6 +11187,7 @@ declare namespace chrome {
          * Typically this should either move the display along an axis (e.g. left+right have the same value)
          * or scale it along an axis (e.g. top+bottom have opposite values).
          * Each Adjust call is cumulative with previous calls since Start.
+         * @platform ChromeOS only
          * @since Chrome 53
          * @param id The display's unique identifier.
          * @param delta The amount to change the overscan insets.
@@ -11139,6 +11196,7 @@ declare namespace chrome {
 
         /**
          * Resets the overscan insets for a display to the last saved value (i.e before Start was called).
+         * @platform ChromeOS only
          * @since Chrome 53
          * @param id The display's unique identifier.
          */
@@ -11146,6 +11204,7 @@ declare namespace chrome {
 
         /**
          * Complete overscan adjustments for a display by saving the current values and hiding the overlay.
+         * @platform ChromeOS only
          * @since Chrome 53
          * @param id The display's unique identifier.
          */
@@ -11157,6 +11216,7 @@ declare namespace chrome {
          * The callback will be invoked in case of successful calibration only.
          * If the calibration fails, this will throw an error.
          * Can return its result via Promise in Manifest V3 or later since Chrome 91.
+         * @platform ChromeOS only
          * @since Chrome 57
          * @param id The display's unique identifier.
          */
@@ -11167,6 +11227,7 @@ declare namespace chrome {
          * Starts custom touch calibration for a display.
          * This should be called when using a custom UX for collecting calibration data.
          * If another touch calibration is already in progress this will throw an error.
+         * @platform ChromeOS only
          * @since Chrome 57
          * @param id The display's unique identifier.
          */
@@ -11177,6 +11238,7 @@ declare namespace chrome {
          * These `pairs` would be used to calibrate the touch screen for display with `id` called in startCustomTouchCalibration().
          * Always call `startCustomTouchCalibration` before calling this method.
          * If another touch calibration is already in progress this will throw an error.
+         * @platform ChromeOS only
          * @since Chrome 57
          * @param pairs The pairs of point used to calibrate the display.
          * @param bounds Bounds of the display when the touch calibration was performed. `bounds.left` and `bounds.top` values are ignored.
@@ -11186,6 +11248,7 @@ declare namespace chrome {
 
         /**
          * Resets the touch calibration for the display and brings it back to its default state by clearing any touch calibration data associated with the display.
+         * @platform ChromeOS only
          * @since Chrome 57
          * @param id The display's unique identifier.
          */
@@ -11195,7 +11258,7 @@ declare namespace chrome {
          * Sets the display mode to the specified mirror mode.
          * Each call resets the state from previous calls.
          * Calling setDisplayProperties() will fail for the mirroring destination displays.
-         * @platform ChromeOS and Web UI only
+         * @platform ChromeOS only
          * @param info The information of the mirror mode that should be applied to the display mode.
          * @since Chrome 65
          */

chrome/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/chrome",
-    "version": "0.2.9",
+    "version": "0.3.1",
     "description": "TypeScript definitions for chrome",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome",
     "license": "MIT",
@@ -54,6 +54,6 @@
         "@types/har-format": "*"
     },
     "peerDependencies": {},
-    "typesPublisherContentHash": "f5961bea7501409c00f4d057d324fcadcefdc9adee1b3d33f0dad9cca1597b91",
+    "typesPublisherContentHash": "7ea6fa0086ffac2cbb3c773dd4de696ba9b67e5439157b5b025db56df5a9be3c",
     "typeScriptVersion": "5.6"
 }