chrome-types 0.1.245 → 0.1.247

package/_all.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright 2023 Google LLC
+ * Copyright 2024 Google LLC
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-// Generated on Thu Nov 16 2023 12:32:42 GMT+0000 (Coordinated Universal Time)
-// Built at b27fc2f5b54feb4bb35a52f318c0a20bbc1da6ae
+// Generated on Fri Jan 05 2024 14:19:46 GMT+0000 (Coordinated Universal Time)
+// Built at d2d64f34870510905d6bd9cd70f6dcef136d7718
 
 // Includes all types, including MV2 + Platform Apps APIs.
 
@@ -6669,7 +6669,7 @@ declare namespace chrome {
         parentId?: number | string,
 
         /**
-         * Restricts the item to apply only to documents or frames whose URL matches one of the given patterns. For details on pattern formats, see [Match Patterns](https://developer.chrome.com/docs/extensions/match_patterns).
+         * Restricts the item to apply only to documents or frames whose URL matches one of the given patterns. For details on pattern formats, see [Match Patterns](https://developer.chrome.com/docs/extensions/develop/concepts/match-patterns).
          */
         documentUrlPatterns?: string[],
 
@@ -6967,7 +6967,7 @@ declare namespace chrome {
     ): void;
 
     /**
-     * Retrieves all cookies from a single cookie store that match the given information. The cookies returned will be sorted, with those with the longest path first. If multiple cookies have the same path length, those with the earliest creation time will be first. Only retrieves cookies for domains which the extension has host permissions to.
+     * Retrieves all cookies from a single cookie store that match the given information. The cookies returned will be sorted, with those with the longest path first. If multiple cookies have the same path length, those with the earliest creation time will be first. This method only retrieves cookies for domains that the extension has host permissions to.
      *
      * @chrome-returns-extra since Chrome 88
      * @param details Information to filter the cookies being retrieved.
@@ -7021,7 +7021,7 @@ declare namespace chrome {
     ): Promise<Cookie[]>;
 
     /**
-     * Retrieves all cookies from a single cookie store that match the given information. The cookies returned will be sorted, with those with the longest path first. If multiple cookies have the same path length, those with the earliest creation time will be first. Only retrieves cookies for domains which the extension has host permissions to.
+     * Retrieves all cookies from a single cookie store that match the given information. The cookies returned will be sorted, with those with the longest path first. If multiple cookies have the same path length, those with the earliest creation time will be first. This method only retrieves cookies for domains that the extension has host permissions to.
      *
      * @param details Information to filter the cookies being retrieved.
      */
@@ -7584,7 +7584,7 @@ declare namespace chrome {
       css?: string[];
 
       /**
-       * Matches if the bookmarked state of the page is equal to the specified value. Requres the [bookmarks permission](https://developer.chrome.com/docs/extensions/declare_permissions).
+       * Matches if the bookmarked state of the page is equal to the specified value. Requres the [bookmarks permission](https://developer.chrome.com/docs/extensions/develop/concepts/declare-permissions).
        *
        * @since Chrome 45
        */
@@ -7592,7 +7592,9 @@ declare namespace chrome {
     }
 
     /**
-     * Declarative event action that shows the extension's {@link pageAction page action} while the corresponding conditions are met. This action can be used without [host permissions](https://developer.chrome.com/docs/extensions/declare_permissions#host-permissions), but the extension must have a page action. If the extension has the [activeTab](https://developer.chrome.com/docs/extensions/activeTab) permission, clicking the page action grants access to the active tab.
+     * A declarative event action that sets the extension's {@link pageAction page action} to an enabled state while the corresponding conditions are met. This action can be used without [host permissions](https://developer.chrome.com/docs/extensions/develop/concepts/declare-permissions#host-permissions), but the extension must have a page action. If the extension has the [activeTab](https://developer.chrome.com/docs/extensions/develop/concepts/activeTab) permission, clicking the page action grants access to the active tab.
+     *
+     * On pages where the conditions are not met the extension's toolbar action will be grey-scale, and clicking it will open the context menu, instead of triggering the action.
      *
      * @deprecated Please use {@link declarativeContent.ShowAction}.
      * @chrome-deprecated-since Chrome 97
@@ -7602,7 +7604,9 @@ declare namespace chrome {
     }
 
     /**
-     * Declarative event action that shows the extension's toolbar action ({@link pageAction page action} or {@link browserAction browser action}) while the corresponding conditions are met. This action can be used without [host permissions](https://developer.chrome.com/docs/extensions/declare_permissions#host-permissions). If the extension has the [activeTab](https://developer.chrome.com/docs/extensions/activeTab) permission, clicking the page action grants access to the active tab.
+     * A declarative event action that sets the extension's toolbar {@link action action} to an enabled state while the corresponding conditions are met. This action can be used without [host permissions](https://developer.chrome.com/docs/extensions/develop/concepts/declare-permissions#host-permissions). If the extension has the [activeTab](https://developer.chrome.com/docs/extensions/develop/concepts/activeTab) permission, clicking the page action grants access to the active tab.
+     *
+     * On pages where the conditions are not met the extension's toolbar action will be grey-scale, and clicking it will open the context menu, instead of triggering the action.
      *
      * @since Chrome 97
      */
@@ -7611,7 +7615,7 @@ declare namespace chrome {
     }
 
     /**
-     * Declarative event action that sets the n-dip square icon for the extension's {@link pageAction page action} or {@link browserAction browser action} while the corresponding conditions are met. This action can be used without [host permissions](https://developer.chrome.com/docs/extensions/declare_permissions#host-permissions), but the extension must have a page or browser action.
+     * Declarative event action that sets the n-dip square icon for the extension's {@link pageAction page action} or {@link browserAction browser action} while the corresponding conditions are met. This action can be used without [host permissions](https://developer.chrome.com/docs/extensions/develop/concepts/declare-permissions#host-permissions), but the extension must have a page or browser action.
      *
      * Exactly one of `imageData` or `path` must be specified. Both are dictionaries mapping a number of pixels to an image representation. The image representation in `imageData` is an [ImageData](https://developer.mozilla.org/en-US/docs/Web/API/ImageData) object; for example, from a `canvas` element, while the image representation in `path` is the path to an image file relative to the extension's manifest. If `scale` screen pixels fit into a device-independent pixel, the `scale * n` icon is used. If that scale is missing, another image is resized to the required size.
      */
@@ -12642,16 +12646,6 @@ declare namespace chrome {
       ) => void,
     ): void;
 
-    /**
-     * Get a writable Entry from another Entry. This call will fail with a runtime error if the application does not have the 'write' permission under 'fileSystem'. If entry is a DirectoryEntry, this call will fail if the application does not have the 'directory' permission under 'fileSystem'.
-     *
-     * @chrome-returns-extra since Chrome 117
-     */
-    export function getWritableEntry(
-
-      entry: Entry,
-    ): Promise<Entry>;
-
     /**
      * Get a writable Entry from another Entry. This call will fail with a runtime error if the application does not have the 'write' permission under 'fileSystem'. If entry is a DirectoryEntry, this call will fail if the application does not have the 'directory' permission under 'fileSystem'.
      */
@@ -12659,7 +12653,7 @@ declare namespace chrome {
 
       entry: Entry,
 
-      callback?: (
+      callback: (
         entry: Entry,
       ) => void,
     ): void;
@@ -21437,6 +21431,16 @@ declare namespace chrome {
       debug_errors: string[];
     }
 
+    /**
+     * This method filters from a list of client certificates the ones that are known to the platform, match `request` and for which the extension has permission to access the certificate and its private key. If `interactive` is true, the user is presented a dialog where they can select from matching certificates and grant the extension access to the certificate. The selected/filtered client certificates will be passed to `callback`.
+     *
+     * @chrome-returns-extra since Pending
+     */
+    export function selectClientCertificates(
+
+      details: SelectDetails,
+    ): Promise<Match[]>;
+
     /**
      * This method filters from a list of client certificates the ones that are known to the platform, match `request` and for which the extension has permission to access the certificate and its private key. If `interactive` is true, the user is presented a dialog where they can select from matching certificates and grant the extension access to the certificate. The selected/filtered client certificates will be passed to `callback`.
      */
@@ -21447,7 +21451,7 @@ declare namespace chrome {
       /**
        * @param matches The list of certificates that match the request, that the extension has permission for and, if `interactive` is true, that were selected by the user.
        */
-      callback: (
+      callback?: (
         matches: Match[],
       ) => void,
     ): void;
@@ -21508,12 +21512,22 @@ declare namespace chrome {
 
     /**
      * Checks whether `details.serverCertificateChain` can be trusted for `details.hostname` according to the trust settings of the platform. Note: The actual behavior of the trust verification is not fully specified and might change in the future. The API implementation verifies certificate expiration, validates the certification path and checks trust by a known CA. The implementation is supposed to respect the EKU serverAuth and to support subject alternative names.
+     *
+     * @chrome-returns-extra since Pending
      */
     export function verifyTLSServerCertificate(
 
       details: VerificationDetails,
+    ): Promise<VerificationResult>;
 
-      callback: (
+    /**
+     * Checks whether `details.serverCertificateChain` can be trusted for `details.hostname` according to the trust settings of the platform. Note: The actual behavior of the trust verification is not fully specified and might change in the future. The API implementation verifies certificate expiration, validates the certification path and checks trust by a known CA. The implementation is supposed to respect the EKU serverAuth and to support subject alternative names.
+     */
+    export function verifyTLSServerCertificate(
+
+      details: VerificationDetails,
+
+      callback?: (
         result: VerificationResult,
       ) => void,
     ): void;
@@ -21693,7 +21707,7 @@ declare namespace chrome {
     export interface SubmitJobRequest {
 
       /**
-       * The print job to be submitted. The only supported content type is "application/pdf", and the CJT ticket shouldn't include FitToPageTicketItem, PageRangeTicketItem, ReverseOrderTicketItem and VendorTicketItem fields since they are irrelevant for native printing. All other fields must be present.
+       * The print job to be submitted. The only supported content type is "application/pdf", and the [Cloud Job Ticket](https://developers.google.com/cloud-print/docs/cdd#cjt) shouldn't include `FitToPageTicketItem`, `PageRangeTicketItem`, `ReverseOrderTicketItem` and `VendorTicketItem` fields since they are irrelevant for native printing. All other fields must be present.
        */
       job: printerProvider.PrintJob;
     }
@@ -21825,7 +21839,8 @@ declare namespace chrome {
     ) => void>;
 
     /**
-     * Submits the job for print. Use the [`PrintingAPIExtensionsAllowlist`](https://chromeenterprise.google/policies/#PrintingAPIExtensionsAllowlist) to bypass promting the user to confirm printing.
+     * Submits the job for printing. If the extension is not listed in the [`PrintingAPIExtensionsAllowlist`](https://chromeenterprise.google/policies/#PrintingAPIExtensionsAllowlist) policy, the user is prompted to accept the print job.
+     * Before Chrome 120, this function did not return a promise.
      *
      * @chrome-returns-extra since Chrome 100
      */
@@ -21835,7 +21850,8 @@ declare namespace chrome {
     ): Promise<SubmitJobResponse>;
 
     /**
-     * Submits the job for print. Use the [`PrintingAPIExtensionsAllowlist`](https://chromeenterprise.google/policies/#PrintingAPIExtensionsAllowlist) to bypass promting the user to confirm printing.
+     * Submits the job for printing. If the extension is not listed in the [`PrintingAPIExtensionsAllowlist`](https://chromeenterprise.google/policies/#PrintingAPIExtensionsAllowlist) policy, the user is prompted to accept the print job.
+     * Before Chrome 120, this function did not return a promise.
      */
     export function submitJob(
 
@@ -22251,6 +22267,13 @@ declare namespace chrome {
        * **Available on Windows and ChromeOS only**: If enabled, Chrome provides a unique ID to plugins in order to run protected content. The value of this preference is of type boolean, and the default value is `true`.
        */
       protectedContentEnabled: types.ChromeSetting<boolean>,
+
+      /**
+       * If disabled, [Related Website Sets](https://developer.chrome.com/docs/privacy-sandbox/related-website-sets/) is deactivated. The value of this preference is of type boolean, and the default value is `true`. Extensions may only disable this API by setting the value to `false`. If you try setting this API to `true`, it will throw an error.
+       *
+       * @since Pending
+       */
+      relatedWebsiteSetsEnabled: types.ChromeSetting<boolean>,
     };
   }
 
@@ -22652,7 +22675,7 @@ declare namespace chrome {
   /**
    * Use the `chrome.readingList` API to read from and modify the items in the [Reading List](https://support.google.com/chrome/answer/7343019).
    *
-   * @since Pending
+   * @since Chrome 120
    * @chrome-permission readingList
    * @chrome-min-manifest MV3
    */
@@ -23246,6 +23269,16 @@ declare namespace chrome {
       port: Port,
     ) => void>;
 
+    /**
+     * Fired when a connection is made from a user script from this extension.
+     *
+     * @since Chrome 115
+     * @chrome-min-manifest MV3
+     */
+    export const onUserScriptConnect: events.Event<(
+      port: Port,
+    ) => void>;
+
     /**
      * Fired when a connection is made from a native application. Currently only supported on Chrome OS.
      *
@@ -23274,6 +23307,18 @@ declare namespace chrome {
       sendResponse: () => void,
     ) => boolean | undefined>;
 
+    /**
+     * Fired when a message is sent from a user script associated with the same extension.
+     *
+     * @since Chrome 115
+     * @chrome-min-manifest MV3
+     */
+    export const onUserScriptMessage: events.Event<(
+      message: any,
+      sender: MessageSender,
+      sendResponse: () => void,
+    ) => boolean | undefined>;
+
     /**
      * Fired when an app or the device that it runs on needs to be restarted. The app should close all its windows at its earliest convenient time to let the restart to happen. If the app does nothing, a restart will be enforced after a 24-hour grace period has passed. Currently, this event is only fired for Chrome OS kiosk apps.
      */
@@ -23653,6 +23698,14 @@ declare namespace chrome {
       ) => void,
     ): void;
 
+    /**
+     * Returns a DirectoryEntry for the package directory.
+     *
+     * @chrome-returns-extra since Pending
+     * @chrome-disallow-service-workers
+     */
+    export function getPackageDirectoryEntry(): Promise<DirectoryEntry>;
+
     /**
      * Returns a DirectoryEntry for the package directory.
      *
@@ -23660,7 +23713,7 @@ declare namespace chrome {
      */
     export function getPackageDirectoryEntry(
 
-      callback: (
+      callback?: (
         directoryEntry: DirectoryEntry,
       ) => void,
     ): void;
@@ -23868,7 +23921,7 @@ declare namespace chrome {
       allFrames?: boolean;
 
       /**
-       * Whether the script should inject into any frames where the URL belongs to a scheme that would never match a specified Match Pattern, including about:, data:, blob:, and filesystem: schemes. In these cases, in order to determine if the script should inject, the origin of the URL is checked. If the origin is `null` (as is the case for data: URLs), then the "initiator" or "creator" origin is used (i.e., the origin of the frame that created or navigated this frame). Note that this may not be the parent frame, if the frame was navigated by another frame in the document hierarchy.
+       * Indicates whether the script can be injected into frames where the URL contains an unsupported scheme; specifically: about:, data:, blob:, or filesystem:. In these cases, the URL's origin is checked to determine if the script should be injected. If the origin is `null` (as is the case for data: URLs) then the used origin is either the frame that created the current frame or the frame that initiated the navigation to this frame. Note that this may not be the parent frame.
        *
        * @since Chrome 119
        */
@@ -25234,32 +25287,31 @@ declare namespace chrome {
     /**
      * Creates a socket of the specified type that will connect to the specified remote machine.
      *
+     * @chrome-returns-extra since Pending
      * @param type The type of socket to create. Must be `tcp` or `udp`.
      * @param options The socket options.
-     * @param callback Called when the socket has been created.
      */
     export function create(
 
       type: SocketType,
 
-      options: CreateOptions,
-
-      callback: (
-        createInfo: CreateInfo,
-      ) => void,
-    ): void;
+      options?: CreateOptions,
+    ): Promise<CreateInfo>;
 
     /**
      * Creates a socket of the specified type that will connect to the specified remote machine.
      *
      * @param type The type of socket to create. Must be `tcp` or `udp`.
+     * @param options The socket options.
      * @param callback Called when the socket has been created.
      */
     export function create(
 
       type: SocketType,
 
-      callback: (
+      options?: CreateOptions,
+
+      callback?: (
         createInfo: CreateInfo,
       ) => void,
     ): void;
@@ -25551,6 +25603,17 @@ declare namespace chrome {
       ) => void,
     ): void;
 
+    /**
+     * Retrieves the state of the given socket.
+     *
+     * @chrome-returns-extra since Pending
+     * @param socketId The socketId.
+     */
+    export function getInfo(
+
+      socketId: number,
+    ): Promise<SocketInfo>;
+
     /**
      * Retrieves the state of the given socket.
      *
@@ -25561,11 +25624,18 @@ declare namespace chrome {
 
       socketId: number,
 
-      callback: (
+      callback?: (
         result: SocketInfo,
       ) => void,
     ): void;
 
+    /**
+     * Retrieves information about local adapters on this system.
+     *
+     * @chrome-returns-extra since Pending
+     */
+    export function getNetworkList(): Promise<NetworkInterface[]>;
+
     /**
      * Retrieves information about local adapters on this system.
      *
@@ -25573,7 +25643,7 @@ declare namespace chrome {
      */
     export function getNetworkList(
 
-      callback: (
+      callback?: (
         result: NetworkInterface[],
       ) => void,
     ): void;
@@ -25874,36 +25944,46 @@ declare namespace chrome {
     /**
      * Creates a TCP socket.
      *
+     * @chrome-returns-extra since Pending
      * @param properties The socket properties (optional).
-     * @param callback Called when the socket has been created.
      */
     export function create(
 
-      properties: SocketProperties,
-
-      /**
-       * @param createInfo The result of the socket creation.
-       */
-      callback: (
-        createInfo: CreateInfo,
-      ) => void,
-    ): void;
+      properties?: SocketProperties,
+    ): Promise<CreateInfo>;
 
     /**
      * Creates a TCP socket.
      *
+     * @param properties The socket properties (optional).
      * @param callback Called when the socket has been created.
      */
     export function create(
 
+      properties?: SocketProperties,
+
       /**
        * @param createInfo The result of the socket creation.
        */
-      callback: (
+      callback?: (
         createInfo: CreateInfo,
       ) => void,
     ): void;
 
+    /**
+     * Updates the socket properties.
+     *
+     * @chrome-returns-extra since Pending
+     * @param socketId The socket identifier.
+     * @param properties The properties to update.
+     */
+    export function update(
+
+      socketId: number,
+
+      properties: SocketProperties,
+    ): Promise<void>;
+
     /**
      * Updates the socket properties.
      *
@@ -25920,6 +26000,18 @@ declare namespace chrome {
       callback?: () => void,
     ): void;
 
+    /**
+     * Enables or disables the application from receiving messages from its peer. The default value is "false". Pausing a socket is typically used by an application to throttle data sent by its peer. When a socket is paused, no `onReceive` event is raised. When a socket is connected and un-paused, `onReceive` events are raised again when messages are received.
+     *
+     * @chrome-returns-extra since Pending
+     */
+    export function setPaused(
+
+      socketId: number,
+
+      paused: boolean,
+    ): Promise<void>;
+
     /**
      * Enables or disables the application from receiving messages from its peer. The default value is "false". Pausing a socket is typically used by an application to throttle data sent by its peer. When a socket is paused, no `onReceive` event is raised. When a socket is connected and un-paused, `onReceive` events are raised again when messages are received.
      *
@@ -26054,6 +26146,17 @@ declare namespace chrome {
       ) => void,
     ): void;
 
+    /**
+     * Disconnects the socket.
+     *
+     * @chrome-returns-extra since Pending
+     * @param socketId The socket identifier.
+     */
+    export function disconnect(
+
+      socketId: number,
+    ): Promise<void>;
+
     /**
      * Disconnects the socket.
      *
@@ -26121,6 +26224,17 @@ declare namespace chrome {
       ) => void,
     ): void;
 
+    /**
+     * Closes the socket and releases the address/port the socket is bound to. Each socket created should be closed after use. The socket id is no no longer valid as soon at the function is called. However, the socket is guaranteed to be closed only when the callback is invoked.
+     *
+     * @chrome-returns-extra since Pending
+     * @param socketId The socket identifier.
+     */
+    export function close(
+
+      socketId: number,
+    ): Promise<void>;
+
     /**
      * Closes the socket and releases the address/port the socket is bound to. Each socket created should be closed after use. The socket id is no no longer valid as soon at the function is called. However, the socket is guaranteed to be closed only when the callback is invoked.
      *
@@ -26134,6 +26248,17 @@ declare namespace chrome {
       callback?: () => void,
     ): void;
 
+    /**
+     * Retrieves the state of the given socket.
+     *
+     * @chrome-returns-extra since Pending
+     * @param socketId The socket identifier.
+     */
+    export function getInfo(
+
+      socketId: number,
+    ): Promise<SocketInfo>;
+
     /**
      * Retrieves the state of the given socket.
      *
@@ -26147,11 +26272,18 @@ declare namespace chrome {
       /**
        * @param socketInfo Object containing the socket information.
        */
-      callback: (
+      callback?: (
         socketInfo: SocketInfo,
       ) => void,
     ): void;
 
+    /**
+     * Retrieves the list of currently opened sockets owned by the application.
+     *
+     * @chrome-returns-extra since Pending
+     */
+    export function getSockets(): Promise<SocketInfo[]>;
+
     /**
      * Retrieves the list of currently opened sockets owned by the application.
      *
@@ -26162,7 +26294,7 @@ declare namespace chrome {
       /**
        * @param socketInfos Array of object containing socket information.
        */
-      callback: (
+      callback?: (
         socketInfos: SocketInfo[],
       ) => void,
     ): void;
@@ -26273,36 +26405,46 @@ declare namespace chrome {
     /**
      * Creates a TCP server socket.
      *
+     * @chrome-returns-extra since Pending
      * @param properties The socket properties (optional).
-     * @param callback Called when the socket has been created.
      */
     export function create(
 
-      properties: SocketProperties,
-
-      /**
-       * @param createInfo The result of the socket creation.
-       */
-      callback: (
-        createInfo: CreateInfo,
-      ) => void,
-    ): void;
+      properties?: SocketProperties,
+    ): Promise<CreateInfo>;
 
     /**
      * Creates a TCP server socket.
      *
+     * @param properties The socket properties (optional).
      * @param callback Called when the socket has been created.
      */
     export function create(
 
+      properties?: SocketProperties,
+
       /**
        * @param createInfo The result of the socket creation.
        */
-      callback: (
+      callback?: (
         createInfo: CreateInfo,
       ) => void,
     ): void;
 
+    /**
+     * Updates the socket properties.
+     *
+     * @chrome-returns-extra since Pending
+     * @param socketId The socket identifier.
+     * @param properties The properties to update.
+     */
+    export function update(
+
+      socketId: number,
+
+      properties: SocketProperties,
+    ): Promise<void>;
+
     /**
      * Updates the socket properties.
      *
@@ -26319,6 +26461,18 @@ declare namespace chrome {
       callback?: () => void,
     ): void;
 
+    /**
+     * Enables or disables a listening socket from accepting new connections. When paused, a listening socket accepts new connections until its backlog (see `listen` function) is full then refuses additional connection requests. `onAccept` events are raised only when the socket is un-paused.
+     *
+     * @chrome-returns-extra since Pending
+     */
+    export function setPaused(
+
+      socketId: number,
+
+      paused: boolean,
+    ): Promise<void>;
+
     /**
      * Enables or disables a listening socket from accepting new connections. When paused, a listening socket accepts new connections until its backlog (see `listen` function) is full then refuses additional connection requests. `onAccept` events are raised only when the socket is un-paused.
      *
@@ -26384,6 +26538,17 @@ declare namespace chrome {
       ) => void,
     ): void;
 
+    /**
+     * Disconnects the listening socket, i.e. stops accepting new connections and releases the address/port the socket is bound to. The socket identifier remains valid, e.g. it can be used with `listen` to accept connections on a new port and address.
+     *
+     * @chrome-returns-extra since Pending
+     * @param socketId The socket identifier.
+     */
+    export function disconnect(
+
+      socketId: number,
+    ): Promise<void>;
+
     /**
      * Disconnects the listening socket, i.e. stops accepting new connections and releases the address/port the socket is bound to. The socket identifier remains valid, e.g. it can be used with `listen` to accept connections on a new port and address.
      *
@@ -26397,6 +26562,17 @@ declare namespace chrome {
       callback?: () => void,
     ): void;
 
+    /**
+     * Disconnects and destroys the socket. Each socket created should be closed after use. The socket id is no longer valid as soon at the function is called. However, the socket is guaranteed to be closed only when the callback is invoked.
+     *
+     * @chrome-returns-extra since Pending
+     * @param socketId The socket identifier.
+     */
+    export function close(
+
+      socketId: number,
+    ): Promise<void>;
+
     /**
      * Disconnects and destroys the socket. Each socket created should be closed after use. The socket id is no longer valid as soon at the function is called. However, the socket is guaranteed to be closed only when the callback is invoked.
      *
@@ -26410,6 +26586,17 @@ declare namespace chrome {
       callback?: () => void,
     ): void;
 
+    /**
+     * Retrieves the state of the given socket.
+     *
+     * @chrome-returns-extra since Pending
+     * @param socketId The socket identifier.
+     */
+    export function getInfo(
+
+      socketId: number,
+    ): Promise<SocketInfo>;
+
     /**
      * Retrieves the state of the given socket.
      *
@@ -26423,11 +26610,18 @@ declare namespace chrome {
       /**
        * @param socketInfo Object containing the socket information.
        */
-      callback: (
+      callback?: (
         socketInfo: SocketInfo,
       ) => void,
     ): void;
 
+    /**
+     * Retrieves the list of currently opened sockets owned by the application.
+     *
+     * @chrome-returns-extra since Pending
+     */
+    export function getSockets(): Promise<SocketInfo[]>;
+
     /**
      * Retrieves the list of currently opened sockets owned by the application.
      *
@@ -26438,7 +26632,7 @@ declare namespace chrome {
       /**
        * @param socketInfos Array of object containing socket information.
        */
-      callback: (
+      callback?: (
         socketInfos: SocketInfo[],
       ) => void,
     ): void;
@@ -26589,36 +26783,46 @@ declare namespace chrome {
     /**
      * Creates a UDP socket with the given properties.
      *
+     * @chrome-returns-extra since Pending
      * @param properties The socket properties (optional).
-     * @param callback Called when the socket has been created.
      */
     export function create(
 
-      properties: SocketProperties,
-
-      /**
-       * @param createInfo The result of the socket creation.
-       */
-      callback: (
-        createInfo: CreateInfo,
-      ) => void,
-    ): void;
+      properties?: SocketProperties,
+    ): Promise<CreateInfo>;
 
     /**
      * Creates a UDP socket with the given properties.
      *
+     * @param properties The socket properties (optional).
      * @param callback Called when the socket has been created.
      */
     export function create(
 
+      properties?: SocketProperties,
+
       /**
        * @param createInfo The result of the socket creation.
        */
-      callback: (
+      callback?: (
         createInfo: CreateInfo,
       ) => void,
     ): void;
 
+    /**
+     * Updates the socket properties.
+     *
+     * @chrome-returns-extra since Pending
+     * @param socketId The socket ID.
+     * @param properties The properties to update.
+     */
+    export function update(
+
+      socketId: number,
+
+      properties: SocketProperties,
+    ): Promise<void>;
+
     /**
      * Updates the socket properties.
      *
@@ -26635,6 +26839,19 @@ declare namespace chrome {
       callback?: () => void,
     ): void;
 
+    /**
+     * Pauses or unpauses a socket. A paused socket is blocked from firing `onReceive` events.
+     *
+     * @chrome-returns-extra since Pending
+     * @param paused Flag to indicate whether to pause or unpause.
+     */
+    export function setPaused(
+
+      socketId: number,
+
+      paused: boolean,
+    ): Promise<void>;
+
     /**
      * Pauses or unpauses a socket. A paused socket is blocked from firing `onReceive` events.
      *
@@ -26736,6 +26953,17 @@ declare namespace chrome {
       ) => void,
     ): void;
 
+    /**
+     * Closes the socket and releases the address/port the socket is bound to. Each socket created should be closed after use. The socket id is no longer valid as soon at the function is called. However, the socket is guaranteed to be closed only when the callback is invoked.
+     *
+     * @chrome-returns-extra since Pending
+     * @param socketId The socket ID.
+     */
+    export function close(
+
+      socketId: number,
+    ): Promise<void>;
+
     /**
      * Closes the socket and releases the address/port the socket is bound to. Each socket created should be closed after use. The socket id is no longer valid as soon at the function is called. However, the socket is guaranteed to be closed only when the callback is invoked.
      *
@@ -26749,6 +26977,17 @@ declare namespace chrome {
       callback?: () => void,
     ): void;
 
+    /**
+     * Retrieves the state of the given socket.
+     *
+     * @chrome-returns-extra since Pending
+     * @param socketId The socket ID.
+     */
+    export function getInfo(
+
+      socketId: number,
+    ): Promise<SocketInfo>;
+
     /**
      * Retrieves the state of the given socket.
      *
@@ -26762,11 +27001,18 @@ declare namespace chrome {
       /**
        * @param socketInfo Object containing the socket information.
        */
-      callback: (
+      callback?: (
         socketInfo: SocketInfo,
       ) => void,
     ): void;
 
+    /**
+     * Retrieves the list of currently opened sockets owned by the application.
+     *
+     * @chrome-returns-extra since Pending
+     */
+    export function getSockets(): Promise<SocketInfo[]>;
+
     /**
      * Retrieves the list of currently opened sockets owned by the application.
      *
@@ -26777,7 +27023,7 @@ declare namespace chrome {
       /**
        * @param socketInfos Array of object containing socket information.
        */
-      callback: (
+      callback?: (
         socketInfos: SocketInfo[],
       ) => void,
     ): void;
@@ -26874,6 +27120,17 @@ declare namespace chrome {
       ) => void,
     ): void;
 
+    /**
+     * Gets the multicast group addresses the socket is currently joined to.
+     *
+     * @chrome-returns-extra since Pending
+     * @param socketId The socket ID.
+     */
+    export function getJoinedGroups(
+
+      socketId: number,
+    ): Promise<string[]>;
+
     /**
      * Gets the multicast group addresses the socket is currently joined to.
      *
@@ -26887,7 +27144,7 @@ declare namespace chrome {
       /**
        * @param groups Array of groups the socket joined.
        */
-      callback: (
+      callback?: (
         groups: string[],
       ) => void,
     ): void;
@@ -28980,6 +29237,13 @@ declare namespace chrome {
        */
       selected: boolean;
 
+      /**
+       * The last time the tab was accessed as the number of milliseconds since epoch.
+       *
+       * @since Pending
+       */
+      lastAccessed?: number;
+
       /**
        * Whether the tab is highlighted.
        */
@@ -32577,7 +32841,7 @@ declare namespace chrome {
   /**
    * Use the `userScripts` API to execute user scripts in the User Scripts context.
    *
-   * @since Pending
+   * @since Chrome 120
    * @chrome-permission userScripts
    * @chrome-min-manifest MV3
    */