chrome-types 0.1.231 → 0.1.233

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. package/_all.d.ts +198 -79
  2. package/index.d.ts +164 -45
  3. package/package.json +2 -2
package/_all.d.ts CHANGED
@@ -14,8 +14,8 @@
14
14
  * limitations under the License.
15
15
  */
16
16
 
17
- // Generated on Thu Aug 31 2023 22:29:55 GMT+0000 (Coordinated Universal Time)
18
- // Built at cd715fdb98572d1150dec612a31dff560090d697
17
+ // Generated on Wed Oct 18 2023 22:34:57 GMT+0000 (Coordinated Universal Time)
18
+ // Built at 21919053e93b8cae4243b76c725831f21b7e4e9c
19
19
 
20
20
  // Includes all types, including MV2 + Platform Apps APIs.
21
21
 
@@ -681,8 +681,8 @@ declare namespace chrome {
681
681
  * Opens the extension's popup.
682
682
  *
683
683
  * @param options Specifies options for opening the popup.
684
- * @alpha
685
- * @chrome-channel dev
684
+ * @since Chrome 118
685
+ * @chrome-install-location policy
686
686
  */
687
687
  export function openPopup(
688
688
 
@@ -693,8 +693,8 @@ declare namespace chrome {
693
693
  * Opens the extension's popup.
694
694
  *
695
695
  * @param options Specifies options for opening the popup.
696
- * @alpha
697
- * @chrome-channel dev
696
+ * @since Chrome 118
697
+ * @chrome-install-location policy
698
698
  */
699
699
  export function openPopup(
700
700
 
@@ -1619,7 +1619,7 @@ declare namespace chrome {
1619
1619
  *
1620
1620
  * To automatically remember the positions of windows you can give them ids. If a window has an id, This id is used to remember the size and position of the window whenever it is moved or resized. This size and position is then used instead of the specified bounds on subsequent opening of a window with the same id. If you need to open a window with an id at a location other than the remembered default, you can create it hidden, move it to the desired location, then show it.
1621
1621
  *
1622
- * @chrome-returns-extra since Pending
1622
+ * @chrome-returns-extra since Chrome 117
1623
1623
  */
1624
1624
  export function create(
1625
1625
 
@@ -4441,7 +4441,7 @@ declare namespace chrome {
4441
4441
  /**
4442
4442
  * Opens a new tab in a browser window associated with the current application and Chrome profile. If no browser window for the Chrome profile is opened, a new one is opened prior to creating the new tab.
4443
4443
  *
4444
- * @chrome-returns-extra since Pending
4444
+ * @chrome-returns-extra since Chrome 117
4445
4445
  * @param options Configures how the tab should be opened.
4446
4446
  */
4447
4447
  export function openTab(
@@ -6765,6 +6765,19 @@ declare namespace chrome {
6765
6765
  */
6766
6766
  export type SameSiteStatus = "no_restriction" | "lax" | "strict" | "unspecified";
6767
6767
 
6768
+ /**
6769
+ * Represents a partitioned cookie's partition key.
6770
+ *
6771
+ * @since Pending
6772
+ */
6773
+ export interface CookiePartitionKey {
6774
+
6775
+ /**
6776
+ * The top-level site the partitioned cookie is available in.
6777
+ */
6778
+ topLevelSite?: string;
6779
+ }
6780
+
6768
6781
  /**
6769
6782
  * Represents information about an HTTP cookie.
6770
6783
  */
@@ -6826,6 +6839,13 @@ declare namespace chrome {
6826
6839
  * The ID of the cookie store containing this cookie, as provided in getAllCookieStores().
6827
6840
  */
6828
6841
  storeId: string;
6842
+
6843
+ /**
6844
+ * The partition key for reading or modifying cookies with the Partitioned attribute.
6845
+ *
6846
+ * @since Pending
6847
+ */
6848
+ partitionKey?: CookiePartitionKey;
6829
6849
  }
6830
6850
 
6831
6851
  /**
@@ -6872,6 +6892,13 @@ declare namespace chrome {
6872
6892
  * The ID of the cookie store in which to look for the cookie. By default, the current execution context's cookie store will be used.
6873
6893
  */
6874
6894
  storeId?: string;
6895
+
6896
+ /**
6897
+ * The partition key for reading or modifying cookies with the Partitioned attribute.
6898
+ *
6899
+ * @since Pending
6900
+ */
6901
+ partitionKey?: CookiePartitionKey;
6875
6902
  }
6876
6903
 
6877
6904
  /**
@@ -6966,6 +6993,13 @@ declare namespace chrome {
6966
6993
  * The cookie store to retrieve cookies from. If omitted, the current execution context's cookie store will be used.
6967
6994
  */
6968
6995
  storeId?: string,
6996
+
6997
+ /**
6998
+ * The partition key for reading or modifying cookies with the Partitioned attribute.
6999
+ *
7000
+ * @since Pending
7001
+ */
7002
+ partitionKey?: CookiePartitionKey,
6969
7003
  },
6970
7004
  ): Promise<Cookie[]>;
6971
7005
 
@@ -7012,6 +7046,13 @@ declare namespace chrome {
7012
7046
  * The cookie store to retrieve cookies from. If omitted, the current execution context's cookie store will be used.
7013
7047
  */
7014
7048
  storeId?: string,
7049
+
7050
+ /**
7051
+ * The partition key for reading or modifying cookies with the Partitioned attribute.
7052
+ *
7053
+ * @since Pending
7054
+ */
7055
+ partitionKey?: CookiePartitionKey,
7015
7056
  },
7016
7057
 
7017
7058
  /**
@@ -7083,6 +7124,13 @@ declare namespace chrome {
7083
7124
  * The ID of the cookie store in which to set the cookie. By default, the cookie is set in the current execution context's cookie store.
7084
7125
  */
7085
7126
  storeId?: string,
7127
+
7128
+ /**
7129
+ * The partition key for reading or modifying cookies with the Partitioned attribute.
7130
+ *
7131
+ * @since Pending
7132
+ */
7133
+ partitionKey?: CookiePartitionKey,
7086
7134
  },
7087
7135
  ): Promise<Cookie | undefined>;
7088
7136
 
@@ -7146,6 +7194,13 @@ declare namespace chrome {
7146
7194
  * The ID of the cookie store in which to set the cookie. By default, the cookie is set in the current execution context's cookie store.
7147
7195
  */
7148
7196
  storeId?: string,
7197
+
7198
+ /**
7199
+ * The partition key for reading or modifying cookies with the Partitioned attribute.
7200
+ *
7201
+ * @since Pending
7202
+ */
7203
+ partitionKey?: CookiePartitionKey,
7149
7204
  },
7150
7205
 
7151
7206
  /**
@@ -7180,6 +7235,13 @@ declare namespace chrome {
7180
7235
  * The ID of the cookie store from which the cookie was removed.
7181
7236
  */
7182
7237
  storeId: string,
7238
+
7239
+ /**
7240
+ * The partition key for reading or modifying cookies with the Partitioned attribute.
7241
+ *
7242
+ * @since Pending
7243
+ */
7244
+ partitionKey?: CookiePartitionKey,
7183
7245
  } | undefined>;
7184
7246
 
7185
7247
  /**
@@ -7209,6 +7271,13 @@ declare namespace chrome {
7209
7271
  * The ID of the cookie store from which the cookie was removed.
7210
7272
  */
7211
7273
  storeId: string,
7274
+
7275
+ /**
7276
+ * The partition key for reading or modifying cookies with the Partitioned attribute.
7277
+ *
7278
+ * @since Pending
7279
+ */
7280
+ partitionKey?: CookiePartitionKey,
7212
7281
  },
7213
7282
  ) => void,
7214
7283
  ): void;
@@ -8325,14 +8394,14 @@ declare namespace chrome {
8325
8394
  /**
8326
8395
  * The maximum number of static `Rulesets` an extension can specify as part of the `"rule_resources"` manifest key.
8327
8396
  */
8328
- export const MAX_NUMBER_OF_STATIC_RULESETS: 50;
8397
+ export const MAX_NUMBER_OF_STATIC_RULESETS: 100;
8329
8398
 
8330
8399
  /**
8331
8400
  * The maximum number of static `Rulesets` an extension can enable at any one time.
8332
8401
  *
8333
8402
  * @since Chrome 94
8334
8403
  */
8335
- export const MAX_NUMBER_OF_ENABLED_STATIC_RULESETS: 10;
8404
+ export const MAX_NUMBER_OF_ENABLED_STATIC_RULESETS: 50;
8336
8405
 
8337
8406
  /**
8338
8407
  * Ruleset ID for the dynamic rules added by the extension.
@@ -10316,7 +10385,7 @@ declare namespace chrome {
10316
10385
  *
10317
10386
  * The user has accepted the dangerous download.
10318
10387
  */
10319
- export type DangerType = "file" | "url" | "content" | "uncommon" | "host" | "unwanted" | "safe" | "accepted" | "allowlistedByPolicy" | "asyncScanning" | "passwordProtected" | "blockedTooLarge" | "sensitiveContentWarning" | "sensitiveContentBlock" | "unsupportedFileType" | "deepScannedFailed" | "deepScannedSafe" | "deepScannedOpenedDangerous" | "promptForScaning" | "accountCompromise";
10388
+ export type DangerType = "file" | "url" | "content" | "uncommon" | "host" | "unwanted" | "safe" | "accepted" | "allowlistedByPolicy" | "asyncScanning" | "passwordProtected" | "blockedTooLarge" | "sensitiveContentWarning" | "sensitiveContentBlock" | "unsupportedFileType" | "deepScannedFailed" | "deepScannedSafe" | "deepScannedOpenedDangerous" | "promptForScanning" | "promptForLocalPasswordScanning" | "accountCompromise";
10320
10389
 
10321
10390
  /**
10322
10391
  * in\_progress
@@ -10981,6 +11050,7 @@ declare namespace chrome {
10981
11050
  * Enable or disable the gray shelf at the bottom of every window associated with the current browser profile. The shelf will be disabled as long as at least one extension has disabled it. Enabling the shelf while at least one other extension has disabled it will return an error through {@link runtime.lastError}. Requires the `"downloads.shelf"` permission in addition to the `"downloads"` permission.
10982
11051
  *
10983
11052
  * @deprecated Use {@link setUiOptions} instead.
11053
+ * @chrome-deprecated-since Chrome 117
10984
11054
  */
10985
11055
  export function setShelfEnabled(
10986
11056
 
@@ -11018,6 +11088,7 @@ declare namespace chrome {
11018
11088
  *
11019
11089
  * @since Chrome 46
11020
11090
  * @chrome-permission enterprise.deviceAttributes
11091
+ * @chrome-install-location policy
11021
11092
  * @chrome-platform chromeos
11022
11093
  * @chrome-platform lacros
11023
11094
  */
@@ -11132,6 +11203,7 @@ declare namespace chrome {
11132
11203
  *
11133
11204
  * @since Chrome 71
11134
11205
  * @chrome-permission enterprise.hardwarePlatform
11206
+ * @chrome-install-location policy
11135
11207
  */
11136
11208
  export namespace enterprise.hardwarePlatform {
11137
11209
 
@@ -11167,6 +11239,7 @@ declare namespace chrome {
11167
11239
  *
11168
11240
  * @since Chrome 85
11169
11241
  * @chrome-permission enterprise.networkingAttributes
11242
+ * @chrome-install-location policy
11170
11243
  * @chrome-platform chromeos
11171
11244
  * @chrome-platform lacros
11172
11245
  */
@@ -11214,6 +11287,7 @@ declare namespace chrome {
11214
11287
  * 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 platformKeys chrome.platformKeys}.
11215
11288
  *
11216
11289
  * @chrome-permission enterprise.platformKeys
11290
+ * @chrome-install-location policy
11217
11291
  * @chrome-platform chromeos
11218
11292
  * @chrome-platform lacros
11219
11293
  */
@@ -12513,7 +12587,7 @@ declare namespace chrome {
12513
12587
  /**
12514
12588
  * Get the display path of an Entry object. The display path is based on the full path of the file or directory on the local file system, but may be made more readable for display purposes.
12515
12589
  *
12516
- * @chrome-returns-extra since Pending
12590
+ * @chrome-returns-extra since Chrome 117
12517
12591
  */
12518
12592
  export function getDisplayPath(
12519
12593
 
@@ -12535,7 +12609,7 @@ declare namespace chrome {
12535
12609
  /**
12536
12610
  * Get a writable Entry from another Entry. This call will fail with a runtime error if the application does not have the 'write' permission under 'fileSystem'. If entry is a DirectoryEntry, this call will fail if the application does not have the 'directory' permission under 'fileSystem'.
12537
12611
  *
12538
- * @chrome-returns-extra since Pending
12612
+ * @chrome-returns-extra since Chrome 117
12539
12613
  */
12540
12614
  export function getWritableEntry(
12541
12615
 
@@ -12557,7 +12631,7 @@ declare namespace chrome {
12557
12631
  /**
12558
12632
  * Gets whether this Entry is writable or not.
12559
12633
  *
12560
- * @chrome-returns-extra since Pending
12634
+ * @chrome-returns-extra since Chrome 117
12561
12635
  */
12562
12636
  export function isWritableEntry(
12563
12637
 
@@ -12615,7 +12689,7 @@ declare namespace chrome {
12615
12689
  /**
12616
12690
  * Returns whether the app has permission to restore the entry with the given id.
12617
12691
  *
12618
- * @chrome-returns-extra since Pending
12692
+ * @chrome-returns-extra since Chrome 117
12619
12693
  */
12620
12694
  export function isRestorable(
12621
12695
 
@@ -12645,7 +12719,7 @@ declare namespace chrome {
12645
12719
  /**
12646
12720
  * Requests access to a file system for a volume represented by `options.volumeId`. If `options.writable` is set to true, then the file system will be writable. Otherwise, it will be read-only. The `writable` option requires the `"fileSystem": {"write"}` permission in the manifest. Available to kiosk apps running in kiosk session only. For manual-launch kiosk mode, a confirmation dialog will be shown on top of the active app window. In case of an error, `fileSystem` will be undefined, and `chrome.runtime.lastError` will be set.
12647
12721
  *
12648
- * @chrome-returns-extra since Pending
12722
+ * @chrome-returns-extra since Chrome 117
12649
12723
  * @since Chrome 44
12650
12724
  */
12651
12725
  export function requestFileSystem(
@@ -12670,7 +12744,7 @@ declare namespace chrome {
12670
12744
  /**
12671
12745
  * Returns a list of volumes available for `requestFileSystem()`. The `"fileSystem": {"requestFileSystem"}` manifest permission is required. Available to kiosk apps running in the kiosk session only. In case of an error, `volumes` will be undefined, and `chrome.runtime.lastError` will be set.
12672
12746
  *
12673
- * @chrome-returns-extra since Pending
12747
+ * @chrome-returns-extra since Chrome 117
12674
12748
  * @since Chrome 44
12675
12749
  */
12676
12750
  export function getVolumeList(): Promise<Volume[] | undefined>;
@@ -12720,7 +12794,7 @@ declare namespace chrome {
12720
12794
  export type CommonActionId = "SAVE_FOR_OFFLINE" | "OFFLINE_NOT_NECESSARY" | "SHARE";
12721
12795
 
12722
12796
  /**
12723
- * @since Pending
12797
+ * @since Chrome 117
12724
12798
  */
12725
12799
  export interface CloudIdentifier {
12726
12800
 
@@ -12770,7 +12844,7 @@ declare namespace chrome {
12770
12844
  /**
12771
12845
  * Cloud storage representation of this entry. Must be provided if requested in `options` and the file is backed by cloud storage. For local files not backed by cloud storage, it should be undefined when requested.
12772
12846
  *
12773
- * @since Pending
12847
+ * @since Chrome 117
12774
12848
  */
12775
12849
  cloudIdentifier?: CloudIdentifier;
12776
12850
  }
@@ -12971,7 +13045,7 @@ declare namespace chrome {
12971
13045
  /**
12972
13046
  * Set to `true` if `cloudIdentifier` value is requested.
12973
13047
  *
12974
- * @since Pending
13048
+ * @since Chrome 117
12975
13049
  */
12976
13050
  cloudIdentifier: boolean;
12977
13051
  }
@@ -14782,7 +14856,7 @@ declare namespace chrome {
14782
14856
  /**
14783
14857
  * Enumerate connected HID devices.
14784
14858
  *
14785
- * @chrome-returns-extra since Pending
14859
+ * @chrome-returns-extra since Chrome 117
14786
14860
  * @param options The properties to search for on target devices.
14787
14861
  */
14788
14862
  export function getDevices(
@@ -14807,7 +14881,7 @@ declare namespace chrome {
14807
14881
  /**
14808
14882
  * Open a connection to an HID device for communication.
14809
14883
  *
14810
- * @chrome-returns-extra since Pending
14884
+ * @chrome-returns-extra since Chrome 117
14811
14885
  * @param deviceId The {@link HidDeviceInfo.deviceId} of the device to open.
14812
14886
  */
14813
14887
  export function connect(
@@ -14832,7 +14906,7 @@ declare namespace chrome {
14832
14906
  /**
14833
14907
  * Disconnect from a device. Invoking operations on a device after calling this is safe but has no effect.
14834
14908
  *
14835
- * @chrome-returns-extra since Pending
14909
+ * @chrome-returns-extra since Chrome 117
14836
14910
  * @param connectionId The `connectionId` returned by {@link connect}.
14837
14911
  */
14838
14912
  export function disconnect(
@@ -14876,7 +14950,7 @@ declare namespace chrome {
14876
14950
  *
14877
14951
  * _Note:_ Do not include a report ID prefix in `data`. It will be added if necessary.
14878
14952
  *
14879
- * @chrome-returns-extra since Pending
14953
+ * @chrome-returns-extra since Chrome 117
14880
14954
  * @param connectionId The `connectionId` returned by {@link connect}.
14881
14955
  * @param reportId The report ID to use, or `0` if none.
14882
14956
  * @param data The report data.
@@ -14913,7 +14987,7 @@ declare namespace chrome {
14913
14987
  /**
14914
14988
  * Request a feature report from the device.
14915
14989
  *
14916
- * @chrome-returns-extra since Pending
14990
+ * @chrome-returns-extra since Chrome 117
14917
14991
  * @param connectionId The `connectionId` returned by {@link connect}.
14918
14992
  * @param reportId The report ID, or `0` if none.
14919
14993
  */
@@ -14949,7 +15023,7 @@ declare namespace chrome {
14949
15023
  *
14950
15024
  * _Note:_ Do not include a report ID prefix in `data`. It will be added if necessary.
14951
15025
  *
14952
- * @chrome-returns-extra since Pending
15026
+ * @chrome-returns-extra since Chrome 117
14953
15027
  * @param connectionId The `connectionId` returned by {@link connect}.
14954
15028
  * @param reportId The report ID to use, or `0` if none.
14955
15029
  * @param data The report data.
@@ -21116,7 +21190,7 @@ declare namespace chrome {
21116
21190
  }
21117
21191
 
21118
21192
  /**
21119
- * Use the `chrome.permissions` API to request [declared optional permissions](https://developer.chrome.com/docs/extensions/reference/permissions/#manifest) at run time rather than install time, so users understand why the permissions are needed and grant only those that are necessary.
21193
+ * Use the `chrome.permissions` API to request [declared optional permissions](https://developer.chrome.com/docs/extensions/mv3/declare_permissions/) at run time rather than install time, so users understand why the permissions are needed and grant only those that are necessary.
21120
21194
  */
21121
21195
  export namespace permissions {
21122
21196
 
@@ -21804,6 +21878,7 @@ declare namespace chrome {
21804
21878
  *
21805
21879
  * @since Chrome 79
21806
21880
  * @chrome-permission printingMetrics
21881
+ * @chrome-install-location policy
21807
21882
  * @chrome-platform chromeos
21808
21883
  * @chrome-platform lacros
21809
21884
  */
@@ -22097,15 +22172,6 @@ declare namespace chrome {
22097
22172
  */
22098
22173
  thirdPartyCookiesAllowed: types.ChromeSetting<boolean>,
22099
22174
 
22100
- /**
22101
- * If enabled, the experimental [Privacy Sandbox](https://www.chromium.org/Home/chromium-privacy/privacy-sandbox) features are active. The value of this preference is of type boolean, and the default value is `true`.
22102
- *
22103
- * @deprecated We’re deprecating the API {@link websites.privacySandboxEnabled chrome.privacy.websites.privacySandboxEnabled}, though it will remain active for backward compatibility until release M113. Instead, please use {@link websites.topicsEnabled chrome.privacy.websites.topicsEnabled}, {@link websites.fledgeEnabled chrome.privacy.websites.fledgeEnabled} and {@link websites.adMeasurementEnabled chrome.privacy.websites.adMeasurementEnabled}. During the migration period: 1. Enabling privacySandboxEnabled will CLEAR the new APIs listed above because extensions aren’t allowed to enable them; 2. Disabling privacySandboxEnabled will also disable the new APIs; 3. Clearing privacySandboxEnabled will also clear the new APIs.
22104
- * @since Chrome 90
22105
- * @chrome-deprecated-since Chrome 111
22106
- */
22107
- privacySandboxEnabled: types.ChromeSetting<boolean>,
22108
-
22109
22175
  /**
22110
22176
  * If disabled, the [Topics API](https://developer.chrome.com/en/docs/privacy-sandbox/topics/) is deactivated. The value of this preference is of type boolean, and the default value is `true`. Extensions may only disable this API by setting the value to `false`. If you try setting this API to `true`, it will throw an error.
22111
22177
  *
@@ -22547,7 +22613,7 @@ declare namespace chrome {
22547
22613
  }
22548
22614
 
22549
22615
  /**
22550
- * Use the `chrome.readingList` API to read from and modify the items in the Reading List.
22616
+ * Use the `chrome.readingList` API to read from and modify the items in the [Reading List](https://support.google.com/chrome/answer/7343019).
22551
22617
  *
22552
22618
  * @alpha
22553
22619
  * @chrome-permission readingList
@@ -22569,17 +22635,17 @@ declare namespace chrome {
22569
22635
  title: string;
22570
22636
 
22571
22637
  /**
22572
- * True if the entry has been read.
22638
+ * Will be `true` if the entry has been read.
22573
22639
  */
22574
22640
  hasBeenRead: boolean;
22575
22641
 
22576
22642
  /**
22577
- * The last update time of the entry. Recorded in milliseconds since Jan 1st 1970.
22643
+ * The last time the entry was updated. This value is in milliseconds since Jan 1, 1970.
22578
22644
  */
22579
22645
  lastUpdateTime: number;
22580
22646
 
22581
22647
  /**
22582
- * The creation time of the entry. Recorded in milliseconds since Jan 1st 1970.
22648
+ * The time the entry was created. Recorded in milliseconds since Jan 1, 1970.
22583
22649
  */
22584
22650
  creationTime: number;
22585
22651
  }
@@ -22597,7 +22663,7 @@ declare namespace chrome {
22597
22663
  title: string;
22598
22664
 
22599
22665
  /**
22600
- * True if the entry has been read.
22666
+ * Will be `true` if the entry has been read.
22601
22667
  */
22602
22668
  hasBeenRead: boolean;
22603
22669
  }
@@ -22618,12 +22684,12 @@ declare namespace chrome {
22618
22684
  url: string;
22619
22685
 
22620
22686
  /**
22621
- * The updated title.
22687
+ * The new title. The existing tile remains if a value isn't provided.
22622
22688
  */
22623
22689
  title?: string;
22624
22690
 
22625
22691
  /**
22626
- * The updated read status.
22692
+ * The updated read status. The existing status remains if a value isn't provided.
22627
22693
  */
22628
22694
  hasBeenRead?: boolean;
22629
22695
  }
@@ -22631,37 +22697,37 @@ declare namespace chrome {
22631
22697
  export interface QueryInfo {
22632
22698
 
22633
22699
  /**
22634
- * The url to query for.
22700
+ * A url to search for.
22635
22701
  */
22636
22702
  url?: string;
22637
22703
 
22638
22704
  /**
22639
- * The title to query for.
22705
+ * A title to search for.
22640
22706
  */
22641
22707
  title?: string;
22642
22708
 
22643
22709
  /**
22644
- * The read status to query for.
22710
+ * Indicates whether to search for read (`true`) or unread (code>false) items.
22645
22711
  */
22646
22712
  hasBeenRead?: boolean;
22647
22713
  }
22648
22714
 
22649
22715
  /**
22650
- * Triggered when a ReadingListEntry was added to the reading list.
22716
+ * Triggered when a `ReadingListEntry` is added to the reading list.
22651
22717
  */
22652
22718
  export const onEntryAdded: events.Event<(
22653
22719
  entry: ReadingListEntry,
22654
22720
  ) => void>;
22655
22721
 
22656
22722
  /**
22657
- * Triggered when a ReadingListEntry is removed from the reading list.
22723
+ * Triggered when a `ReadingListEntry` is removed from the reading list.
22658
22724
  */
22659
22725
  export const onEntryRemoved: events.Event<(
22660
22726
  entry: ReadingListEntry,
22661
22727
  ) => void>;
22662
22728
 
22663
22729
  /**
22664
- * Triggered when a ReadingListEntry was updated in the reading list.
22730
+ * Triggered when a `ReadingListEntry` is updated in the reading list.
22665
22731
  */
22666
22732
  export const onEntryUpdated: events.Event<(
22667
22733
  entry: ReadingListEntry,
@@ -22714,7 +22780,7 @@ declare namespace chrome {
22714
22780
  ): void;
22715
22781
 
22716
22782
  /**
22717
- * Updates the features of a reading list entry if it exists.
22783
+ * Updates a reading list entry if it exists.
22718
22784
  *
22719
22785
  * @param info The entry to update.
22720
22786
  */
@@ -22724,7 +22790,7 @@ declare namespace chrome {
22724
22790
  ): Promise<void>;
22725
22791
 
22726
22792
  /**
22727
- * Updates the features of a reading list entry if it exists.
22793
+ * Updates a reading list entry if it exists.
22728
22794
  *
22729
22795
  * @param info The entry to update.
22730
22796
  * @param callback Invoked once the matched entries have been updated.
@@ -22737,9 +22803,9 @@ declare namespace chrome {
22737
22803
  ): void;
22738
22804
 
22739
22805
  /**
22740
- * Retrieves all entries which match the QueryInfo properties. Properties which are not provided will not be matched.
22806
+ * Retrieves all entries that match the `QueryInfo` properties. Properties that are not provided will not be matched.
22741
22807
  *
22742
- * @param info The entry properties to search for.
22808
+ * @param info The properties to search for.
22743
22809
  */
22744
22810
  export function query(
22745
22811
 
@@ -22747,9 +22813,9 @@ declare namespace chrome {
22747
22813
  ): Promise<ReadingListEntry[]>;
22748
22814
 
22749
22815
  /**
22750
- * Retrieves all entries which match the QueryInfo properties. Properties which are not provided will not be matched.
22816
+ * Retrieves all entries that match the `QueryInfo` properties. Properties that are not provided will not be matched.
22751
22817
  *
22752
- * @param info The entry properties to search for.
22818
+ * @param info The properties to search for.
22753
22819
  * @param callback Invoked once the entries have been matched.
22754
22820
  */
22755
22821
  export function query(
@@ -23765,6 +23831,13 @@ declare namespace chrome {
23765
23831
  */
23766
23832
  allFrames?: boolean;
23767
23833
 
23834
+ /**
23835
+ * Whether the script should inject into any frames where the URL belongs to a scheme that would never match a specified Match Pattern, including about:, data:, blob:, and filesystem: schemes. In these cases, in order to determine if the script should inject, the origin of the URL is checked. If the origin is `null` (as is the case for data: URLs), then the "initiator" or "creator" origin is used (i.e., the origin of the frame that created or navigated this frame). Note that this may not be the parent frame, if the frame was navigated by another frame in the document hierarchy.
23836
+ *
23837
+ * @since Pending
23838
+ */
23839
+ matchOriginAsFallback?: boolean;
23840
+
23768
23841
  /**
23769
23842
  * Specifies when JavaScript files are injected into the web page. The preferred and default value is `document_idle`.
23770
23843
  */
@@ -24291,7 +24364,7 @@ declare namespace chrome {
24291
24364
  /**
24292
24365
  * Returns information about available serial devices on the system. The list is regenerated each time this method is called.
24293
24366
  *
24294
- * @chrome-returns-extra since Pending
24367
+ * @chrome-returns-extra since Chrome 117
24295
24368
  */
24296
24369
  export function getDevices(): Promise<DeviceInfo[]>;
24297
24370
 
@@ -24310,7 +24383,7 @@ declare namespace chrome {
24310
24383
  /**
24311
24384
  * Connects to a given serial port.
24312
24385
  *
24313
- * @chrome-returns-extra since Pending
24386
+ * @chrome-returns-extra since Chrome 117
24314
24387
  * @param path The system path of the serial port to open.
24315
24388
  * @param options Port configuration options.
24316
24389
  */
@@ -24342,7 +24415,7 @@ declare namespace chrome {
24342
24415
  /**
24343
24416
  * Update the option settings on an open serial port connection.
24344
24417
  *
24345
- * @chrome-returns-extra since Pending
24418
+ * @chrome-returns-extra since Chrome 117
24346
24419
  * @param connectionId The id of the opened connection.
24347
24420
  * @param options Port configuration options.
24348
24421
  */
@@ -24374,7 +24447,7 @@ declare namespace chrome {
24374
24447
  /**
24375
24448
  * Disconnects from a serial port.
24376
24449
  *
24377
- * @chrome-returns-extra since Pending
24450
+ * @chrome-returns-extra since Chrome 117
24378
24451
  * @param connectionId The id of the opened connection.
24379
24452
  */
24380
24453
  export function disconnect(
@@ -24400,7 +24473,7 @@ declare namespace chrome {
24400
24473
  /**
24401
24474
  * Pauses or unpauses an open connection.
24402
24475
  *
24403
- * @chrome-returns-extra since Pending
24476
+ * @chrome-returns-extra since Chrome 117
24404
24477
  * @param connectionId The id of the opened connection.
24405
24478
  * @param paused Flag to indicate whether to pause or unpause.
24406
24479
  */
@@ -24430,7 +24503,7 @@ declare namespace chrome {
24430
24503
  /**
24431
24504
  * Retrieves the state of a given connection.
24432
24505
  *
24433
- * @chrome-returns-extra since Pending
24506
+ * @chrome-returns-extra since Chrome 117
24434
24507
  * @param connectionId The id of the opened connection.
24435
24508
  */
24436
24509
  export function getInfo(
@@ -24456,7 +24529,7 @@ declare namespace chrome {
24456
24529
  /**
24457
24530
  * Retrieves the list of currently opened serial port connections owned by the application.
24458
24531
  *
24459
- * @chrome-returns-extra since Pending
24532
+ * @chrome-returns-extra since Chrome 117
24460
24533
  */
24461
24534
  export function getConnections(): Promise<ConnectionInfo[]>;
24462
24535
 
@@ -24475,7 +24548,7 @@ declare namespace chrome {
24475
24548
  /**
24476
24549
  * Writes data to the given connection.
24477
24550
  *
24478
- * @chrome-returns-extra since Pending
24551
+ * @chrome-returns-extra since Chrome 117
24479
24552
  * @param connectionId The id of the connection.
24480
24553
  * @param data The data to send.
24481
24554
  */
@@ -24507,7 +24580,7 @@ declare namespace chrome {
24507
24580
  /**
24508
24581
  * Flushes all bytes in the given connection's input and output buffers.
24509
24582
  *
24510
- * @chrome-returns-extra since Pending
24583
+ * @chrome-returns-extra since Chrome 117
24511
24584
  */
24512
24585
  export function flush(
24513
24586
 
@@ -24529,7 +24602,7 @@ declare namespace chrome {
24529
24602
  /**
24530
24603
  * Retrieves the state of control signals on a given connection.
24531
24604
  *
24532
- * @chrome-returns-extra since Pending
24605
+ * @chrome-returns-extra since Chrome 117
24533
24606
  * @param connectionId The id of the connection.
24534
24607
  */
24535
24608
  export function getControlSignals(
@@ -24555,7 +24628,7 @@ declare namespace chrome {
24555
24628
  /**
24556
24629
  * Sets the state of control signals on a given connection.
24557
24630
  *
24558
- * @chrome-returns-extra since Pending
24631
+ * @chrome-returns-extra since Chrome 117
24559
24632
  * @param connectionId The id of the connection.
24560
24633
  * @param signals The set of signal changes to send to the device.
24561
24634
  */
@@ -24587,7 +24660,7 @@ declare namespace chrome {
24587
24660
  /**
24588
24661
  * Suspends character transmission on a given connection and places the transmission line in a break state until the clearBreak is called.
24589
24662
  *
24590
- * @chrome-returns-extra since Pending
24663
+ * @chrome-returns-extra since Chrome 117
24591
24664
  * @param connectionId The id of the connection.
24592
24665
  * @since Chrome 45
24593
24666
  */
@@ -24614,7 +24687,7 @@ declare namespace chrome {
24614
24687
  /**
24615
24688
  * Restore character transmission on a given connection and place the transmission line in a nonbreak state.
24616
24689
  *
24617
- * @chrome-returns-extra since Pending
24690
+ * @chrome-returns-extra since Chrome 117
24618
24691
  * @param connectionId The id of the connection.
24619
24692
  * @since Chrome 45
24620
24693
  */
@@ -27198,7 +27271,7 @@ declare namespace chrome {
27198
27271
  *
27199
27272
  * Note this call can fail. For example, if the user is not signed in to Chrome or if there is no network operation. To handle these errors it is important chrome.runtime.lastError is checked in the callback.
27200
27273
  *
27201
- * @chrome-returns-extra since Pending
27274
+ * @chrome-returns-extra since Chrome 117
27202
27275
  */
27203
27276
  export function requestFileSystem(): Promise<DOMFileSystem>;
27204
27277
 
@@ -27221,7 +27294,7 @@ declare namespace chrome {
27221
27294
  /**
27222
27295
  * Sets the default conflict resolution policy for the `'syncable'` file storage for the app. By default it is set to `'last_write_win'`. When conflict resolution policy is set to `'last_write_win'` conflicts for existing files are automatically resolved next time the file is updated. `callback` can be optionally given to know if the request has succeeded or not.
27223
27296
  *
27224
- * @chrome-returns-extra since Pending
27297
+ * @chrome-returns-extra since Chrome 117
27225
27298
  */
27226
27299
  export function setConflictResolutionPolicy(
27227
27300
 
@@ -27243,7 +27316,7 @@ declare namespace chrome {
27243
27316
  /**
27244
27317
  * Gets the current conflict resolution policy.
27245
27318
  *
27246
- * @chrome-returns-extra since Pending
27319
+ * @chrome-returns-extra since Chrome 117
27247
27320
  */
27248
27321
  export function getConflictResolutionPolicy(): Promise<ConflictResolutionPolicy>;
27249
27322
 
@@ -27262,7 +27335,7 @@ declare namespace chrome {
27262
27335
  /**
27263
27336
  * Returns the current usage and quota in bytes for the `'syncable'` file storage for the app.
27264
27337
  *
27265
- * @chrome-returns-extra since Pending
27338
+ * @chrome-returns-extra since Chrome 117
27266
27339
  */
27267
27340
  export function getUsageAndQuota(
27268
27341
 
@@ -27286,7 +27359,7 @@ declare namespace chrome {
27286
27359
  /**
27287
27360
  * Returns the {@link FileStatus} for the given `fileEntry`. The status value can be `'synced'`, `'pending'` or `'conflicting'`. Note that `'conflicting'` state only happens when the service's conflict resolution policy is set to `'manual'`.
27288
27361
  *
27289
- * @chrome-returns-extra since Pending
27362
+ * @chrome-returns-extra since Chrome 117
27290
27363
  */
27291
27364
  export function getFileStatus(
27292
27365
 
@@ -27310,7 +27383,7 @@ declare namespace chrome {
27310
27383
  /**
27311
27384
  * Returns each {@link FileStatus} for the given `fileEntry` array. Typically called with the result from dirReader.readEntries().
27312
27385
  *
27313
- * @chrome-returns-extra since Pending
27386
+ * @chrome-returns-extra since Chrome 117
27314
27387
  */
27315
27388
  export function getFileStatuses(
27316
27389
 
@@ -27334,7 +27407,7 @@ declare namespace chrome {
27334
27407
  /**
27335
27408
  * Returns the current sync backend status.
27336
27409
  *
27337
- * @chrome-returns-extra since Pending
27410
+ * @chrome-returns-extra since Chrome 117
27338
27411
  */
27339
27412
  export function getServiceStatus(): Promise<ServiceStatus>;
27340
27413
 
@@ -27675,7 +27748,7 @@ declare namespace chrome {
27675
27748
  /**
27676
27749
  * An enum to tell if the display is detected and used by the system. The display is considered 'inactive', if it is not detected by the system (maybe disconnected, or considered disconnected due to sleep mode, etc). This state is used to keep existing display when the all displays are disconnected, for example.
27677
27750
  *
27678
- * @since Pending
27751
+ * @since Chrome 117
27679
27752
  */
27680
27753
  export type ActiveState = "active" | "inactive";
27681
27754
 
@@ -27723,7 +27796,7 @@ declare namespace chrome {
27723
27796
  /**
27724
27797
  * Active if the display is detected and used by the system.
27725
27798
  *
27726
- * @since Pending
27799
+ * @since Chrome 117
27727
27800
  */
27728
27801
  activeState: ActiveState;
27729
27802
 
@@ -32475,6 +32548,14 @@ declare namespace chrome {
32475
32548
  */
32476
32549
  export namespace userScripts {
32477
32550
 
32551
+ /**
32552
+ * The JavaScript world for a user script to execute within.
32553
+ *
32554
+ * @chrome-enum "MAIN" Specifies the execution environment of the DOM, which is the execution environment shared with the host page's JavaScript.
32555
+ * @chrome-enum "USER\_SCRIPT" Specifies the execution enviroment that is specific to user scripts and is exempt from the page's CSP.
32556
+ */
32557
+ export type ExecutionWorld = "MAIN" | "USER_SCRIPT";
32558
+
32478
32559
  export interface ScriptSource {
32479
32560
 
32480
32561
  /**
@@ -32496,7 +32577,7 @@ declare namespace chrome {
32496
32577
  allFrames?: boolean;
32497
32578
 
32498
32579
  /**
32499
- * Excludes pages that this content script would otherwise be injected into. See [Match Patterns](https://developer.chrome.com/docs/extensions/match_patterns) for more details on the syntax of these strings.
32580
+ * Excludes pages that this user script would otherwise be injected into. See [Match Patterns](https://developer.chrome.com/docs/extensions/match_patterns) for more details on the syntax of these strings.
32500
32581
  */
32501
32582
  excludeMatches?: string[];
32502
32583
 
@@ -32505,13 +32586,23 @@ declare namespace chrome {
32505
32586
  */
32506
32587
  id: string;
32507
32588
 
32589
+ /**
32590
+ * Specifies wildcard patterns for pages this user script will be injected into.
32591
+ */
32592
+ includeGlobs?: string[];
32593
+
32594
+ /**
32595
+ * Specifies wildcard patterns for pages this user script will NOT be injected into.
32596
+ */
32597
+ excludeGlobs?: string[];
32598
+
32508
32599
  /**
32509
32600
  * The list of ScriptSource objects defining sources of scripts to be injected into matching pages.
32510
32601
  */
32511
32602
  js: ScriptSource[];
32512
32603
 
32513
32604
  /**
32514
- * Specifies which pages this content script will be injected into. See [Match Patterns](https://developer.chrome.com/docs/extensions/match_patterns) for more details on the syntax of these strings.
32605
+ * Specifies which pages this user script will be injected into. See [Match Patterns](https://developer.chrome.com/docs/extensions/match_patterns) for more details on the syntax of these strings. This property must be specified for ${ref:register}.
32515
32606
  */
32516
32607
  matches?: string[];
32517
32608
 
@@ -32519,6 +32610,11 @@ declare namespace chrome {
32519
32610
  * Specifies when JavaScript files are injected into the web page. The preferred and default value is `document_idle`.
32520
32611
  */
32521
32612
  runAt?: extensionTypes.RunAt;
32613
+
32614
+ /**
32615
+ * The JavaScript execution environment to run the script in. The default is `` `USER_SCRIPT` ``.
32616
+ */
32617
+ world?: ExecutionWorld;
32522
32618
  }
32523
32619
 
32524
32620
  export interface UserScriptFilter {
@@ -32599,6 +32695,29 @@ declare namespace chrome {
32599
32695
 
32600
32696
  callback?: () => void,
32601
32697
  ): void;
32698
+
32699
+ /**
32700
+ * Updates one or more user scripts for this extension.
32701
+ *
32702
+ * @param scripts Contains a list of user scripts to be updated. A property is only updated for the existing script if it is specified in this object. If there are errors during script parsing/file validation, or if the IDs specified do not correspond to a fully registered script, then no scripts are updated.
32703
+ */
32704
+ export function update(
32705
+
32706
+ scripts: RegisteredUserScript[],
32707
+ ): Promise<void>;
32708
+
32709
+ /**
32710
+ * Updates one or more user scripts for this extension.
32711
+ *
32712
+ * @param scripts Contains a list of user scripts to be updated. A property is only updated for the existing script if it is specified in this object. If there are errors during script parsing/file validation, or if the IDs specified do not correspond to a fully registered script, then no scripts are updated.
32713
+ * @param callback Called once scripts have been fully updated or if an error occurs.
32714
+ */
32715
+ export function update(
32716
+
32717
+ scripts: RegisteredUserScript[],
32718
+
32719
+ callback?: () => void,
32720
+ ): void;
32602
32721
  }
32603
32722
 
32604
32723
  /**