chrome-types 0.1.403 → 0.1.405

package/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright 2025 Google LLC
+ * Copyright 2026 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 Wed Dec 24 2025 22:33:46 GMT+0000 (Coordinated Universal Time)
-// Built at 456fefca54e809142055dbd8348d8d51eaaef2e8
+// Generated on Tue Jan 06 2026 22:34:25 GMT+0000 (Coordinated Universal Time)
+// Built at 6e48d4846be29f4a9aaed3eb462a776dde83c792
 
 // Includes MV3+ APIs only.
 
@@ -876,7 +876,7 @@ declare namespace chrome {
      *
      * @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`.
-     * @param callback Invoked when the alarm has been created.
+     * @param callback Promise that resolves when the alarm has been created.
      */
     export function create(
 
@@ -898,7 +898,7 @@ declare namespace chrome {
      * To help you debug your app or extension, when you've loaded it unpacked, there's no limit to how often the alarm can fire.
      *
      * @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`.
-     * @param callback Invoked when the alarm has been created.
+     * @param callback Promise that resolves when the alarm has been created.
      */
     export function create(
 
@@ -1242,7 +1242,7 @@ declare namespace chrome {
      * Gets the system-wide mute state for the specified stream type.
      *
      * @param streamType Stream type for which mute state should be fetched.
-     * @param callback Callback reporting whether mute is set or not for specified stream type.
+     * @param callback Promise that resolves with a boolean indicating whether mute is set or not for specified stream type.
      */
     export function getMute(
 
@@ -2617,7 +2617,7 @@ declare namespace chrome {
      * Requests the PIN from the user. Only one ongoing request at a time is allowed. The requests issued while another flow is ongoing are rejected. It's the extension's responsibility to try again later if another flow is in progress.
      *
      * @param details Contains the details about the requested dialog.
-     * @param callback Is called when the dialog is resolved with the user input, or when the dialog request finishes unsuccessfully (e.g. the dialog was canceled by the user or was not allowed to be shown).
+     * @param callback 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(
@@ -2645,7 +2645,7 @@ declare namespace chrome {
      * Stops the pin request started by the {@link requestPin} function.
      *
      * @param details Contains the details about the reason for stopping the request flow.
-     * @param callback To be used by Chrome to send to the extension the status from their request to close PIN dialog for user.
+     * @param callback Returns a Promise which resolves when the request to close the PIN dialog is complete.
      * @since Chrome 57
      */
     export function stopPinRequest(
@@ -2675,7 +2675,7 @@ declare namespace chrome {
      * The extension should call this function after initialization and on every change in the set of currently available certificates. The extension should also call this function in response to {@link onCertificatesUpdateRequested} every time this event is received.
      *
      * @param details The certificates to set. Invalid certificates will be ignored.
-     * @param callback Called upon completion.
+     * @param callback Returns a Promise which resolves upon completion.
      * @since Chrome 86
      */
     export function setCertificates(
@@ -5566,7 +5566,7 @@ declare namespace chrome {
      * *   Static rules specified as part of the extension package can not be removed using this function.
      * *   {@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}.
      *
-     * @param callback Called once the update is complete or has failed. In case of an error, {@link runtime.lastError} will be set 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.
+     * @param callback 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(
 
@@ -5596,7 +5596,7 @@ declare namespace chrome {
      * Returns the current set of dynamic rules for the extension. Callers can optionally filter the list of fetched rules by specifying a `filter`.
      *
      * @param filter An object to filter the list of fetched rules.
-     * @param callback Called with the set of dynamic rules. An error might be raised in case of transient internal errors.
+     * @param callback Promise that resolves with the set of dynamic rules. The Promise may be rejected in case of transient internal errors.
      */
     export function getDynamicRules(
 
@@ -5632,7 +5632,7 @@ declare namespace chrome {
      * *   These rules are not persisted across sessions and are backed in memory.
      * *   {@link MAX_NUMBER_OF_SESSION_RULES} is the maximum number of session rules an extension can add.
      *
-     * @param callback Called once the update is complete or has failed. In case of an error, {@link runtime.lastError} will be set 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.
+     * @param callback 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(
@@ -5661,7 +5661,7 @@ declare namespace chrome {
      * Returns the current set of session scoped rules for the extension. Callers can optionally filter the list of fetched rules by specifying a `filter`.
      *
      * @param filter An object to filter the list of fetched rules.
-     * @param callback Called with the set of session scoped rules.
+     * @param callback Promise that resolves with the set of session scoped rules.
      * @since Chrome 90
      */
     export function getSessionRules(
@@ -5694,7 +5694,7 @@ declare namespace chrome {
      * Updates the set of enabled static rulesets for the extension. The rulesets with IDs listed in `options.disableRulesetIds` are first removed, and then the rulesets listed in `options.enableRulesetIds` are added.
      * 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.
      *
-     * @param callback Called once the update is complete. In case of an error, {@link runtime.lastError} will be set and no change will be made to set of enabled rulesets. This can happen for multiple reasons, such as invalid ruleset IDs, rule count limit exceeded, or internal errors.
+     * @param callback 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(
 
@@ -5716,7 +5716,7 @@ declare namespace chrome {
     /**
      * Returns the ids for the current set of enabled static rulesets.
      *
-     * @param callback Called with a list of ids, where each id corresponds to an enabled static {@link Ruleset}.
+     * @param callback Promise that resolves with a list of ids, where each id corresponds to an enabled static {@link Ruleset}.
      */
     export function getEnabledRulesets(
 
@@ -5738,7 +5738,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.
      *
-     * @param callback Called once the update is complete. In case of an error, {@link runtime.lastError} will be set and no change will be made to the enabled static rules.
+     * @param callback 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(
@@ -5763,7 +5763,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.
-     * @param callback Called with a list of ids that correspond to the disabled rules in that ruleset.
+     * @param callback Promise that resolves with a list of ids that correspond to the disabled rules in that ruleset.
      * @since Chrome 111
      */
     export function getDisabledRuleIds(
@@ -5790,7 +5790,7 @@ declare namespace chrome {
      * Returns all rules matched for the extension. Callers can optionally filter the list of matched rules by specifying a `filter`. This method is only available to extensions with the `"declarativeNetRequestFeedback"` permission or having the `"activeTab"` permission granted for the `tabId` specified in `filter`. Note: Rules not associated with an active document that were matched more than five minutes ago will not be returned.
      *
      * @param filter An object to filter the list of matched rules.
-     * @param callback Called once the list of matched rules has been fetched. In case of an error, {@link runtime.lastError} will be set and no rules will be returned. This can happen for multiple reasons, such as insufficient permissions, or exceeding the quota.
+     * @param callback 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(
 
@@ -5843,7 +5843,7 @@ declare namespace chrome {
      * Checks if the given regular expression will be supported as a `regexFilter` rule condition.
      *
      * @param regexOptions The regular expression to check.
-     * @param callback Called with details consisting of whether the regular expression is supported and the reason if not.
+     * @param callback Promise that resolves with details consisting of whether the regular expression is supported and the reason if not.
      * @since Chrome 87
      */
     export function isRegexSupported(
@@ -5888,7 +5888,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.
      *
-     * @param callback Called with the details of matched rules.
+     * @param callback Promise that resolves with the details of matched rules.
      * @since Chrome 103
      */
     export function testMatchOutcome(
@@ -6725,7 +6725,7 @@ declare namespace chrome {
      * Resolves the given hostname or IP address literal.
      *
      * @param hostname The hostname to resolve.
-     * @param callback Called when the resolution operation completes.
+     * @param callback Promise that resolves when the resolution operation completes.
      */
     export function resolve(
 
@@ -7256,7 +7256,7 @@ declare namespace chrome {
      * Performs a document scan and returns a Promise that resolves with a {@link ScanResults} object. If a callback is passed to this function, the returned data is passed to it instead.
      *
      * @param options An object containing scan parameters.
-     * @param callback Called with the result and data from the scan.
+     * @param callback Returns a Promise which resolves with the scan results.
      */
     export function scan(
 
@@ -7282,7 +7282,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.
-     * @param callback Called with the result and list of scanners.
+     * @param callback Returns a Promise which resolves with the result and list of scanners.
      * @since Chrome 125
      */
     export function getScannerList(
@@ -7309,7 +7309,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}.
-     * @param callback Called with the result.
+     * @param callback Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function openScanner(
@@ -7336,7 +7336,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}.
-     * @param callback Called with the result.
+     * @param callback Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function getOptionGroups(
@@ -7363,7 +7363,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}.
-     * @param callback Called with the result.
+     * @param callback Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function closeScanner(
@@ -7394,7 +7394,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.
-     * @param callback Called with the result.
+     * @param callback Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function setOptions(
@@ -7427,7 +7427,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`.
-     * @param callback Called with the result.
+     * @param callback Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function startScan(
@@ -7456,7 +7456,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}.
-     * @param callback Called with the result.
+     * @param callback Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function cancelScan(
@@ -7491,7 +7491,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}.
-     * @param callback Called with the result.
+     * @param callback Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function readScanData(
@@ -8059,7 +8059,7 @@ declare namespace chrome {
      * Download a URL. If the URL uses the HTTP\[S\] protocol, then the request will include all cookies currently set for its hostname. If both `filename` and `saveAs` are specified, then the Save As dialog will be displayed, pre-populated with the specified `filename`. If the download started successfully, `callback` will be called with the new {@link DownloadItem}'s `downloadId`. If there was an error starting the download, then `callback` will be called with `downloadId=undefined` and {@link runtime.lastError} will contain a descriptive string. The error strings are not guaranteed to remain backwards compatible between releases. Extensions must not parse it.
      *
      * @param options What to download and how.
-     * @param callback Called with the id of the new {@link DownloadItem}.
+     * @param callback Returns a Promise which resolves with the id of the new {@link DownloadItem}.
      */
     export function download(
 
@@ -8107,7 +8107,7 @@ declare namespace chrome {
      * Pause the download. If the request was successful the download is in a paused state. Otherwise {@link runtime.lastError} contains an error message. The request will fail if the download is not active.
      *
      * @param downloadId The id of the download to pause.
-     * @param callback Called when the pause request is completed.
+     * @param callback Returns a Promise which resolves when the pause request is completed.
      */
     export function pause(
 
@@ -8131,7 +8131,7 @@ declare namespace chrome {
      * Resume a paused download. If the request was successful the download is in progress and unpaused. Otherwise {@link runtime.lastError} contains an error message. The request will fail if the download is not active.
      *
      * @param downloadId The id of the download to resume.
-     * @param callback Called when the resume request is completed.
+     * @param callback Returns a Promise which resolves when the resume request is completed.
      */
     export function resume(
 
@@ -8155,7 +8155,7 @@ declare namespace chrome {
      * Cancel a download. When `callback` is run, the download is cancelled, completed, interrupted or doesn't exist anymore.
      *
      * @param downloadId The id of the download to cancel.
-     * @param callback Called when the cancel request is completed.
+     * @param callback Returns a Promise which resolves when the cancel request is completed.
      */
     export function cancel(
 
@@ -8181,7 +8181,7 @@ declare namespace chrome {
      * Retrieve an icon for the specified download. For new downloads, file icons are available after the {@link onCreated} event has been received. The image returned by this function while a download is in progress may be different from the image returned after the download is complete. Icon retrieval is done by querying the underlying operating system or toolkit depending on the platform. The icon that is returned will therefore depend on a number of factors including state of the download, platform, registered file types and visual theme. If a file icon cannot be determined, {@link runtime.lastError} will contain an error message.
      *
      * @param downloadId The identifier for the download.
-     * @param callback A URL to an image that represents the download.
+     * @param callback Returns a Promise which resolves with a URL to an image that represents the download.
      */
     export function getFileIcon(
 
@@ -8292,7 +8292,7 @@ declare namespace chrome {
      * Prompt the user to accept a dangerous download. Can only be called from a visible context (tab, window, or page/browser action popup). Does not automatically accept dangerous downloads. If the download is accepted, then an {@link onChanged} event will fire, otherwise nothing will happen. When all the data is fetched into a temporary file and either the download is not dangerous or the danger has been accepted, then the temporary file is renamed to the target filename, the `state` changes to 'complete', and {@link onChanged} fires.
      *
      * @param downloadId The identifier for the {@link DownloadItem}.
-     * @param callback Called when the danger prompt dialog closes.
+     * @param callback Returns a Promise which resolves when the danger prompt dialog closes.
      */
     export function acceptDanger(
 
@@ -8327,7 +8327,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.
-     * @param callback Called when the UI update is completed.
+     * @param callback Returns a Promise which resolves when the UI update is completed.
      * @since Chrome 105
      */
     export function setUiOptions(
@@ -8358,7 +8358,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.
      *
-     * @param callback Called with the device identifier of the directory API when received.
+     * @param callback Returns a Promise which resolves with the device identifier of the directory API.
      */
     export function getDirectoryDeviceId(
 
@@ -8378,7 +8378,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.
      *
-     * @param callback Called with the serial number of the device.
+     * @param callback Returns a Promise which resolves with the serial number of the device.
      * @since Chrome 66
      */
     export function getDeviceSerialNumber(
@@ -8399,7 +8399,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.
      *
-     * @param callback Called with the Asset ID of the device.
+     * @param callback Returns a Promise which resolves with the Asset ID of the device.
      * @since Chrome 66
      */
     export function getDeviceAssetId(
@@ -8420,7 +8420,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.
      *
-     * @param callback Called with the Annotated Location of the device.
+     * @param callback Returns a Promise which resolves with the Annotated Location of the device.
      * @since Chrome 66
      */
     export function getDeviceAnnotatedLocation(
@@ -8441,7 +8441,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.
      *
-     * @param callback Called with hostname of the device.
+     * @param callback Returns a Promise which resolves with the hostname of the device.
      * @since Chrome 82
      */
     export function getDeviceHostname(
@@ -8478,7 +8478,7 @@ declare namespace chrome {
     /**
      * Obtains the manufacturer and model for the hardware platform and, if the extension is authorized, returns it via `callback`.
      *
-     * @param callback Called with the hardware platform info.
+     * @param callback Returns a Promise which resolves with the hardware platform info.
      */
     export function getHardwarePlatformInfo(
 
@@ -8520,7 +8520,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}.
-     * @param callback Called when the input method is changed or if there is an error.
+     * @param callback Returns a Promise which resolves when the input method is changed, or rejects if there is an error.
      */
     export function setCurrentInputMethod(
 
@@ -8592,7 +8592,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.
      *
-     * @param callback Called with the device's default network's {@link NetworkDetails}.
+     * @param callback Returns a Promise which resolves with the device's default network's {@link NetworkDetails}.
      */
     export function getNetworkDetails(
 
@@ -8724,7 +8724,7 @@ declare namespace chrome {
      * Returns the list of all client certificates available from the given token. Can be used to check for the existence and expiration of client certificates that are usable for a certain authentication.
      *
      * @param tokenId The id of a Token returned by `getTokens`.
-     * @param callback Called back with the list of the available certificates.
+     * @param callback Returns a Promise which resolves with the list of the available certificates.
      */
     export function getCertificates(
 
@@ -8757,7 +8757,7 @@ declare namespace chrome {
      *
      * @param tokenId The id of a Token returned by `getTokens`.
      * @param certificate The DER encoding of a X.509 certificate.
-     * @param callback Called back when this operation is finished.
+     * @param callback Returns a Promise which resolves when this operation is finished.
      */
     export function importCertificate(
 
@@ -8787,7 +8787,7 @@ declare namespace chrome {
      *
      * @param tokenId The id of a Token returned by `getTokens`.
      * @param certificate The DER encoding of a X.509 certificate.
-     * @param callback Called back when this operation is finished.
+     * @param callback Returns a Promise which resolves when this operation is finished.
      */
     export function removeCertificate(
 
@@ -8822,7 +8822,7 @@ declare namespace chrome {
      * This function is highly restricted and will fail if the current device is not managed, the current user is not managed, or if this operation has not explicitly been enabled for the caller by enterprise device policy. The challenged key does not reside in the `"system"` or `"user"` token and is not accessible by any other API.
      *
      * @param options Object containing the fields defined in {@link ChallengeKeyOptions}.
-     * @param callback Called back with the challenge response.
+     * @param callback Returns a Promise which resolves with the challenge response.
      * @since Chrome 110
      */
     export function challengeKey(
@@ -8862,7 +8862,7 @@ declare namespace chrome {
      *
      * @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.
-     * @param callback Called back with the challenge response.
+     * @param callback Returns a Promise which resolves with the challenge response.
      * @deprecated Use {@link challengeKey} instead.
      * @since Chrome 50
      * @chrome-deprecated-since Chrome 110
@@ -8906,7 +8906,7 @@ declare namespace chrome {
      *
      * @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.
-     * @param callback Called back with the challenge response.
+     * @param callback Returns a Promise which resolves with the challenge response.
      * @deprecated Use {@link challengeKey} instead.
      * @since Chrome 50
      * @chrome-deprecated-since Chrome 110
@@ -12380,7 +12380,7 @@ declare namespace chrome {
      * Note: When called with a callback, instead of returning an object this function will return the two properties as separate arguments passed to the callback.
      *
      * @param details Token options.
-     * @param callback Called with an OAuth2 access token as specified by the manifest, or undefined 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.
+     * @param callback 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(
 
@@ -12420,7 +12420,7 @@ declare namespace chrome {
      * This API is different from identity.getAccounts in two ways. The information returned is available offline, and it only applies to the primary account for the profile.
      *
      * @param details Profile options.
-     * @param callback Called with the `ProfileUserInfo` of the primary Chrome account, of an empty `ProfileUserInfo` if the account with given `details` doesn't exist.
+     * @param callback 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(
 
@@ -12453,7 +12453,7 @@ declare namespace chrome {
      * If an access token is discovered to be invalid, it should be passed to removeCachedAuthToken to remove it from the cache. The app may then retrieve a fresh token with `getAuthToken`.
      *
      * @param details Token information.
-     * @param callback Called when the token has been removed from the cache.
+     * @param callback Returns a Promise which resolves when the token has been removed from the cache.
      */
     export function removeCachedAuthToken(
 
@@ -12481,7 +12481,7 @@ declare namespace chrome {
      * *   Removes user's account preferences
      * *   De-authorizes the user from all auth flows
      *
-     * @param callback Called when the state has been cleared.
+     * @param callback Returns a Promise which resolves when the state has been cleared.
      * @since Chrome 87
      */
     export function clearAllCachedAuthTokens(
@@ -12512,7 +12512,7 @@ declare namespace chrome {
      * For a good user experience it is important interactive auth flows are initiated by UI in your app explaining what the authorization is for. Failing to do this will cause your users to get authorization requests with no context. In particular, do not launch an interactive auth flow when your app is first launched.
      *
      * @param details WebAuth flow options.
-     * @param callback Called with the URL redirected back to your application.
+     * @param callback Returns a Promise which resolves with the URL redirected back to your application.
      */
     export function launchWebAuthFlow(
 
@@ -14989,11 +14989,7 @@ declare namespace chrome {
 
     The `notificationId` parameter is required before Chrome 42.
      * @param options Contents of the notification.
-     * @param callback
-
-    Returns the notification id (either supplied or generated) that represents the created notification.
-
-    The callback is required before Chrome 42.
+     * @param callback Returns a Promise which resolves with the notification id (either supplied or generated) that represents the created notification.
      */
     export function create(
 
@@ -15010,11 +15006,7 @@ declare namespace chrome {
      * Creates and displays a notification.
      *
      * @param options Contents of the notification.
-     * @param callback
-
-    Returns the notification id (either supplied or generated) that represents the created notification.
-
-    The callback is required before Chrome 42.
+     * @param callback Returns a Promise which resolves with the notification id (either supplied or generated) that represents the created notification.
      */
     export function create(
 
@@ -15044,11 +15036,7 @@ declare namespace chrome {
      *
      * @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.
-     * @param callback
-
-    Called to indicate whether a matching notification existed.
-
-    The callback is required before Chrome 42.
+     * @param callback Returns a Promise which resolves to indicate whether a matching notification existed.
      */
     export function update(
 
@@ -15076,11 +15064,7 @@ declare namespace chrome {
      * Clears the specified notification.
      *
      * @param notificationId The id of the notification to be cleared. This is returned by {@link notifications.create} method.
-     * @param callback
-
-    Called to indicate whether a matching notification existed.
-
-    The callback is required before Chrome 42.
+     * @param callback Returns a Promise which resolves to indicate whether a matching notification existed.
      */
     export function clear(
 
@@ -15101,7 +15085,7 @@ declare namespace chrome {
     /**
      * Retrieves all the notifications of this app or extension.
      *
-     * @param callback Returns the set of notification\_ids currently in the system.
+     * @param callback Returns a Promise which resolves with the set of notification\_ids currently in the system.
      */
     export function getAll(
 
@@ -15120,7 +15104,7 @@ declare namespace chrome {
     /**
      * Retrieves whether the user has enabled notifications from this app or extension.
      *
-     * @param callback Returns the current permission level.
+     * @param callback Returns a Promise which resolves with the current permission level.
      */
     export function getPermissionLevel(
 
@@ -15211,7 +15195,7 @@ declare namespace chrome {
      * Creates a new offscreen document for the extension.
      *
      * @param parameters The parameters describing the offscreen document to create.
-     * @param callback Invoked when the offscreen document is created and has completed its initial page load.
+     * @param callback Promise that resolves when the offscreen document is created and has completed its initial page load.
      */
     export function createDocument(
 
@@ -15228,7 +15212,7 @@ declare namespace chrome {
     /**
      * Closes the currently-open offscreen document for the extension.
      *
-     * @param callback Invoked when the offscreen document has been closed.
+     * @param callback Promise that resolves when the offscreen document has been closed.
      */
     export function closeDocument(
 
@@ -17158,7 +17142,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.
-     * @param callback Invoked once the entry has been added.
+     * @param callback Resolves once the entry has been added.
      */
     export function addEntry(
 
@@ -17181,7 +17165,7 @@ declare namespace chrome {
      * Removes an entry from the reading list if it exists.
      *
      * @param info The entry to remove from the reading list.
-     * @param callback Invoked once the entry has been removed.
+     * @param callback Resolves once the entry has been removed.
      */
     export function removeEntry(
 
@@ -17204,7 +17188,7 @@ declare namespace chrome {
      * Updates a reading list entry if it exists.
      *
      * @param info The entry to update.
-     * @param callback Invoked once the matched entries have been updated.
+     * @param callback Resolves once the matched entries have been updated.
      */
     export function updateEntry(
 
@@ -17227,7 +17211,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.
-     * @param callback Invoked once the entries have been matched.
+     * @param callback Resolves once the entries have been matched.
      */
     export function query(
 
@@ -18348,7 +18332,7 @@ declare namespace chrome {
      * Injects a script into a target context. By default, the script will be run at `document_idle`, or immediately if the page has already loaded. If the `injectImmediately` property is set, the script will inject without waiting, even if the page has not finished loading. If the script evaluates to a promise, the browser will wait for the promise to settle and return the resulting value.
      *
      * @param injection The details of the script which to inject.
-     * @param callback Invoked upon completion of the injection. The resulting array contains the result of execution for each frame where the injection succeeded.
+     * @param callback 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(
 
@@ -18374,7 +18358,7 @@ declare namespace chrome {
      * Inserts a CSS stylesheet into a target context. If multiple frames are specified, unsuccessful injections are ignored.
      *
      * @param injection The details of the styles to insert.
-     * @param callback Invoked upon completion of the insertion.
+     * @param callback Returns a Promise which resolves upon completion of the insertion.
      */
     export function insertCSS(
 
@@ -18398,7 +18382,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.
-     * @param callback A callback to be invoked upon the completion of the removal.
+     * @param callback Returns a Promise which resolves upon the completion of the removal.
      * @since Chrome 90
      */
     export function removeCSS(
@@ -18423,7 +18407,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.
-     * @param callback A callback to be invoked once scripts have been fully registered or if an error has occurred.
+     * @param callback Returns a Promise which resolves once scripts have been fully registered or rejects if an error has occurred.
      * @since Chrome 96
      */
     export function registerContentScripts(
@@ -18474,7 +18458,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.
-     * @param callback A callback to be invoked once scripts have been unregistered or if an error has occurred.
+     * @param callback Returns a Promise which resolves once scripts have been unregistered or rejects if an error has occurred.
      * @since Chrome 96
      */
     export function unregisterContentScripts(
@@ -18499,7 +18483,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.
-     * @param callback A callback to be invoked once scripts have been updated or if an error has occurred.
+     * @param callback Returns a Promise which resolves once scripts have been updated or rejects if an error has occurred.
      * @since Chrome 96
      */
     export function updateContentScripts(
@@ -18904,7 +18888,7 @@ declare namespace chrome {
      * Configures the side panel.
      *
      * @param options The configuration options to apply to the panel.
-     * @param callback Invoked when the options have been set.
+     * @param callback Returns a Promise which resolves when the options have been set.
      */
     export function setOptions(
 
@@ -18927,7 +18911,7 @@ declare namespace chrome {
      * Returns the active panel configuration.
      *
      * @param options Specifies the context to return the configuration for.
-     * @param callback Called with the active panel configuration.
+     * @param callback Returns a Promise which resolves with the active panel configuration.
      */
     export function getOptions(
 
@@ -18952,7 +18936,7 @@ declare namespace chrome {
      * Configures the extension's side panel behavior. This is an upsert operation.
      *
      * @param behavior The new behavior to be set.
-     * @param callback Called when the new behavior has been set.
+     * @param callback Returns a Promise which resolves when the new behavior has been set.
      */
     export function setPanelBehavior(
 
@@ -18969,7 +18953,7 @@ declare namespace chrome {
     /**
      * Returns the extension's current side panel behavior.
      *
-     * @param callback Called with the extension's side panel behavior.
+     * @param callback Returns a Promise which resolves with the extension's side panel behavior.
      */
     export function getPanelBehavior(
 
@@ -18993,7 +18977,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.
-     * @param callback Called when the side panel has been opened.
+     * @param callback Returns a Promise which resolves when the side panel has been opened.
      * @since Chrome 116
      */
     export function open(
@@ -19013,7 +18997,7 @@ declare namespace chrome {
     /**
      * Returns the side panel's current layout.
      *
-     * @param callback Called with a {@link PanelLayout} containing the side value.
+     * @param callback Returns a Promise which resolves with a {@link PanelLayout}.
      * @since Chrome 140
      */
     export function getLayout(
@@ -21274,7 +21258,7 @@ declare namespace chrome {
      * Requests the information for all attached display devices.
      *
      * @param flags Options affecting how the information is returned.
-     * @param callback The callback to invoke with the results.
+     * @param callback Promise that resolves with the results.
      */
     export function getInfo(
 
@@ -21299,7 +21283,7 @@ declare namespace chrome {
     /**
      * Requests the layout info for all displays. NOTE: This is only available to ChromeOS Kiosk apps and Web UI.
      *
-     * @param callback The callback to invoke with the results.
+     * @param callback Promise that resolves with the results.
      * @since Chrome 53
      */
     export function getDisplayLayout(
@@ -21328,7 +21312,7 @@ declare namespace chrome {
      *
      * @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`.
-     * @param callback Empty function called when the function finishes. To find out whether the function succeeded, {@link runtime.lastError} should be queried.
+     * @param callback Promise that resolves when the function finishes.
      */
     export function setDisplayProperties(
 
@@ -21355,7 +21339,7 @@ declare namespace chrome {
      * Set the layout for all displays. Any display not included will use the default layout. If a layout would overlap or be otherwise invalid it will be adjusted to a valid layout. After layout is resolved, an onDisplayChanged event will be triggered. NOTE: This is only available to ChromeOS Kiosk apps and Web UI.
      *
      * @param layouts The layout information, required for all displays except the primary display.
-     * @param callback Empty function called when the function finishes. To find out whether the function succeeded, {@link runtime.lastError} should be queried.
+     * @param callback Promise that resolves when the function finishes.
      * @since Chrome 53
      */
     export function setDisplayLayout(
@@ -21439,7 +21423,7 @@ declare namespace chrome {
      * Displays the native touch calibration UX for the display with `id` as display id. This will show an overlay on the screen with required instructions on how to proceed. The callback will be invoked in case of successful calibration only. If the calibration fails, this will throw an error.
      *
      * @param id The display's unique identifier.
-     * @param callback Optional callback to inform the caller that the touch calibration has ended. The argument of the callback informs if the calibration was a success or not.
+     * @param callback 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(
@@ -21503,7 +21487,7 @@ declare namespace chrome {
      * Sets the display mode to the specified mirror mode. Each call resets the state from previous calls. Calling setDisplayProperties() will fail for the mirroring destination displays. NOTE: This is only available to ChromeOS Kiosk apps and Web UI.
      *
      * @param info The information of the mirror mode that should be applied to the display mode.
-     * @param callback Empty function called when the function finishes. To find out whether the function succeeded, {@link runtime.lastError} should be queried.
+     * @param callback Promise that resolves when the function finishes.
      * @since Chrome 65
      */
     export function setMirrorMode(
@@ -21771,7 +21755,7 @@ declare namespace chrome {
      * Adds a new log record.
      *
      * @param options The logging options.
-     * @param callback A callback to invoke once the log has been added.
+     * @param callback Returns a Promise which resolves once the log has been added.
      */
     export function add(
 
@@ -21875,7 +21859,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).
      *
-     * @param callback Callback invoked with CaptureInfo\[\] for captured tabs.
+     * @param callback Returns a Promise which resolves with CaptureInfo\[\] for captured tabs.
      */
     export function getCapturedTabs(
 
@@ -21898,7 +21882,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.
      *
-     * @param callback Callback to invoke 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.
+     * @param callback 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(
@@ -24988,7 +24972,7 @@ declare namespace chrome {
      * Registers one or more user scripts for this extension.
      *
      * @param scripts Contains a list of user scripts to be registered.
-     * @param callback Called once scripts have been fully registered or if an error has ocurred.
+     * @param callback Promise that resolves once scripts have been fully registered. The promise will be rejected if an error occurs.
      */
     export function register(
 
@@ -25011,7 +24995,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.
-     * @param callback Called once scripts have been fully registered or if an error occurs.
+     * @param callback Promise that resolves with the registered scripts. The promise will be rejected if an error occurs.
      */
     export function getScripts(
 
@@ -25036,7 +25020,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.
-     * @param callback Called once scripts have been fully unregistered or if an error ocurs
+     * @param callback Promise that resolves once scripts have been fully unregistered. The promise will be rejected if an error occurs.
      */
     export function unregister(
 
@@ -25059,7 +25043,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.
-     * @param callback Called once scripts have been fully updated or if an error occurs.
+     * @param callback Promise that resolves once scripts have been fully updated. The promise will be rejected if an error occurs.
      */
     export function update(
 
@@ -25106,7 +25090,7 @@ declare namespace chrome {
      * Configures the `` `USER_SCRIPT` `` execution environment.
      *
      * @param properties Contains the user script world configuration.
-     * @param callback Called once world hase been configured.
+     * @param callback Promise that resolves once the world has been configured.
      */
     export function configureWorld(
 
@@ -25125,7 +25109,7 @@ declare namespace chrome {
     /**
      * Retrieves all registered world configurations.
      *
-     * @param callback Called with the registered world configurations.
+     * @param callback Promise that resolves with the registered world configurations.
      * @since Chrome 133
      */
     export function getWorldConfigurations(
@@ -25150,7 +25134,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.
-     * @param callback Called when the configuration is reset.
+     * @param callback Promise that resolves when the configuration is reset.
      * @since Chrome 133
      */
     export function resetWorldConfiguration(
@@ -25304,7 +25288,7 @@ declare namespace chrome {
      * Creates a new VPN configuration that persists across multiple login sessions of the user.
      *
      * @param name The name of the VPN configuration.
-     * @param callback Called when the configuration is created or if there is an error.
+     * @param callback Returns a Promise which resolves when the configuration is created or rejects if there is an error.
      */
     export function createConfig(
 
@@ -25333,7 +25317,7 @@ declare namespace chrome {
      * Destroys a VPN configuration created by the extension.
      *
      * @param id ID of the VPN configuration to destroy.
-     * @param callback Called when the configuration is destroyed or if there is an error.
+     * @param callback Returns a Promise which resolves when the configuration is destroyed or rejects if there is an error.
      */
     export function destroyConfig(
 
@@ -25357,7 +25341,7 @@ declare namespace chrome {
      * Sets the parameters for the VPN session. This should be called immediately after `"connected"` is received from the platform. This will succeed only when the VPN session is owned by the extension.
      *
      * @param parameters The parameters for the VPN session.
-     * @param callback Called when the parameters are set or if there is an error.
+     * @param callback Returns a Promise which resolves when the parameters are set or rejects if there is an error.
      */
     export function setParameters(
 
@@ -25381,7 +25365,7 @@ declare namespace chrome {
      * Sends an IP packet through the tunnel created for the VPN session. This will succeed only when the VPN session is owned by the extension.
      *
      * @param data The IP packet to be sent to the platform.
-     * @param callback Called when the packet is sent or if there is an error.
+     * @param callback Returns a Promise which resolves when the packet is sent or rejects if there is an error.
      */
     export function sendPacket(
 
@@ -25405,7 +25389,7 @@ declare namespace chrome {
      * Notifies the VPN session state to the platform. This will succeed only when the VPN session is owned by the extension.
      *
      * @param state The VPN session state of the VPN client.
-     * @param callback Called when the notification is complete or if there is an error.
+     * @param callback Returns a Promise which resolves when the notification is complete or rejects if there is an error.
      */
     export function notifyConnectionStateChanged(