@types/chrome 0.2.5 → 0.2.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. chrome/README.md +1 -1
  2. chrome/index.d.ts +122 -81
  3. chrome/package.json +2 -2
chrome/README.md CHANGED
@@ -8,7 +8,7 @@ This package contains type definitions for chrome (https://developer.chrome.com/
8
8
  Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome.
9
9
 
10
10
  ### Additional Details
11
- * Last updated: Fri, 31 Jul 2026 22:47:24 GMT
11
+ * Last updated: Fri, 21 Aug 2026 19:38:26 GMT
12
12
  * Dependencies: [@types/filesystem](https://npmjs.com/package/@types/filesystem), [@types/har-format](https://npmjs.com/package/@types/har-format)
13
13
 
14
14
  # Credits
chrome/index.d.ts CHANGED
@@ -168,7 +168,7 @@ declare namespace chrome {
168
168
  interface TitleDetails {
169
169
  /** The string the action should display when moused over. */
170
170
  title: string;
171
- /** Limits the change to when a particular tab is selected. Automatically resets when the tab is closed. */
171
+ /** Limits the change to when a particular tab is selected. Automatically resets when the tab is closed. */
172
172
  tabId?: number | undefined;
173
173
  }
174
174
 
@@ -201,12 +201,12 @@ declare namespace chrome {
201
201
 
202
202
  /** @since Chrome 99 */
203
203
  interface OpenPopupOptions {
204
- /** The id of the window to open the action popup in. Defaults to the currently-active window if unspecified. */
204
+ /** The id of the window to open the action popup in. Defaults to the currently-active window if unspecified. */
205
205
  windowId?: number | undefined;
206
206
  }
207
207
 
208
208
  interface TabDetails {
209
- /** The ID of the tab to query state for. If no tab is specified, the non-tab-specific state is returned. */
209
+ /** The ID of the tab to query state for. If no tab is specified, the non-tab-specific state is returned. */
210
210
  tabId?: number | undefined;
211
211
  }
212
212
 
@@ -402,7 +402,7 @@ declare namespace chrome {
402
402
  }
403
403
  & (
404
404
  | {
405
- /** Length of time in minutes after which the {@link onAlarm} event should fire. */
405
+ /** Length of time in minutes after which the {@link onAlarm} event should fire. */
406
406
  delayInMinutes: number;
407
407
  /** If set, the onAlarm event should fire every `periodInMinutes` minutes after the initial event specified by `when` or `delayInMinutes`. If not set, the alarm will only fire once. */
408
408
  periodInMinutes?: number | undefined;
@@ -410,7 +410,7 @@ declare namespace chrome {
410
410
  when?: undefined;
411
411
  }
412
412
  | {
413
- /** Length of time in minutes after which the {@link onAlarm} event should fire. */
413
+ /** Length of time in minutes after which the {@link onAlarm} event should fire. */
414
414
  delayInMinutes?: number | undefined;
415
415
  /** If set, the onAlarm event should fire every `periodInMinutes` minutes after the initial event specified by `when` or `delayInMinutes`. If not set, the alarm will only fire once. */
416
416
  periodInMinutes: number;
@@ -418,7 +418,7 @@ declare namespace chrome {
418
418
  when?: undefined;
419
419
  }
420
420
  | {
421
- /** Length of time in minutes after which the {@link onAlarm} event should fire. */
421
+ /** Length of time in minutes after which the {@link onAlarm} event should fire. */
422
422
  delayInMinutes?: undefined;
423
423
  /** If set, the onAlarm event should fire every `periodInMinutes` minutes after the initial event specified by `when` or `delayInMinutes`. If not set, the alarm will only fire once. */
424
424
  periodInMinutes?: number | undefined;
@@ -833,7 +833,7 @@ declare namespace chrome {
833
833
  function removeTree(id: string, callback: () => void): void;
834
834
 
835
835
  interface SearchQuery {
836
- /** A string of words and quoted phrases that are matched against bookmark URLs and titles.*/
836
+ /** A string of words and quoted phrases that are matched against bookmark URLs and titles. */
837
837
  query?: string;
838
838
  /** The URL of the bookmark; matches verbatim. Note that folders have no URL. */
839
839
  url?: string;
@@ -863,7 +863,7 @@ declare namespace chrome {
863
863
  function update(id: string, changes: UpdateChanges): Promise<BookmarkTreeNode>;
864
864
  function update(id: string, changes: UpdateChanges, callback: (result: BookmarkTreeNode) => void): void;
865
865
 
866
- /** Fired when a bookmark or folder changes. **Note:** Currently, only title and url changes trigger this.*/
866
+ /** Fired when a bookmark or folder changes. **Note:** Currently, only title and url changes trigger this. */
867
867
  const onChanged: events.Event<(id: string, changeInfo: { title: string; url?: string }) => void>;
868
868
 
869
869
  /** Fired when the children of a folder have changed their order due to the order being sorted in the UI. This is not called as a result of a move(). */
@@ -875,7 +875,7 @@ declare namespace chrome {
875
875
  /** Fired when a bookmark import session is begun. Expensive observers should ignore onCreated updates until onImportEnded is fired. Observers should still handle other notifications immediately. */
876
876
  const onImportBegan: events.Event<() => void>;
877
877
 
878
- /** Fired when a bookmark import session is ended. */
878
+ /** Fired when a bookmark import session is ended. */
879
879
  const onImportEnded: events.Event<() => void>;
880
880
 
881
881
  /** Fired when a bookmark or folder is moved to a different parent folder. */
@@ -933,7 +933,7 @@ declare namespace chrome {
933
933
  interface TitleDetails {
934
934
  /** The string the browser action should display when moused over. */
935
935
  title: string;
936
- /** Optional. Limits the change to when a particular tab is selected. Automatically resets when the tab is closed. */
936
+ /** Optional. Limits the change to when a particular tab is selected. Automatically resets when the tab is closed. */
937
937
  tabId?: number | null | undefined;
938
938
  }
939
939
 
@@ -965,7 +965,7 @@ declare namespace chrome {
965
965
  interface PopupDetails {
966
966
  /** Limits the change to when a particular tab is selected. Automatically resets when the tab is closed. */
967
967
  tabId?: number | null | undefined;
968
- /** The relative path to the HTML file to show in a popup. If set to the empty string (`''`), no popup is shown.*/
968
+ /** The relative path to the HTML file to show in a popup. If set to the empty string (`''`), no popup is shown. */
969
969
  popup: string;
970
970
  }
971
971
 
@@ -1329,7 +1329,7 @@ declare namespace chrome {
1329
1329
  GENERAL_ERROR = "GENERAL_ERROR",
1330
1330
  }
1331
1331
 
1332
- /** @deprecated Replaced by {@link Algorithm}.*/
1332
+ /** @deprecated Replaced by {@link Algorithm}. */
1333
1333
  enum Hash {
1334
1334
  /** Specifies the MD5 and SHA1 hashing algorithms. */
1335
1335
  MD5_SHA1 = "MD5_SHA1",
@@ -1407,7 +1407,7 @@ declare namespace chrome {
1407
1407
  error?: `${Error}` | undefined;
1408
1408
  }
1409
1409
 
1410
- /** @since Chrome 86 */
1410
+ /** @since Chrome 86 */
1411
1411
  interface SignatureRequest {
1412
1412
  /** Signature algorithm to be used. */
1413
1413
  algorithm: `${Algorithm}`;
@@ -1422,7 +1422,7 @@ declare namespace chrome {
1422
1422
  interface SignRequest {
1423
1423
  /** The DER encoding of a X.509 certificate. The extension must sign `digest` using the associated private key. */
1424
1424
  certificate: ArrayBuffer;
1425
- /** The digest that must be signed. */
1425
+ /** The digest that must be signed. */
1426
1426
  digest: ArrayBuffer;
1427
1427
  /** Refers to the hash algorithm that was used to create `digest`. */
1428
1428
  hash: `${Hash}`;
@@ -1589,7 +1589,7 @@ declare namespace chrome {
1589
1589
  resourceIdentifier?: ResourceIdentifier;
1590
1590
  /** Where to set the setting (default: regular). */
1591
1591
  scope?: `${Scope}`;
1592
- /** The pattern for the secondary URL. Defaults to matching all URLs. For details on the format of a pattern, see Content Setting Patterns.*/
1592
+ /** The pattern for the secondary URL. Defaults to matching all URLs. For details on the format of a pattern, see Content Setting Patterns. */
1593
1593
  secondaryPattern?: string;
1594
1594
  /** The setting applied by this rule. See the description of the individual ContentSetting objects for the possible values. */
1595
1595
  setting: T;
@@ -1700,7 +1700,7 @@ declare namespace chrome {
1700
1700
 
1701
1701
  /** The only content type using resource identifiers is contentSettings.plugins. For more information, see Resource Identifiers. */
1702
1702
  interface ResourceIdentifier {
1703
- /** A human readable description of the resource. */
1703
+ /** A human readable description of the resource. */
1704
1704
  description?: string;
1705
1705
  /** The resource identifier for the given content type. */
1706
1706
  id: string;
@@ -1939,15 +1939,15 @@ declare namespace chrome {
1939
1939
  checked?: boolean;
1940
1940
  /** List of contexts this menu item will appear in. Defaults to `['page']`. */
1941
1941
  contexts?: [`${ContextType}`, ...`${ContextType}`[]];
1942
- /** Restricts the item to apply only to documents or frames whose URL matches one of the given patterns. For details on pattern formats, see Match Patterns. */
1942
+ /** Restricts the item to apply only to documents or frames whose URL matches one of the given patterns. For details on pattern formats, see Match Patterns. */
1943
1943
  documentUrlPatterns?: string[];
1944
- /** Whether this context menu item is enabled or disabled. Defaults to `true`. */
1944
+ /** Whether this context menu item is enabled or disabled. Defaults to `true`. */
1945
1945
  enabled?: boolean;
1946
1946
  /** The unique ID to assign to this item. Mandatory for event pages. Cannot be the same as another ID for this extension. */
1947
1947
  id?: string;
1948
- /** The ID of a parent menu item; this makes the item a child of a previously added item. */
1948
+ /** The ID of a parent menu item; this makes the item a child of a previously added item. */
1949
1949
  parentId?: number | string;
1950
- /** Similar to `documentUrlPatterns`, filters based on the `src` attribute of `img`, `audio`, and `video` tags and the `href` attribute of `a` tags. */
1950
+ /** Similar to `documentUrlPatterns`, filters based on the `src` attribute of `img`, `audio`, and `video` tags and the `href` attribute of `a` tags. */
1951
1951
  targetUrlPatterns?: string[];
1952
1952
  /** The text to display in the item; this is _required_ unless `type` is `separator`. When the context is `selection`, use `%s` within the string to show the selected text. For example, if this parameter's value is "Translate '%s' to Pig Latin" and the user selects the word "cool", the context menu item for the selection is "Translate 'cool' to Pig Latin". */
1953
1953
  title?: string;
@@ -1981,7 +1981,7 @@ declare namespace chrome {
1981
1981
  interface OnClickData {
1982
1982
  /** A flag indicating the state of a checkbox or radio item after it is clicked. */
1983
1983
  checked?: boolean;
1984
- /** A flag indicating whether the element is editable (text input, textarea, etc.). */
1984
+ /** A flag indicating whether the element is editable (text input, textarea, etc.). */
1985
1985
  editable: boolean;
1986
1986
  /**
1987
1987
  * The ID of the frame of the element where the context menu was clicked, if it was in a frame.
@@ -1998,7 +1998,7 @@ declare namespace chrome {
1998
1998
  menuItemId: number | string;
1999
1999
  /** The URL of the page where the menu item was clicked. This property is not set if the click occurred in a context where there is no current page, such as in a launcher context menu. */
2000
2000
  pageUrl?: string;
2001
- /** The parent ID, if any, for the item clicked.*/
2001
+ /** The parent ID, if any, for the item clicked. */
2002
2002
  parentMenuItemId?: number | string;
2003
2003
  /** The text for the context selection, if any. */
2004
2004
  selectionText?: string | undefined;
@@ -2063,7 +2063,7 @@ declare namespace chrome {
2063
2063
  * Manifest: "host_permissions"
2064
2064
  */
2065
2065
  export namespace cookies {
2066
- /** 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. **/
2066
+ /** 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. */
2067
2067
  enum SameSiteStatus {
2068
2068
  NO_RESTRICTION = "no_restriction",
2069
2069
  LAX = "lax",
@@ -2314,7 +2314,7 @@ declare namespace chrome {
2314
2314
  * @since Chrome 125
2315
2315
  */
2316
2316
  interface DebuggerSession {
2317
- /** The id of the extension which you intend to debug. Attaching to an extension background page is only possible when the `--silent-debugger-extension-api` command-line switch is used.*/
2317
+ /** The id of the extension which you intend to debug. Attaching to an extension background page is only possible when the `--silent-debugger-extension-api` command-line switch is used. */
2318
2318
  extensionId?: string;
2319
2319
  /** The opaque id of the Chrome DevTools Protocol session. Identifies a child session within the root session identified by tabId, extensionId or targetId. */
2320
2320
  sessionId?: string;
@@ -2349,7 +2349,7 @@ declare namespace chrome {
2349
2349
  title: string;
2350
2350
  /** Target URL. */
2351
2351
  url: string;
2352
- /** Target favicon URL. */
2352
+ /** Target favicon URL. */
2353
2353
  faviconUrl?: string;
2354
2354
  }
2355
2355
 
@@ -2850,7 +2850,7 @@ declare namespace chrome {
2850
2850
  getContent(): Promise<{
2851
2851
  /** Content of the resource (potentially encoded). */
2852
2852
  content: string;
2853
- /** Empty if the content is not encoded, encoding name otherwise. Currently, only base64 is supported.*/
2853
+ /** Empty if the content is not encoded, encoding name otherwise. Currently, only base64 is supported. */
2854
2854
  encoding: string;
2855
2855
  }>;
2856
2856
  getContent(
@@ -3382,7 +3382,7 @@ declare namespace chrome {
3382
3382
  enum OperationResult {
3383
3383
  /** An unknown or generic failure occurred. */
3384
3384
  UNKNOWN = "UNKNOWN",
3385
- /**The operation succeeded. */
3385
+ /** The operation succeeded. */
3386
3386
  SUCCESS = "SUCCESS",
3387
3387
  /** The operation is not supported. */
3388
3388
  UNSUPPORTED = "UNSUPPORTED",
@@ -3565,7 +3565,7 @@ declare namespace chrome {
3565
3565
 
3566
3566
  /** @since Chrome 125 */
3567
3567
  interface SetOptionResult {
3568
- /** Indicates the name of the option that was set. */
3568
+ /** Indicates the name of the option that was set. */
3569
3569
  name: string;
3570
3570
  /** Indicates the result of setting the option. */
3571
3571
  result: `${OperationResult}`;
@@ -3597,7 +3597,7 @@ declare namespace chrome {
3597
3597
  interface StartScanResponse<T> {
3598
3598
  /** If `result` is `SUCCESS`, provides a handle that can be used to read scan data or cancel the job. */
3599
3599
  job?: string;
3600
- /** The result of starting a scan. If the value of this is `SUCCESS`, the `job` property will be populated. */
3600
+ /** The result of starting a scan. If the value of this is `SUCCESS`, the `job` property will be populated. */
3601
3601
  result: `${OperationResult}`;
3602
3602
  /** Provides the same scanner handle that was passed to {@link startScan}. */
3603
3603
  scannerHandle: T;
@@ -4742,6 +4742,25 @@ declare namespace chrome {
4742
4742
  */
4743
4743
  type CSSOrigin = "author" | "user";
4744
4744
 
4745
+ /**
4746
+ * Details of the CSS to remove. Either the code or the file property must be set, but both may not be set at the same time.
4747
+ * @since Chrome 87
4748
+ */
4749
+ interface DeleteInjectionDetails {
4750
+ /** If allFrames is `true`, implies that the CSS should be removed from all frames of current page. By default, it's `false` and is only removed from the top frame. If `true` and `frameId` is set, then the code is removed from the selected frame and all of its child frames. */
4751
+ allFrames?: boolean;
4752
+ /** CSS code to remove. */
4753
+ code?: string;
4754
+ /** The origin of the CSS to remove. Defaults to `"author"`. */
4755
+ cssOrigin?: CSSOrigin;
4756
+ /** CSS file to remove. */
4757
+ file?: string;
4758
+ /** The frame from where the CSS should be removed. Defaults to 0 (the top-level frame). */
4759
+ frameId?: number;
4760
+ /** If matchAboutBlank is true, then the code is also removed from about:blank and about:srcdoc frames if your extension has access to its parent document. By default it is `false`. */
4761
+ matchAboutBlank?: boolean;
4762
+ }
4763
+
4745
4764
  /**
4746
4765
  * The document lifecycle of the frame.
4747
4766
  * @since Chrome 106
@@ -5165,7 +5184,7 @@ declare namespace chrome {
5165
5184
  requestId: number;
5166
5185
  }
5167
5186
 
5168
- /** Error codes used by providing extensions in response to requests as well as in case of errors when calling methods of the API. For success, `"OK"` must be used.*/
5187
+ /** Error codes used by providing extensions in response to requests as well as in case of errors when calling methods of the API. For success, `"OK"` must be used. */
5169
5188
  enum ProviderError {
5170
5189
  OK = "OK",
5171
5190
  FAILED = "FAILED",
@@ -5372,7 +5391,7 @@ declare namespace chrome {
5372
5391
  ) => void
5373
5392
  >;
5374
5393
 
5375
- /** Raised when opening a file previously opened with `openRequestId` is requested to be closed.*/
5394
+ /** Raised when opening a file previously opened with `openRequestId` is requested to be closed. */
5376
5395
  const onCloseFileRequested: events.Event<
5377
5396
  (
5378
5397
  options: CloseFileRequestedOptions,
@@ -5817,7 +5836,7 @@ declare namespace chrome {
5817
5836
  genericFamily: `${GenericFamily}`;
5818
5837
  /** The level of control this extension has over the setting. */
5819
5838
  levelOfControl: `${LevelOfControl}`;
5820
- /** Optional. The script code for which the font setting has changed. */
5839
+ /** Optional. The script code for which the font setting has changed. */
5821
5840
  script?: `${ScriptCode}`;
5822
5841
  /** The font ID. See the description in {@link getFont}. */
5823
5842
  fontId: string;
@@ -6276,7 +6295,8 @@ declare namespace chrome {
6276
6295
  /** Gets the browser UI language of the browser. This is different from {@link i18n.getAcceptLanguages} which returns the preferred user languages. */
6277
6296
  function getUILanguage(): string;
6278
6297
 
6279
- /** Detects the language of the provided text using CLD.
6298
+ /**
6299
+ * Detects the language of the provided text using CLD.
6280
6300
  * @param text User input string to be translated.
6281
6301
  *
6282
6302
  * Can return its result via Promise in Manifest V3 or later since Chrome 99.
@@ -6406,7 +6426,7 @@ declare namespace chrome {
6406
6426
  *
6407
6427
  * The Identity API caches access tokens in memory, so it's ok to call getAuthToken non-interactively any time a token is required. The token cache automatically handles expiration.
6408
6428
  *
6409
- * For a good user experience it is important interactive token requests 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, or Chrome sign in screens if they are not signed in, with with no context. In particular, do not use getAuthToken interactively when your app is first launched.
6429
+ * For a good user experience it is important interactive token requests 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, or Chrome sign in screens if they are not signed in, with no context. In particular, do not use getAuthToken interactively when your app is first launched.
6410
6430
  * @param details Token options.
6411
6431
  *
6412
6432
  * Can return its result via Promise since Chrome 105.
@@ -7029,13 +7049,13 @@ declare namespace chrome {
7029
7049
  /** This event is sent when an IME is deactivated. It signals that the IME will no longer be receiving onKeyPress events. */
7030
7050
  const onDeactivated: events.Event<(engineID: string) => void>;
7031
7051
 
7032
- /** This event is sent when the properties of the current InputContext change, such as the the type. It is sent to all extensions that are listening to this event, and enabled by the user. */
7052
+ /** This event is sent when the properties of the current InputContext change, such as the type. It is sent to all extensions that are listening to this event, and enabled by the user. */
7033
7053
  const onInputContextUpdate: events.Event<(context: InputContext) => void>;
7034
7054
 
7035
7055
  /** This event is sent when an IME is activated. It signals that the IME will be receiving onKeyPress events. */
7036
7056
  const onActivate: events.Event<(engineID: string, screen: `${ScreenType}`) => void>;
7037
7057
 
7038
- // /** This event is sent when focus enters a text box. It is sent to all extensions that are listening to this event, and enabled by the user. */
7058
+ /** This event is sent when focus enters a text box. It is sent to all extensions that are listening to this event, and enabled by the user. */
7039
7059
  const onFocus: events.Event<(context: InputContext) => void>;
7040
7060
 
7041
7061
  /** Called when the user selects a menu item */
@@ -7193,7 +7213,7 @@ declare namespace chrome {
7193
7213
  function getSessionState(): Promise<`${SessionState}`>;
7194
7214
  function getSessionState(callback: (sessionState: `${SessionState}`) => void): void;
7195
7215
 
7196
- /** Dispatched when the session state changes. `sessionState` is the new session state.*/
7216
+ /** Dispatched when the session state changes. `sessionState` is the new session state. */
7197
7217
  const onSessionStateChanged: events.Event<(sessionState: `${SessionState}`) => void>;
7198
7218
  }
7199
7219
 
@@ -7603,7 +7623,8 @@ declare namespace chrome {
7603
7623
  * **Note:** This value is required for the {@link notifications.create}() method.
7604
7624
  */
7605
7625
  title?: string;
7606
- /** Which type of notification to display.
7626
+ /**
7627
+ * Which type of notification to display.
7607
7628
  *
7608
7629
  * **Note:** This value is required for the {@link notifications.create}() method.
7609
7630
  */
@@ -8067,7 +8088,7 @@ declare namespace chrome {
8067
8088
  // Platform Keys
8068
8089
  ////////////////////
8069
8090
  /**
8070
- * 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).
8091
+ * 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 certificate in its custom authentication protocol. E.g. this allows usage of platform managed certificates in third party VPNs (see chrome.vpnProvider).
8071
8092
  *
8072
8093
  * Permissions: "platformKeys"
8073
8094
  * @platform ChromeOS only
@@ -8229,7 +8250,7 @@ declare namespace chrome {
8229
8250
  enum PrintError {
8230
8251
  /** Specifies that the operation was completed successfully. */
8231
8252
  OK = "OK",
8232
- /** Specifies that a general failure occured. */
8253
+ /** Specifies that a general failure occurred. */
8233
8254
  FAILED = "FAILED",
8234
8255
  /** Specifies that the print ticket is invalid. For example, the ticket is inconsistent with some capabilities, or the extension is not able to handle all settings from the ticket. */
8235
8256
  INVALID_TICKET = "INVALID_TICKET",
@@ -9030,7 +9051,7 @@ declare namespace chrome {
9030
9051
  */
9031
9052
  export namespace runtime {
9032
9053
  interface LastError {
9033
- /** Details about the error which occurred. */
9054
+ /** Details about the error which occurred. */
9034
9055
  message?: string;
9035
9056
  }
9036
9057
 
@@ -9066,19 +9087,19 @@ declare namespace chrome {
9066
9087
  * @since Chrome 44
9067
9088
  */
9068
9089
  enum PlatformArch {
9069
- /** Specifies the processer architecture as arm. */
9090
+ /** Specifies the processor architecture as arm. */
9070
9091
  ARM = "arm",
9071
- /** Specifies the processer architecture as arm64. */
9092
+ /** Specifies the processor architecture as arm64. */
9072
9093
  ARM64 = "arm64",
9073
- /** Specifies the processer architecture as x86-32. */
9094
+ /** Specifies the processor architecture as x86-32. */
9074
9095
  X86_32 = "x86-32",
9075
- /** Specifies the processer architecture as x86-64. */
9096
+ /** Specifies the processor architecture as x86-64. */
9076
9097
  X86_64 = "x86-64",
9077
- /** Specifies the processer architecture as mips. */
9098
+ /** Specifies the processor architecture as mips. */
9078
9099
  MIPS = "mips",
9079
- /** Specifies the processer architecture as mips64. */
9100
+ /** Specifies the processor architecture as mips64. */
9080
9101
  MIPS64 = "mips64",
9081
- /** Specifies the processer architecture as riscv64. */
9102
+ /** Specifies the processor architecture as riscv64. */
9082
9103
  RISCV64 = "riscv64",
9083
9104
  }
9084
9105
 
@@ -9185,7 +9206,7 @@ declare namespace chrome {
9185
9206
  contextId: string;
9186
9207
  /** The type of context this corresponds to. */
9187
9208
  contextType: `${ContextType}`;
9188
- /** A UUID for the document associated with this context, or undefined if this context is hosted not in a document.*/
9209
+ /** A UUID for the document associated with this context, or undefined if this context is hosted not in a document. */
9189
9210
  documentId?: string;
9190
9211
  /** The origin of the document associated with this context, or undefined if the context is not hosted in a document. */
9191
9212
  documentOrigin?: string;
@@ -9467,7 +9488,7 @@ declare namespace chrome {
9467
9488
  // Optional
9468
9489
  /** @deprecated As of February 2024, the `author` key is no longer supported by Chrome or the Chrome Web Store. If present, it's silently ignored. */
9469
9490
  author?: { email: string } | undefined;
9470
- /** Defines overrides for selected Chrome settings. */
9491
+ /** Defines overrides for selected Chrome settings. */
9471
9492
  chrome_settings_overrides?: {
9472
9493
  /** The new value for the homepage. */
9473
9494
  homepage?: string | undefined;
@@ -9544,7 +9565,7 @@ declare namespace chrome {
9544
9565
  /** Files app uses above information in order to render related UI elements appropriately. For example, if `configurable` is set to true, then a menu item for configuring volumes will be rendered. Similarly, if `multiple_mounts` is set to true, then Files app will allow to add more than one mount points from the UI. If `watchable` is false, then a refresh button will be rendered. Note, that if possible you should add support for watchers, so changes on the file system can be reflected immediately and automatically. */
9545
9566
  source: "file" | "device" | "network";
9546
9567
  } | undefined;
9547
- /** string specifying a URL for the extension's homepage. If this is undefined, the homepage defaults to the extension's Chrome Web Store page. This field is particularly useful if you host the extension on your own site. */
9568
+ /** string specifying a URL for the extension's homepage. If this is undefined, the homepage defaults to the extension's Chrome Web Store page. This field is particularly useful if you host the extension on your own site. */
9548
9569
  homepage_url?: string | undefined;
9549
9570
  /** Allows resources to be imported into the extension. */
9550
9571
  import?:
@@ -10667,9 +10688,9 @@ declare namespace chrome {
10667
10688
  }
10668
10689
 
10669
10690
  interface Bounds {
10670
- /** The x-coordinate of the upper-left corner. */
10691
+ /** The x-coordinate of the upper-left corner. */
10671
10692
  left: number;
10672
- /** The y-coordinate of the upper-left corner. */
10693
+ /** The y-coordinate of the upper-left corner. */
10673
10694
  top: number;
10674
10695
  /** The width of the display in pixels. */
10675
10696
  width: number;
@@ -10899,7 +10920,8 @@ declare namespace chrome {
10899
10920
  dpiX: number;
10900
10921
  /** The number of pixels per inch along the y-axis. */
10901
10922
  dpiY: number;
10902
- /** The display's clockwise rotation in degrees relative to the vertical position.
10923
+ /**
10924
+ * The display's clockwise rotation in degrees relative to the vertical position.
10903
10925
  * Currently exposed only on ChromeOS. Will be set to 0 on other platforms.
10904
10926
  * A value of -1 will be interpreted as auto-rotate when the device is in a physical tablet state.
10905
10927
  * @platform ChromeOS only
@@ -11164,7 +11186,7 @@ declare namespace chrome {
11164
11186
 
11165
11187
  /** @since Chrome 71 */
11166
11188
  interface GetMediaStreamOptions {
11167
- /** Optional tab id of the tab which will later invoke `getUserMedia()` to consume the stream. If not specified then the resulting stream can be used only by the calling extension. The stream can only be used by frames in the given tab whose security origin matches the consumber tab's origin. The tab's origin must be a secure origin, e.g. HTTPS. */
11189
+ /** Optional tab id of the tab which will later invoke `getUserMedia()` to consume the stream. If not specified then the resulting stream can be used only by the calling extension. The stream can only be used by frames in the given tab whose security origin matches the consumer tab's origin. The tab's origin must be a secure origin, e.g. HTTPS. */
11168
11190
  consumerTabId?: number | undefined;
11169
11191
  /** Optional tab id of the tab which will be captured. If not specified then the current active tab will be selected. Only tabs for which the extension has been granted the `activeTab` permission can be used as the target tab. */
11170
11192
  targetTabId?: number | undefined;
@@ -11438,7 +11460,7 @@ declare namespace chrome {
11438
11460
  url?: string | undefined;
11439
11461
  /** Adds or removes the tab from the current selection. */
11440
11462
  highlighted?: boolean | undefined;
11441
- /** Whether the tab should be active. Does not affect whether the window is focused (see {@link windows.update}).*/
11463
+ /** Whether the tab should be active. Does not affect whether the window is focused (see {@link windows.update}). */
11442
11464
  active?: boolean | undefined;
11443
11465
  /**
11444
11466
  * Whether the tab should be selected.
@@ -11887,7 +11909,7 @@ declare namespace chrome {
11887
11909
  * MV2 only
11888
11910
  * @param tabId The ID of the tab in which to insert the CSS; defaults to the active tab of the current window.
11889
11911
  * @param details Details of the CSS text to insert. Either the code or the file property must be set, but both may not be set at the same time.
11890
- * @deprecated since Chrome 99. Replaced by {@link scripting.insertCSS} in Manifest V3.
11912
+ * @deprecated since Chrome 91. Replaced by {@link scripting.insertCSS} in Manifest V3.
11891
11913
  */
11892
11914
  function insertCSS(details: extensionTypes.InjectDetails): Promise<void>;
11893
11915
  function insertCSS(tabId: number | undefined, details: extensionTypes.InjectDetails): Promise<void>;
@@ -11898,6 +11920,26 @@ declare namespace chrome {
11898
11920
  callback: () => void,
11899
11921
  ): void;
11900
11922
 
11923
+ /**
11924
+ * Removes from a page CSS that was previously injected by a call to {@link tabs.insertCSS}.
11925
+ *
11926
+ * Can return its result via Promise in Manifest V3 or later since Chrome 88.
11927
+ *
11928
+ * MV2 only
11929
+ * @param tabId The ID of the tab from which to remove the CSS; defaults to the active tab of the current window.
11930
+ * @param details Details of the CSS text to remove. Either the code or the file property must be set, but both may not be set at the same time.
11931
+ * @since Chrome 87
11932
+ * @deprecated since Chrome 91. Replaced by {@link scripting.removeCSS} in Manifest V3.
11933
+ */
11934
+ function removeCSS(details: extensionTypes.DeleteInjectionDetails): Promise<void>;
11935
+ function removeCSS(tabId: number | undefined, details: extensionTypes.DeleteInjectionDetails): Promise<void>;
11936
+ function removeCSS(details: extensionTypes.DeleteInjectionDetails, callback: () => void): void;
11937
+ function removeCSS(
11938
+ tabId: number | undefined,
11939
+ details: extensionTypes.DeleteInjectionDetails,
11940
+ callback: () => void,
11941
+ ): void;
11942
+
11901
11943
  /**
11902
11944
  * Highlights the given tabs and focuses on the first of group. Will appear to do nothing if the specified tab is currently active.
11903
11945
  *
@@ -11975,7 +12017,7 @@ declare namespace chrome {
11975
12017
  * Discards a tab from memory. Discarded tabs are still visible on the tab strip and are reloaded when activated.
11976
12018
  *
11977
12019
  * Can return its result via Promise in Manifest V3 or later since Chrome 88.
11978
- * @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..
12020
+ * @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.
11979
12021
  * @since Chrome 54
11980
12022
  */
11981
12023
  function discard(tabId?: number): Promise<Tab | undefined>;
@@ -12350,7 +12392,7 @@ declare namespace chrome {
12350
12392
  voiceName?: string;
12351
12393
  }
12352
12394
 
12353
- /** @deprecated since Chrome 70. Gender is deprecated and is ignored.*/
12395
+ /** @deprecated since Chrome 70. Gender is deprecated and is ignored. */
12354
12396
  enum VoiceGender {
12355
12397
  FEMALE = "female",
12356
12398
  MALE = "male",
@@ -12817,7 +12859,7 @@ declare namespace chrome {
12817
12859
  /** Triggered when a configuration created by the extension is removed by the platform. */
12818
12860
  const onConfigRemoved: events.Event<(id: string) => void>;
12819
12861
 
12820
- // /** Triggered when a configuration is created by the platform for the extension. */
12862
+ /** Triggered when a configuration is created by the platform for the extension. */
12821
12863
  const onConfigCreated: events.Event<
12822
12864
  (id: string, name: string, data: { [key: string]: unknown }) => void
12823
12865
  >;
@@ -12903,7 +12945,7 @@ declare namespace chrome {
12903
12945
  interface GetRequest {
12904
12946
  /** The `PublicKeyCredentialRequestOptions` passed to `navigator.credentials.get()`, serialized as a JSON string. The serialization format is compatible with [`PublicKeyCredential.parseRequestOptionsFromJSON()`](https://w3c.github.io/webauthn/#sctn-parseRequestOptionsFromJSON). */
12905
12947
  requestDetailsJson: string;
12906
- /** An opaque identifier for the request. */
12948
+ /** An opaque identifier for the request. */
12907
12949
  requestId: number;
12908
12950
  }
12909
12951
 
@@ -12935,7 +12977,7 @@ declare namespace chrome {
12935
12977
  *
12936
12978
  * The attached extension must call `detach()` once the remote desktop session has ended in order to resume regular WebAuthn request processing. Extensions automatically become detached if they are unloaded.
12937
12979
  *
12938
- * Refer to the `onRemoteSessionStateChange` event for signaling a change of remote session attachment from a native application to to the (possibly suspended) extension.
12980
+ * Refer to the `onRemoteSessionStateChange` event for signaling a change of remote session attachment from a native application to the (possibly suspended) extension.
12939
12981
  */
12940
12982
  function attach(): Promise<string | undefined>;
12941
12983
  function attach(callback: (error?: string | undefined) => void): void;
@@ -12957,7 +12999,7 @@ declare namespace chrome {
12957
12999
  *
12958
13000
  * This method is typically called when the extension detects that a remote desktop session was terminated. Once this method returns, the extension ceases to be the active Web Authentication API request proxy.
12959
13001
  *
12960
- * Refer to the `onRemoteSessionStateChange` event for signaling a change of remote session attachment from a native application to to the (possibly suspended) extension.
13002
+ * Refer to the `onRemoteSessionStateChange` event for signaling a change of remote session attachment from a native application to the (possibly suspended) extension.
12961
13003
  */
12962
13004
  function detach(): Promise<string | undefined>;
12963
13005
  function detach(callback: (error?: string | undefined) => void): void;
@@ -13054,7 +13096,7 @@ declare namespace chrome {
13054
13096
  );
13055
13097
 
13056
13098
  interface GetFrameResultDetails {
13057
- /** The URL currently associated with this frame, if the frame identified by the frameId existed at one point in the given tab. The fact that an URL is associated with a given frameId does not imply that the corresponding frame still exists. */
13099
+ /** The URL currently associated with this frame, if the frame identified by the frameId existed at one point in the given tab. The fact that a URL is associated with a given frameId does not imply that the corresponding frame still exists. */
13058
13100
  url: string;
13059
13101
  /** A UUID of the document loaded. */
13060
13102
  documentId: string;
@@ -13159,7 +13201,7 @@ declare namespace chrome {
13159
13201
  documentId: string;
13160
13202
  /** Cause of the navigation. */
13161
13203
  transitionType: `${TransitionType}`;
13162
- /** A list of transition qualifiers.*/
13204
+ /** A list of transition qualifiers. */
13163
13205
  transitionQualifiers: `${TransitionQualifier}`[];
13164
13206
  }
13165
13207
 
@@ -13210,7 +13252,7 @@ declare namespace chrome {
13210
13252
  /** Fired when a document, including the resources it refers to, is completely loaded and initialized. */
13211
13253
  const onCompleted: WebNavigationEvent<(details: WebNavigationFramedCallbackDetails) => void>;
13212
13254
 
13213
- // /** Fired when the frame's history was updated to a new URL. All future events for that frame will use the updated URL. */
13255
+ /** Fired when the frame's history was updated to a new URL. All future events for that frame will use the updated URL. */
13214
13256
  const onHistoryStateUpdated: WebNavigationEvent<
13215
13257
  (details: WebNavigationTransitionCallbackDetails) => void
13216
13258
  >;
@@ -13220,7 +13262,7 @@ declare namespace chrome {
13220
13262
  (details: WebNavigationSourceCallbackDetails) => void
13221
13263
  >;
13222
13264
 
13223
- /** Fired when the contents of the tab is replaced by a different (usually previously pre-rendered) tab*/
13265
+ /** Fired when the contents of the tab is replaced by a different (usually previously pre-rendered) tab */
13224
13266
  const onTabReplaced: events.Event<(details: WebNavigationReplacementCallbackDetails) => void>;
13225
13267
 
13226
13268
  /** Fired when a navigation is about to occur. */
@@ -13513,7 +13555,7 @@ declare namespace chrome {
13513
13555
  * @since Chrome 43
13514
13556
  */
13515
13557
  statusCode: number;
13516
- /** HTTP status line of the response or the 'HTTP/0.9 200 OK' string for HTTP/0.9 responses (i.e., responses that lack a status line) or an empty string if there are no headers.*/
13558
+ /** HTTP status line of the response or the 'HTTP/0.9 200 OK' string for HTTP/0.9 responses (i.e., responses that lack a status line) or an empty string if there are no headers. */
13517
13559
  statusLine: string;
13518
13560
  }
13519
13561
 
@@ -13528,7 +13570,7 @@ declare namespace chrome {
13528
13570
  responseHeaders?: HttpHeader[];
13529
13571
  /** Standard HTTP status code returned by the server. */
13530
13572
  statusCode: number;
13531
- /** HTTP status line of the response or the 'HTTP/0.9 200 OK' string for HTTP/0.9 responses (i.e., responses that lack a status line) or an empty string if there are no headers.*/
13573
+ /** HTTP status line of the response or the 'HTTP/0.9 200 OK' string for HTTP/0.9 responses (i.e., responses that lack a status line) or an empty string if there are no headers. */
13532
13574
  statusLine: string;
13533
13575
  }
13534
13576
 
@@ -13560,7 +13602,7 @@ declare namespace chrome {
13560
13602
  responseHeaders?: HttpHeader[];
13561
13603
  /** Standard HTTP status code returned by the server. */
13562
13604
  statusCode: number;
13563
- /** HTTP status line of the response or the 'HTTP/0.9 200 OK' string for HTTP/0.9 responses (i.e., responses that lack a status line) or an empty string if there are no headers.*/
13605
+ /** HTTP status line of the response or the 'HTTP/0.9 200 OK' string for HTTP/0.9 responses (i.e., responses that lack a status line) or an empty string if there are no headers. */
13564
13606
  statusLine: string;
13565
13607
  }
13566
13608
 
@@ -13583,7 +13625,7 @@ declare namespace chrome {
13583
13625
  securityInfo?: SecurityInfo;
13584
13626
  /** Standard HTTP status code returned by the server. */
13585
13627
  statusCode: number;
13586
- /** HTTP status line of the response or the 'HTTP/0.9 200 OK' string for HTTP/0.9 responses (i.e., responses that lack a status line) or an empty string if there are no headers.*/
13628
+ /** HTTP status line of the response or the 'HTTP/0.9 200 OK' string for HTTP/0.9 responses (i.e., responses that lack a status line) or an empty string if there are no headers. */
13587
13629
  statusLine: string;
13588
13630
  }
13589
13631
 
@@ -13614,9 +13656,9 @@ declare namespace chrome {
13614
13656
 
13615
13657
  const onActionIgnored: events.Event<
13616
13658
  (details: {
13617
- // The proposed action which was ignored.
13659
+ /** The proposed action which was ignored. */
13618
13660
  action: `${IgnoredActionType}`;
13619
- // The ID of the request. Request IDs are unique within a browser session. As a result, they could be used to relate different events of the same request.
13661
+ /** The ID of the request. Request IDs are unique within a browser session. As a result, they could be used to relate different events of the same request. */
13620
13662
  requestId: string;
13621
13663
  }) => void
13622
13664
  >;
@@ -13661,7 +13703,6 @@ declare namespace chrome {
13661
13703
  ) => BlockingResponse | undefined,
13662
13704
  `${OnAuthRequiredOptions}`[]
13663
13705
  >;
13664
- // const onAuthRequired: WebAuthenticationChallengeEvent;
13665
13706
 
13666
13707
  /** Fired when the first byte of the response body is received. For HTTP requests, this means that the status line and response headers are available. */
13667
13708
  const onResponseStarted: WebRequestEvent<
@@ -14767,13 +14808,13 @@ declare namespace chrome {
14767
14808
  /** @since Chrome 141 */
14768
14809
  type CloseOptions =
14769
14810
  | {
14770
- /** The tab in which to close the side panel. If a tab-specific side panel is open in the specified tab, it will be closed for that tab. At least one of this or `windowId` must be provided. */
14811
+ /** The tab in which to close the side panel. If a tab-specific side panel is open in the specified tab, it will be closed for that tab. At least one of this or `windowId` must be provided. */
14771
14812
  tabId: number;
14772
14813
  /** The window in which to close the side panel. If a global side panel is open in the specified window, it will be closed for all tabs in that window where no tab-specific panel is active. At least one of this or `tabId` must be provided. */
14773
14814
  windowId?: number | undefined;
14774
14815
  }
14775
14816
  | {
14776
- /** The tab in which to close the side panel. If a tab-specific side panel is open in the specified tab, it will be closed for that tab. At least one of this or `windowId` must be provided. */
14817
+ /** The tab in which to close the side panel. If a tab-specific side panel is open in the specified tab, it will be closed for that tab. At least one of this or `windowId` must be provided. */
14777
14818
  tabId?: number | undefined;
14778
14819
  /** The window in which to close the side panel. If a global side panel is open in the specified window, it will be closed for all tabs in that window where no tab-specific panel is active. At least one of this or `tabId` must be provided. */
14779
14820
  windowId: number;
@@ -14793,7 +14834,7 @@ declare namespace chrome {
14793
14834
  /**
14794
14835
  * The tab in which to open the side panel.
14795
14836
  * If the corresponding tab has a tab-specific side panel, the panel will only be open for that tab.
14796
- * If there is not a tab-specific panel, the global panel will be open in the specified tab and any other tabs without a currently-open tab- specific panel.
14837
+ * If there is not a tab-specific panel, the global panel will be open in the specified tab and any other tabs without a currently-open tab-specific panel.
14797
14838
  * This will override any currently-active side panel (global or tab-specific) in the corresponding tab.
14798
14839
  * At least one of this and `windowId` must be provided. */
14799
14840
  tabId?: number | undefined;
@@ -14985,7 +15026,7 @@ declare namespace chrome {
14985
15026
  interface WorldProperties {
14986
15027
  /** Specifies the world csp. The default is the `ISOLATED` world csp. */
14987
15028
  csp?: string | undefined;
14988
- /** Specifies whether messaging APIs are exposed. The default is `false`.*/
15029
+ /** Specifies whether messaging APIs are exposed. The default is `false`. */
14989
15030
  messaging?: boolean | undefined;
14990
15031
  /**
14991
15032
  * Specifies the ID of the specific user script world to update. If not provided, updates the properties of the default user script world. Values with leading underscores (`_`) are reserved.
@@ -14999,7 +15040,7 @@ declare namespace chrome {
14999
15040
  ids?: string[] | undefined;
15000
15041
  }
15001
15042
 
15002
- // /** @since Chrome 135 */
15043
+ /** @since Chrome 135 */
15003
15044
  type InjectionTarget =
15004
15045
  & {
15005
15046
  /** The ID of the tab into which to inject. */
@@ -15037,13 +15078,13 @@ declare namespace chrome {
15037
15078
  allFrames?: boolean | undefined;
15038
15079
  /** Specifies wildcard patterns for pages this user script will NOT be injected into. */
15039
15080
  excludeGlobs?: string[] | undefined;
15040
- /**Excludes pages that this user script would otherwise be injected into. See Match Patterns for more details on the syntax of these strings. */
15081
+ /** Excludes pages that this user script would otherwise be injected into. See Match Patterns for more details on the syntax of these strings. */
15041
15082
  excludeMatches?: string[] | undefined;
15042
15083
  /** The ID of the user script specified in the API call. This property must not start with a '_' as it's reserved as a prefix for generated script IDs. */
15043
15084
  id: string;
15044
15085
  /** Specifies wildcard patterns for pages this user script will be injected into. */
15045
15086
  includeGlobs?: string[] | undefined;
15046
- /** The list of ScriptSource objects defining sources of scripts to be injected into matching pages. This property must be specified for {@link register}, and when specified it must be a non-empty array.*/
15087
+ /** The list of ScriptSource objects defining sources of scripts to be injected into matching pages. This property must be specified for {@link register}, and when specified it must be a non-empty array. */
15047
15088
  js?: ScriptSource[] | undefined;
15048
15089
  /** Specifies which pages this user script will be injected into. See Match Patterns for more details on the syntax of these strings. This property must be specified for {@link register}. */
15049
15090
  matches?: string[] | undefined;
chrome/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@types/chrome",
3
- "version": "0.2.5",
3
+ "version": "0.2.7",
4
4
  "description": "TypeScript definitions for chrome",
5
5
  "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/chrome",
6
6
  "license": "MIT",
@@ -94,6 +94,6 @@
94
94
  "@types/har-format": "*"
95
95
  },
96
96
  "peerDependencies": {},
97
- "typesPublisherContentHash": "e51c75dde3ead4663df9abefa0b6c0b7b91334e97ff04a090ec4665fd83ff079",
97
+ "typesPublisherContentHash": "47a32e4859f36cb5c33ad530ec591ce35a563d6725344169f0b57debde67a4d3",
98
98
  "typeScriptVersion": "5.6"
99
99
  }