@types/chrome 0.3.0 → 0.3.2

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: Tue, 15 Sep 2026 20:33:28 GMT
+ * Last updated: Mon, 28 Sep 2026 21:04:10 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

@@ -2044,7 +2044,7 @@ declare namespace chrome {
         const ACTION_MENU_TOP_LEVEL_LIMIT: 6;
 
         /**
-         * Creates a new context menu item. If an error occurs during creation, it may not be detected until the creation callback fires; details will be in {@link chrome.runtime.lastError}.
+         * Creates a new context menu item. If an error occurs during creation, it may not be detected until the creation callback fires; details will be in {@link runtime.lastError}.
          * @return The ID of the newly created item.
          */
         function create(createProperties: CreateProperties, callback?: () => void): number | string;
@@ -8989,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
     ////////////////////
@@ -9283,14 +9320,31 @@ declare namespace chrome {
             includeTlsChannelId?: boolean | undefined;
         }
 
-        interface InstalledDetails {
-            /** The reason that this event is being dispatched. */
-            reason: `${OnInstalledReason}`;
-            /** Indicates the previous version of the extension, which has just been updated. This is present only if 'reason' is 'update'. */
-            previousVersion?: string;
-            /** Indicates the ID of the imported shared module extension which updated. This is present only if 'reason' is 'shared_module_update'. */
-            id?: string;
-        }
+        type InstalledDetails =
+            | {
+                /** The reason that this event is being dispatched. */
+                reason: `${OnInstalledReason.UPDATE}`;
+                /** Indicates the previous version of the extension, which has just been updated. This is present only if 'reason' is 'update'. */
+                previousVersion: string;
+                /** Indicates the ID of the imported shared module extension which updated. This is present only if 'reason' is 'shared_module_update'. */
+                id?: undefined;
+            }
+            | {
+                /** The reason that this event is being dispatched. */
+                reason: `${OnInstalledReason.SHARED_MODULE_UPDATE}`;
+                /** Indicates the previous version of the extension, which has just been updated. This is present only if 'reason' is 'update'. */
+                previousVersion?: undefined;
+                /** Indicates the ID of the imported shared module extension which updated. This is present only if 'reason' is 'shared_module_update'. */
+                id: string;
+            }
+            | {
+                /** The reason that this event is being dispatched. */
+                reason: `${OnInstalledReason.INSTALL}` | `${OnInstalledReason.CHROME_UPDATE}`;
+                /** Indicates the previous version of the extension, which has just been updated. This is present only if 'reason' is 'update'. */
+                previousVersion?: undefined;
+                /** Indicates the ID of the imported shared module extension which updated. This is present only if 'reason' is 'shared_module_update'. */
+                id?: undefined;
+            };
 
         /**
          * A context hosting extension content.
@@ -9375,7 +9429,7 @@ declare namespace chrome {
             postMessage: (message: any) => void;
             /** Immediately disconnect the port. Calling `disconnect()` on an already-disconnected port has no effect. When a port is disconnected, no new events will be dispatched to this port. */
             disconnect: () => void;
-            /** This property will **only** be present on ports passed to {@link runtime.onConnect onConnect} / {@link runtime.onConnectExternal onConnectExternal} / {@link runtime.onConnectExternal onConnectNative} listeners. */
+            /** This property will **only** be present on ports passed to {@link runtime.onConnect onConnect} / {@link runtime.onConnectExternal onConnectExternal} / {@link runtime.onConnectNative onConnectNative} listeners. */
             sender?: MessageSender;
             /** Fired when the port is disconnected from the other end(s). {@link runtime.lastError} may be set if the port was disconnected by an error. If the port is closed via {@link Port.disconnect disconnect}, then this event is _only_ fired on the other end. This event is fired at most once (see also Port lifetime). */
             onDisconnect: events.Event<(port: Port) => void>;
@@ -9518,7 +9572,6 @@ declare namespace chrome {
             ManifestPermission,
             | "debugger"
             | "declarativeNetRequest"
-            | "devtools"
             | "experimental"
             | "fontSettings"
             | "geolocation"
@@ -9704,6 +9757,8 @@ declare namespace chrome {
             omnibox?: { keyword: string } | undefined;
             /** Specifies a path to an options.html file for the extension to use as an options page. */
             options_page?: string | undefined;
+            /** URL of the web app that replaces this extension. */
+            replacement_web_app?: string | undefined;
             /** Lists technologies required to use the extension. */
             requirements?: {
                 "3D"?: { features?: string[] | undefined } | undefined;
@@ -9719,6 +9774,12 @@ declare namespace chrome {
             short_name?: string | undefined;
             /** Declares a JSON schema for the managed storage area. */
             storage?: { managed_schema: string } | undefined;
+            /**
+             * An array of trial tokens to enable Origin Trial and Deprecation Trial features in extension contexts. You can browse and register for active trials on the active trials page.
+             *
+             * To participate in multiple trials simultaneously, include each token as a separate array entry.
+             */
+            trial_tokens?: string[] | undefined;
             /** Registers the extension as a text to speech engine. */
             tts_engine?: {
                 voices: Array<{
@@ -9845,6 +9906,11 @@ declare namespace chrome {
                 /** Indicates whether the extension's options page will be opened in a new tab. If set to `false`, the extension's options page is embedded in `chrome://extensions` rather than opened in a new tab. */
                 open_in_tab?: boolean | undefined;
             } | undefined;
+            /**
+             * The message serialization format used to communicate with extension pages/content scripts/frames running in this extension. The default value is "json".
+             * @since Chrome 148
+             */
+            message_serialization?: "json" | "structured_clone" | undefined;
             /**
              * Maps MIME types to the extension pages that render them. As of Chrome 151, `application/pdf` is the only MIME type available to public handlers. Declaring an unsupported MIME type causes an installation warning.
              * @since Chrome 151
@@ -10019,7 +10085,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>;
@@ -10043,7 +10109,7 @@ declare namespace chrome {
          *
          * The precise behavior may depend on your manifest's options_ui or options_page key, or what Chrome happens to support at the time. For example, the page may be opened in a new tab, within chrome://extensions, within an App, or it may just focus an open options page. It will never cause the caller page to reload.
          *
-         * If your Extension does not declare an options page, or Chrome failed to create one for some other reason, the callback will set {@link runtime.lastError lastError} .
+         * If your Extension does not declare an options page, or Chrome failed to create one for some other reason, the callback will set {@link runtime.lastError lastError}.
          *
          * Can return its result via Promise in Manifest V3 or later since Chrome 99
          */
@@ -10098,13 +10164,13 @@ declare namespace chrome {
 
         /**
          * Fired when a connection is made from a user script from this extension.
-         * @since chrome 115 MV3
+         * @since Chrome 115, MV3
          */
         const onUserScriptConnect: events.Event<(port: Port) => void>;
 
         /**
          * Fired when a message is sent from a user script associated with the same extension.
-         * @since chrome 115, MV3
+         * @since Chrome 115, MV3
          */
         const onUserScriptMessage: events.Event<
             (message: any, sender: MessageSender, sendResponse: (response?: any) => void) => void
@@ -10982,7 +11048,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;
@@ -11093,7 +11159,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;
@@ -11105,7 +11171,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`.
          */
@@ -11118,7 +11184,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.
          */
@@ -11129,8 +11195,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;
@@ -11139,6 +11205,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.
          */
@@ -11149,6 +11216,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.
@@ -11157,6 +11225,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.
          */
@@ -11164,6 +11233,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.
          */
@@ -11175,6 +11245,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.
          */
@@ -11185,6 +11256,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.
          */
@@ -11195,6 +11267,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.
@@ -11204,6 +11277,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.
          */
@@ -11213,7 +11287,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.3.0",
+    "version": "0.3.2",
     "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": "9c20c819fceff510723a6c0d98a378ee8e943c0a33951dfcd16ddb2a43167319",
+    "typesPublisherContentHash": "c958f1f1f0fdca9974a3d23c01aace79ba0b941c3831e233535929542b6e690d",
     "typeScriptVersion": "5.6"
 }