chrome-types 0.1.405 → 0.1.406

package/index.d.ts

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-// Generated on Tue Jan 06 2026 22:34:25 GMT+0000 (Coordinated Universal Time)
-// Built at 6e48d4846be29f4a9aaed3eb462a776dde83c792
+// Generated on Wed Jan 07 2026 11:21:40 GMT+0000 (Coordinated Universal Time)
+// Built at 63430eaeb62bb0431b4e1b9cd67c91c51556da8e
 
 // Includes MV3+ APIs only.
 
@@ -844,6 +844,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(
 
@@ -861,6 +862,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(
 
@@ -876,7 +878,6 @@ 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 Promise that resolves when the alarm has been created.
      */
     export function create(
 
@@ -898,7 +899,6 @@ 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 Promise that resolves when the alarm has been created.
      */
     export function create(
 
@@ -1151,6 +1151,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(
 
@@ -1161,7 +1162,6 @@ declare namespace chrome {
      * Gets a list of audio devices filtered based on `filter`.
      *
      * @param filter Device properties by which to filter the list of returned audio devices. If the filter is not set or set to `{}`, returned device list will contain all available audio devices.
-     * @param callback Reports the requested list of audio devices.
      */
     export function getDevices(
 
@@ -1232,6 +1232,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(
 
@@ -1242,7 +1243,6 @@ 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 Promise that resolves with a boolean indicating whether mute is set or not for specified stream type.
      */
     export function getMute(
 
@@ -1988,6 +1988,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(
 
@@ -2000,7 +2001,6 @@ declare namespace chrome {
      * Clears various types of browsing data stored in a user's profile.
      *
      * @param dataToRemove The set of data types to remove.
-     * @param callback Resolves when deletion has completed.
      */
     export function remove(
 
@@ -2015,6 +2015,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(
 
@@ -2023,8 +2024,6 @@ declare namespace chrome {
 
     /**
      * Clears websites' appcache data.
-     *
-     * @param callback Resolves when websites' appcache data has been cleared.
      */
     export function removeAppcache(
 
@@ -2037,6 +2036,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(
 
@@ -2045,8 +2045,6 @@ declare namespace chrome {
 
     /**
      * Clears the browser's cache.
-     *
-     * @param callback Resolves when the browser's cache has been cleared.
      */
     export function removeCache(
 
@@ -2059,6 +2057,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(
@@ -2069,7 +2068,6 @@ declare namespace chrome {
     /**
      * Clears websites' cache storage data.
      *
-     * @param callback Resolves when websites' cache storage has been cleared.
      * @since Chrome 72
      */
     export function removeCacheStorage(
@@ -2083,6 +2081,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(
 
@@ -2091,8 +2090,6 @@ declare namespace chrome {
 
     /**
      * Clears the browser's cookies and server-bound certificates modified within a particular timeframe.
-     *
-     * @param callback Resolves when the browser's cookies and server-bound certificates have been cleared.
      */
     export function removeCookies(
 
@@ -2105,6 +2102,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(
 
@@ -2113,8 +2111,6 @@ declare namespace chrome {
 
     /**
      * Clears the browser's list of downloaded files (_not_ the downloaded files themselves).
-     *
-     * @param callback Resolves when the browser's list of downloaded files has been cleared.
      */
     export function removeDownloads(
 
@@ -2127,6 +2123,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(
 
@@ -2135,8 +2132,6 @@ declare namespace chrome {
 
     /**
      * Clears websites' file system data.
-     *
-     * @param callback Resolves when websites' file systems have been cleared.
      */
     export function removeFileSystems(
 
@@ -2149,6 +2144,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(
 
@@ -2157,8 +2153,6 @@ declare namespace chrome {
 
     /**
      * Clears the browser's stored form data (autofill).
-     *
-     * @param callback Resolves when the browser's form data has been cleared.
      */
     export function removeFormData(
 
@@ -2171,6 +2165,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(
 
@@ -2179,8 +2174,6 @@ declare namespace chrome {
 
     /**
      * Clears the browser's history.
-     *
-     * @param callback Resolves when the browser's history has cleared.
      */
     export function removeHistory(
 
@@ -2193,6 +2186,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(
 
@@ -2201,8 +2195,6 @@ declare namespace chrome {
 
     /**
      * Clears websites' IndexedDB data.
-     *
-     * @param callback Resolves when websites' IndexedDB data has been cleared.
      */
     export function removeIndexedDB(
 
@@ -2215,6 +2207,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(
 
@@ -2223,8 +2216,6 @@ declare namespace chrome {
 
     /**
      * Clears websites' local storage data.
-     *
-     * @param callback Resolves when websites' local storage has been cleared.
      */
     export function removeLocalStorage(
 
@@ -2237,6 +2228,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
      */
@@ -2248,7 +2240,6 @@ declare namespace chrome {
     /**
      * Clears plugins' data.
      *
-     * @param callback Resolves when plugins' data has been cleared.
      * @deprecated Support for Flash has been removed. This function has no effect.
      * @chrome-deprecated-since Chrome 88
      */
@@ -2263,6 +2254,7 @@ 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.
      */
     export function removePasswords(
@@ -2273,7 +2265,6 @@ declare namespace chrome {
     /**
      * Clears the browser's stored passwords.
      *
-     * @param callback Resolves when the browser's passwords have been cleared.
      * @deprecated Support for password deletion through extensions has been removed. This function has no effect.
      */
     export function removePasswords(
@@ -2287,6 +2278,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(
@@ -2297,7 +2289,6 @@ declare namespace chrome {
     /**
      * Clears websites' service workers.
      *
-     * @param callback Resolves when websites' service workers have been cleared.
      * @since Chrome 72
      */
     export function removeServiceWorkers(
@@ -2311,6 +2302,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(
 
@@ -2319,8 +2311,6 @@ declare namespace chrome {
 
     /**
      * Clears websites' WebSQL data.
-     *
-     * @param callback Resolves when websites' WebSQL databases have been cleared.
      */
     export function removeWebSQL(
 
@@ -2606,6 +2596,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(
@@ -2617,7 +2608,6 @@ 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 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(
@@ -2634,6 +2624,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(
@@ -2645,7 +2636,6 @@ 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 Returns a Promise which resolves when the request to close the PIN dialog is complete.
      * @since Chrome 57
      */
     export function stopPinRequest(
@@ -2662,6 +2652,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(
@@ -2675,7 +2666,6 @@ 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 Returns a Promise which resolves upon completion.
      * @since Chrome 86
      */
     export function setCertificates(
@@ -2779,13 +2769,12 @@ 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[]>;
 
     /**
      * Returns all the registered extension commands for this extension and their shortcut (if active). Before Chrome 110, this command did not return `_execute_action`.
-     *
-     * @param callback Resolves with a list of the registered commands.
      */
     export function getAll(
 
@@ -3506,6 +3495,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(
 
@@ -3560,7 +3550,6 @@ declare namespace chrome {
      *
      * @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.
-     * @param callback Resolves when the context menu has been updated.
      */
     export function update(
 
@@ -3617,6 +3606,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(
 
@@ -3627,7 +3617,6 @@ declare namespace chrome {
      * Removes a context menu item.
      *
      * @param menuItemId The ID of the context menu item to remove.
-     * @param callback Resolves when the context menu has been removed.
      */
     export function remove(
 
@@ -3640,13 +3629,12 @@ 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>;
 
     /**
      * Removes all context menu items added by this extension.
-     *
-     * @param callback Resolves when removal is complete.
      */
     export function removeAll(
 
@@ -4427,6 +4415,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(
 
@@ -4440,7 +4429,6 @@ declare namespace chrome {
      *
      * @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).
-     * @param callback 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(
 
@@ -4456,6 +4444,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(
 
@@ -4466,7 +4455,6 @@ declare namespace chrome {
      * Detaches debugger from the given target.
      *
      * @param target Debugging target from which you want to detach.
-     * @param callback 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(
 
@@ -4482,6 +4470,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(
 
@@ -4498,7 +4487,6 @@ 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.
-     * @param callback Response body. If an error occurs while posting the message, the promise will be rejected.
      */
     export function sendCommand(
 
@@ -5549,6 +5537,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(
 
@@ -5565,8 +5554,6 @@ declare namespace chrome {
      * *   These rules are persisted across browser sessions and across extension updates.
      * *   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 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(
 
@@ -5583,6 +5570,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(
 
@@ -5596,7 +5584,6 @@ 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 Promise that resolves with the set of dynamic rules. The Promise may be rejected in case of transient internal errors.
      */
     export function getDynamicRules(
 
@@ -5618,6 +5605,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(
@@ -5632,7 +5620,6 @@ 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 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(
@@ -5647,6 +5634,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(
@@ -5661,7 +5649,6 @@ 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 Promise that resolves with the set of session scoped rules.
      * @since Chrome 90
      */
     export function getSessionRules(
@@ -5681,6 +5668,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(
 
@@ -5693,8 +5681,6 @@ 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 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(
 
@@ -5710,13 +5696,12 @@ 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[]>;
 
     /**
      * Returns the ids for the current set of enabled static rulesets.
-     *
-     * @param callback Promise that resolves with a list of ids, where each id corresponds to an enabled static {@link Ruleset}.
      */
     export function getEnabledRulesets(
 
@@ -5728,6 +5713,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(
@@ -5738,7 +5724,6 @@ 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 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(
@@ -5752,6 +5737,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(
@@ -5763,7 +5749,6 @@ 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 Promise that resolves with a list of ids that correspond to the disabled rules in that ruleset.
      * @since Chrome 111
      */
     export function getDisabledRuleIds(
@@ -5780,6 +5765,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(
 
@@ -5790,7 +5776,6 @@ 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 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(
 
@@ -5832,6 +5817,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(
@@ -5843,7 +5829,6 @@ 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 Promise that resolves with details consisting of whether the regular expression is supported and the reason if not.
      * @since Chrome 87
      */
     export function isRegexSupported(
@@ -5878,6 +5863,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(
@@ -5888,7 +5874,6 @@ 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 Promise that resolves with the details of matched rules.
      * @since Chrome 103
      */
     export function testMatchOutcome(
@@ -6715,6 +6700,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(
 
@@ -6725,7 +6711,6 @@ declare namespace chrome {
      * Resolves the given hostname or IP address literal.
      *
      * @param hostname The hostname to resolve.
-     * @param callback Promise that resolves when the resolution operation completes.
      */
     export function resolve(
 
@@ -7246,6 +7231,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(
 
@@ -7256,7 +7242,6 @@ 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 Returns a Promise which resolves with the scan results.
      */
     export function scan(
 
@@ -7271,6 +7256,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(
@@ -7282,7 +7268,6 @@ 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 Returns a Promise which resolves with the result and list of scanners.
      * @since Chrome 125
      */
     export function getScannerList(
@@ -7298,6 +7283,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(
@@ -7309,7 +7295,6 @@ 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 Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function openScanner(
@@ -7325,6 +7310,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(
@@ -7336,7 +7322,6 @@ 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 Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function getOptionGroups(
@@ -7352,6 +7337,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(
@@ -7363,7 +7349,6 @@ 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 Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function closeScanner(
@@ -7380,6 +7365,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(
@@ -7394,7 +7380,6 @@ 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 Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function setOptions(
@@ -7413,6 +7398,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(
@@ -7427,7 +7413,6 @@ 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 Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function startScan(
@@ -7445,6 +7430,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(
@@ -7456,7 +7442,6 @@ 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 Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function cancelScan(
@@ -7476,6 +7461,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(
@@ -7491,7 +7477,6 @@ 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 Returns a Promise which resolves with the result.
      * @since Chrome 125
      */
     export function readScanData(
@@ -8049,6 +8034,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(
 
@@ -8059,7 +8045,6 @@ 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 Returns a Promise which resolves with the id of the new {@link DownloadItem}.
      */
     export function download(
 
@@ -8097,6 +8082,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(
 
@@ -8107,7 +8093,6 @@ 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 Returns a Promise which resolves when the pause request is completed.
      */
     export function pause(
 
@@ -8121,6 +8106,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(
 
@@ -8131,7 +8117,6 @@ 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 Returns a Promise which resolves when the resume request is completed.
      */
     export function resume(
 
@@ -8145,6 +8130,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(
 
@@ -8155,7 +8141,6 @@ 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 Returns a Promise which resolves when the cancel request is completed.
      */
     export function cancel(
 
@@ -8169,6 +8154,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(
 
@@ -8181,7 +8167,6 @@ 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 Returns a Promise which resolves with a URL to an image that represents the download.
      */
     export function getFileIcon(
 
@@ -8282,6 +8267,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(
 
@@ -8292,7 +8278,6 @@ 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 Returns a Promise which resolves when the danger prompt dialog closes.
      */
     export function acceptDanger(
 
@@ -8316,6 +8301,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(
@@ -8327,7 +8313,6 @@ 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 Returns a Promise which resolves when the UI update is completed.
      * @since Chrome 105
      */
     export function setUiOptions(
@@ -8352,13 +8337,12 @@ 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>;
 
     /**
      * 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 Returns a Promise which resolves with the device identifier of the directory API.
      */
     export function getDirectoryDeviceId(
 
@@ -8371,6 +8355,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>;
@@ -8378,7 +8363,6 @@ 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 Returns a Promise which resolves with the serial number of the device.
      * @since Chrome 66
      */
     export function getDeviceSerialNumber(
@@ -8392,6 +8376,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>;
@@ -8399,7 +8384,6 @@ 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 Returns a Promise which resolves with the Asset ID of the device.
      * @since Chrome 66
      */
     export function getDeviceAssetId(
@@ -8413,6 +8397,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>;
@@ -8420,7 +8405,6 @@ 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 Returns a Promise which resolves with the Annotated Location of the device.
      * @since Chrome 66
      */
     export function getDeviceAnnotatedLocation(
@@ -8434,6 +8418,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>;
@@ -8441,7 +8426,6 @@ 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 Returns a Promise which resolves with the hostname of the device.
      * @since Chrome 82
      */
     export function getDeviceHostname(
@@ -8472,13 +8456,12 @@ 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>;
 
     /**
      * Obtains the manufacturer and model for the hardware platform and, if the extension is authorized, returns it via `callback`.
-     *
-     * @param callback Returns a Promise which resolves with the hardware platform info.
      */
     export function getHardwarePlatformInfo(
 
@@ -8510,6 +8493,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(
 
@@ -8520,7 +8504,6 @@ 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 Returns a Promise which resolves when the input method is changed, or rejects if there is an error.
      */
     export function setCurrentInputMethod(
 
@@ -8586,13 +8569,12 @@ 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>;
 
     /**
      * 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 Returns a Promise which resolves with the device's default network's {@link NetworkDetails}.
      */
     export function getNetworkDetails(
 
@@ -8691,13 +8673,12 @@ 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[]>;
 
     /**
      * 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).
-     *
-     * @param callback Invoked by `getTokens` with the list of available Tokens.
      */
     export function getTokens(
 
@@ -8714,6 +8695,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(
 
@@ -8724,7 +8706,6 @@ 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 Returns a Promise which resolves with the list of the available certificates.
      */
     export function getCertificates(
 
@@ -8744,6 +8725,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(
 
@@ -8757,7 +8739,6 @@ 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 Returns a Promise which resolves when this operation is finished.
      */
     export function importCertificate(
 
@@ -8774,6 +8755,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(
 
@@ -8787,7 +8769,6 @@ 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 Returns a Promise which resolves when this operation is finished.
      */
     export function removeCertificate(
 
@@ -8807,6 +8788,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(
@@ -8822,7 +8804,6 @@ 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 Returns a Promise which resolves with the challenge response.
      * @since Chrome 110
      */
     export function challengeKey(
@@ -8843,6 +8824,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
@@ -8862,7 +8844,6 @@ 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 Returns a Promise which resolves with the challenge response.
      * @deprecated Use {@link challengeKey} instead.
      * @since Chrome 50
      * @chrome-deprecated-since Chrome 110
@@ -8890,6 +8871,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
@@ -8906,7 +8888,6 @@ 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 Returns a Promise which resolves with the challenge response.
      * @deprecated Use {@link challengeKey} instead.
      * @since Chrome 50
      * @chrome-deprecated-since Chrome 110
@@ -10814,6 +10795,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(
 
@@ -10826,8 +10808,6 @@ declare namespace chrome {
      * Depending on the type of the file system being mounted, the `source` option must be set appropriately.
      *
      * In case of an error, {@link runtime.lastError} will be set with a corresponding error code.
-     *
-     * @param callback A generic result callback to indicate success or failure.
      */
     export function mount(
 
@@ -10842,6 +10822,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(
 
@@ -10852,8 +10833,6 @@ declare namespace chrome {
      * Unmounts a file system with the given `fileSystemId`. It must be called after {@link onUnmountRequested} is invoked. Also, the providing extension can decide to perform unmounting if not requested (eg. in case of lost connection, or a file error).
      *
      * In case of an error, {@link runtime.lastError} will be set with a corresponding error code.
-     *
-     * @param callback A generic result callback to indicate success or failure.
      */
     export function unmount(
 
@@ -10866,13 +10845,12 @@ 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[]>;
 
     /**
      * Returns all file systems mounted by the extension.
-     *
-     * @param callback Callback to receive the result of {@link getAll} function.
      */
     export function getAll(
 
@@ -10885,6 +10863,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(
 
@@ -10893,8 +10872,6 @@ declare namespace chrome {
 
     /**
      * Returns information about a file system with the passed `fileSystemId`.
-     *
-     * @param callback Callback to receive the result of {@link get} function.
      */
     export function get(
 
@@ -10919,6 +10896,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(
@@ -10939,7 +10917,6 @@ declare namespace chrome {
      *
      * In case of an error, {@link runtime.lastError} will be set will a corresponding error code.
      *
-     * @param callback A generic result callback to indicate success or failure.
      * @since Chrome 45
      */
     export function notify(
@@ -11626,6 +11603,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(
 
@@ -11636,7 +11614,6 @@ declare namespace chrome {
      * Registers the application with FCM. The registration ID will be returned by the `callback`. If `register` is called again with the same list of `senderIds`, the same registration ID will be returned.
      *
      * @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.
-     * @param callback Resolves when registration completes.
      */
     export function register(
 
@@ -11654,13 +11631,12 @@ 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>;
 
     /**
      * Unregisters the application from FCM.
-     *
-     * @param callback Resolves after the unregistration completes. Unregistration was successful if the promise does not reject.
      */
     export function unregister(
 
@@ -11672,6 +11648,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(
 
@@ -11703,7 +11680,6 @@ declare namespace chrome {
      * Sends a message according to its contents.
      *
      * @param message A message to send to the other party via FCM.
-     * @param callback Resolves after the message is successfully queued for sending. If an error occurs, the promise will be rejected.
      */
     export function send(
 
@@ -12364,6 +12340,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(
 
@@ -12380,7 +12357,6 @@ 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 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(
 
@@ -12403,6 +12379,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(
 
@@ -12420,7 +12397,6 @@ 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 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(
 
@@ -12441,6 +12417,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(
 
@@ -12453,7 +12430,6 @@ 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 Returns a Promise which resolves when the token has been removed from the cache.
      */
     export function removeCachedAuthToken(
 
@@ -12470,6 +12446,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>;
@@ -12481,7 +12458,6 @@ declare namespace chrome {
      * *   Removes user's account preferences
      * *   De-authorizes the user from all auth flows
      *
-     * @param callback Returns a Promise which resolves when the state has been cleared.
      * @since Chrome 87
      */
     export function clearAllCachedAuthTokens(
@@ -12498,6 +12474,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(
 
@@ -12512,7 +12489,6 @@ 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 Returns a Promise which resolves with the URL redirected back to your application.
      */
     export function launchWebAuthFlow(
 
@@ -13015,6 +12991,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(
 
@@ -13070,8 +13047,6 @@ declare namespace chrome {
 
     /**
      * Set the current composition. If this extension does not own the active IME, this fails.
-     *
-     * @param callback 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(
 
@@ -13133,6 +13108,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(
 
@@ -13147,8 +13123,6 @@ declare namespace chrome {
 
     /**
      * Clear the current composition. If this extension does not own the active IME, this fails.
-     *
-     * @param callback 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(
 
@@ -13169,6 +13143,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(
 
@@ -13188,8 +13163,6 @@ declare namespace chrome {
 
     /**
      * Commits the provided text to the current input.
-     *
-     * @param callback 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(
 
@@ -13215,6 +13188,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(
 
@@ -13234,8 +13208,6 @@ 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.
-     *
-     * @param callback Resolves when the operation completes.
      */
     export function sendKeyEvents(
 
@@ -13264,6 +13236,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(
 
@@ -13330,8 +13303,6 @@ declare namespace chrome {
 
     /**
      * Sets the properties of the candidate window. This fails if the extension doesn't own the active IME
-     *
-     * @param callback Resolves when the operation completes.
      */
     export function setCandidateWindowProperties(
 
@@ -13404,6 +13375,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(
 
@@ -13465,8 +13437,6 @@ declare namespace chrome {
 
     /**
      * Sets the current candidate list. This fails if this extension doesn't own the active IME
-     *
-     * @param callback Resolves when the operation completes.
      */
     export function setCandidates(
 
@@ -13534,6 +13504,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(
 
@@ -13553,8 +13524,6 @@ 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.
-     *
-     * @param callback Resolves when the operation completes
      */
     export function setCursorPosition(
 
@@ -13580,6 +13549,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(
@@ -13601,7 +13571,6 @@ declare namespace chrome {
     /**
      * Shows/Hides an assistive window with the given properties.
      *
-     * @param callback Resolves when the operation completes.
      * @since Chrome 85
      */
     export function setAssistiveWindowProperties(
@@ -13628,6 +13597,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(
@@ -13664,7 +13634,6 @@ declare namespace chrome {
     /**
      * Highlights/Unhighlights a button in an assistive window.
      *
-     * @param callback Resolves when the operation completes. On failure, the promise will be rejected.
      * @since Chrome 86
      */
     export function setAssistiveWindowButtonHighlighted(
@@ -13724,6 +13693,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(
 
@@ -13732,8 +13702,6 @@ declare namespace chrome {
 
     /**
      * Updates the state of the MenuItems specified
-     *
-     * @param callback Resolves when the operation completes
      */
     export function updateMenuItems(
 
@@ -13746,6 +13714,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(
 
@@ -13775,8 +13744,6 @@ declare namespace chrome {
 
     /**
      * Deletes the text around the caret.
-     *
-     * @param callback Resolves when the operation completes.
      */
     export function deleteSurroundingText(
 
@@ -13837,13 +13804,12 @@ 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>;
 
     /**
      * 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.
-     *
-     * @param callback Resolves when the retrieval completes.
      */
     export function getID(
 
@@ -13859,13 +13825,12 @@ 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>;
 
     /**
      * Retrieves the time when the InstanceID has been generated. The creation time will be returned by the `callback`.
-     *
-     * @param callback Resolves when the retrieval completes.
      */
     export function getCreationTime(
 
@@ -13882,6 +13847,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 96
      * @param getTokenParams Parameters for getToken.
+     * @returns Resolves when the retrieval completes.
      */
     export function getToken(
 
@@ -13916,7 +13882,6 @@ declare namespace chrome {
      * Return a token that allows the authorized entity to access the service defined by scope.
      *
      * @param getTokenParams Parameters for getToken.
-     * @param callback Resolves when the retrieval completes.
      */
     export function getToken(
 
@@ -13959,6 +13924,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(
 
@@ -13984,7 +13950,6 @@ declare namespace chrome {
      * Revokes a granted token.
      *
      * @param deleteTokenParams Parameters for deleteToken.
-     * @param callback Resolves when the token deletion completes. The token was revoked successfully if the promise does not reject.
      */
     export function deleteToken(
 
@@ -14012,13 +13977,12 @@ 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>;
 
     /**
      * Resets the app instance identifier and revokes all tokens associated with it.
-     *
-     * @param callback Resolves when the deletion completes. The instance identifier was revoked successfully if the promise does not reject.
      */
     export function deleteID(
 
@@ -14961,6 +14925,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(
 
@@ -14974,6 +14939,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(
 
@@ -14989,7 +14955,6 @@ declare namespace chrome {
 
     The `notificationId` parameter is required before Chrome 42.
      * @param options Contents of the notification.
-     * @param callback Returns a Promise which resolves with the notification id (either supplied or generated) that represents the created notification.
      */
     export function create(
 
@@ -15006,7 +14971,6 @@ declare namespace chrome {
      * Creates and displays a notification.
      *
      * @param options Contents of the notification.
-     * @param callback Returns a Promise which resolves with the notification id (either supplied or generated) that represents the created notification.
      */
     export function create(
 
@@ -15023,6 +14987,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(
 
@@ -15036,7 +15001,6 @@ 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 Returns a Promise which resolves to indicate whether a matching notification existed.
      */
     export function update(
 
@@ -15054,6 +15018,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(
 
@@ -15064,7 +15029,6 @@ 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 Returns a Promise which resolves to indicate whether a matching notification existed.
      */
     export function clear(
 
@@ -15079,13 +15043,12 @@ 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}>;
 
     /**
      * Retrieves all the notifications of this app or extension.
-     *
-     * @param callback Returns a Promise which resolves with the set of notification\_ids currently in the system.
      */
     export function getAll(
 
@@ -15098,13 +15061,12 @@ 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>;
 
     /**
      * Retrieves whether the user has enabled notifications from this app or extension.
-     *
-     * @param callback Returns a Promise which resolves with the current permission level.
      */
     export function getPermissionLevel(
 
@@ -15185,6 +15147,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(
 
@@ -15195,7 +15158,6 @@ declare namespace chrome {
      * Creates a new offscreen document for the extension.
      *
      * @param parameters The parameters describing the offscreen document to create.
-     * @param callback Promise that resolves when the offscreen document is created and has completed its initial page load.
      */
     export function createDocument(
 
@@ -15206,13 +15168,13 @@ 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>;
 
     /**
      * Closes the currently-open offscreen document for the extension.
-     *
-     * @param callback Promise that resolves when the offscreen document has been closed.
      */
     export function closeDocument(
 
@@ -15353,6 +15315,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(
 
@@ -15367,8 +15330,6 @@ declare namespace chrome {
 
     /**
      * Saves the content of the tab with given id as MHTML.
-     *
-     * @param callback Resolves when the MHTML has been generated.
      */
     export function saveAsMHTML(
 
@@ -16746,6 +16707,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(
 
@@ -16756,7 +16718,6 @@ 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.
-     * @param callback A callback to return the ID of the renderer process of a tab.
      */
     export function getProcessIdForTab(
 
@@ -16774,6 +16735,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(
 
@@ -16784,7 +16746,6 @@ 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.
-     * @param callback A callback to report the status of the termination.
      */
     export function terminate(
 
@@ -16803,6 +16764,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(
 
@@ -16816,7 +16778,6 @@ 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.
-     * @param callback A callback called when the processes information is collected.
      */
     export function getProcessInfo(
 
@@ -17132,6 +17093,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(
 
@@ -17142,7 +17104,6 @@ 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 Resolves once the entry has been added.
      */
     export function addEntry(
 
@@ -17155,6 +17116,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(
 
@@ -17165,7 +17127,6 @@ 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 Resolves once the entry has been removed.
      */
     export function removeEntry(
 
@@ -17178,6 +17139,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(
 
@@ -17188,7 +17150,6 @@ declare namespace chrome {
      * Updates a reading list entry if it exists.
      *
      * @param info The entry to update.
-     * @param callback Resolves once the matched entries have been updated.
      */
     export function updateEntry(
 
@@ -17201,6 +17162,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(
 
@@ -17211,7 +17173,6 @@ 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 Resolves once the entries have been matched.
      */
     export function query(
 
@@ -17754,6 +17715,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 99
      * @param url URL to be opened after the extension is uninstalled. This URL must have an http: or https: scheme. Set an empty string to not open a new tab upon uninstallation.
+     * @returns Promise that resolves when the uninstall URL is set. If the given URL is invalid, the promise will be rejected.
      */
     export function setUninstallURL(
 
@@ -17764,7 +17726,6 @@ declare namespace chrome {
      * Sets the URL to be visited upon uninstallation. This may be used to clean up server-side data, do analytics, and implement surveys. Maximum 1023 characters.
      *
      * @param url URL to be opened after the extension is uninstalled. This URL must have an http: or https: scheme. Set an empty string to not open a new tab upon uninstallation.
-     * @param callback Called when the uninstall URL is set. If the given URL is invalid, {@link runtime.lastError} will be set.
      */
     export function setUninstallURL(
 
@@ -17848,6 +17809,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 99
      * @param seconds Time to wait in seconds before rebooting the device, or -1 to cancel a scheduled reboot.
+     * @returns Promise that resolves when a restart request was successfully rescheduled.
      * @since Chrome 53
      */
     export function restartAfterDelay(
@@ -17859,7 +17821,6 @@ declare namespace chrome {
      * Restart the ChromeOS device when the app runs in kiosk mode after the given seconds. If called again before the time ends, the reboot will be delayed. If called with a value of -1, the reboot will be cancelled. It's a no-op in non-kiosk mode. It's only allowed to be called repeatedly by the first extension to invoke this API.
      *
      * @param seconds Time to wait in seconds before rebooting the device, or -1 to cancel a scheduled reboot.
-     * @param callback A callback to be invoked when a restart request was successfully rescheduled.
      * @since Chrome 53
      */
     export function restartAfterDelay(
@@ -17911,6 +17872,7 @@ declare namespace chrome {
      * @chrome-returns-extra since Chrome 99
      * @param extensionId The ID of the extension to send the message to. If omitted, the message will be sent to your own extension/app. Required if sending messages from a web page for [web messaging](https://developer.chrome.com/docs/extensions/manifest/externally_connectable).
      * @param message The message to send. This message should be a JSON-ifiable object.
+     * @returns Promise support was added for extension contexts in Chrome 99. When communicating from a web page to an extension, promises are available from Chrome 118.
      */
     export function sendMessage(
 
@@ -17932,6 +17894,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 99
      * @param message The message to send. This message should be a JSON-ifiable object.
+     * @returns Promise support was added for extension contexts in Chrome 99. When communicating from a web page to an extension, promises are available from Chrome 118.
      */
     export function sendMessage(
 
@@ -17951,7 +17914,6 @@ declare namespace chrome {
      *
      * @param extensionId The ID of the extension to send the message to. If omitted, the message will be sent to your own extension/app. Required if sending messages from a web page for [web messaging](https://developer.chrome.com/docs/extensions/manifest/externally_connectable).
      * @param message The message to send. This message should be a JSON-ifiable object.
-     * @param callback Promise support was added for extension contexts in Chrome 99. When communicating from a web page to an extension, promises are available from Chrome 118.
      */
     export function sendMessage(
 
@@ -17980,7 +17942,6 @@ declare namespace chrome {
      * Sends a single message to event listeners within your extension or a different extension/app. Similar to {@link runtime.connect} but only sends a single message, with an optional response. If sending to your extension, the {@link runtime.onMessage} event will be fired in every frame of your extension (except for the sender's frame), or {@link runtime.onMessageExternal}, if a different extension. Note that extensions cannot send messages to content scripts using this method. To send messages to content scripts, use {@link tabs.sendMessage}.
      *
      * @param message The message to send. This message should be a JSON-ifiable object.
-     * @param callback Promise support was added for extension contexts in Chrome 99. When communicating from a web page to an extension, promises are available from Chrome 118.
      */
     export function sendMessage(
 
@@ -18044,13 +18005,12 @@ declare namespace chrome {
      * Returns information about the current platform.
      *
      * @chrome-returns-extra since Chrome 99
+     * @returns Promise that resolves with information about the current platform.
      */
     export function getPlatformInfo(): Promise<PlatformInfo>;
 
     /**
      * Returns information about the current platform.
-     *
-     * @param callback Called with results
      */
     export function getPlatformInfo(
 
@@ -18083,6 +18043,7 @@ declare namespace chrome {
      * Fetches information about active contexts associated with this extension
      *
      * @param filter A filter to find matching contexts. A context matches if it matches all specified fields in the filter. Any unspecified field in the filter matches all contexts.
+     * @returns Promise that resolves with the matching contexts, if any.
      * @since Chrome 116
      * @chrome-min-manifest MV3
      */
@@ -18095,7 +18056,6 @@ declare namespace chrome {
      * Fetches information about active contexts associated with this extension
      *
      * @param filter A filter to find matching contexts. A context matches if it matches all specified fields in the filter. Any unspecified field in the filter matches all contexts.
-     * @param callback Invoked with the matching contexts, if any.
      * @since Chrome 116
      * @chrome-min-manifest MV3
      */
@@ -18322,6 +18282,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(
 
@@ -18332,7 +18293,6 @@ 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 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(
 
@@ -18348,6 +18308,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(
 
@@ -18358,7 +18319,6 @@ 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 Returns a Promise which resolves upon completion of the insertion.
      */
     export function insertCSS(
 
@@ -18371,6 +18331,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(
@@ -18382,7 +18343,6 @@ 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 Returns a Promise which resolves upon the completion of the removal.
      * @since Chrome 90
      */
     export function removeCSS(
@@ -18396,6 +18356,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(
@@ -18407,7 +18368,6 @@ 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 Returns a Promise which resolves once scripts have been fully registered or rejects if an error has occurred.
      * @since Chrome 96
      */
     export function registerContentScripts(
@@ -18447,6 +18407,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(
@@ -18458,7 +18419,6 @@ 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 Returns a Promise which resolves once scripts have been unregistered or rejects if an error has occurred.
      * @since Chrome 96
      */
     export function unregisterContentScripts(
@@ -18472,6 +18432,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(
@@ -18483,7 +18444,6 @@ 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 Returns a Promise which resolves once scripts have been updated or rejects if an error has occurred.
      * @since Chrome 96
      */
     export function updateContentScripts(
@@ -18878,6 +18838,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(
 
@@ -18888,7 +18849,6 @@ declare namespace chrome {
      * Configures the side panel.
      *
      * @param options The configuration options to apply to the panel.
-     * @param callback Returns a Promise which resolves when the options have been set.
      */
     export function setOptions(
 
@@ -18901,6 +18861,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(
 
@@ -18911,7 +18872,6 @@ declare namespace chrome {
      * Returns the active panel configuration.
      *
      * @param options Specifies the context to return the configuration for.
-     * @param callback Returns a Promise which resolves with the active panel configuration.
      */
     export function getOptions(
 
@@ -18926,6 +18886,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(
 
@@ -18936,7 +18897,6 @@ 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 Returns a Promise which resolves when the new behavior has been set.
      */
     export function setPanelBehavior(
 
@@ -18947,13 +18907,13 @@ 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>;
 
     /**
      * Returns the extension's current side panel behavior.
-     *
-     * @param callback Returns a Promise which resolves with the extension's side panel behavior.
      */
     export function getPanelBehavior(
 
@@ -18966,6 +18926,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(
@@ -18977,7 +18938,6 @@ 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 Returns a Promise which resolves when the side panel has been opened.
      * @since Chrome 116
      */
     export function open(
@@ -18990,6 +18950,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>;
@@ -18997,7 +18958,6 @@ declare namespace chrome {
     /**
      * Returns the side panel's current layout.
      *
-     * @param callback Returns a Promise which resolves with a {@link PanelLayout}.
      * @since Chrome 140
      */
     export function getLayout(
@@ -19179,6 +19139,7 @@ declare namespace chrome {
      * Creates a TCP socket.
      *
      * @param properties The socket properties (optional).
+     * @returns Called when the socket has been created.
      */
     export function create(
 
@@ -19189,7 +19150,6 @@ declare namespace chrome {
      * Creates a TCP socket.
      *
      * @param properties The socket properties (optional).
-     * @param callback Called when the socket has been created.
      */
     export function create(
 
@@ -19208,6 +19168,7 @@ declare namespace chrome {
      *
      * @param socketId The socket identifier.
      * @param properties The properties to update.
+     * @returns Called when the properties are updated.
      */
     export function update(
 
@@ -19221,7 +19182,6 @@ declare namespace chrome {
      *
      * @param socketId The socket identifier.
      * @param properties The properties to update.
-     * @param callback Called when the properties are updated.
      */
     export function update(
 
@@ -19234,6 +19194,8 @@ declare namespace chrome {
 
     /**
      * Enables or disables the application from receiving messages from its peer. The default value is "false". Pausing a socket is typically used by an application to throttle data sent by its peer. When a socket is paused, no `onReceive` event is raised. When a socket is connected and un-paused, `onReceive` events are raised again when messages are received.
+     *
+     * @returns Callback from the `setPaused` method.
      */
     export function setPaused(
 
@@ -19244,8 +19206,6 @@ declare namespace chrome {
 
     /**
      * Enables or disables the application from receiving messages from its peer. The default value is "false". Pausing a socket is typically used by an application to throttle data sent by its peer. When a socket is paused, no `onReceive` event is raised. When a socket is connected and un-paused, `onReceive` events are raised again when messages are received.
-     *
-     * @param callback Callback from the `setPaused` method.
      */
     export function setPaused(
 
@@ -19377,6 +19337,7 @@ declare namespace chrome {
      * Disconnects the socket.
      *
      * @param socketId The socket identifier.
+     * @returns Called when the disconnect attempt is complete.
      */
     export function disconnect(
 
@@ -19387,7 +19348,6 @@ declare namespace chrome {
      * Disconnects the socket.
      *
      * @param socketId The socket identifier.
-     * @param callback Called when the disconnect attempt is complete.
      */
     export function disconnect(
 
@@ -19454,6 +19414,7 @@ declare namespace chrome {
      * Closes the socket and releases the address/port the socket is bound to. Each socket created should be closed after use. The socket id is no no longer valid as soon at the function is called. However, the socket is guaranteed to be closed only when the callback is invoked.
      *
      * @param socketId The socket identifier.
+     * @returns Called when the `close` operation completes.
      */
     export function close(
 
@@ -19464,7 +19425,6 @@ declare namespace chrome {
      * Closes the socket and releases the address/port the socket is bound to. Each socket created should be closed after use. The socket id is no no longer valid as soon at the function is called. However, the socket is guaranteed to be closed only when the callback is invoked.
      *
      * @param socketId The socket identifier.
-     * @param callback Called when the `close` operation completes.
      */
     export function close(
 
@@ -19477,6 +19437,7 @@ declare namespace chrome {
      * Retrieves the state of the given socket.
      *
      * @param socketId The socket identifier.
+     * @returns Called when the socket state is available.
      */
     export function getInfo(
 
@@ -19487,7 +19448,6 @@ declare namespace chrome {
      * Retrieves the state of the given socket.
      *
      * @param socketId The socket identifier.
-     * @param callback Called when the socket state is available.
      */
     export function getInfo(
 
@@ -19503,13 +19463,13 @@ declare namespace chrome {
 
     /**
      * Retrieves the list of currently opened sockets owned by the application.
+     *
+     * @returns Called when the list of sockets is available.
      */
     export function getSockets(): Promise<SocketInfo[]>;
 
     /**
      * Retrieves the list of currently opened sockets owned by the application.
-     *
-     * @param callback Called when the list of sockets is available.
      */
     export function getSockets(
 
@@ -19633,6 +19593,7 @@ declare namespace chrome {
      * Creates a TCP server socket.
      *
      * @param properties The socket properties (optional).
+     * @returns Called when the socket has been created.
      */
     export function create(
 
@@ -19643,7 +19604,6 @@ declare namespace chrome {
      * Creates a TCP server socket.
      *
      * @param properties The socket properties (optional).
-     * @param callback Called when the socket has been created.
      */
     export function create(
 
@@ -19662,6 +19622,7 @@ declare namespace chrome {
      *
      * @param socketId The socket identifier.
      * @param properties The properties to update.
+     * @returns Called when the properties are updated.
      */
     export function update(
 
@@ -19675,7 +19636,6 @@ declare namespace chrome {
      *
      * @param socketId The socket identifier.
      * @param properties The properties to update.
-     * @param callback Called when the properties are updated.
      */
     export function update(
 
@@ -19688,6 +19648,8 @@ declare namespace chrome {
 
     /**
      * Enables or disables a listening socket from accepting new connections. When paused, a listening socket accepts new connections until its backlog (see `listen` function) is full then refuses additional connection requests. `onAccept` events are raised only when the socket is un-paused.
+     *
+     * @returns Callback from the `setPaused` method.
      */
     export function setPaused(
 
@@ -19698,8 +19660,6 @@ declare namespace chrome {
 
     /**
      * Enables or disables a listening socket from accepting new connections. When paused, a listening socket accepts new connections until its backlog (see `listen` function) is full then refuses additional connection requests. `onAccept` events are raised only when the socket is un-paused.
-     *
-     * @param callback Callback from the `setPaused` method.
      */
     export function setPaused(
 
@@ -19765,6 +19725,7 @@ declare namespace chrome {
      * Disconnects the listening socket, i.e. stops accepting new connections and releases the address/port the socket is bound to. The socket identifier remains valid, e.g. it can be used with `listen` to accept connections on a new port and address.
      *
      * @param socketId The socket identifier.
+     * @returns Called when the disconnect attempt is complete.
      */
     export function disconnect(
 
@@ -19775,7 +19736,6 @@ declare namespace chrome {
      * Disconnects the listening socket, i.e. stops accepting new connections and releases the address/port the socket is bound to. The socket identifier remains valid, e.g. it can be used with `listen` to accept connections on a new port and address.
      *
      * @param socketId The socket identifier.
-     * @param callback Called when the disconnect attempt is complete.
      */
     export function disconnect(
 
@@ -19788,6 +19748,7 @@ declare namespace chrome {
      * Disconnects and destroys the socket. Each socket created should be closed after use. The socket id is no longer valid as soon at the function is called. However, the socket is guaranteed to be closed only when the callback is invoked.
      *
      * @param socketId The socket identifier.
+     * @returns Called when the `close` operation completes.
      */
     export function close(
 
@@ -19798,7 +19759,6 @@ declare namespace chrome {
      * Disconnects and destroys the socket. Each socket created should be closed after use. The socket id is no longer valid as soon at the function is called. However, the socket is guaranteed to be closed only when the callback is invoked.
      *
      * @param socketId The socket identifier.
-     * @param callback Called when the `close` operation completes.
      */
     export function close(
 
@@ -19811,6 +19771,7 @@ declare namespace chrome {
      * Retrieves the state of the given socket.
      *
      * @param socketId The socket identifier.
+     * @returns Called when the socket state is available.
      */
     export function getInfo(
 
@@ -19821,7 +19782,6 @@ declare namespace chrome {
      * Retrieves the state of the given socket.
      *
      * @param socketId The socket identifier.
-     * @param callback Called when the socket state is available.
      */
     export function getInfo(
 
@@ -19837,13 +19797,13 @@ declare namespace chrome {
 
     /**
      * Retrieves the list of currently opened sockets owned by the application.
+     *
+     * @returns Called when the list of sockets is available.
      */
     export function getSockets(): Promise<SocketInfo[]>;
 
     /**
      * Retrieves the list of currently opened sockets owned by the application.
-     *
-     * @param callback Called when the list of sockets is available.
      */
     export function getSockets(
 
@@ -20005,6 +19965,7 @@ declare namespace chrome {
      * Creates a UDP socket with the given properties.
      *
      * @param properties The socket properties (optional).
+     * @returns Called when the socket has been created.
      */
     export function create(
 
@@ -20015,7 +19976,6 @@ declare namespace chrome {
      * Creates a UDP socket with the given properties.
      *
      * @param properties The socket properties (optional).
-     * @param callback Called when the socket has been created.
      */
     export function create(
 
@@ -20034,6 +19994,7 @@ declare namespace chrome {
      *
      * @param socketId The socket ID.
      * @param properties The properties to update.
+     * @returns Called when the properties are updated.
      */
     export function update(
 
@@ -20047,7 +20008,6 @@ declare namespace chrome {
      *
      * @param socketId The socket ID.
      * @param properties The properties to update.
-     * @param callback Called when the properties are updated.
      */
     export function update(
 
@@ -20062,6 +20022,7 @@ declare namespace chrome {
      * Pauses or unpauses a socket. A paused socket is blocked from firing `onReceive` events.
      *
      * @param paused Flag to indicate whether to pause or unpause.
+     * @returns Called when the socket has been successfully paused or unpaused.
      */
     export function setPaused(
 
@@ -20074,7 +20035,6 @@ declare namespace chrome {
      * Pauses or unpauses a socket. A paused socket is blocked from firing `onReceive` events.
      *
      * @param paused Flag to indicate whether to pause or unpause.
-     * @param callback Called when the socket has been successfully paused or unpaused.
      */
     export function setPaused(
 
@@ -20172,6 +20132,7 @@ declare namespace chrome {
      * Closes the socket and releases the address/port the socket is bound to. Each socket created should be closed after use. The socket id is no longer valid as soon at the function is called. However, the socket is guaranteed to be closed only when the callback is invoked.
      *
      * @param socketId The socket ID.
+     * @returns Called when the `close` operation completes.
      */
     export function close(
 
@@ -20182,7 +20143,6 @@ declare namespace chrome {
      * Closes the socket and releases the address/port the socket is bound to. Each socket created should be closed after use. The socket id is no longer valid as soon at the function is called. However, the socket is guaranteed to be closed only when the callback is invoked.
      *
      * @param socketId The socket ID.
-     * @param callback Called when the `close` operation completes.
      */
     export function close(
 
@@ -20195,6 +20155,7 @@ declare namespace chrome {
      * Retrieves the state of the given socket.
      *
      * @param socketId The socket ID.
+     * @returns Called when the socket state is available.
      */
     export function getInfo(
 
@@ -20205,7 +20166,6 @@ declare namespace chrome {
      * Retrieves the state of the given socket.
      *
      * @param socketId The socket ID.
-     * @param callback Called when the socket state is available.
      */
     export function getInfo(
 
@@ -20221,13 +20181,13 @@ declare namespace chrome {
 
     /**
      * Retrieves the list of currently opened sockets owned by the application.
+     *
+     * @returns Called when the list of sockets is available.
      */
     export function getSockets(): Promise<SocketInfo[]>;
 
     /**
      * Retrieves the list of currently opened sockets owned by the application.
-     *
-     * @param callback Called when the list of sockets is available.
      */
     export function getSockets(
 
@@ -20335,6 +20295,7 @@ declare namespace chrome {
      * Gets the multicast group addresses the socket is currently joined to.
      *
      * @param socketId The socket ID.
+     * @returns Called with an array of strings of the result.
      */
     export function getJoinedGroups(
 
@@ -20345,7 +20306,6 @@ declare namespace chrome {
      * Gets the multicast group addresses the socket is currently joined to.
      *
      * @param socketId The socket ID.
-     * @param callback Called with an array of strings of the result.
      */
     export function getJoinedGroups(
 
@@ -20426,6 +20386,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 storage items, or rejects on failure.
        */
       get(
 
@@ -20436,7 +20397,6 @@ declare namespace chrome {
        * Gets one or more items from storage.
        *
        * @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.
-       * @param callback Callback with storage items, or on failure (in which case {@link runtime.lastError} will be set).
        */
       get(
 
@@ -20453,6 +20413,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[]>;
@@ -20460,7 +20421,6 @@ declare namespace chrome {
       /**
        * Gets all keys from storage.
        *
-       * @param callback Callback with storage keys, or on failure (in which case {@link runtime.lastError} will be set).
        * @since Chrome 130
        */
       getKeys(
@@ -20478,6 +20438,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(
 
@@ -20488,7 +20449,6 @@ declare namespace chrome {
        * Gets the amount of space (in bytes) being used by one or more items.
        *
        * @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.
-       * @param callback Callback with the amount of space being used by storage, or on failure (in which case {@link runtime.lastError} will be set).
        */
       getBytesInUse(
 
@@ -20511,6 +20471,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(
 
@@ -20525,7 +20486,6 @@ 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).
-       * @param callback Callback on success, or on failure (in which case {@link runtime.lastError} will be set).
        */
       set(
 
@@ -20539,6 +20499,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(
 
@@ -20549,7 +20510,6 @@ declare namespace chrome {
        * Removes one or more items from storage.
        *
        * @param keys A single key or a list of keys for items to remove.
-       * @param callback Callback on success, or on failure (in which case {@link runtime.lastError} will be set).
        */
       remove(
 
@@ -20562,13 +20522,12 @@ 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>;
 
       /**
        * Removes all items from storage.
-       *
-       * @param callback Callback on success, or on failure (in which case {@link runtime.lastError} will be set).
        */
       clear(
 
@@ -20578,6 +20537,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(
@@ -20594,7 +20554,6 @@ 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.
        *
-       * @param callback Callback on success, or on failure (in which case {@link runtime.lastError} will be set).
        * @since Chrome 102
        */
       setAccessLevel(
@@ -21245,6 +21204,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(
 
@@ -21258,7 +21218,6 @@ declare namespace chrome {
      * Requests the information for all attached display devices.
      *
      * @param flags Options affecting how the information is returned.
-     * @param callback Promise that resolves with the results.
      */
     export function getInfo(
 
@@ -21276,6 +21235,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[]>;
@@ -21283,7 +21243,6 @@ declare namespace chrome {
     /**
      * Requests the layout info for all displays. NOTE: This is only available to ChromeOS Kiosk apps and Web UI.
      *
-     * @param callback Promise that resolves with the results.
      * @since Chrome 53
      */
     export function getDisplayLayout(
@@ -21299,6 +21258,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(
 
@@ -21312,7 +21272,6 @@ 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 Promise that resolves when the function finishes.
      */
     export function setDisplayProperties(
 
@@ -21328,6 +21287,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(
@@ -21339,7 +21299,6 @@ 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 Promise that resolves when the function finishes.
      * @since Chrome 53
      */
     export function setDisplayLayout(
@@ -21412,6 +21371,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(
@@ -21423,7 +21383,6 @@ 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 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(
@@ -21476,6 +21435,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(
@@ -21487,7 +21447,6 @@ 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 Promise that resolves when the function finishes.
      * @since Chrome 65
      */
     export function setMirrorMode(
@@ -21565,13 +21524,13 @@ declare namespace chrome {
 
     /**
      * Retrieves information about local adapters on this system.
+     *
+     * @returns Called when local adapter information is available.
      */
     export function getNetworkInterfaces(): Promise<NetworkInterface[]>;
 
     /**
      * Retrieves information about local adapters on this system.
-     *
-     * @param callback Called when local adapter information is available.
      */
     export function getNetworkInterfaces(
 
@@ -21745,6 +21704,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(
 
@@ -21755,7 +21715,6 @@ declare namespace chrome {
      * Adds a new log record.
      *
      * @param options The logging options.
-     * @param callback Returns a Promise which resolves once the log has been added.
      */
     export function add(
 
@@ -21853,13 +21812,12 @@ 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[]>;
 
     /**
      * 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 Returns a Promise which resolves with CaptureInfo\[\] for captured tabs.
      */
     export function getCapturedTabs(
 
@@ -21872,6 +21830,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(
@@ -21882,7 +21841,6 @@ 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 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(
@@ -23741,6 +23699,7 @@ declare namespace chrome {
      * @chrome-returns-extra since Chrome 88
      * @param tabId The ID of the tab to zoom; defaults to the active tab of the current window.
      * @param zoomFactor The new zoom factor. A value of `0` sets the tab to its current default zoom factor. Values greater than `0` specify a (possibly non-default) zoom factor for the tab.
+     * @returns Resolves after the zoom factor has been changed.
      */
     export function setZoom(
 
@@ -23754,6 +23713,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 88
      * @param zoomFactor The new zoom factor. A value of `0` sets the tab to its current default zoom factor. Values greater than `0` specify a (possibly non-default) zoom factor for the tab.
+     * @returns Resolves after the zoom factor has been changed.
      */
     export function setZoom(
 
@@ -23765,7 +23725,6 @@ declare namespace chrome {
      *
      * @param tabId The ID of the tab to zoom; defaults to the active tab of the current window.
      * @param zoomFactor The new zoom factor. A value of `0` sets the tab to its current default zoom factor. Values greater than `0` specify a (possibly non-default) zoom factor for the tab.
-     * @param callback Resolves after the zoom factor has been changed.
      */
     export function setZoom(
 
@@ -23780,7 +23739,6 @@ declare namespace chrome {
      * Zooms a specified tab.
      *
      * @param zoomFactor The new zoom factor. A value of `0` sets the tab to its current default zoom factor. Values greater than `0` specify a (possibly non-default) zoom factor for the tab.
-     * @param callback Resolves after the zoom factor has been changed.
      */
     export function setZoom(
 
@@ -23794,6 +23752,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 88
      * @param tabId The ID of the tab to get the current zoom factor from; defaults to the active tab of the current window.
+     * @returns Resolves with the tab's current zoom factor after it has been fetched.
      */
     export function getZoom(
 
@@ -23804,7 +23763,6 @@ declare namespace chrome {
      * Gets the current zoom factor of a specified tab.
      *
      * @param tabId The ID of the tab to get the current zoom factor from; defaults to the active tab of the current window.
-     * @param callback Resolves with the tab's current zoom factor after it has been fetched.
      */
     export function getZoom(
 
@@ -23824,6 +23782,7 @@ declare namespace chrome {
      * @chrome-returns-extra since Chrome 88
      * @param tabId The ID of the tab to change the zoom settings for; defaults to the active tab of the current window.
      * @param zoomSettings Defines how zoom changes are handled and at what scope.
+     * @returns Resolves after the zoom settings are changed.
      */
     export function setZoomSettings(
 
@@ -23837,6 +23796,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 88
      * @param zoomSettings Defines how zoom changes are handled and at what scope.
+     * @returns Resolves after the zoom settings are changed.
      */
     export function setZoomSettings(
 
@@ -23848,7 +23808,6 @@ declare namespace chrome {
      *
      * @param tabId The ID of the tab to change the zoom settings for; defaults to the active tab of the current window.
      * @param zoomSettings Defines how zoom changes are handled and at what scope.
-     * @param callback Resolves after the zoom settings are changed.
      */
     export function setZoomSettings(
 
@@ -23863,7 +23822,6 @@ declare namespace chrome {
      * Sets the zoom settings for a specified tab, which define how zoom changes are handled. These settings are reset to defaults upon navigating the tab.
      *
      * @param zoomSettings Defines how zoom changes are handled and at what scope.
-     * @param callback Resolves after the zoom settings are changed.
      */
     export function setZoomSettings(
 
@@ -23877,6 +23835,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 88
      * @param tabId The ID of the tab to get the current zoom settings from; defaults to the active tab of the current window.
+     * @returns Resolves with the tab's current zoom settings.
      */
     export function getZoomSettings(
 
@@ -23887,7 +23846,6 @@ declare namespace chrome {
      * Gets the current zoom settings of a specified tab.
      *
      * @param tabId The ID of the tab to get the current zoom settings from; defaults to the active tab of the current window.
-     * @param callback Resolves with the tab's current zoom settings.
      */
     export function getZoomSettings(
 
@@ -23906,6 +23864,7 @@ declare namespace chrome {
      *
      * @chrome-returns-extra since Chrome 88
      * @param tabId The ID of the tab to be discarded. If specified, the tab is discarded unless it is active or already discarded. If omitted, the browser discards the least important tab. This can fail if no discardable tabs exist.
+     * @returns Resolves after the operation is completed.
      * @since Chrome 54
      */
     export function discard(
@@ -23917,7 +23876,6 @@ declare namespace chrome {
      * Discards a tab from memory. Discarded tabs are still visible on the tab strip and are reloaded when activated.
      *
      * @param tabId The ID of the tab to be discarded. If specified, the tab is discarded unless it is active or already discarded. If omitted, the browser discards the least important tab. This can fail if no discardable tabs exist.
-     * @param callback Resolves after the operation is completed.
      * @since Chrome 54
      */
     export function discard(
@@ -24193,6 +24151,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(
 
@@ -24206,7 +24165,6 @@ declare namespace chrome {
      *
      * @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.
-     * @param callback 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(
 
@@ -24681,6 +24639,7 @@ declare namespace chrome {
        *
        * @chrome-returns-extra since Chrome 96
        * @param details Which setting to change.
+       * @returns Called at the completion of the set operation.
        */
       set(
 
@@ -24703,7 +24662,6 @@ declare namespace chrome {
        * Sets the value of a setting.
        *
        * @param details Which setting to change.
-       * @param callback Called at the completion of the set operation.
        */
       set(
 
@@ -24729,6 +24687,7 @@ declare namespace chrome {
        *
        * @chrome-returns-extra since Chrome 96
        * @param details Which setting to clear.
+       * @returns Called at the completion of the clear operation.
        */
       clear(
 
@@ -24745,7 +24704,6 @@ declare namespace chrome {
        * Clears the setting, restoring any default value.
        *
        * @param details Which setting to clear.
-       * @param callback Called at the completion of the clear operation.
        */
       clear(
 
@@ -24962,6 +24920,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(
 
@@ -24972,7 +24931,6 @@ 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 Promise that resolves once scripts have been fully registered. The promise will be rejected if an error occurs.
      */
     export function register(
 
@@ -24985,6 +24943,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(
 
@@ -24995,7 +24954,6 @@ 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 Promise that resolves with the registered scripts. The promise will be rejected if an error occurs.
      */
     export function getScripts(
 
@@ -25010,6 +24968,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(
 
@@ -25020,7 +24979,6 @@ 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 Promise that resolves once scripts have been fully unregistered. The promise will be rejected if an error occurs.
      */
     export function unregister(
 
@@ -25033,6 +24991,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(
 
@@ -25043,7 +25002,6 @@ 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 Promise that resolves once scripts have been fully updated. The promise will be rejected if an error occurs.
      */
     export function update(
 
@@ -25080,6 +25038,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(
 
@@ -25090,7 +25049,6 @@ declare namespace chrome {
      * Configures the `` `USER_SCRIPT` `` execution environment.
      *
      * @param properties Contains the user script world configuration.
-     * @param callback Promise that resolves once the world has been configured.
      */
     export function configureWorld(
 
@@ -25102,6 +25060,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[]>;
@@ -25109,7 +25068,6 @@ declare namespace chrome {
     /**
      * Retrieves all registered world configurations.
      *
-     * @param callback Promise that resolves with the registered world configurations.
      * @since Chrome 133
      */
     export function getWorldConfigurations(
@@ -25123,6 +25081,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(
@@ -25134,7 +25093,6 @@ 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 Promise that resolves when the configuration is reset.
      * @since Chrome 133
      */
     export function resetWorldConfiguration(
@@ -25278,6 +25236,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(
 
@@ -25288,7 +25247,6 @@ 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 Returns a Promise which resolves when the configuration is created or rejects if there is an error.
      */
     export function createConfig(
 
@@ -25307,6 +25265,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(
 
@@ -25317,7 +25276,6 @@ declare namespace chrome {
      * Destroys a VPN configuration created by the extension.
      *
      * @param id ID of the VPN configuration to destroy.
-     * @param callback Returns a Promise which resolves when the configuration is destroyed or rejects if there is an error.
      */
     export function destroyConfig(
 
@@ -25331,6 +25289,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(
 
@@ -25341,7 +25300,6 @@ 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 Returns a Promise which resolves when the parameters are set or rejects if there is an error.
      */
     export function setParameters(
 
@@ -25355,6 +25313,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(
 
@@ -25365,7 +25324,6 @@ 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 Returns a Promise which resolves when the packet is sent or rejects if there is an error.
      */
     export function sendPacket(
 
@@ -25379,6 +25337,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(
 
@@ -25389,7 +25348,6 @@ 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 Returns a Promise which resolves when the notification is complete or rejects if there is an error.
      */
     export function notifyConnectionStateChanged(