@types/chrome 0.1.10 → 0.1.12

chrome/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for chrome (https://developer.chrome.com/
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome.
 
 ### Additional Details
- * Last updated: Fri, 12 Sep 2025 19:02:26 GMT
+ * Last updated: Tue, 16 Sep 2025 21:32:23 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

@@ -5348,212 +5348,382 @@ declare namespace chrome {
             fontId: string;
         }
 
-        export interface DefaultFontSizeDetails {
-            /** The font size in pixels. */
-            pixelSize: number;
-        }
-
-        export interface FontDetails {
-            /** The generic font family for the font. */
-            genericFamily:
-                | "cursive"
-                | "fantasy"
-                | "fixed"
-                | "sansserif"
-                | "serif"
-                | "standard";
-            /** Optional. The script for the font. If omitted, the global script font setting is affected.  */
-            script?: string | undefined;
+        /** A CSS generic font family. */
+        export enum GenericFamily {
+            STANDARD = "standard",
+            SANSSERIF = "sansserif",
+            SERIF = "serif",
+            FIXED = "fixed",
+            CURSIVE = "cursive",
+            FANTASY = "fantasy",
+            MATH = "math",
+        }
+
+        export enum LevelOfControl {
+            /** Cannot be controlled by any extension */
+            NOT_CONTROLLABLE = "not_controllable",
+            /** Controlled by extensions with higher precedence */
+            CONTROLLED_BY_OTHER_EXTENSIONS = "controlled_by_other_extensions",
+            /** Can be controlled by this extension */
+            CONTROLLABLE_BY_THIS_EXTENSION = "controllable_by_this_extension",
+            /** Controlled by this extension */
+            CONTROLLED_BY_THIS_EXTENSION = "controlled_by_this_extension",
+        }
+
+        /** An ISO 15924 script code. The default, or global, script is represented by script code "Zyyy". */
+        export enum ScriptCode {
+            AFAK = "Afak",
+            ARAB = "Arab",
+            ARMI = "Armi",
+            ARMN = "Armn",
+            AVST = "Avst",
+            BALI = "Bali",
+            BAMU = "Bamu",
+            BASS = "Bass",
+            BATK = "Batk",
+            BENG = "Beng",
+            BLIS = "Blis",
+            BOPO = "Bopo",
+            BRAH = "Brah",
+            BRAI = "Brai",
+            BUGI = "Bugi",
+            BUHD = "Buhd",
+            CAKM = "Cakm",
+            CANS = "Cans",
+            CARI = "Cari",
+            CHAM = "Cham",
+            CHER = "Cher",
+            CIRT = "Cirt",
+            COPT = "Copt",
+            CPRT = "Cprt",
+            CYRL = "Cyrl",
+            CYRS = "Cyrs",
+            DEVA = "Deva",
+            DSRT = "Dsrt",
+            DUPL = "Dupl",
+            EGYD = "Egyd",
+            EGYH = "Egyh",
+            EGYP = "Egyp",
+            ELBA = "Elba",
+            ETHI = "Ethi",
+            GEOK = "Geok",
+            GEOR = "Geor",
+            GLAG = "Glag",
+            GOTH = "Goth",
+            GRAN = "Gran",
+            GREK = "Grek",
+            GUJR = "Gujr",
+            GURU = "Guru",
+            HANG = "Hang",
+            HANI = "Hani",
+            HANO = "Hano",
+            HANS = "Hans",
+            HANT = "Hant",
+            HEBR = "Hebr",
+            HLUW = "Hluw",
+            HMNG = "Hmng",
+            HUNG = "Hung",
+            INDS = "Inds",
+            ITAL = "Ital",
+            JAVA = "Java",
+            JPAN = "Jpan",
+            JURC = "Jurc",
+            KALI = "Kali",
+            KHAR = "Khar",
+            KHMR = "Khmr",
+            KHOJ = "Khoj",
+            KNDA = "Knda",
+            KPEL = "Kpel",
+            KTHI = "Kthi",
+            LANA = "Lana",
+            LAOO = "Laoo",
+            LATF = "Latf",
+            LATG = "Latg",
+            LATN = "Latn",
+            LEPC = "Lepc",
+            LIMB = "Limb",
+            LINA = "Lina",
+            LINB = "Linb",
+            LISU = "Lisu",
+            LOMA = "Loma",
+            LYCI = "Lyci",
+            LYDI = "Lydi",
+            MAND = "Mand",
+            MANI = "Mani",
+            MAYA = "Maya",
+            MEND = "Mend",
+            MERC = "Merc",
+            MERO = "Mero",
+            MLYM = "Mlym",
+            MONG = "Mong",
+            MOON = "Moon",
+            MROO = "Mroo",
+            MTEI = "Mtei",
+            MYMR = "Mymr",
+            NARB = "Narb",
+            NBAT = "Nbat",
+            NKGB = "Nkgb",
+            NKOO = "Nkoo",
+            NSHU = "Nshu",
+            OGAM = "Ogam",
+            OLCK = "Olck",
+            ORKH = "Orkh",
+            ORYA = "Orya",
+            OSMA = "Osma",
+            PALM = "Palm",
+            PERM = "Perm",
+            PHAG = "Phag",
+            PHLI = "Phli",
+            PHLP = "Phlp",
+            PHLV = "Phlv",
+            PHNX = "Phnx",
+            PLRD = "Plrd",
+            PRTI = "Prti",
+            RJNG = "Rjng",
+            RORO = "Roro",
+            RUNR = "Runr",
+            SAMR = "Samr",
+            SARA = "Sara",
+            SARB = "Sarb",
+            SAUR = "Saur",
+            SGNW = "Sgnw",
+            SHAW = "Shaw",
+            SHRD = "Shrd",
+            SIND = "Sind",
+            SINH = "Sinh",
+            SORA = "Sora",
+            SUND = "Sund",
+            SYLO = "Sylo",
+            SYRC = "Syrc",
+            SYRE = "Syre",
+            SYRJ = "Syrj",
+            SYRN = "Syrn",
+            TAGB = "Tagb",
+            TAKR = "Takr",
+            TALE = "Tale",
+            TALU = "Talu",
+            TAML = "Taml",
+            TANG = "Tang",
+            TAVT = "Tavt",
+            TELU = "Telu",
+            TENG = "Teng",
+            TFNG = "Tfng",
+            TGLG = "Tglg",
+            THAA = "Thaa",
+            THAI = "Thai",
+            TIBT = "Tibt",
+            TIRH = "Tirh",
+            UGAR = "Ugar",
+            VAII = "Vaii",
+            VISP = "Visp",
+            WARA = "Wara",
+            WOLE = "Wole",
+            XPEO = "Xpeo",
+            XSUX = "Xsux",
+            YIII = "Yiii",
+            ZMTH = "Zmth",
+            ZSYM = "Zsym",
+            ZYYY = "Zyyy",
+        }
+
+        export interface ClearFontDetails {
+            /** The generic font family for which the font should be cleared. */
+            genericFamily: `${GenericFamily}`;
+            /** The script for which the font should be cleared. If omitted, the global script font setting is cleared. */
+            script?: `${ScriptCode}` | undefined;
+        }
+
+        export interface GetFontDetails {
+            /** The generic font family for which the font should be retrieved. */
+            genericFamily: `${GenericFamily}`;
+            /** The script for which the font should be retrieved. If omitted, the font setting for the global script (script code "Zyyy") is retrieved. */
+            script?: `${ScriptCode}` | undefined;
+        }
+
+        export interface SetFontDetails {
+            /** The font ID. The empty string means to fallback to the global script font setting. */
+            fontId: string;
+            /** The generic font family for which the font should be set. */
+            genericFamily: `${GenericFamily}`;
+            /** The script code which the font should be set. If omitted, the font setting for the global script (script code "Zyyy") is set. */
+            script?: `${ScriptCode}` | undefined;
         }
 
-        export interface FullFontDetails {
+        export interface FontChangedResult {
             /** The generic font family for which the font setting has changed. */
-            genericFamily: string;
+            genericFamily: `${GenericFamily}`;
             /** The level of control this extension has over the setting. */
-            levelOfControl: string;
+            levelOfControl: `${LevelOfControl}`;
             /** Optional. The script code for which the font setting has changed.  */
-            script?: string | undefined;
-            /** The font ID. See the description in getFont. */
+            script?: `${ScriptCode}`;
+            /** The font ID. See the description in {@link getFont}. */
             fontId: string;
         }
 
-        export interface FontDetailsResult {
+        export interface FontResult {
             /** The level of control this extension has over the setting. */
-            levelOfControl: string;
-            /** The font ID. Rather than the literal font ID preference value, this may be the ID of the font that the system resolves the preference value to. So, fontId can differ from the font passed to setFont, if, for example, the font is not available on the system. The empty string signifies fallback to the global script font setting. */
+            levelOfControl: `${LevelOfControl}`;
+            /** The font ID. Rather than the literal font ID preference value, this may be the ID of the font that the system resolves the preference value to. So, `fontId` can differ from the font passed to {@link setFont}, if, for example, the font is not available on the system. The empty string signifies fallback to the global script font setting. */
             fontId: string;
         }
 
-        export interface FontSizeDetails {
+        export interface FontSizeResult {
             /** The font size in pixels. */
             pixelSize: number;
             /** The level of control this extension has over the setting. */
-            levelOfControl: string;
+            levelOfControl: `${LevelOfControl}`;
         }
 
-        export interface SetFontSizeDetails {
+        export interface FontSizeDetails {
             /** The font size in pixels. */
             pixelSize: number;
         }
 
-        export interface SetFontDetails extends FontDetails {
-            /** The font ID. The empty string means to fallback to the global script font setting. */
-            fontId: string;
-        }
-
-        export interface DefaultFixedFontSizeChangedEvent
-            extends chrome.events.Event<(details: FontSizeDetails) => void>
-        {}
-
-        export interface DefaultFontSizeChangedEvent extends chrome.events.Event<(details: FontSizeDetails) => void> {}
-
-        export interface MinimumFontSizeChangedEvent extends chrome.events.Event<(details: FontSizeDetails) => void> {}
-
-        export interface FontChangedEvent extends chrome.events.Event<(details: FullFontDetails) => void> {}
-
         /**
          * Sets the default font size.
-         * @return The `setDefaultFontSize` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
-         */
-        export function setDefaultFontSize(details: DefaultFontSizeDetails): Promise<void>;
-        /**
-         * Sets the default font size.
-         */
-        export function setDefaultFontSize(details: DefaultFontSizeDetails, callback: () => void): void;
-        /**
-         * Gets the font for a given script and generic font family.
-         * @return The `getFont` method provides its result via callback or returned as a `Promise` (MV3 only).
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
-        export function getFont(details: FontDetails): Promise<FontDetailsResult>;
+        export function setDefaultFontSize(details: FontSizeDetails): Promise<void>;
+        export function setDefaultFontSize(details: FontSizeDetails, callback: () => void): void;
+
         /**
          * Gets the font for a given script and generic font family.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
-        export function getFont(details: FontDetails, callback: (details: FontDetailsResult) => void): void;
-        /**
-         * Gets the default font size.
-         * @param details This parameter is currently unused.
-         * @return The `getDefaultFontSize` method provides its result via callback or returned as a `Promise` (MV3 only).
-         */
-        export function getDefaultFontSize(details?: unknown): Promise<FontSizeDetails>;
+        export function getFont(details: GetFontDetails): Promise<FontResult>;
+        export function getFont(details: GetFontDetails, callback: (details: FontResult) => void): void;
+
         /**
          * Gets the default font size.
          * @param details This parameter is currently unused.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
-        export function getDefaultFontSize(callback: (options: FontSizeDetails) => void): void;
-        export function getDefaultFontSize(details: unknown, callback: (options: FontSizeDetails) => void): void;
-        /**
-         * Gets the minimum font size.
-         * @param details This parameter is currently unused.
-         * @return The `getMinimumFontSize` method provides its result via callback or returned as a `Promise` (MV3 only).
-         */
-        export function getMinimumFontSize(details?: unknown): Promise<FontSizeDetails>;
+        export function getDefaultFontSize(details?: { [key: string]: unknown }): Promise<FontSizeResult>;
+        export function getDefaultFontSize(callback: (options: FontSizeResult) => void): void;
+        export function getDefaultFontSize(
+            details: { [key: string]: unknown } | undefined,
+            callback: (options: FontSizeResult) => void,
+        ): void;
+
         /**
          * Gets the minimum font size.
          * @param details This parameter is currently unused.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
-        export function getMinimumFontSize(callback: (options: FontSizeDetails) => void): void;
-        export function getMinimumFontSize(details: unknown, callback: (options: FontSizeDetails) => void): void;
-        /**
-         * Sets the minimum font size.
-         * @return The `setMinimumFontSize` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
-         */
-        export function setMinimumFontSize(details: SetFontSizeDetails): Promise<void>;
+        export function getMinimumFontSize(details?: { [key: string]: unknown }): Promise<FontSizeResult>;
+        export function getMinimumFontSize(callback: (options: FontSizeResult) => void): void;
+        export function getMinimumFontSize(
+            details: { [key: string]: unknown } | undefined,
+            callback: (options: FontSizeResult) => void,
+        ): void;
+
         /**
          * Sets the minimum font size.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
-        export function setMinimumFontSize(details: SetFontSizeDetails, callback: () => void): void;
-        /**
-         * Gets the default size for fixed width fonts.
-         * @param details This parameter is currently unused.
-         * @return The `getDefaultFixedFontSize` method provides its result via callback or returned as a `Promise` (MV3 only).
-         */
-        export function getDefaultFixedFontSize(details?: unknown): Promise<FontSizeDetails>;
+        export function setMinimumFontSize(details: FontSizeDetails): Promise<void>;
+        export function setMinimumFontSize(details: FontSizeDetails, callback: () => void): void;
+
         /**
          * Gets the default size for fixed width fonts.
          * @param details This parameter is currently unused.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
-        export function getDefaultFixedFontSize(callback: (details: FontSizeDetails) => void): void;
-        export function getDefaultFixedFontSize(details: unknown, callback: (details: FontSizeDetails) => void): void;
-        /**
-         * Clears the default font size set by this extension, if any.
-         * @param details This parameter is currently unused.
-         * @return The `clearDefaultFontSize` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
-         */
-        export function clearDefaultFontSize(details?: unknown): Promise<void>;
+        export function getDefaultFixedFontSize(details?: { [key: string]: unknown }): Promise<FontSizeResult>;
+        export function getDefaultFixedFontSize(callback: (details: FontSizeResult) => void): void;
+        export function getDefaultFixedFontSize(
+            details: { [key: string]: unknown } | undefined,
+            callback: (details: FontSizeResult) => void,
+        ): void;
+
         /**
          * Clears the default font size set by this extension, if any.
          * @param details This parameter is currently unused.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
+        export function clearDefaultFontSize(details?: { [key: string]: unknown }): Promise<void>;
         export function clearDefaultFontSize(callback: () => void): void;
-        export function clearDefaultFontSize(details: unknown, callback: () => void): void;
-        /**
-         * Sets the default size for fixed width fonts.
-         * @return The `setDefaultFixedFontSize` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
-         */
-        export function setDefaultFixedFontSize(details: SetFontSizeDetails): Promise<void>;
+        export function clearDefaultFontSize(
+            details: { [key: string]: unknown } | undefined,
+            callback: () => void,
+        ): void;
+
         /**
          * Sets the default size for fixed width fonts.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
-        export function setDefaultFixedFontSize(details: SetFontSizeDetails, callback: () => void): void;
-        /**
-         * Clears the font set by this extension, if any.
-         * @return The `clearFont` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
-         */
-        export function clearFont(details: FontDetails): Promise<void>;
+        export function setDefaultFixedFontSize(details: FontSizeDetails): Promise<void>;
+        export function setDefaultFixedFontSize(details: FontSizeDetails, callback: () => void): void;
+
         /**
          * Clears the font set by this extension, if any.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
-        export function clearFont(details: FontDetails, callback: () => void): void;
+        export function clearFont(details: ClearFontDetails): Promise<void>;
+        export function clearFont(details: ClearFontDetails, callback: () => void): void;
+
         /**
          * Sets the font for a given script and generic font family.
-         * @return The `setFont` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function setFont(details: SetFontDetails): Promise<void>;
-        /**
-         * Sets the font for a given script and generic font family.
-         */
         export function setFont(details: SetFontDetails, callback: () => void): void;
+
         /**
          * Clears the minimum font size set by this extension, if any.
          * @param details This parameter is currently unused.
-         * @return The `clearMinimumFontSize` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
-         */
-        export function clearMinimumFontSize(details?: unknown): Promise<void>;
-        /**
-         * Clears the minimum font size set by this extension, if any.
-         * @param details This parameter is currently unused.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
+        export function clearMinimumFontSize(details?: { [key: string]: unknown }): Promise<void>;
         export function clearMinimumFontSize(callback: () => void): void;
-        export function clearMinimumFontSize(details: unknown, callback: () => void): void;
+        export function clearMinimumFontSize(
+            details: { [key: string]: unknown } | undefined,
+            callback: () => void,
+        ): void;
+
         /**
          * Gets a list of fonts on the system.
-         * @return The `getFontList` method provides its result via callback or returned as a `Promise` (MV3 only).
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function getFontList(): Promise<FontName[]>;
-        /**
-         * Gets a list of fonts on the system.
-         */
         export function getFontList(callback: (results: FontName[]) => void): void;
+
         /**
          * Clears the default fixed font size set by this extension, if any.
          * @param details This parameter is currently unused.
-         * @return The `clearDefaultFixedFontSize` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
-         */
-        export function clearDefaultFixedFontSize(details: unknown): Promise<void>;
-        /**
-         * Clears the default fixed font size set by this extension, if any.
-         * @param details This parameter is currently unused.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
-        export function clearDefaultFixedFontSize(details: unknown, callback: () => void): void;
+        export function clearDefaultFixedFontSize(details?: { [key: string]: unknown }): Promise<void>;
+        export function clearDefaultFixedFontSize(callback: () => void): void;
+        export function clearDefaultFixedFontSize(
+            details: { [key: string]: unknown } | undefined,
+            callback: () => void,
+        ): void;
 
         /** Fired when the default fixed font size setting changes. */
-        export var onDefaultFixedFontSizeChanged: DefaultFixedFontSizeChangedEvent;
+        export const onDefaultFixedFontSizeChanged: events.Event<(details: FontSizeResult) => void>;
+
         /** Fired when the default font size setting changes. */
-        export var onDefaultFontSizeChanged: DefaultFontSizeChangedEvent;
+        export const onDefaultFontSizeChanged: events.Event<(details: FontSizeResult) => void>;
+
         /** Fired when the minimum font size setting changes. */
-        export var onMinimumFontSizeChanged: MinimumFontSizeChangedEvent;
+        export const onMinimumFontSizeChanged: events.Event<(details: FontSizeResult) => void>;
+
         /** Fired when a font setting changes. */
-        export var onFontChanged: FontChangedEvent;
+        export const onFontChanged: events.Event<(details: FontChangedResult) => void>;
     }
 
     ////////////////////
@@ -5645,46 +5815,81 @@ declare namespace chrome {
         /** An object encapsulating one visit to a URL. */
         export interface VisitItem {
             /** The transition type for this visit from its referrer. */
-            transition: string;
-            /** Optional. When this visit occurred, represented in milliseconds since the epoch. */
-            visitTime?: number | undefined;
+            transition: `${TransitionType}`;
+            /**
+             * True if the visit originated on this device. False if it was synced from a different device
+             * @since Chrome 115
+             */
+            isLocal: boolean;
+            /** When this visit occurred, represented in milliseconds since the epoch. */
+            visitTime?: number;
             /** The unique identifier for this visit. */
             visitId: string;
             /** The visit ID of the referrer. */
             referringVisitId: string;
-            /** The unique identifier for the item. */
+            /** The unique identifier for the corresponding {@link history.HistoryItem}. */
             id: string;
         }
 
         /** An object encapsulating one result of a history query. */
         export interface HistoryItem {
-            /** Optional. The number of times the user has navigated to this page by typing in the address. */
-            typedCount?: number | undefined;
-            /** Optional. The title of the page when it was last loaded. */
-            title?: string | undefined;
-            /** Optional. The URL navigated to by a user. */
-            url?: string | undefined;
-            /** Optional. When this page was last loaded, represented in milliseconds since the epoch. */
-            lastVisitTime?: number | undefined;
-            /** Optional. The number of times the user has navigated to this page. */
-            visitCount?: number | undefined;
+            /** The number of times the user has navigated to this page by typing in the address. */
+            typedCount?: number;
+            /** The title of the page when it was last loaded. */
+            title?: string;
+            /** The URL navigated to by a user. */
+            url?: string;
+            /** When this page was last loaded, represented in milliseconds since the epoch. */
+            lastVisitTime?: number;
+            /** The number of times the user has navigated to this page. */
+            visitCount?: number;
             /** The unique identifier for the item. */
             id: string;
         }
 
+        /**
+         * The transition type for this visit from its referrer.
+         * @since Chrome 44
+         */
+        export enum TransitionType {
+            /** The user arrived at this page by clicking a link on another page. */
+            LINK = "link",
+            /** The user arrived at this page by typing the URL in the address bar. This is also used for other explicit navigation actions. */
+            TYPED = "typed",
+            /** The user arrived at this page through a suggestion in the UI, for example, through a menu item. */
+            AUTO_BOOKMARK = "auto_bookmark",
+            /** The user arrived at this page through subframe navigation that they didn't request, such as through an ad loading in a frame on the previous page. These don't always generate new navigation entries in the back and forward menus. */
+            AUTO_SUBFRAME = "auto_subframe",
+            /** The user arrived at this page by selecting something in a subframe. */
+            MANUAL_SUBFRAME = "manual_subframe",
+            /** The user arrived at this page by typing in the address bar and selecting an entry that didn't look like a URL, such as a Google Search suggestion. For example, a match might have the URL of a Google Search result page, but it might appear to the user as "Search Google for ...". These are different from typed navigations because the user didn't type or see the destination URL. They're also related to keyword navigations. */
+            GENERATED = "generated",
+            /** The page was specified in the command line or is the start page. */
+            AUTO_TOPLEVEL = "auto_toplevel",
+            /** The user arrived at this page by filling out values in a form and submitting the form. Not all form submissions use this transition type. */
+            FORM_SUBMIT = "form_submit",
+            /** The user reloaded the page, either by clicking the reload button or by pressing Enter in the address bar. Session restore and Reopen closed tab also use this transition type. */
+            RELOAD = "reload",
+            /** The URL for this page was generated from a replaceable keyword other than the default search provider. */
+            KEYWORD = "keyword",
+            /** Corresponds to a visit generated for a keyword. */
+            KEYWORD_GENERATED = "keyword_generated",
+        }
+
         export interface HistoryQuery {
-            /** A free-text query to the history service. Leave empty to retrieve all pages. */
+            /** A free-text query to the history service. Leave this empty to retrieve all pages. */
             text: string;
-            /** Optional. The maximum number of results to retrieve. Defaults to 100. */
+            /** The maximum number of results to retrieve. Defaults to 100. */
             maxResults?: number | undefined;
-            /** Optional. Limit results to those visited after this date, represented in milliseconds since the epoch. */
+            /** Limit results to those visited after this date, represented in milliseconds since the epoch. If property is not specified, it will default to 24 hours. */
             startTime?: number | undefined;
-            /** Optional. Limit results to those visited before this date, represented in milliseconds since the epoch. */
+            /** Limit results to those visited before this date, represented in milliseconds since the epoch. */
             endTime?: number | undefined;
         }
 
-        export interface Url {
-            /** The URL for the operation. It must be in the format as returned from a call to history.search. */
+        /** @since Chrome 88 */
+        export interface UrlDetails {
+            /** The URL for the operation. It must be in the format as returned from a call to {@link history.search}. */
             url: string;
         }
 
@@ -5698,73 +5903,62 @@ declare namespace chrome {
         export interface RemovedResult {
             /** True if all history was removed. If true, then urls will be empty. */
             allHistory: boolean;
-            /** Optional. */
-            urls?: string[] | undefined;
+            urls?: string[];
         }
 
-        export interface HistoryVisitedEvent extends chrome.events.Event<(result: HistoryItem) => void> {}
-
-        export interface HistoryVisitRemovedEvent extends chrome.events.Event<(removed: RemovedResult) => void> {}
-
         /**
          * Searches the history for the last visit time of each page matching the query.
-         * @return The `search` method provides its result via callback or returned as a `Promise` (MV3 only).
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function search(query: HistoryQuery): Promise<HistoryItem[]>;
-        /**
-         * Searches the history for the last visit time of each page matching the query.
-         */
         export function search(query: HistoryQuery, callback: (results: HistoryItem[]) => void): void;
+
         /**
          * Adds a URL to the history at the current time with a transition type of "link".
-         * @return The `addUrl` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
-         */
-        export function addUrl(details: Url): Promise<void>;
-        /**
-         * Adds a URL to the history at the current time with a transition type of "link".
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
-        export function addUrl(details: Url, callback: () => void): void;
+        export function addUrl(details: UrlDetails): Promise<void>;
+        export function addUrl(details: UrlDetails, callback: () => void): void;
+
         /**
          * Removes all items within the specified date range from the history. Pages will not be removed from the history unless all visits fall within the range.
-         * @return The `deleteRange` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function deleteRange(range: Range): Promise<void>;
-        /**
-         * Removes all items within the specified date range from the history. Pages will not be removed from the history unless all visits fall within the range.
-         */
         export function deleteRange(range: Range, callback: () => void): void;
+
         /**
          * Deletes all items from the history.
-         * @return The `deleteAll` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
         export function deleteAll(): Promise<void>;
-        /**
-         * Deletes all items from the history.
-         */
         export function deleteAll(callback: () => void): void;
+
         /**
          * Retrieves information about visits to a URL.
-         * @return The `getVisits` method provides its result via callback or returned as a `Promise` (MV3 only).
-         */
-        export function getVisits(details: Url): Promise<VisitItem[]>;
-        /**
-         * Retrieves information about visits to a URL.
-         */
-        export function getVisits(details: Url, callback: (results: VisitItem[]) => void): void;
-        /**
-         * Removes all occurrences of the given URL from the history.
-         * @return The `deleteUrl` method provides its result via callback or returned as a `Promise` (MV3 only). It has no parameters.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
-        export function deleteUrl(details: Url): Promise<void>;
+        export function getVisits(details: UrlDetails): Promise<VisitItem[]>;
+        export function getVisits(details: UrlDetails, callback: (results: VisitItem[]) => void): void;
+
         /**
          * Removes all occurrences of the given URL from the history.
+         *
+         * Can return its result via Promise in Manifest V3 or later since Chrome 96.
          */
-        export function deleteUrl(details: Url, callback: () => void): void;
+        export function deleteUrl(details: UrlDetails): Promise<void>;
+        export function deleteUrl(details: UrlDetails, callback: () => void): void;
+
+        /** Fired when a URL is visited, providing the {@link HistoryItem} data for that URL. This event fires before the page has loaded. */
+        export const onVisited: events.Event<(result: HistoryItem) => void>;
 
-        /** Fired when a URL is visited, providing the HistoryItem data for that URL. This event fires before the page has loaded. */
-        export var onVisited: HistoryVisitedEvent;
-        /** Fired when one or more URLs are removed from the history service. When all visits have been removed the URL is purged from history. */
-        export var onVisitRemoved: HistoryVisitRemovedEvent;
+        /** Fired when one or more URLs are removed from history. When all visits have been removed the URL is purged from history. */
+        export const onVisitRemoved: events.Event<(removed: RemovedResult) => void>;
     }
 
     ////////////////////

chrome/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/chrome",
-    "version": "0.1.10",
+    "version": "0.1.12",
     "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": "a46e6689297c50bba1d7cc23508d14acdbf293bafc846406f96238879a6c46de",
+    "typesPublisherContentHash": "4be2065e800c9158a9e20019cc5cf220ee67551b642b4dcef5ea7cd2751cf4a9",
     "typeScriptVersion": "5.2"
 }