chrome-types 0.1.407 → 0.1.409

package/_all.d.ts

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-// Generated on Wed Jan 07 2026 15:45:22 GMT+0000 (Coordinated Universal Time)
-// Built at b53c887388cda795521d8f71e46844d3fc36967a
+// Generated on Fri Jan 09 2026 22:34:02 GMT+0000 (Coordinated Universal Time)
+// Built at 2d4be9c66aeadd66d47b4dd9b233902226201612
 
 // Includes all types, including MV2 + Platform Apps APIs.
 
@@ -786,6 +786,7 @@ declare namespace chrome {
      * @chrome-returns-extra since Chrome 111
      * @param name Optional name to identify this alarm. Defaults to the empty string.
      * @param alarmInfo Describes when the alarm should fire. The initial time must be specified by either `when` or `delayInMinutes` (but not both). If `periodInMinutes` is set, the alarm will repeat every `periodInMinutes` minutes after the initial event. If neither `when` or `delayInMinutes` is set for a repeating alarm, `periodInMinutes` is used as the default for `delayInMinutes`.
+     * @returns Promise that resolves when the alarm has been created.
      */
     export function create(
 
@@ -803,6 +804,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 111
      * @param alarmInfo Describes when the alarm should fire. The initial time must be specified by either `when` or `delayInMinutes` (but not both). If `periodInMinutes` is set, the alarm will repeat every `periodInMinutes` minutes after the initial event. If neither `when` or `delayInMinutes` is set for a repeating alarm, `periodInMinutes` is used as the default for `delayInMinutes`.
+     * @returns Promise that resolves when the alarm has been created.
      */
     export function create(
 
@@ -1907,6 +1909,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 116
      * @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.
+     * @returns Reports the requested list of audio devices.
      */
     export function getDevices(
 
@@ -1987,6 +1990,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 116
      * @param streamType Stream type for which mute state should be fetched.
+     * @returns Promise that resolves with a boolean indicating whether mute is set or not for specified stream type.
      */
     export function getMute(
 
@@ -4978,6 +4982,7 @@ declare namespace chrome {
        * Stored passwords.
        *
        * @deprecated Support for password deletion through extensions has been removed. This data type will be ignored.
+       * @chrome-deprecated-since Chrome 144
        */
       passwords?: boolean;
 
@@ -5048,6 +5053,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 96
      * @param dataToRemove The set of data types to remove.
+     * @returns Resolves when deletion has completed.
      */
     export function remove(
 
@@ -5074,6 +5080,7 @@ declare namespace chrome {
      * Clears websites' appcache data.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Resolves when websites' appcache data has been cleared.
      */
     export function removeAppcache(
 
@@ -5094,6 +5101,7 @@ declare namespace chrome {
      * Clears the browser's cache.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Resolves when the browser's cache has been cleared.
      */
     export function removeCache(
 
@@ -5114,6 +5122,7 @@ declare namespace chrome {
      * Clears websites' cache storage data.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Resolves when websites' cache storage has been cleared.
      * @since Chrome 72
      */
     export function removeCacheStorage(
@@ -5137,6 +5146,7 @@ declare namespace chrome {
      * Clears the browser's cookies and server-bound certificates modified within a particular timeframe.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Resolves when the browser's cookies and server-bound certificates have been cleared.
      */
     export function removeCookies(
 
@@ -5157,6 +5167,7 @@ declare namespace chrome {
      * Clears the browser's list of downloaded files (_not_ the downloaded files themselves).
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Resolves when the browser's list of downloaded files has been cleared.
      */
     export function removeDownloads(
 
@@ -5177,6 +5188,7 @@ declare namespace chrome {
      * Clears websites' file system data.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Resolves when websites' file systems have been cleared.
      */
     export function removeFileSystems(
 
@@ -5197,6 +5209,7 @@ declare namespace chrome {
      * Clears the browser's stored form data (autofill).
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Resolves when the browser's form data has been cleared.
      */
     export function removeFormData(
 
@@ -5217,6 +5230,7 @@ declare namespace chrome {
      * Clears the browser's history.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Resolves when the browser's history has cleared.
      */
     export function removeHistory(
 
@@ -5237,6 +5251,7 @@ declare namespace chrome {
      * Clears websites' IndexedDB data.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Resolves when websites' IndexedDB data has been cleared.
      */
     export function removeIndexedDB(
 
@@ -5257,6 +5272,7 @@ declare namespace chrome {
      * Clears websites' local storage data.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Resolves when websites' local storage has been cleared.
      */
     export function removeLocalStorage(
 
@@ -5277,6 +5293,7 @@ declare namespace chrome {
      * Clears plugins' data.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Resolves when plugins' data has been cleared.
      * @deprecated Support for Flash has been removed. This function has no effect.
      * @chrome-deprecated-since Chrome 88
      */
@@ -5302,7 +5319,9 @@ declare namespace chrome {
      * Clears the browser's stored passwords.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Resolves when the browser's passwords have been cleared.
      * @deprecated Support for password deletion through extensions has been removed. This function has no effect.
+     * @chrome-deprecated-since Chrome 144
      */
     export function removePasswords(
 
@@ -5313,6 +5332,7 @@ declare namespace chrome {
      * Clears the browser's stored passwords.
      *
      * @deprecated Support for password deletion through extensions has been removed. This function has no effect.
+     * @chrome-deprecated-since Chrome 144
      */
     export function removePasswords(
 
@@ -5325,6 +5345,7 @@ declare namespace chrome {
      * Clears websites' service workers.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Resolves when websites' service workers have been cleared.
      * @since Chrome 72
      */
     export function removeServiceWorkers(
@@ -5348,6 +5369,7 @@ declare namespace chrome {
      * Clears websites' WebSQL data.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Resolves when websites' WebSQL databases have been cleared.
      */
     export function removeWebSQL(
 
@@ -5678,6 +5700,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 96
      * @param details Contains the details about the requested dialog.
+     * @returns Returns a Promise which resolves when the PIN is provided by the user. Rejects with an error if the dialog request finishes unsuccessfully (e.g. the dialog was canceled by the user or was not allowed to be shown).
      * @since Chrome 57
      */
     export function requestPin(
@@ -5705,6 +5728,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 96
      * @param details Contains the details about the reason for stopping the request flow.
+     * @returns Returns a Promise which resolves when the request to close the PIN dialog is complete.
      * @since Chrome 57
      */
     export function stopPinRequest(
@@ -5732,6 +5756,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 96
      * @param details The certificates to set. Invalid certificates will be ignored.
+     * @returns Returns a Promise which resolves upon completion.
      * @since Chrome 86
      */
     export function setCertificates(
@@ -5939,6 +5964,7 @@ declare namespace chrome {
      * Returns all the registered extension commands for this extension and their shortcut (if active). Before Chrome 110, this command did not return `_execute_action`.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Resolves with a list of the registered commands.
      */
     export function getAll(): Promise<Command[]>;
 
@@ -6664,6 +6690,7 @@ declare namespace chrome {
      * @chrome-returns-extra since Chrome 123
      * @param id The ID of the item to update.
      * @param updateProperties The properties to update. Accepts the same values as the {@link contextMenus.create} function.
+     * @returns Resolves when the context menu has been updated.
      */
     export function update(
 
@@ -6774,6 +6801,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 123
      * @param menuItemId The ID of the context menu item to remove.
+     * @returns Resolves when the context menu has been removed.
      */
     export function remove(
 
@@ -6796,6 +6824,7 @@ declare namespace chrome {
      * Removes all context menu items added by this extension.
      *
      * @chrome-returns-extra since Chrome 123
+     * @returns Resolves when removal is complete.
      */
     export function removeAll(): Promise<void>;
 
@@ -7581,6 +7610,7 @@ declare namespace chrome {
      * @chrome-returns-extra since Chrome 96
      * @param target Debugging target to which you want to attach.
      * @param requiredVersion Required debugging protocol version ("0.1"). One can only attach to the debuggee with matching major version and greater or equal minor version. List of the protocol versions can be obtained [here](https://developer.chrome.com/devtools/docs/debugger-protocol).
+     * @returns Resolves once the attach operation succeeds or fails. The promise resolves with no value. If the attach fails, the promise will be rejected.
      */
     export function attach(
 
@@ -7609,6 +7639,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 96
      * @param target Debugging target from which you want to detach.
+     * @returns Resolves once the detach operation succeeds or fails. The promise resolves with no value. If the detach fails, the promise will be rejected.
      */
     export function detach(
 
@@ -7634,6 +7665,7 @@ declare namespace chrome {
      * @param target Debugging target to which you want to send the command.
      * @param method Method name. Should be one of the methods defined by the [remote debugging protocol](https://developer.chrome.com/devtools/docs/debugger-protocol).
      * @param commandParams JSON object with request parameters. This object must conform to the remote debugging params scheme for given method.
+     * @returns Response body. If an error occurs while posting the message, the promise will be rejected.
      */
     export function sendCommand(
 
@@ -8700,6 +8732,7 @@ declare namespace chrome {
      * *   {@link MAX_NUMBER_OF_DYNAMIC_RULES} is the maximum number of dynamic rules an extension can add. The number of [unsafe rules](https://developer.chrome.com/docs/extensions/reference/declarativeNetRequest/#safe_rules) must not exceed {@link MAX_NUMBER_OF_UNSAFE_DYNAMIC_RULES}.
      *
      * @chrome-returns-extra since Chrome 91
+     * @returns Promise that resolves once the update is complete. In case of an error, the promise will be rejected 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, internal errors, and others.
      */
     export function updateDynamicRules(
 
@@ -8732,6 +8765,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 91
      * @param filter An object to filter the list of fetched rules.
+     * @returns Promise that resolves with the set of dynamic rules. The Promise may be rejected in case of transient internal errors.
      */
     export function getDynamicRules(
 
@@ -8766,6 +8800,7 @@ declare namespace chrome {
      * *   {@link MAX_NUMBER_OF_SESSION_RULES} is the maximum number of session rules an extension can add.
      *
      * @chrome-returns-extra since Chrome 91
+     * @returns Promise that resolves once the update is complete. In case of an error, the promise will be rejected 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.
      * @since Chrome 90
      */
     export function updateSessionRules(
@@ -8794,6 +8829,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 91
      * @param filter An object to filter the list of fetched rules.
+     * @returns Promise that resolves with the set of session scoped rules.
      * @since Chrome 90
      */
     export function getSessionRules(
@@ -8827,6 +8863,7 @@ declare namespace chrome {
      * Note that the set of enabled static rulesets is persisted across sessions but not across extension updates, i.e. the `rule_resources` manifest key will determine the set of enabled static rulesets on each extension update.
      *
      * @chrome-returns-extra since Chrome 91
+     * @returns Promise that resolves once the update is complete. In case of an error, the promise will be rejected and no change will be made to the set of enabled rulesets. This can happen for multiple reasons, such as invalid ruleset IDs, rule count limit exceeded, or internal errors.
      */
     export function updateEnabledRulesets(
 
@@ -8854,6 +8891,7 @@ declare namespace chrome {
      * Returns the ids for the current set of enabled static rulesets.
      *
      * @chrome-returns-extra since Chrome 91
+     * @returns Promise that resolves with a list of ids, where each id corresponds to an enabled static {@link Ruleset}.
      */
     export function getEnabledRulesets(): Promise<string[]>;
 
@@ -8870,6 +8908,7 @@ declare namespace chrome {
     /**
      * Disables and enables individual static rules in a {@link Ruleset}. Changes to rules belonging to a disabled {@link Ruleset} will take effect the next time that it becomes enabled.
      *
+     * @returns Promise that resolves when the update is complete. In case of an error, the promise will be rejected and no change will be made to the enabled static rules.
      * @since Chrome 111
      */
     export function updateStaticRules(
@@ -8893,6 +8932,7 @@ declare namespace chrome {
      * Returns the list of static rules in the given {@link Ruleset} that are currently disabled.
      *
      * @param options Specifies the ruleset to query.
+     * @returns Promise that resolves with a list of ids that correspond to the disabled rules in that ruleset.
      * @since Chrome 111
      */
     export function getDisabledRuleIds(
@@ -8920,6 +8960,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 91
      * @param filter An object to filter the list of matched rules.
+     * @returns Promise that resolves once the list of matched rules has been fetched. In case of an error, the Promise will be rejected. This can happen for multiple reasons, such as insufficient permissions, or exceeding the quota.
      */
     export function getMatchedRules(
 
@@ -8971,6 +9012,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 91
      * @param regexOptions The regular expression to check.
+     * @returns Promise that resolves with details consisting of whether the regular expression is supported and the reason if not.
      * @since Chrome 87
      */
     export function isRegexSupported(
@@ -9016,6 +9058,7 @@ declare namespace chrome {
     /**
      * Checks if any of the extension's declarativeNetRequest rules would match a hypothetical request. Note: Only available for unpacked extensions as this is only intended to be used during extension development.
      *
+     * @returns Promise that resolves with the details of matched rules.
      * @since Chrome 103
      */
     export function testMatchOutcome(
@@ -10472,6 +10515,7 @@ declare namespace chrome {
      * Resolves the given hostname or IP address literal.
      *
      * @param hostname The hostname to resolve.
+     * @returns Promise that resolves when the resolution operation completes.
      */
     export function resolve(
 
@@ -11002,6 +11046,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 96
      * @param options An object containing scan parameters.
+     * @returns Returns a Promise which resolves with the scan results.
      */
     export function scan(
 
@@ -11026,6 +11071,7 @@ declare namespace chrome {
      * Gets the list of available scanners and returns a Promise that resolves with a {@link GetScannerListResponse} object. If a callback is passed to this function, returned data is passed to it instead.
      *
      * @param filter A {@link DeviceFilter} indicating which types of scanners should be returned.
+     * @returns Returns a Promise which resolves with the result and list of scanners.
      * @since Chrome 125
      */
     export function getScannerList(
@@ -11052,6 +11098,7 @@ declare namespace chrome {
      * Opens a scanner for exclusive access and returns a Promise that resolves with an {@link OpenScannerResponse} object. If a callback is passed to this function, returned data is passed to it instead.
      *
      * @param scannerId The ID of a scanner to be opened. This value is one returned from a previous call to {@link getScannerList}.
+     * @returns Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function openScanner(
@@ -11078,6 +11125,7 @@ declare namespace chrome {
      * Gets the group names and member options from a scanner previously opened by {@link openScanner}. This method returns a Promise that resolves with a {@link GetOptionGroupsResponse} object. If a callback is passed to this function, returned data is passed to it instead.
      *
      * @param scannerHandle The handle of an open scanner returned from a call to {@link openScanner}.
+     * @returns Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function getOptionGroups(
@@ -11104,6 +11152,7 @@ declare namespace chrome {
      * Closes the scanner with the passed in handle and returns a Promise that resolves with a {@link CloseScannerResponse} object. If a callback is used, the object is passed to it instead. Even if the response is not a success, the supplied handle becomes invalid and should not be used for further operations.
      *
      * @param scannerHandle Specifies the handle of an open scanner that was previously returned from a call to {@link openScanner}.
+     * @returns Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function closeScanner(
@@ -11131,6 +11180,7 @@ declare namespace chrome {
      *
      * @param scannerHandle The handle of the scanner to set options on. This should be a value previously returned from a call to {@link openScanner}.
      * @param options A list of `OptionSetting` objects to be applied to the scanner.
+     * @returns Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function setOptions(
@@ -11163,6 +11213,7 @@ declare namespace chrome {
      *
      * @param scannerHandle The handle of an open scanner. This should be a value previously returned from a call to {@link openScanner}.
      * @param options A {@link StartScanOptions} object indicating the options to be used for the scan. The `StartScanOptions.format` property must match one of the entries returned in the scanner's `ScannerInfo`.
+     * @returns Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function startScan(
@@ -11194,6 +11245,7 @@ declare namespace chrome {
      * Cancels a started scan and returns a Promise that resolves with a {@link CancelScanResponse} object. If a callback is used, the object is passed to it instead.
      *
      * @param job The handle of an active scan job previously returned from a call to {@link startScan}.
+     * @returns Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function cancelScan(
@@ -11224,6 +11276,7 @@ declare namespace chrome {
      * When the scan job completes, the response will have the result value of `EOF`. This response may contain a final non-zero `data` member.
      *
      * @param job Active job handle previously returned from {@link startScan}.
+     * @returns Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function readScanData(
@@ -11796,6 +11849,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 96
      * @param options What to download and how.
+     * @returns Returns a Promise which resolves with the id of the new {@link DownloadItem}.
      */
     export function download(
 
@@ -11843,6 +11897,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 96
      * @param downloadId The id of the download to pause.
+     * @returns Returns a Promise which resolves when the pause request is completed.
      */
     export function pause(
 
@@ -11866,6 +11921,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 96
      * @param downloadId The id of the download to resume.
+     * @returns Returns a Promise which resolves when the resume request is completed.
      */
     export function resume(
 
@@ -11889,6 +11945,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 96
      * @param downloadId The id of the download to cancel.
+     * @returns Returns a Promise which resolves when the cancel request is completed.
      */
     export function cancel(
 
@@ -11912,6 +11969,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 96
      * @param downloadId The identifier for the download.
+     * @returns Returns a Promise which resolves with a URL to an image that represents the download.
      */
     export function getFileIcon(
 
@@ -12024,6 +12082,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 96
      * @param downloadId The identifier for the {@link DownloadItem}.
+     * @returns Returns a Promise which resolves when the danger prompt dialog closes.
      */
     export function acceptDanger(
 
@@ -12057,6 +12116,7 @@ declare namespace chrome {
      * Change the download UI of every window associated with the current browser profile. As long as at least one extension has set {@link UiOptions.enabled} to false, the download UI will be hidden. Setting {@link UiOptions.enabled} to true while at least one other extension has disabled it will return an error through {@link runtime.lastError}. Requires the `"downloads.ui"` permission in addition to the `"downloads"` permission.
      *
      * @param options Encapsulate a change to the download UI.
+     * @returns Returns a Promise which resolves when the UI update is completed.
      * @since Chrome 105
      */
     export function setUiOptions(
@@ -12092,6 +12152,7 @@ declare namespace chrome {
      * Fetches the value of [the device identifier of the directory API](https://developers.google.com/admin-sdk/directory/v1/guides/manage-chrome-devices), that is generated by the server and identifies the cloud record of the device for querying in the cloud directory API. If the current user is not affiliated, returns an empty string.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Returns a Promise which resolves with the device identifier of the directory API.
      */
     export function getDirectoryDeviceId(): Promise<string>;
 
@@ -12109,6 +12170,7 @@ declare namespace chrome {
      * Fetches the device's serial number. Please note the purpose of this API is to administrate the device (e.g. generating Certificate Sign Requests for device-wide certificates). This API may not be used for tracking devices without the consent of the device's administrator. If the current user is not affiliated, returns an empty string.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Returns a Promise which resolves with the serial number of the device.
      * @since Chrome 66
      */
     export function getDeviceSerialNumber(): Promise<string>;
@@ -12129,6 +12191,7 @@ declare namespace chrome {
      * Fetches the administrator-annotated Asset Id. If the current user is not affiliated or no Asset Id has been set by the administrator, returns an empty string.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Returns a Promise which resolves with the Asset ID of the device.
      * @since Chrome 66
      */
     export function getDeviceAssetId(): Promise<string>;
@@ -12149,6 +12212,7 @@ declare namespace chrome {
      * Fetches the administrator-annotated Location. If the current user is not affiliated or no Annotated Location has been set by the administrator, returns an empty string.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Returns a Promise which resolves with the Annotated Location of the device.
      * @since Chrome 66
      */
     export function getDeviceAnnotatedLocation(): Promise<string>;
@@ -12169,6 +12233,7 @@ declare namespace chrome {
      * Fetches the device's hostname as set by DeviceHostnameTemplate policy. If the current user is not affiliated or no hostname has been set by the enterprise policy, returns an empty string.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Returns a Promise which resolves with the hostname of the device.
      * @since Chrome 82
      */
     export function getDeviceHostname(): Promise<string>;
@@ -12206,6 +12271,7 @@ declare namespace chrome {
      * Obtains the manufacturer and model for the hardware platform and, if the extension is authorized, returns it via `callback`.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Returns a Promise which resolves with the hardware platform info.
      */
     export function getHardwarePlatformInfo(): Promise<HardwarePlatformInfo>;
 
@@ -12242,6 +12308,7 @@ declare namespace chrome {
      * Sets the current input method. This function only changes the current input method to an enabled input method. Input methods can be enabled by enterprise polices. If the input method ID is invalid, or not enabled, {@link runtime.lastError} will be set with a failure reason.
      *
      * @param options Object containing the fields defined in {@link SetCurrentInputMethodOptions}.
+     * @returns Returns a Promise which resolves when the input method is changed, or rejects if there is an error.
      */
     export function setCurrentInputMethod(
 
@@ -12317,6 +12384,7 @@ declare namespace chrome {
      * Retrieves the network details of the device's default network. If the user is not affiliated or the device is not connected to a network, {@link runtime.lastError} will be set with a failure reason.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Returns a Promise which resolves with the device's default network's {@link NetworkDetails}.
      */
     export function getNetworkDetails(): Promise<NetworkDetails>;
 
@@ -12420,6 +12488,7 @@ declare namespace chrome {
      * Returns the available Tokens. In a regular user's session the list will always contain the user's token with `id` `"user"`. If a system-wide TPM token is available, the returned list will also contain the system-wide token with `id` `"system"`. The system-wide token will be the same for all sessions on this device (device in the sense of e.g. a Chromebook).
      *
      * @chrome-returns-extra since Chrome 131
+     * @returns Invoked by `getTokens` with the list of available Tokens.
      */
     export function getTokens(): Promise<Token[]>;
 
@@ -12441,6 +12510,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 131
      * @param tokenId The id of a Token returned by `getTokens`.
+     * @returns Returns a Promise which resolves with the list of the available certificates.
      */
     export function getCertificates(
 
@@ -12470,6 +12540,7 @@ declare namespace chrome {
      * @chrome-returns-extra since Chrome 131
      * @param tokenId The id of a Token returned by `getTokens`.
      * @param certificate The DER encoding of a X.509 certificate.
+     * @returns Returns a Promise which resolves when this operation is finished.
      */
     export function importCertificate(
 
@@ -12499,6 +12570,7 @@ declare namespace chrome {
      * @chrome-returns-extra since Chrome 131
      * @param tokenId The id of a Token returned by `getTokens`.
      * @param certificate The DER encoding of a X.509 certificate.
+     * @returns Returns a Promise which resolves when this operation is finished.
      */
     export function removeCertificate(
 
@@ -12531,6 +12603,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 131
      * @param options Object containing the fields defined in {@link ChallengeKeyOptions}.
+     * @returns Returns a Promise which resolves with the challenge response.
      * @since Chrome 110
      */
     export function challengeKey(
@@ -12566,6 +12639,7 @@ declare namespace chrome {
      * @chrome-returns-extra since Chrome 131
      * @param challenge A challenge as emitted by the Verified Access Web API.
      * @param registerKey If set, the current Enterprise Machine Key is registered with the `"system"` token and relinquishes the Enterprise Machine Key role. The key can then be associated with a certificate and used like any other signing key. This key is 2048-bit RSA. Subsequent calls to this function will then generate a new Enterprise Machine Key.
+     * @returns Returns a Promise which resolves with the challenge response.
      * @deprecated Use {@link challengeKey} instead.
      * @since Chrome 50
      * @chrome-deprecated-since Chrome 110
@@ -12612,6 +12686,7 @@ declare namespace chrome {
      * @chrome-returns-extra since Chrome 131
      * @param challenge A challenge as emitted by the Verified Access Web API.
      * @param registerKey If set, the current Enterprise User Key is registered with the `"user"` token and relinquishes the Enterprise User Key role. The key can then be associated with a certificate and used like any other signing key. This key is 2048-bit RSA. Subsequent calls to this function will then generate a new Enterprise User Key.
+     * @returns Returns a Promise which resolves with the challenge response.
      * @deprecated Use {@link challengeKey} instead.
      * @since Chrome 50
      * @chrome-deprecated-since Chrome 110
@@ -14947,6 +15022,7 @@ declare namespace chrome {
      * In case of an error, {@link runtime.lastError} will be set with a corresponding error code.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns A generic result callback to indicate success or failure.
      */
     export function mount(
 
@@ -14973,6 +15049,7 @@ declare namespace chrome {
      * In case of an error, {@link runtime.lastError} will be set with a corresponding error code.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns A generic result callback to indicate success or failure.
      */
     export function unmount(
 
@@ -14995,6 +15072,7 @@ declare namespace chrome {
      * Returns all file systems mounted by the extension.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Callback to receive the result of {@link getAll} function.
      */
     export function getAll(): Promise<FileSystemInfo[]>;
 
@@ -15012,6 +15090,7 @@ declare namespace chrome {
      * Returns information about a file system with the passed `fileSystemId`.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Callback to receive the result of {@link get} function.
      */
     export function get(
 
@@ -15044,6 +15123,7 @@ declare namespace chrome {
      * In case of an error, {@link runtime.lastError} will be set will a corresponding error code.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns A generic result callback to indicate success or failure.
      * @since Chrome 45
      */
     export function notify(
@@ -15750,6 +15830,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 116
      * @param senderIds A list of server IDs that are allowed to send messages to the application. It should contain at least one and no more than 100 sender IDs.
+     * @returns Resolves when registration completes.
      */
     export function register(
 
@@ -15777,6 +15858,7 @@ declare namespace chrome {
      * Unregisters the application from FCM.
      *
      * @chrome-returns-extra since Chrome 116
+     * @returns Resolves after the unregistration completes. Unregistration was successful if the promise does not reject.
      */
     export function unregister(): Promise<void>;
 
@@ -15793,6 +15875,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 116
      * @param message A message to send to the other party via FCM.
+     * @returns Resolves after the message is successfully queued for sending. If an error occurs, the promise will be rejected.
      */
     export function send(
 
@@ -16839,6 +16922,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 105
      * @param details Token options.
+     * @returns Returns a Promise which resolves with an OAuth2 access token as specified by the manifest, or rejects if there was an error. The `grantedScopes` parameter is populated since Chrome 87. When available, this parameter contains the list of granted scopes corresponding with the returned token.
      */
     export function getAuthToken(
 
@@ -16877,6 +16961,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 106
      * @param details Profile options.
+     * @returns Returns a Promise which resolves with the `ProfileUserInfo` of the primary Chrome account, or an empty `ProfileUserInfo` if the account with given `details` doesn't exist.
      */
     export function getProfileUserInfo(
 
@@ -16914,6 +16999,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 106
      * @param details Token information.
+     * @returns Returns a Promise which resolves when the token has been removed from the cache.
      */
     export function removeCachedAuthToken(
 
@@ -16942,6 +17028,7 @@ declare namespace chrome {
      * *   De-authorizes the user from all auth flows
      *
      * @chrome-returns-extra since Chrome 106
+     * @returns Returns a Promise which resolves when the state has been cleared.
      * @since Chrome 87
      */
     export function clearAllCachedAuthTokens(): Promise<void>;
@@ -16969,6 +17056,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 106
      * @param details WebAuth flow options.
+     * @returns Returns a Promise which resolves with the URL redirected back to your application.
      */
     export function launchWebAuthFlow(
 
@@ -17485,6 +17573,7 @@ declare namespace chrome {
      * Set the current composition. If this extension does not own the active IME, this fails.
      *
      * @chrome-returns-extra since Chrome 111
+     * @returns Resolves when the operation completes with a boolean indicating if the text was accepted or not. On failure, the promise will be rejected.
      */
     export function setComposition(
 
@@ -17601,6 +17690,7 @@ declare namespace chrome {
      * Clear the current composition. If this extension does not own the active IME, this fails.
      *
      * @chrome-returns-extra since Chrome 111
+     * @returns Resolves when the operation completes with a boolean indicating if the text was accepted or not. On failure, the promise will be rejected.
      */
     export function clearComposition(
 
@@ -17635,6 +17725,7 @@ declare namespace chrome {
      * Commits the provided text to the current input.
      *
      * @chrome-returns-extra since Chrome 111
+     * @returns Resolves when the operation completes with a boolean indicating if the text was accepted or not. On failure, the promise will be rejected.
      */
     export function commitText(
 
@@ -17679,6 +17770,7 @@ declare namespace chrome {
      * Sends the key events. This function is expected to be used by virtual keyboards. When key(s) on a virtual keyboard is pressed by a user, this function is used to propagate that event to the system.
      *
      * @chrome-returns-extra since Chrome 111
+     * @returns Resolves when the operation completes.
      */
     export function sendKeyEvents(
 
@@ -17726,6 +17818,7 @@ declare namespace chrome {
      * Sets the properties of the candidate window. This fails if the extension doesn't own the active IME
      *
      * @chrome-returns-extra since Chrome 111
+     * @returns Resolves when the operation completes.
      */
     export function setCandidateWindowProperties(
 
@@ -17864,6 +17957,7 @@ declare namespace chrome {
      * Sets the current candidate list. This fails if this extension doesn't own the active IME
      *
      * @chrome-returns-extra since Chrome 111
+     * @returns Resolves when the operation completes.
      */
     export function setCandidates(
 
@@ -17992,6 +18086,7 @@ declare namespace chrome {
      * Set the position of the cursor in the candidate window. This is a no-op if this extension does not own the active IME.
      *
      * @chrome-returns-extra since Chrome 111
+     * @returns Resolves when the operation completes
      */
     export function setCursorPosition(
 
@@ -18036,6 +18131,7 @@ declare namespace chrome {
      * Shows/Hides an assistive window with the given properties.
      *
      * @chrome-returns-extra since Chrome 111
+     * @returns Resolves when the operation completes.
      * @since Chrome 85
      */
     export function setAssistiveWindowProperties(
@@ -18083,6 +18179,7 @@ declare namespace chrome {
      * Highlights/Unhighlights a button in an assistive window.
      *
      * @chrome-returns-extra since Chrome 111
+     * @returns Resolves when the operation completes. On failure, the promise will be rejected.
      * @since Chrome 86
      */
     export function setAssistiveWindowButtonHighlighted(
@@ -18178,6 +18275,7 @@ declare namespace chrome {
      * Updates the state of the MenuItems specified
      *
      * @chrome-returns-extra since Chrome 111
+     * @returns Resolves when the operation completes
      */
     export function updateMenuItems(
 
@@ -18198,6 +18296,7 @@ declare namespace chrome {
      * Deletes the text around the caret.
      *
      * @chrome-returns-extra since Chrome 111
+     * @returns Resolves when the operation completes.
      */
     export function deleteSurroundingText(
 
@@ -18287,6 +18386,7 @@ declare namespace chrome {
      * Retrieves an identifier for the app instance. The instance ID will be returned by the `callback`. The same ID will be returned as long as the application identity has not been revoked or expired.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Resolves when the retrieval completes.
      */
     export function getID(): Promise<string>;
 
@@ -18307,6 +18407,7 @@ declare namespace chrome {
      * Retrieves the time when the InstanceID has been generated. The creation time will be returned by the `callback`.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Resolves when the retrieval completes.
      */
     export function getCreationTime(): Promise<number>;
 
@@ -18328,6 +18429,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 96
      * @param getTokenParams Parameters for getToken.
+     * @returns Resolves when the retrieval completes.
      */
     export function getToken(
 
@@ -18404,6 +18506,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 96
      * @param deleteTokenParams Parameters for deleteToken.
+     * @returns Resolves when the token deletion completes. The token was revoked successfully if the promise does not reject.
      */
     export function deleteToken(
 
@@ -18456,6 +18559,7 @@ declare namespace chrome {
      * Resets the app instance identifier and revokes all tokens associated with it.
      *
      * @chrome-returns-extra since Chrome 96
+     * @returns Resolves when the deletion completes. The instance identifier was revoked successfully if the promise does not reject.
      */
     export function deleteID(): Promise<void>;
 
@@ -21751,6 +21855,7 @@ declare namespace chrome {
 
     The `notificationId` parameter is required before Chrome 42.
      * @param options Contents of the notification.
+     * @returns Returns a Promise which resolves with the notification id (either supplied or generated) that represents the created notification.
      */
     export function create(
 
@@ -21764,6 +21869,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 116
      * @param options Contents of the notification.
+     * @returns Returns a Promise which resolves with the notification id (either supplied or generated) that represents the created notification.
      */
     export function create(
 
@@ -21811,6 +21917,7 @@ declare namespace chrome {
      * @chrome-returns-extra since Chrome 116
      * @param notificationId The id of the notification to be updated. This is returned by {@link notifications.create} method.
      * @param options Contents of the notification to update to.
+     * @returns Returns a Promise which resolves to indicate whether a matching notification existed.
      */
     export function update(
 
@@ -21841,6 +21948,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 116
      * @param notificationId The id of the notification to be cleared. This is returned by {@link notifications.create} method.
+     * @returns Returns a Promise which resolves to indicate whether a matching notification existed.
      */
     export function clear(
 
@@ -21865,6 +21973,7 @@ declare namespace chrome {
      * Retrieves all the notifications of this app or extension.
      *
      * @chrome-returns-extra since Chrome 116
+     * @returns Returns a Promise which resolves with the set of notification\_ids currently in the system.
      */
     export function getAll(): Promise<{[name: string]: any}>;
 
@@ -21882,6 +21991,7 @@ declare namespace chrome {
      * Retrieves whether the user has enabled notifications from this app or extension.
      *
      * @chrome-returns-extra since Chrome 116
+     * @returns Returns a Promise which resolves with the current permission level.
      */
     export function getPermissionLevel(): Promise<PermissionLevel>;
 
@@ -21967,6 +22077,7 @@ declare namespace chrome {
      * Creates a new offscreen document for the extension.
      *
      * @param parameters The parameters describing the offscreen document to create.
+     * @returns Promise that resolves when the offscreen document is created and has completed its initial page load.
      */
     export function createDocument(
 
@@ -21987,6 +22098,8 @@ declare namespace chrome {
 
     /**
      * Closes the currently-open offscreen document for the extension.
+     *
+     * @returns Promise that resolves when the offscreen document has been closed.
      */
     export function closeDocument(): Promise<void>;
 
@@ -22412,6 +22525,7 @@ declare namespace chrome {
      * Saves the content of the tab with given id as MHTML.
      *
      * @chrome-returns-extra since Chrome 116
+     * @returns Resolves when the MHTML has been generated.
      */
     export function saveAsMHTML(
 
@@ -23803,6 +23917,7 @@ declare namespace chrome {
      * Returns the ID of the renderer process for the specified tab.
      *
      * @param tabId The ID of the tab for which the renderer process ID is to be returned.
+     * @returns A callback to return the ID of the renderer process of a tab.
      */
     export function getProcessIdForTab(
 
@@ -23830,6 +23945,7 @@ declare namespace chrome {
      * Terminates the specified renderer process. Equivalent to visiting about:crash, but without changing the tab's URL.
      *
      * @param processId The ID of the process to be terminated.
+     * @returns A callback to report the status of the termination.
      */
     export function terminate(
 
@@ -23858,6 +23974,7 @@ declare namespace chrome {
      *
      * @param processIds The list of process IDs or single process ID for which to return the process information. An empty list indicates all processes are requested.
      * @param includeMemory True if detailed memory usage is required. Note, collecting memory usage information incurs extra CPU usage and should only be queried for when needed.
+     * @returns A callback called when the processes information is collected.
      */
     export function getProcessInfo(
 
@@ -24186,6 +24303,7 @@ declare namespace chrome {
      * Adds an entry to the reading list if it does not exist.
      *
      * @param entry The entry to add to the reading list.
+     * @returns Resolves once the entry has been added.
      */
     export function addEntry(
 
@@ -24208,6 +24326,7 @@ declare namespace chrome {
      * Removes an entry from the reading list if it exists.
      *
      * @param info The entry to remove from the reading list.
+     * @returns Resolves once the entry has been removed.
      */
     export function removeEntry(
 
@@ -24230,6 +24349,7 @@ declare namespace chrome {
      * Updates a reading list entry if it exists.
      *
      * @param info The entry to update.
+     * @returns Resolves once the matched entries have been updated.
      */
     export function updateEntry(
 
@@ -24252,6 +24372,7 @@ declare namespace chrome {
      * Retrieves all entries that match the `QueryInfo` properties. Properties that are not provided will not be matched.
      *
      * @param info The properties to search for.
+     * @returns Resolves once the entries have been matched.
      */
     export function query(
 
@@ -24705,7 +24826,7 @@ declare namespace chrome {
          */
         response?: any,
       ) => void,
-    ) => boolean | undefined>;
+    ) => (boolean | Promise<any>) | undefined>;
 
     /**
      * Fired when a message is sent from a user script associated with the same extension.
@@ -25382,6 +25503,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 90
      * @param injection The details of the script which to inject.
+     * @returns Returns a Promise which resolves upon completion of the injection. The resulting array contains the result of execution for each frame where the injection succeeded.
      */
     export function executeScript(
 
@@ -25407,6 +25529,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 90
      * @param injection The details of the styles to insert.
+     * @returns Returns a Promise which resolves upon completion of the insertion.
      */
     export function insertCSS(
 
@@ -25429,6 +25552,7 @@ declare namespace chrome {
      * Removes a CSS stylesheet that was previously inserted by this extension from a target context.
      *
      * @param injection The details of the styles to remove. Note that the `css`, `files`, and `origin` properties must exactly match the stylesheet inserted through {@link insertCSS}. Attempting to remove a non-existent stylesheet is a no-op.
+     * @returns Returns a Promise which resolves upon the completion of the removal.
      * @since Chrome 90
      */
     export function removeCSS(
@@ -25453,6 +25577,7 @@ declare namespace chrome {
      * Registers one or more content scripts for this extension.
      *
      * @param scripts Contains a list of scripts to be registered. If there are errors during script parsing/file validation, or if the IDs specified already exist, then no scripts are registered.
+     * @returns Returns a Promise which resolves once scripts have been fully registered or rejects if an error has occurred.
      * @since Chrome 96
      */
     export function registerContentScripts(
@@ -25503,6 +25628,7 @@ declare namespace chrome {
      * Unregisters content scripts for this extension.
      *
      * @param filter If specified, only unregisters dynamic content scripts which match the filter. Otherwise, all of the extension's dynamic content scripts are unregistered.
+     * @returns Returns a Promise which resolves once scripts have been unregistered or rejects if an error has occurred.
      * @since Chrome 96
      */
     export function unregisterContentScripts(
@@ -25527,6 +25653,7 @@ declare namespace chrome {
      * Updates one or more content scripts for this extension.
      *
      * @param scripts Contains a list of scripts to be updated. A property is only updated for the existing script if it is specified in this object. If there are errors during script parsing/file validation, or if the IDs specified do not correspond to a fully registered script, then no scripts are updated.
+     * @returns Returns a Promise which resolves once scripts have been updated or rejects if an error has occurred.
      * @since Chrome 96
      */
     export function updateContentScripts(
@@ -26528,7 +26655,7 @@ declare namespace chrome {
     /**
      * Fired when the extension's side panel is closed.
      *
-     * @since Pending
+     * @since Chrome 144
      */
     export const onClosed: events.Event<(
       info: PanelClosedInfo,
@@ -26538,6 +26665,7 @@ declare namespace chrome {
      * Configures the side panel.
      *
      * @param options The configuration options to apply to the panel.
+     * @returns Returns a Promise which resolves when the options have been set.
      */
     export function setOptions(
 
@@ -26560,6 +26688,7 @@ declare namespace chrome {
      * Returns the active panel configuration.
      *
      * @param options Specifies the context to return the configuration for.
+     * @returns Returns a Promise which resolves with the active panel configuration.
      */
     export function getOptions(
 
@@ -26584,6 +26713,7 @@ declare namespace chrome {
      * Configures the extension's side panel behavior. This is an upsert operation.
      *
      * @param behavior The new behavior to be set.
+     * @returns Returns a Promise which resolves when the new behavior has been set.
      */
     export function setPanelBehavior(
 
@@ -26604,6 +26734,8 @@ declare namespace chrome {
 
     /**
      * Returns the extension's current side panel behavior.
+     *
+     * @returns Returns a Promise which resolves with the extension's side panel behavior.
      */
     export function getPanelBehavior(): Promise<PanelBehavior>;
 
@@ -26621,6 +26753,7 @@ declare namespace chrome {
      * Opens the side panel for the extension. This may only be called in response to a user action.
      *
      * @param options Specifies the context in which to open the side panel.
+     * @returns Returns a Promise which resolves when the side panel has been opened.
      * @since Chrome 116
      */
     export function open(
@@ -26644,6 +26777,7 @@ declare namespace chrome {
     /**
      * Returns the side panel's current layout.
      *
+     * @returns Returns a Promise which resolves with a {@link PanelLayout}.
      * @since Chrome 140
      */
     export function getLayout(): Promise<PanelLayout>;
@@ -28718,6 +28852,7 @@ declare namespace chrome {
        *
        * @chrome-returns-extra since Chrome 95
        * @param keys A single key to get, list of keys to get, or a dictionary specifying default values (see description of the object). An empty list or object will return an empty result object. Pass in `null` to get the entire contents of storage.
+       * @returns Promise that resolves with an object containing a key-value map for the requested items, or rejects on failure.
        */
       get(
 
@@ -28744,6 +28879,7 @@ declare namespace chrome {
       /**
        * Gets all keys from storage.
        *
+       * @returns Promise that resolves with storage keys, or rejects on failure.
        * @since Chrome 130
        */
       getKeys(): Promise<string[]>;
@@ -28768,6 +28904,7 @@ declare namespace chrome {
        *
        * @chrome-returns-extra since Chrome 95
        * @param keys A single key or list of keys to get the total usage for. An empty list will return 0. Pass in `null` to get the total usage of all of storage.
+       * @returns Promise that resolves with the amount of space being used by storage, or rejects on failure.
        */
       getBytesInUse(
 
@@ -28800,6 +28937,7 @@ declare namespace chrome {
       An object which gives each key/value pair to update storage with. Any other key/value pairs in storage will not be affected.
 
       Primitive values such as numbers will serialize as expected. Values with a `typeof` `"object"` and `"function"` will typically serialize to `{}`, with the exception of `Array` (serializes as expected), `Date`, and `Regex` (serialize using their `String` representation).
+       * @returns Promise that resolves on success, or rejects on failure.
        */
       set(
 
@@ -28827,6 +28965,7 @@ declare namespace chrome {
        *
        * @chrome-returns-extra since Chrome 95
        * @param keys A single key or a list of keys for items to remove.
+       * @returns Promise that resolves on success, or rejects on failure.
        */
       remove(
 
@@ -28849,6 +28988,7 @@ declare namespace chrome {
        * Removes all items from storage.
        *
        * @chrome-returns-extra since Chrome 95
+       * @returns Promise that resolves on success, or rejects on failure.
        */
       clear(): Promise<void>;
 
@@ -28863,6 +29003,7 @@ declare namespace chrome {
       /**
        * Sets the desired access level for the storage area. By default, `session` storage is restricted to trusted contexts (extension pages and service workers), while `managed`, `local`, and `sync` storage allow access from both trusted and untrusted contexts.
        *
+       * @returns Promise that resolves on success, or rejects on failure.
        * @since Chrome 102
        */
       setAccessLevel(
@@ -29774,6 +29915,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 91
      * @param flags Options affecting how the information is returned.
+     * @returns Promise that resolves with the results.
      */
     export function getInfo(
 
@@ -29804,6 +29946,7 @@ declare namespace chrome {
      * Requests the layout info for all displays. NOTE: This is only available to ChromeOS Kiosk apps and Web UI.
      *
      * @chrome-returns-extra since Chrome 91
+     * @returns Promise that resolves with the results.
      * @since Chrome 53
      */
     export function getDisplayLayout(): Promise<DisplayLayout[]>;
@@ -29826,6 +29969,7 @@ declare namespace chrome {
      * @chrome-returns-extra since Chrome 91
      * @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`.
+     * @returns Promise that resolves when the function finishes.
      */
     export function setDisplayProperties(
 
@@ -29854,6 +29998,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 91
      * @param layouts The layout information, required for all displays except the primary display.
+     * @returns Promise that resolves when the function finishes.
      * @since Chrome 53
      */
     export function setDisplayLayout(
@@ -29937,6 +30082,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 91
      * @param id The display's unique identifier.
+     * @returns Promise that resolves to inform the caller that the touch calibration has ended. The boolean value informs if the calibration was a success or not.
      * @since Chrome 57
      */
     export function showNativeTouchCalibration(
@@ -30000,6 +30146,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 91
      * @param info The information of the mirror mode that should be applied to the display mode.
+     * @returns Promise that resolves when the function finishes.
      * @since Chrome 65
      */
     export function setMirrorMode(
@@ -30267,6 +30414,7 @@ declare namespace chrome {
      * Adds a new log record.
      *
      * @param options The logging options.
+     * @returns Returns a Promise which resolves once the log has been added.
      */
     export function add(
 
@@ -30374,6 +30522,7 @@ declare namespace chrome {
      * Returns a list of tabs that have requested capture or are being captured, i.e. status != stopped and status != error. This allows extensions to inform the user that there is an existing tab capture that would prevent a new tab capture from succeeding (or to prevent redundant requests for the same tab).
      *
      * @chrome-returns-extra since Chrome 116
+     * @returns Returns a Promise which resolves with CaptureInfo\[\] for captured tabs.
      */
     export function getCapturedTabs(): Promise<CaptureInfo[]>;
 
@@ -30391,6 +30540,7 @@ declare namespace chrome {
      * Creates a stream ID to capture the target tab. Similar to chrome.tabCapture.capture() method, but returns a media stream ID, instead of a media stream, to the consumer tab.
      *
      * @chrome-returns-extra since Chrome 116
+     * @returns Returns a Promise which resolves with the result. If successful, the result is an opaque string that can be passed to the `getUserMedia()` API to generate a media stream that corresponds to the target tab. The created `streamId` can only be used once and expires after a few seconds if it is not used.
      * @since Chrome 71
      */
     export function getMediaStreamId(
@@ -33071,6 +33221,7 @@ declare namespace chrome {
      * @chrome-returns-extra since Chrome 101
      * @param utterance The text to speak, either plain text or a complete, well-formed SSML document. Speech engines that do not support SSML will strip away the tags and speak the text. The maximum length of the text is 32,768 characters.
      * @param options The speech options.
+     * @returns Resolves right away, before speech finishes. If an error occurs, the promise will be rejected. Use options.onEvent to get more detailed feedback.
      */
     export function speak(
 
@@ -34785,6 +34936,7 @@ declare namespace chrome {
      * Registers one or more user scripts for this extension.
      *
      * @param scripts Contains a list of user scripts to be registered.
+     * @returns Promise that resolves once scripts have been fully registered. The promise will be rejected if an error occurs.
      */
     export function register(
 
@@ -34807,6 +34959,7 @@ declare namespace chrome {
      * Returns all dynamically-registered user scripts for this extension.
      *
      * @param filter If specified, this method returns only the user scripts that match it.
+     * @returns Promise that resolves with the registered scripts. The promise will be rejected if an error occurs.
      */
     export function getScripts(
 
@@ -34831,6 +34984,7 @@ declare namespace chrome {
      * Unregisters all dynamically-registered user scripts for this extension.
      *
      * @param filter If specified, this method unregisters only the user scripts that match it.
+     * @returns Promise that resolves once scripts have been fully unregistered. The promise will be rejected if an error occurs.
      */
     export function unregister(
 
@@ -34853,6 +35007,7 @@ declare namespace chrome {
      * Updates one or more user scripts for this extension.
      *
      * @param scripts Contains a list of user scripts to be updated. A property is only updated for the existing script if it is specified in this object. If there are errors during script parsing/file validation, or if the IDs specified do not correspond to a fully registered script, then no scripts are updated.
+     * @returns Promise that resolves once scripts have been fully updated. The promise will be rejected if an error occurs.
      */
     export function update(
 
@@ -34899,6 +35054,7 @@ declare namespace chrome {
      * Configures the `` `USER_SCRIPT` `` execution environment.
      *
      * @param properties Contains the user script world configuration.
+     * @returns Promise that resolves once the world has been configured.
      */
     export function configureWorld(
 
@@ -34920,6 +35076,7 @@ declare namespace chrome {
     /**
      * Retrieves all registered world configurations.
      *
+     * @returns Promise that resolves with the registered world configurations.
      * @since Chrome 133
      */
     export function getWorldConfigurations(): Promise<WorldProperties[]>;
@@ -34940,6 +35097,7 @@ declare namespace chrome {
      * Resets the configuration for a user script world. Any scripts that inject into the world with the specified ID will use the default world configuration.
      *
      * @param worldId The ID of the user script world to reset. If omitted, resets the default world's configuration.
+     * @returns Promise that resolves when the configuration is reset.
      * @since Chrome 133
      */
     export function resetWorldConfiguration(
@@ -35161,6 +35319,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 96
      * @param name The name of the VPN configuration.
+     * @returns Returns a Promise which resolves when the configuration is created or rejects if there is an error.
      */
     export function createConfig(
 
@@ -35189,6 +35348,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 96
      * @param id ID of the VPN configuration to destroy.
+     * @returns Returns a Promise which resolves when the configuration is destroyed or rejects if there is an error.
      */
     export function destroyConfig(
 
@@ -35212,6 +35372,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 96
      * @param parameters The parameters for the VPN session.
+     * @returns Returns a Promise which resolves when the parameters are set or rejects if there is an error.
      */
     export function setParameters(
 
@@ -35235,6 +35396,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 96
      * @param data The IP packet to be sent to the platform.
+     * @returns Returns a Promise which resolves when the packet is sent or rejects if there is an error.
      */
     export function sendPacket(
 
@@ -35258,6 +35420,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 96
      * @param state The VPN session state of the VPN client.
+     * @returns Returns a Promise which resolves when the notification is complete or rejects if there is an error.
      */
     export function notifyConnectionStateChanged(
 
@@ -36792,7 +36955,7 @@ declare namespace chrome {
     }
 
     /**
-     * @since Pending
+     * @since Chrome 144
      */
     export interface SecurityInfo {
 
@@ -37232,7 +37395,7 @@ declare namespace chrome {
           /**
            * Information about the TLS/QUIC connection used for the underlying connection. Only provided if `securityInfo` is specified in the `extraInfoSpec` parameter.
            *
-           * @since Pending
+           * @since Chrome 144
            */
           securityInfo?: SecurityInfo,
         },