@types/chrome 0.0.293 → 0.0.294

chrome/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for chrome (http://developer.chrome.com/e
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome.
 
 ### Additional Details
- * Last updated: Thu, 09 Jan 2025 14:35:38 GMT
+ * Last updated: Tue, 14 Jan 2025 07:02:19 GMT
  * Dependencies: [@types/filesystem](https://npmjs.com/package/@types/filesystem), [@types/har-format](https://npmjs.com/package/@types/har-format)
 
 # Credits

chrome/index.d.ts

@@ -14,7 +14,8 @@ declare namespace chrome {
     // Accessibility Features
     ////////////////////
     /**
-     * Use the chrome.accessibilityFeatures API to manage Chrome's accessibility features. This API relies on the ChromeSetting prototype of the type API for getting and setting individual accessibility features. In order to get feature states the extension must request `accessibilityFeatures.read` permission. For modifying feature state, the extension needs `accessibilityFeatures.modify` permission. Note that `accessibilityFeatures.modify` does not imply `accessibilityFeatures.read` permission.
+     * Use the `chrome.accessibilityFeatures` API to manage Chrome's accessibility features. This API relies on the ChromeSetting prototype of the type API for getting and setting individual accessibility features. In order to get feature states the extension must request `accessibilityFeatures.read` permission. For modifying feature state, the extension needs `accessibilityFeatures.modify` permission. Note that `accessibilityFeatures.modify` does not imply `accessibilityFeatures.read` permission.
+     *
      * Permissions: "accessibilityFeatures.read", "accessibilityFeatures.modify"
      */
     export namespace accessibilityFeatures {
@@ -139,9 +140,11 @@ declare namespace chrome {
     // Action
     ////////////////////
     /**
-     * Use the chrome.action API to control the extension's icon in the Google Chrome toolbar.
+     * Use the `chrome.action` API to control the extension's icon in the Google Chrome toolbar.
+     * The action icons are displayed in the browser toolbar next to the omnibox. After installation, these appear in the extensions menu (the puzzle piece icon). Users can pin your extension icon to the toolbar.
+     *
+     * Manifest: "action"
      * @since Chrome 88, MV3
-     * Manifest:  "action": {...}
      */
     export namespace action {
         /** @deprecated Use BadgeColorDetails instead. */
@@ -444,9 +447,9 @@ declare namespace chrome {
     // Alarms
     ////////////////////
     /**
-     * Use the chrome.alarms API to schedule code to run periodically or at a specified time in the future.
-     * @since Chrome 22
-     * Permissions:  "alarms"
+     * Use the `chrome.alarms` API to schedule code to run periodically or at a specified time in the future.
+     *
+     * Permissions: "alarms"
      */
     export namespace alarms {
         export interface AlarmCreateInfo {
@@ -570,11 +573,9 @@ declare namespace chrome {
     // Audio
     ////////////////////
     /**
-     * The chrome.audio API is provided to allow users to get information about and control the audio devices attached to the system.
-     * This API is currently only available in kiosk mode for ChromeOS.
+     * The `chrome.audio` API is provided to allow users to get information about and control the audio devices attached to the system. This API is currently only available in kiosk mode for ChromeOS.
      *
      * Permissions: "audio"
-     *
      * @platform ChromeOS only
      * @since Chrome 59
      */
@@ -758,9 +759,9 @@ declare namespace chrome {
     // Bookmarks
     ////////////////////
     /**
-     * Use the chrome.bookmarks API to create, organize, and otherwise manipulate bookmarks. Also see Override Pages, which you can use to create a custom Bookmark Manager page.
-     * @since Chrome 5
-     * Permissions:  "bookmarks"
+     * Use the `chrome.bookmarks` API to create, organize, and otherwise manipulate bookmarks. Also see Override Pages, which you can use to create a custom Bookmark Manager page.
+     *
+     * Permissions: "bookmarks"
      */
     export namespace bookmarks {
         /** A node (either a bookmark or a folder) in the bookmark tree. Child nodes are ordered within their parent folder. */
@@ -1030,9 +1031,11 @@ declare namespace chrome {
     // Browser Action
     ////////////////////
     /**
-     * Use browser actions to put icons in the main Google Chrome toolbar, to the right of the address bar. In addition to its icon, a browser action can also have a tooltip, a badge, and a popup.
-     * @since Chrome 5
-     * Manifest:  "browser_action": {...}
+     * Use browser actions to put icons in the main Google Chrome toolbar, to the right of the address bar. In addition to its icon, a browser action can have a tooltip, a badge, and a popup.
+     *
+     * Manifest: "browser_action"
+     *
+     * MV2 only
      */
     export namespace browserAction {
         export interface BadgeBackgroundColorDetails {
@@ -1209,9 +1212,9 @@ declare namespace chrome {
     // Browsing Data
     ////////////////////
     /**
-     * Use the chrome.browsingData API to remove browsing data from a user's local profile.
-     * @since Chrome 19
-     * Permissions:  "browsingData"
+     * Use the `chrome.browsingData` API to remove browsing data from a user's local profile.
+     *
+     * Permissions: "browsingData"
      */
     export namespace browsingData {
         export interface OriginTypes {
@@ -1484,8 +1487,8 @@ declare namespace chrome {
     ////////////////////
     /**
      * Use the commands API to add keyboard shortcuts that trigger actions in your extension, for example, an action to open the browser action or send a command to the extension.
-     * @since Chrome 25
-     * Manifest:  "commands": {...}
+     *
+     * Manifest: "commands"
      */
     export namespace commands {
         export interface Command {
@@ -1518,9 +1521,9 @@ declare namespace chrome {
     // Content Settings
     ////////////////////
     /**
-     * Use the chrome.contentSettings API to change settings that control whether websites can use features such as cookies, JavaScript, and plugins. More generally speaking, content settings allow you to customize Chrome's behavior on a per-site basis instead of globally.
-     * @since Chrome 16
-     * Permissions:  "contentSettings"
+     * Use the `chrome.contentSettings` API to change settings that control whether websites can use features such as cookies, JavaScript, and plugins. More generally speaking, content settings allow you to customize Chrome's behavior on a per-site basis instead of globally.
+     *
+     * Permissions: "contentSettings"
      */
     export namespace contentSettings {
         type ScopeEnum = "regular" | "incognito_session_only";
@@ -1843,9 +1846,9 @@ declare namespace chrome {
     // Context Menus
     ////////////////////
     /**
-     * Use the chrome.contextMenus API to add items to Google Chrome's context menu. You can choose what types of objects your context menu additions apply to, such as images, hyperlinks, and pages.
-     * @since Chrome 6
-     * Permissions:  "contextMenus"
+     * Use the `chrome.contextMenus` API to add items to Google Chrome's context menu. You can choose what types of objects your context menu additions apply to, such as images, hyperlinks, and pages.
+     *
+     * Permissions: "contextMenus"
      */
     export namespace contextMenus {
         export interface OnClickData {
@@ -2046,9 +2049,11 @@ declare namespace chrome {
     // Cookies
     ////////////////////
     /**
-     * Use the chrome.cookies API to query and modify cookies, and to be notified when they change.
-     * @since Chrome 6
-     * Permissions:  "cookies", host permissions
+     * Use the `chrome.cookies` API to query and modify cookies, and to be notified when they change.
+     *
+     * Permissions: "cookies"
+     *
+     * Manifest: "host_permissions"
      */
     export namespace cookies {
         /** A cookie's 'SameSite' state (https://tools.ietf.org/html/draft-west-first-party-cookies). 'no_restriction' corresponds to a cookie set with 'SameSite=None', 'lax' to 'SameSite=Lax', and 'strict' to 'SameSite=Strict'. 'unspecified' corresponds to a cookie set without the SameSite attribute. **/
@@ -2255,9 +2260,9 @@ declare namespace chrome {
     // Debugger
     ////////////////////
     /**
-     * The chrome.debugger API serves as an alternate transport for Chrome's remote debugging protocol. Use chrome.debugger to attach to one or more tabs to instrument network interaction, debug JavaScript, mutate the DOM and CSS, etc. Use the Debuggee tabId to target tabs with sendCommand and route events by tabId from onEvent callbacks.
-     * @since Chrome 18
-     * Permissions:  "debugger"
+     * The `chrome.debugger` API serves as an alternate transport for Chrome's remote debugging protocol. Use `chrome.debugger` to attach to one or more tabs to instrument network interaction, debug JavaScript, mutate the DOM and CSS, and more. Use the {@link Debuggee} `tabId` to target tabs with `sendCommand` and route events by `tabId` from `onEvent` callbacks.
+     *
+     * Permissions: "debugger"
      */
     export namespace _debugger {
         /** Debuggee identifier. Either tabId or extensionId must be specified */
@@ -2390,13 +2395,14 @@ declare namespace chrome {
     }
 
     export { _debugger as debugger };
+
     ////////////////////
     // Declarative Content
     ////////////////////
     /**
-     * Use the chrome.declarativeContent API to take actions depending on the content of a page, without requiring permission to read the page's content.
-     * @since Chrome 33
-     * Permissions:  "declarativeContent"
+     * Use the `chrome.declarativeContent` API to take actions depending on the content of a page, without requiring permission to read the page's content.
+     *
+     * Permissions: "declarativeContent"
      */
     export namespace declarativeContent {
         export interface PageStateUrlDetails {
@@ -2486,6 +2492,14 @@ declare namespace chrome {
     ////////////////////
     // Declarative Web Request
     ////////////////////
+    /**
+     * Use the `chrome.declarativeWebRequest` API to intercept, block, or modify requests in-flight. It is significantly faster than the chrome.webRequest API because you can register rules that are evaluated in the browser rather than the JavaScript engine, which reduces roundtrip latencies and allows higher efficiency.
+     *
+     * Permissions: "declarativeWebRequest"
+     *
+     * MV2 only
+     * @deprecated Check out the {@link declarativeNetRequest} API instead
+     */
     export namespace declarativeWebRequest {
         export interface HeaderFilter {
             nameEquals?: string | undefined;
@@ -2596,9 +2610,9 @@ declare namespace chrome {
     // DesktopCapture
     ////////////////////
     /**
-     * Desktop Capture API that can be used to capture content of screen, individual windows or tabs.
-     * @since Chrome 34
-     * Permissions:  "desktopCapture"
+     * The Desktop Capture API captures the content of the screen, individual windows, or individual tabs.
+     *
+     * Permissions: "desktopCapture"
      */
     export namespace desktopCapture {
         /** Contains properties that describe the stream. */
@@ -2637,8 +2651,9 @@ declare namespace chrome {
     // Dev Tools - Inspected Window
     ////////////////////
     /**
-     * Use the chrome.devtools.inspectedWindow API to interact with the inspected window: obtain the tab ID for the inspected page, evaluate the code in the context of the inspected window, reload the page, or obtain the list of resources within the page.
-     * @since Chrome 18
+     * Use the `chrome.devtools.inspectedWindow` API to interact with the inspected window: obtain the tab ID for the inspected page, evaluate the code in the context of the inspected window, reload the page, or obtain the list of resources within the page.
+     *
+     * Manifest: "devtools_page"
      */
     export namespace devtools.inspectedWindow {
         /** A resource within the inspected page, such as a document, a script, or an image. */
@@ -2765,8 +2780,9 @@ declare namespace chrome {
     // Dev Tools - Network
     ////////////////////
     /**
-     * Use the chrome.devtools.network API to retrieve the information about network requests displayed by the Developer Tools in the Network panel.
-     * @since Chrome 18
+     * Use the `chrome.devtools.network` API to retrieve the information about network requests displayed by the Developer Tools in the Network panel.
+     *
+     * Manifest: "devtools_page"
      */
     export namespace devtools.network {
         /** Represents a HAR entry for a specific finished request. */
@@ -2810,8 +2826,8 @@ declare namespace chrome {
     // Dev Tools - Performance
     ////////////////////
     /**
-     * The chrome.devtools.performance API allows developers to interact with the recording features of the Performance panel in Chrome DevTools. You can use this API to get notifications when recording starts or stops.
-     * @since Chrome 128
+     * Use the `chrome.devtools.performance` API to listen to recording status updates in the Performance panel in DevTools.
+     * @since Chrome 129
      */
     export namespace devtools.performance {
         export interface ProfilingStartedEvent extends chrome.events.Event<() => void> {}
@@ -2828,8 +2844,9 @@ declare namespace chrome {
     // Dev Tools - Panels
     ////////////////////
     /**
-     * Use the chrome.devtools.panels API to integrate your extension into Developer Tools window UI: create your own panels, access existing panels, and add sidebars.
-     * @since Chrome 18
+     * Use the `chrome.devtools.panels` API to integrate your extension into Developer Tools window UI: create your own panels, access existing panels, and add sidebars.
+     *
+     * Manifest: "devtools_page"
      */
     export namespace devtools.panels {
         export interface PanelShownEvent extends chrome.events.Event<(window: Window) => void> {}
@@ -3022,10 +3039,12 @@ declare namespace chrome {
     // Document Scan
     ////////////////////
     /**
-     * Use the chrome.documentScan API to discover and retrieve images from attached paper document scanners.
+     * Use the `chrome.documentScan` API to discover and retrieve images from attached document scanners.
+     * The Document Scan API is designed to allow apps and extensions to view the content of paper documents on an attached document scanner.
+     *
+     * Permissions: "documentScan"
+     * @platform ChromeOS only
      * @since Chrome 44
-     * Permissions:  "documentScan"
-     * Important: This API works only on Chrome OS.
      */
     export namespace documentScan {
         export interface DocumentScanOptions {
@@ -3054,7 +3073,7 @@ declare namespace chrome {
     // DOM
     ////////////////////
     /**
-     * Use the chrome.dom API to programmatically access shadow root in an HTMLElement.
+     * Use the `chrome.dom` API to access special DOM APIs for Extensions
      * @since Chrome 88
      */
     export namespace dom {
@@ -3067,12 +3086,12 @@ declare namespace chrome {
     }
 
     ////////////////////
-    // Dev Tools - Downloads
+    // Downloads
     ////////////////////
     /**
-     * Use the chrome.downloads API to programmatically initiate, monitor, manipulate, and search for downloads.
-     * @since Chrome 31
-     * Permissions:  "downloads"
+     * Use the `chrome.downloads` API to programmatically initiate, monitor, manipulate, and search for downloads.
+     *
+     * Permissions: "downloads"
      */
     export namespace downloads {
         export interface HeaderNameValuePair {
@@ -3472,11 +3491,12 @@ declare namespace chrome {
     // Enterprise Platform Keys
     ////////////////////
     /**
-     * Use the chrome.enterprise.platformKeys API to generate hardware-backed keys and to install certificates for these keys. The certificates will be managed by the platform and can be used for TLS authentication, network access or by other extension through chrome.platformKeys.
-     * @since Chrome 37
-     * Permissions:  "enterprise.platformKeys"
-     * Important: This API works only on Chrome OS.
-     * Note:  This API is only for extensions pre-installed by policy.
+     * Use the `chrome.enterprise.platformKeys` API to generate keys and install certificates for these keys. The certificates will be managed by the platform and can be used for TLS authentication, network access or by other extension through {@link chrome.platformKeys}.
+     *
+     * Permissions: "enterprise.platformKeys"
+     *
+     * Note: Only available to policy installed extensions.
+     * @platform ChromeOS only
      */
     export namespace enterprise.platformKeys {
         export interface Token {
@@ -3647,11 +3667,13 @@ declare namespace chrome {
     // Enterprise Device Attributes
     ////////////////////
     /**
-     * Use the <code>chrome.enterprise.deviceAttributes</code> API to read device attributes.
-     * Permissions:  "enterprise.deviceAttributes"
+     * Use the `chrome.enterprise.deviceAttributes` API to read device attributes.
+     *
+     * Permissions: "enterprise.deviceAttributes"
+     *
+     * Note: Only available to policy installed extensions.
+     * @platform ChromeOS only
      * @since Chrome 46
-     * Important: This API works only on Chrome OS.
-     * Note: This API is only for extensions pre-installed by policy.
      */
     export namespace enterprise.deviceAttributes {
         /**
@@ -3700,12 +3722,11 @@ declare namespace chrome {
     // Enterprise Hardware Platform
     ////////////////////
     /**
-     * Use the chrome.enterprise.hardwarePlatform API to get the manufacturer and model of the hardware platform where the browser runs.
+     * Use the `chrome.enterprise.hardwarePlatform` API to get the manufacturer and model of the hardware platform where the browser runs.
      *
      * Permissions: "enterprise.hardwarePlatform"
      *
-     * Note: This API is only for extensions pre-installed by policy.
-     * @platform ChromeOS only
+     * Note: Only available to policy installed extensions.
      * @since Chrome 71
      */
     export namespace enterprise.hardwarePlatform {
@@ -3726,8 +3747,12 @@ declare namespace chrome {
     // Enterprise Networking Attributes
     ////////////////////
     /**
-     * Use the <code>chrome.enterprise.networkingAttributes</code> API to read information about your current network. Note: This API is only available to extensions force-installed by enterprise policy.
-     * Important: This API works only on Chrome OS.
+     * Use the `chrome.enterprise.networkingAttributes` API to read information about your current network. Note: This API is only available to extensions force-installed by enterprise policy.
+     *
+     * Permissions: "enterprise.networkingAttributes"
+     *
+     * Note: Only available to policy installed extensions.
+     * @platform ChromeOS only
      * @since Chrome 85
      */
     export namespace enterprise.networkingAttributes {
@@ -3751,8 +3776,7 @@ declare namespace chrome {
     // Events
     ////////////////////
     /**
-     * The chrome.events namespace contains common types used by APIs dispatching events to notify you when something interesting happens.
-     * @since Chrome 21
+     * The `chrome.events` namespace contains common types used by APIs dispatching events to notify you when something interesting happens.
      */
     export namespace events {
         /** Filters URLs for various criteria. See event filtering. All criteria are case sensitive. */
@@ -3893,8 +3917,7 @@ declare namespace chrome {
     // Extension
     ////////////////////
     /**
-     * The chrome.extension API has utilities that can be used by any extension page. It includes support for exchanging messages between an extension and its content scripts or between extensions, as described in detail in Message Passing.
-     * @since Chrome 5
+     * The `chrome.extension` API has utilities that can be used by any extension page. It includes support for exchanging messages between an extension and its content scripts or between extensions, as described in detail in Message Passing.
      */
     export namespace extension {
         export interface FetchProperties {
@@ -4014,10 +4037,10 @@ declare namespace chrome {
     // File Browser Handler
     ////////////////////
     /**
-     * Use the chrome.fileBrowserHandler API to extend the Chrome OS file browser. For example, you can use this API to enable users to upload files to your website.
-     * @since Chrome 12
-     * Permissions:  "fileBrowserHandler"
-     * Important: This API works only on Chrome OS.
+     * Use the `chrome.fileBrowserHandler` API to extend the Chrome OS file browser. For example, you can use this API to enable users to upload files to your website.
+     *
+     * Permissions: "fileBrowserHandler"
+     * @platform ChromeOS only
      */
     export namespace fileBrowserHandler {
         export interface SelectionParams {
@@ -4067,10 +4090,10 @@ declare namespace chrome {
     // File System Provider
     ////////////////////
     /**
-     * Use the chrome.fileSystemProvider API to create file systems, that can be accessible from the file manager on Chrome OS.
-     * @since Chrome 40
-     * Permissions:  "fileSystemProvider"
-     * Important: This API works only on Chrome OS.
+     * Use the `chrome.fileSystemProvider` API to create file systems, that can be accessible from the file manager on Chrome OS.
+     *
+     * Permissions: "fileSystemProvider"
+     * @platform ChromeOS only
      */
     export namespace fileSystemProvider {
         export interface OpenedFileInfo {
@@ -4599,9 +4622,9 @@ declare namespace chrome {
     // Font Settings
     ////////////////////
     /**
-     * Use the chrome.fontSettings API to manage Chrome's font settings.
-     * @since Chrome 22
-     * Permissions:  "fontSettings"
+     * Use the `chrome.fontSettings` API to manage Chrome's font settings.
+     *
+     * Permissions: "fontSettings"
      */
     export namespace fontSettings {
         /** Represents a font name. */
@@ -4824,9 +4847,9 @@ declare namespace chrome {
     // Google Cloud Messaging
     ////////////////////
     /**
-     * Use chrome.gcm to enable apps and extensions to send and receive messages through the Google Cloud Messaging Service.
-     * @since Chrome 35
-     * Permissions:  "gcm"
+     * Use `chrome.gcm` to enable apps and extensions to send and receive messages through Firebase Cloud Messaging (FCM).
+     *
+     * Permissions: "gcm"
      */
     export namespace gcm {
         export interface OutgoingMessage {
@@ -4906,9 +4929,9 @@ declare namespace chrome {
     // History
     ////////////////////
     /**
-     * Use the chrome.history API to interact with the browser's record of visited pages. You can add, remove, and query for URLs in the browser's history. To override the history page with your own version, see Override Pages.
-     * @since Chrome 5
-     * Permissions:  "history"
+     * Use the `chrome.history` API to interact with the browser's record of visited pages. You can add, remove, and query for URLs in the browser's history. To override the history page with your own version, see Override Pages.
+     *
+     * Permissions: "history"
      */
     export namespace history {
         /** An object encapsulating one visit to a URL. */
@@ -5040,8 +5063,9 @@ declare namespace chrome {
     // i18n
     ////////////////////
     /**
-     * Use the chrome.i18n infrastructure to implement internationalization across your whole app or extension.
-     * @since Chrome 5
+     * Use the `chrome.i18n` infrastructure to implement internationalization across your whole app or extension.
+     *
+     * Manifest: "default_locale"
      */
     export namespace i18n {
         /** Holds detected ISO language code and its percentage in the input string */
@@ -5103,9 +5127,9 @@ declare namespace chrome {
     // Identity
     ////////////////////
     /**
-     * Use the chrome.identity API to get OAuth2 access tokens.
-     * Permissions:  "identity"
-     * @since Chrome 29
+     * Use the `chrome.identity` API to get OAuth2 access tokens.
+     *
+     * Permissions: "identity"
      */
     export namespace identity {
         /** @since Chrome 32 */
@@ -5278,9 +5302,9 @@ declare namespace chrome {
     // Idle
     ////////////////////
     /**
-     * Use the chrome.idle API to detect when the machine's idle state changes.
-     * Permissions:  "idle"
-     * @since Chrome 6
+     * Use the `chrome.idle` API to detect when the machine's idle state changes.
+     *
+     * Permissions: "idle"
      */
     export namespace idle {
         export type IdleState = "active" | "idle" | "locked";
@@ -5321,9 +5345,10 @@ declare namespace chrome {
     // Input - IME
     ////////////////////
     /**
-     * Use the chrome.input.ime API to implement a custom IME for Chrome OS. This allows your extension to handle keystrokes, set the composition, and manage the candidate window.
-     * Permissions:  "input"
-     * @since Chrome 21
+     * Use the `chrome.input.ime` API to implement a custom IME for Chrome OS. This allows your extension to handle keystrokes, set the composition, and manage the candidate window.
+     *
+     * Permissions: "input"
+     * @platform ChromeOS only
      */
     export namespace input.ime {
         /** See http://www.w3.org/TR/DOM-Level-3-Events/#events-KeyboardEvent */
@@ -5801,8 +5826,12 @@ declare namespace chrome {
         export var onReset: InputResetEvent;
     }
 
+    ////////////////////
+    // Instance ID
+    ////////////////////
     /**
-     * Use chrome.instanceID to access the Instance ID service.
+     * Use `chrome.instanceID` to access the Instance ID service.
+     *
      * Permissions: "gcm"
      * @since Chrome 44
      */
@@ -5885,10 +5914,11 @@ declare namespace chrome {
     // LoginState
     ////////////////////
     /**
-     * Use the chrome.loginState API to read and monitor the login state.
+     * Use the `chrome.loginState` API to read and monitor the login state.
+     *
      * Permissions: "loginState"
+     * @platform ChromeOS only
      * @since Chrome 78
-     * Important: This API works only on Chrome OS.
      */
     export namespace loginState {
         export interface SessionStateChangedEvent extends chrome.events.Event<(sessionState: SessionState) => void> {}
@@ -5913,9 +5943,9 @@ declare namespace chrome {
     // Management
     ////////////////////
     /**
-     * The chrome.management API provides ways to manage the list of extensions/apps that are installed and running. It is particularly useful for extensions that override the built-in New Tab page.
-     * Permissions:  "management"
-     * @since Chrome 8
+     * The `chrome.management` API provides ways to manage installed apps and extensions.
+     *
+     * Permissions: "management"
      */
     export namespace management {
         /** Information about an installed extension, app, or theme. */
@@ -6233,7 +6263,7 @@ declare namespace chrome {
     }
 
     ////////////////////
-    // Notifications
+    // Networking
     ////////////////////
     /**
      * Use the networking.config API to authenticate to captive portals.
@@ -6283,12 +6313,11 @@ declare namespace chrome {
 
     ////////////////////
     // Notifications
-    // https://developer.chrome.com/extensions/notifications
     ////////////////////
     /**
-     * Use the chrome.notifications API to create rich notifications using templates and show these notifications to users in the system tray.
-     * Permissions:  "notifications"
-     * @since Chrome 28
+     * Use the `chrome.notifications` API to create rich notifications using templates and show these notifications to users in the system tray.
+     *
+     * Permissions: "notifications"
      */
     export namespace notifications {
         export type TemplateType = "basic" | "image" | "list" | "progress";
@@ -6472,9 +6501,10 @@ declare namespace chrome {
     // Offscreen
     ////////////////////
     /**
-     * Use the offscreen API to create and manage offscreen documents.
-     * @since Chrome 109, MV3
+     * Use the `offscreen` API to create and manage offscreen documents.
+     *
      * Permissions: "offscreen"
+     * @since Chrome 109, MV3
      */
     export namespace offscreen {
         /** The reason(s) the extension is creating the offscreen document. */
@@ -6562,8 +6592,8 @@ declare namespace chrome {
     ////////////////////
     /**
      * The omnibox API allows you to register a keyword with Google Chrome's address bar, which is also known as the omnibox.
-     * Manifest:  "omnibox": {...}
-     * @since Chrome 9
+     *
+     * Manifest: "omnibox"
      */
     export namespace omnibox {
         /** A suggest result. */
@@ -6626,9 +6656,11 @@ declare namespace chrome {
     // Page Action
     ////////////////////
     /**
-     * Use the chrome.pageAction API to put icons inside the address bar. Page actions represent actions that can be taken on the current page, but that aren't applicable to all pages.
-     * Manifest:  "page_action": {...}
-     * @since Chrome 5
+     * Use the `chrome.pageAction` API to put icons in the main Google Chrome toolbar, to the right of the address bar. Page actions represent actions that can be taken on the current page, but that aren't applicable to all pages. Page actions appear grayed out when inactive.
+     *
+     * Manifest: "page_action"
+     *
+     * MV2 only
      */
     export namespace pageAction {
         export interface PageActionClickedEvent extends chrome.events.Event<(tab: chrome.tabs.Tab) => void> {}
@@ -6717,9 +6749,9 @@ declare namespace chrome {
     // Page Capture
     ////////////////////
     /**
-     * Use the chrome.pageCapture API to save a tab as MHTML.
-     * Permissions:  "pageCapture"
-     * @since Chrome 18
+     * Use the `chrome.pageCapture` API to save a tab as MHTML.
+     *
+     * Permissions: "pageCapture"
      */
     export namespace pageCapture {
         export interface SaveDetails {
@@ -6744,8 +6776,7 @@ declare namespace chrome {
     // Permissions
     ////////////////////
     /**
-     * Use the chrome.permissions API to request declared optional permissions at run time rather than install time, so users understand why the permissions are needed and grant only those that are necessary.
-     * @since Chrome 16
+     * Use the `chrome.permissions` API to request declared optional permissions at run time rather than install time, so users understand why the permissions are needed and grant only those that are necessary.
      */
     export namespace permissions {
         export interface Permissions {
@@ -6798,9 +6829,10 @@ declare namespace chrome {
     // Platform Keys
     ////////////////////
     /**
-     * Use the chrome.platformKeys API to access client certificates managed by the platform. If the user or policy grants the permission, an extension can use such a certficate in its custom authentication protocol. E.g. this allows usage of platform managed certificates in third party VPNs (see chrome.vpnProvider).
-     * Permissions:  "platformKeys"
-     * Important: This API works only on Chrome OS.
+     * Use the `chrome.platformKeys` API to access client certificates managed by the platform. If the user or policy grants the permission, an extension can use such a certficate in its custom authentication protocol. E.g. this allows usage of platform managed certificates in third party VPNs (see chrome.vpnProvider).
+     *
+     * Permissions: "platformKeys"
+     * @platform ChromeOS only
      * @since Chrome 45
      */
     export namespace platformKeys {
@@ -6896,9 +6928,9 @@ declare namespace chrome {
     // Power
     ////////////////////
     /**
-     * Use the chrome.power API to override the system's power management features.
+     * Use the `chrome.power` API to override the system's power management features.
+     *
      * Permissions: "power"
-     * @since Chrome 27
      */
     export namespace power {
         export enum Level {
@@ -6928,8 +6960,9 @@ declare namespace chrome {
     // Printer Provider
     ////////////////////
     /**
-     * The chrome.printerProvider API exposes events used by print manager to query printers controlled by extensions, to query their capabilities and to submit print jobs to these printers.
-     * Permissions:  "printerProvider"
+     * The `chrome.printerProvider` API exposes events used by print manager to query printers controlled by extensions, to query their capabilities and to submit print jobs to these printers.
+     *
+     * Permissions: "printerProvider"
      * @since Chrome 44
      */
     export namespace printerProvider {
@@ -6996,12 +7029,12 @@ declare namespace chrome {
     // Printing
     ////////////////////
     /**
- * Use the chrome.printing API to send print jobs to printers installed on Chromebook.
+     * Use the `chrome.printing` API to send print jobs to printers installed on Chromebook.
 
- * Permissions: "printing"
- * @platform ChromeOS only
- * @since Chrome 81
- */
+    * Permissions: "printing"
+    * @platform ChromeOS only
+    * @since Chrome 81
+    */
     export namespace printing {
         export interface GetPrinterInfoResponse {
             /** Printer capabilities in [CDD format](https://developers.google.com/cloud-print/docs/cdd#cdd-example). The property may be missing. */
@@ -7149,11 +7182,11 @@ declare namespace chrome {
     // Printing Metrics
     ////////////////////
     /**
-     * Use the chrome.printingMetrics API to fetch data about printing usage.
+     * Use the `chrome.printingMetrics` API to fetch data about printing usage.
      *
      * Permissions: "printingMetrics"
      *
-     * Note: This API is only for extensions pre-installed by policy.
+     * Note: Only available to policy installed extensions.
      * @platform ChromeOS only
      * @since Chrome 79
      */
@@ -7279,10 +7312,10 @@ declare namespace chrome {
     // Privacy
     ////////////////////
     /**
-     * Use the chrome.privacy API to control usage of the features in Chrome that can affect a user's privacy. This API relies on the ChromeSetting prototype of the type API for getting and setting Chrome's configuration.
-     * Permissions:  "privacy"
-     * The Chrome Privacy Whitepaper gives background detail regarding the features which this API can control.
-     * @since Chrome 18
+     * Use the `chrome.privacy` API to control usage of the features in Chrome that can affect a user's privacy. This API relies on the ChromeSetting prototype of the type API for getting and setting Chrome's configuration.
+     * Note: The Chrome Privacy Whitepaper gives background detail regarding the features which this API can control.
+     *
+     * Permissions: "privacy"
      */
     export namespace privacy {
         /**
@@ -7342,9 +7375,9 @@ declare namespace chrome {
     // Proxy
     ////////////////////
     /**
-     * Use the chrome.proxy API to manage Chrome's proxy settings. This API relies on the ChromeSetting prototype of the type API for getting and setting the proxy configuration.
-     * Permissions:  "proxy"
-     * @since Chrome 13
+     * Use the `chrome.proxy` API to manage Chrome's proxy settings. This API relies on the ChromeSetting prototype of the type API for getting and setting the proxy configuration.
+     *
+     * Permissions: "proxy"
      */
     export namespace proxy {
         /** An object holding proxy auto-config information. Exactly one of the fields should be non-empty. */
@@ -7419,10 +7452,11 @@ declare namespace chrome {
     // Search
     ////////////////////
     /**
-     * Use the chrome.search API to search via the default provider.
-     * Permissions:  "search"
+     * Use the `chrome.search` API to search via the default provider.
+     *
+     * Permissions: "search"
+     * @since Chrome 87
      */
-
     export namespace search {
         export type Disposition = "CURRENT_TAB" | "NEW_TAB" | "NEW_WINDOW";
 
@@ -7724,8 +7758,7 @@ declare namespace chrome {
     // Runtime
     ////////////////////
     /**
-     * Use the chrome.runtime API to retrieve the background page, return details about the manifest, and listen for and respond to events in the app or extension lifecycle. You can also use this API to convert the relative path of URLs to fully-qualified URLs.
-     * @since Chrome 22
+     * Use the `chrome.runtime` API to retrieve the service worker, return details about the manifest, and listen for and respond to events in the extension lifecycle. You can also use this API to convert the relative path of URLs to fully-qualified URLs.
      */
     export namespace runtime {
         /** This will be defined during an API method callback if there was an error */
@@ -8600,7 +8633,8 @@ declare namespace chrome {
     // Scripting
     ////////////////////
     /**
-     * Use the chrome.scripting API to execute script in different contexts.
+     * Use the `chrome.scripting` API to execute script in different contexts.
+     *
      * Permissions: "scripting"
      * @since Chrome 88, MV3
      */
@@ -8852,9 +8886,9 @@ declare namespace chrome {
     // Sessions
     ////////////////////
     /**
-     * Use the chrome.sessions API to query and restore tabs and windows from a browsing session.
-     * Permissions:  "sessions"
-     * @since Chrome 37
+     * Use the `chrome.sessions` API to query and restore tabs and windows from a browsing session.
+     *
+     * Permissions: "sessions"
      */
     export namespace sessions {
         export interface Filter {
@@ -8956,9 +8990,9 @@ declare namespace chrome {
     // Storage
     ////////////////////
     /**
-     * Use the chrome.storage API to store, retrieve, and track changes to user data.
-     * Permissions:  "storage"
-     * @since Chrome 20
+     * Use the `chrome.storage` API to store, retrieve, and track changes to user data.
+     *
+     * Permissions: "storage"
      */
     export namespace storage {
         /** NoInfer for old TypeScript versions */
@@ -9267,9 +9301,9 @@ declare namespace chrome {
     // System CPU
     ////////////////////
     /**
-     * Use the system.cpu API to query CPU metadata.
+     * Use the `system.cpu` API to query CPU metadata.
+     *
      * Permissions: "system.cpu"
-     * @since Chrome 32
      */
     export namespace system.cpu {
         export interface ProcessorUsage {
@@ -9318,9 +9352,9 @@ declare namespace chrome {
     // System Memory
     ////////////////////
     /**
-     * The chrome.system.memory API.
-     * Permissions:  "system.memory"
-     * @since Chrome 32
+     * The `chrome.system.memory` API.
+     *
+     * Permissions: "system.memory"
      */
     export namespace system.memory {
         export interface MemoryInfo {
@@ -9344,9 +9378,9 @@ declare namespace chrome {
     // System Storage
     ////////////////////
     /**
-     * Use the chrome.system.storage API to query storage device information and be notified when a removable storage device is attached and detached.
-     * Permissions:  "system.storage"
-     * @since Chrome 30
+     * Use the `chrome.system.storage` API to query storage device information and be notified when a removable storage device is attached and detached.
+     *
+     * Permissions: "system.storage"
      */
     export namespace system.storage {
         export interface StorageUnitInfo {
@@ -9418,9 +9452,9 @@ declare namespace chrome {
     // System Display //
     ////////////////////
     /**
-     * Use the system.display API to query display metadata.
+     * Use the `system.display` API to query display metadata.
+     *
      * Permissions: "system.display"
-     * @since Chrome 30
      */
     export namespace system.display {
         export enum LayoutPosition {
@@ -9896,11 +9930,11 @@ declare namespace chrome {
     // SystemLog
     ////////////////////
     /**
-     * Use the chrome.systemLog API to record Chrome system logs from extensions.
+     * Use the `chrome.systemLog` API to record Chrome system logs from extensions.
      *
      * Permissions: "systemLog"
      *
-     * Note: This API is only for extensions pre-installed by policy.
+     * Note: Only available to policy installed extensions.
      * @platform ChromeOS only
      * @since Chrome 125
      */
@@ -9921,9 +9955,9 @@ declare namespace chrome {
     // TabCapture
     ////////////////////
     /**
-     * Use the chrome.tabCapture API to interact with tab media streams.
-     * Permissions:  "tabCapture"
-     * @since Chrome 31
+     * Use the `chrome.tabCapture` API to interact with tab media streams.
+     *
+     * Permissions: "tabCapture"
      */
     export namespace tabCapture {
         export interface CaptureInfo {
@@ -9990,9 +10024,9 @@ declare namespace chrome {
     // Tabs
     ////////////////////
     /**
-     * Use the chrome.tabs API to interact with the browser's tab system. You can use this API to create, modify, and rearrange tabs in the browser.
+     * Use the `chrome.tabs` API to interact with the browser's tab system. You can use this API to create, modify, and rearrange tabs in the browser.
+     *
      * Permissions: The majority of the chrome.tabs API can be used without declaring any permission. However, the "tabs" permission is required in order to populate the url, title, and favIconUrl properties of Tab.
-     * @since Chrome 5
      */
     export namespace tabs {
         /**
@@ -10124,7 +10158,7 @@ declare namespace chrome {
              */
             groupId: number;
             /**
-             * The last time the tab was accessed as the number of milliseconds since epoch.
+             * The last time the tab became active in its window as the number of milliseconds since epoch.
              * @since Chrome 121
              */
             lastAccessed?: number | undefined;
@@ -11224,8 +11258,9 @@ declare namespace chrome {
     // Tab Groups
     ////////////////////
     /**
-     * Use the chrome.tabGroups API to interact with the browser's tab grouping system. You can use this API to modify and rearrange tab groups in the browser. To group and ungroup tabs, or to query what tabs are in groups, use the chrome.tabs API.
-     * Permissions:  "tabGroups"
+     * Use the `chrome.tabGroups` API to interact with the browser's tab grouping system. You can use this API to modify and rearrange tab groups in the browser. To group and ungroup tabs, or to query what tabs are in groups, use the `chrome.tabs` API.
+     *
+     * Permissions: "tabGroups"
      * @since Chrome 89, MV3
      */
     export namespace tabGroups {
@@ -11361,9 +11396,9 @@ declare namespace chrome {
     // Top Sites
     ////////////////////
     /**
-     * Use the chrome.topSites API to access the top sites that are displayed on the new tab page.
-     * Permissions:  "topSites"
-     * @since Chrome 19
+     * Use the `chrome.topSites` API to access the top sites (i.e. most visited sites) that are displayed on the new tab page. These do not include shortcuts customized by the user.
+     *
+     * Permissions: "topSites"
      */
     export namespace topSites {
         /** An object encapsulating a most visited URL, such as the URLs on the new tab page. */
@@ -11388,9 +11423,9 @@ declare namespace chrome {
     // Text to Speech
     ////////////////////
     /**
-     * Use the chrome.tts API to play synthesized text-to-speech (TTS). See also the related ttsEngine API, which allows an extension to implement a speech engine.
-     * Permissions:  "tts"
-     * @since Chrome 14
+     * Use the `chrome.tts` API to play synthesized text-to-speech (TTS). See also the related ttsEngine API, which allows an extension to implement a speech engine.
+     *
+     * Permissions: "tts"
      */
     export namespace tts {
         /** An event from the TTS engine to communicate the status of an utterance. */
@@ -11521,9 +11556,9 @@ declare namespace chrome {
     // Text to Speech Engine
     ////////////////////
     /**
-     * Use the chrome.ttsEngine API to implement a text-to-speech(TTS) engine using an extension. If your extension registers using this API, it will receive events containing an utterance to be spoken and other parameters when any extension or Chrome App uses the tts API to generate speech. Your extension can then use any available web technology to synthesize and output the speech, and send events back to the calling function to report the status.
-     * Permissions:  "ttsEngine"
-     * @since Chrome 14
+     * Use the `chrome.ttsEngine` API to implement a text-to-speech(TTS) engine using an extension. If your extension registers using this API, it will receive events containing an utterance to be spoken and other parameters when any extension or Chrome App uses the {@link tts} API to generate speech. Your extension can then use any available web technology to synthesize and output the speech, and send events back to the calling function to report the status.
+     *
+     * Permissions: "ttsEngine"
      */
     export namespace ttsEngine {
         export interface SpeakOptions {
@@ -11573,8 +11608,7 @@ declare namespace chrome {
     // Types
     ////////////////////
     /**
-     * The chrome.types API contains type declarations for Chrome.
-     * @since Chrome 13
+     * The `chrome.types` API contains type declarations for Chrome.
      */
     export namespace types {
         /**
@@ -11685,9 +11719,10 @@ declare namespace chrome {
     // VPN Provider
     ////////////////////
     /**
-     * Use the chrome.vpnProvider API to implement a VPN client.
-     * Permissions:  "vpnProvider"
-     * Important: This API works only on Chrome OS.
+     * Use the `chrome.vpnProvider` API to implement a VPN client.
+     *
+     * Permissions: "vpnProvider"
+     * @platform ChromeOS only
      * @since Chrome 43
      */
     export namespace vpnProvider {
@@ -11776,9 +11811,10 @@ declare namespace chrome {
     // Wallpaper
     ////////////////////
     /**
-     * Use the chrome.wallpaper API to change the ChromeOS wallpaper.
-     * Permissions:  "wallpaper"
-     * Important: This API works only on Chrome OS.
+     * Use the `chrome.wallpaper` API to change the ChromeOS wallpaper.
+     *
+     * Permissions: "wallpaper"
+     * @platform ChromeOS only
      * @since Chrome 43
      */
     export namespace wallpaper {
@@ -11810,9 +11846,9 @@ declare namespace chrome {
     // Web Navigation
     ////////////////////
     /**
-     * Use the chrome.webNavigation API to receive notifications about the status of navigation requests in-flight.
-     * Permissions:  "webNavigation"
-     * @since Chrome 16
+     * Use the `chrome.webNavigation` API to receive notifications about the status of navigation requests in-flight.
+     *
+     * Permissions: "webNavigation"
      */
     export namespace webNavigation {
         export interface GetFrameDetails {
@@ -12023,9 +12059,11 @@ declare namespace chrome {
     // Web Request
     ////////////////////
     /**
-     * Use the chrome.webRequest API to observe and analyze traffic and to intercept, block, or modify requests in-flight.
-     * Permissions:  "webRequest", host permissions
-     * @since Chrome 17
+     * Use the `chrome.webRequest` API to observe and analyze traffic and to intercept, block, or modify requests in-flight.
+     *
+     * Permissions: "webRequest"
+     *
+     * Manifest: "host_permissions"
      */
     export namespace webRequest {
         interface WebRequestEvent<T extends Function, U extends string[]>
@@ -12433,9 +12471,9 @@ declare namespace chrome {
     // Windows
     ////////////////////
     /**
-     * Use the chrome.windows API to interact with browser windows. You can use this API to create, modify, and rearrange windows in the browser.
+     * Use the `chrome.windows` API to interact with browser windows. You can use this API to create, modify, and rearrange windows in the browser.
+     *
      * Permissions: The chrome.windows API can be used without declaring any permission. However, the "tabs" permission is required in order to populate the url, title, and favIconUrl properties of Tab objects.
-     * @since Chrome 5
      */
     export namespace windows {
         export interface Window {
@@ -12768,6 +12806,17 @@ declare namespace chrome {
         export var onBoundsChanged: WindowReferenceEvent;
     }
 
+    ////////////////////
+    // declarativeNetRequest
+    ////////////////////
+    /**
+     * The `chrome.declarativeNetRequest` API is used to block or modify network requests by specifying declarative rules. This lets extensions modify network requests without intercepting them and viewing their content, thus providing more privacy.
+     *
+     * Permissions: "declarativeNetRequest", "declarativeNetRequestWithHostAccess", "declarativeNetRequestFeedback"
+     *
+     * Manifest: "host_permissions"
+     * @since Chrome 84
+     */
     export namespace declarativeNetRequest {
         /** Ruleset ID for the dynamic rules added by the extension. */
         export const DYNAMIC_RULESET_ID: "_dynamic";
@@ -13596,9 +13645,10 @@ declare namespace chrome {
     // SidePanel
     ////////////////////
     /**
-     * @since Chrome 114, MV3
-     * https://developer.chrome.com/docs/extensions/reference/api/sidePanel
+     * Use the `chrome.sidePanel` API to host content in the browser's side panel alongside the main content of a webpage.
+     *
      * Permissions: "sidePanel"
+     * @since Chrome 114, MV3
      */
     export namespace sidePanel {
         export interface GetPanelOptions {
@@ -13739,15 +13789,15 @@ declare namespace chrome {
         ): Promise<void>;
     }
 
-    // Type definitions for chrome.userScripts API
-
+    ////////////////////
+    // User Scripts
+    ////////////////////
     /**
-     * Availability: Chrome 120 beta. Manifest v3.
-     * https://developer.chrome.com/docs/extensions/reference/api/userScripts
+     * Use the `userScripts` API to execute user scripts in the User Scripts context.
+     *
      * Permissions: "userScripts"
-     * Description: "A user script is a bit of code injected into a web page to modify its appearance or behavior. Scripts are either created by users or downloaded from a script repository or a user script extension.""
+     * @since Chrome 120, MV3
      */
-
     export namespace userScripts {
         /**
          * Execution environment for a user script.

chrome/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/chrome",
-    "version": "0.0.293",
+    "version": "0.0.294",
     "description": "TypeScript definitions for chrome",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome",
     "license": "MIT",
@@ -94,6 +94,6 @@
         "@types/har-format": "*"
     },
     "peerDependencies": {},
-    "typesPublisherContentHash": "3562b0db015921b752bed042f4f84e49c863b177ba1695d426f93a479b4c3f62",
+    "typesPublisherContentHash": "ee5173779b32ec36ced6918cfdf3e272c65479c5642f0cfcc39c0a9ac51cdbad",
     "typeScriptVersion": "5.0"
 }