@cloudflare/workers-types 5.20260811.1 → 5.20260813.1

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.
@@ -16,26 +16,26 @@ and limitations under the License.
16
16
  // noinspection JSUnusedGlobalSymbols
17
17
  export declare var onmessage: never;
18
18
  /**
19
- * The **`DOMException`** interface represents an abnormal event (called an **exception**) that occurs as a result of calling a method or accessing a property of a web API.
19
+ * The **`DOMException`** interface represents an abnormal event (called an exception) that occurs as a result of calling a method or accessing a property of a web API. This is how error conditions are described in web APIs.
20
20
  *
21
21
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException)
22
22
  */
23
23
  export declare class DOMException extends Error {
24
24
  constructor(message?: string, name?: string);
25
25
  /**
26
- * The **`message`** read-only property of the a message or description associated with the given error name.
26
+ * The **`message`** read-only property of the DOMException interface returns a string representing a message or description associated with the given error name.
27
27
  *
28
28
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/message)
29
29
  */
30
30
  readonly message: string;
31
31
  /**
32
- * The **`name`** read-only property of the one of the strings associated with an error name.
32
+ * The **`name`** read-only property of the DOMException interface returns a string that contains one of the strings associated with an error name.
33
33
  *
34
34
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/name)
35
35
  */
36
36
  readonly name: string;
37
37
  /**
38
- * The **`code`** read-only property of the DOMException interface returns one of the legacy error code constants, or `0` if none match.
38
+ * The **`code`** read-only property of the DOMException interface returns one of the legacy error code constants, or 0 if none match.
39
39
  * @deprecated
40
40
  *
41
41
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/code)
@@ -85,7 +85,7 @@ export declare abstract class WorkerGlobalScope extends EventTarget<WorkerGlobal
85
85
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console)
86
86
  */
87
87
  export interface Console {
88
- "assert"(condition?: boolean, ...data: any[]): void;
88
+ assert(condition?: boolean, ...data: any[]): void;
89
89
  /**
90
90
  * The **`console.clear()`** static method clears the console if possible.
91
91
  *
@@ -93,61 +93,61 @@ export interface Console {
93
93
  */
94
94
  clear(): void;
95
95
  /**
96
- * The **`console.count()`** static method logs the number of times that this particular call to `count()` has been called.
96
+ * The **`console.count()`** static method logs the number of times that this particular call to count() has been called.
97
97
  *
98
98
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/count_static)
99
99
  */
100
100
  count(label?: string): void;
101
101
  /**
102
- * The **`console.countReset()`** static method resets counter used with console/count_static.
102
+ * The **`console.countReset()`** static method resets counter used with console.count().
103
103
  *
104
104
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/countReset_static)
105
105
  */
106
106
  countReset(label?: string): void;
107
107
  /**
108
- * The **`console.debug()`** static method outputs a message to the console at the 'debug' log level.
108
+ * The **`console.debug()`** static method outputs a message to the console at the "debug" log level. The message is only displayed to the user if the console is configured to display debug output. In most cases, the log level is configured within the console UI. This log level might correspond to the Debug or Verbose log level.
109
109
  *
110
110
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/debug_static)
111
111
  */
112
112
  debug(...data: any[]): void;
113
113
  /**
114
- * The **`console.dir()`** static method displays a list of the properties of the specified JavaScript object.
114
+ * The **`console.dir()`** static method displays a list of the properties of the specified JavaScript object. In browser consoles, the output is presented as a hierarchical listing with disclosure triangles that let you see the contents of child objects.
115
115
  *
116
116
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/dir_static)
117
117
  */
118
118
  dir(item?: any, options?: any): void;
119
119
  /**
120
- * The **`console.dirxml()`** static method displays an interactive tree of the descendant elements of the specified XML/HTML element.
120
+ * The **`console.dirxml()`** static method displays an interactive tree of the descendant elements of the specified XML/HTML element. If it is not possible to display as an element the JavaScript Object view is shown instead. The output is presented as a hierarchical listing of expandable nodes that let you see the contents of child nodes.
121
121
  *
122
122
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/dirxml_static)
123
123
  */
124
124
  dirxml(...data: any[]): void;
125
125
  /**
126
- * The **`console.error()`** static method outputs a message to the console at the 'error' log level.
126
+ * The **`console.error()`** static method outputs a message to the console at the "error" log level. The message is only displayed to the user if the console is configured to display error output. In most cases, the log level is configured within the console UI. The message may be formatted as an error, with red colors and call stack information.
127
127
  *
128
128
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/error_static)
129
129
  */
130
130
  error(...data: any[]): void;
131
131
  /**
132
- * The **`console.group()`** static method creates a new inline group in the Web console log, causing any subsequent console messages to be indented by an additional level, until console/groupEnd_static is called.
132
+ * The **`console.group()`** static method creates a new inline group in the Web console log, causing any subsequent console messages to be indented by an additional level, until console.groupEnd() is called.
133
133
  *
134
134
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/group_static)
135
135
  */
136
136
  group(...data: any[]): void;
137
137
  /**
138
- * The **`console.groupCollapsed()`** static method creates a new inline group in the console.
138
+ * The **`console.groupCollapsed()`** static method creates a new inline group in the console. Unlike console.group(), however, the new group is created collapsed. The user will need to use the disclosure button next to it to expand it, revealing the entries created in the group.
139
139
  *
140
140
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/groupCollapsed_static)
141
141
  */
142
142
  groupCollapsed(...data: any[]): void;
143
143
  /**
144
- * The **`console.groupEnd()`** static method exits the current inline group in the console.
144
+ * The **`console.groupEnd()`** static method exits the current inline group in the console. See Using groups in the console in the console documentation for details and examples.
145
145
  *
146
146
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/groupEnd_static)
147
147
  */
148
148
  groupEnd(): void;
149
149
  /**
150
- * The **`console.info()`** static method outputs a message to the console at the 'info' log level.
150
+ * The **`console.info()`** static method outputs a message to the console at the "info" log level. The message is only displayed to the user if the console is configured to display info output. In most cases, the log level is configured within the console UI. The message may receive special formatting, such as a small "i" icon next to it.
151
151
  *
152
152
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/info_static)
153
153
  */
@@ -165,23 +165,24 @@ export interface Console {
165
165
  */
166
166
  table(tabularData?: any, properties?: string[]): void;
167
167
  /**
168
- * The **`console.time()`** static method starts a timer you can use to track how long an operation takes.
168
+ * The **`console.time()`** static method starts a timer you can use to track how long an operation takes. You give each timer a unique name, and may have up to 10,000 timers running on a given page. When you call console.timeEnd() with the same name, the browser will output the time, in milliseconds, that elapsed since the timer was started.
169
169
  *
170
170
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/time_static)
171
171
  */
172
172
  time(label?: string): void;
173
173
  /**
174
- * The **`console.timeEnd()`** static method stops a timer that was previously started by calling console/time_static.
174
+ * The **`console.timeEnd()`** static method stops a timer that was previously started by calling console.time().
175
175
  *
176
176
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/timeEnd_static)
177
177
  */
178
178
  timeEnd(label?: string): void;
179
179
  /**
180
- * The **`console.timeLog()`** static method logs the current value of a timer that was previously started by calling console/time_static.
180
+ * The **`console.timeLog()`** static method logs the current value of a timer that was previously started by calling console.time().
181
181
  *
182
182
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/timeLog_static)
183
183
  */
184
184
  timeLog(label?: string, ...data: any[]): void;
185
+ /* The **`console.timeStamp()`** static method adds a single marker to the browser's Performance tool (Firefox bug 1387528, Chrome). This lets you correlate a point in your code with the other events recorded in the timeline, such as layout and paint events. */
185
186
  timeStamp(label?: string): void;
186
187
  /**
187
188
  * The **`console.trace()`** static method outputs a stack trace to the console.
@@ -190,7 +191,7 @@ export interface Console {
190
191
  */
191
192
  trace(...data: any[]): void;
192
193
  /**
193
- * The **`console.warn()`** static method outputs a warning message to the console at the 'warning' log level.
194
+ * The **`console.warn()`** static method outputs a warning message to the console at the "warning" log level. The message is only displayed to the user if the console is configured to display warning output. In most cases, the log level is configured within the console UI. The message may receive special formatting, such as yellow colors and a warning icon.
194
195
  *
195
196
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/warn_static)
196
197
  */
@@ -218,13 +219,7 @@ export declare namespace WebAssembly {
218
219
  constructor(message?: string);
219
220
  }
220
221
  type ValueType =
221
- | "anyfunc"
222
- | "externref"
223
- | "f32"
224
- | "f64"
225
- | "i32"
226
- | "i64"
227
- | "v128";
222
+ "anyfunc" | "externref" | "f32" | "f64" | "i32" | "i64" | "v128";
228
223
  interface GlobalDescriptor {
229
224
  value: ValueType;
230
225
  mutable?: boolean;
@@ -410,7 +405,7 @@ export declare function removeEventListener<
410
405
  options?: EventTargetEventListenerOptions | boolean,
411
406
  ): void;
412
407
  /**
413
- * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order.
408
+ * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order. The normal event processing rules (including the capturing and optional bubbling phase) also apply to events dispatched manually with dispatchEvent().
414
409
  *
415
410
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/dispatchEvent)
416
411
  */
@@ -477,6 +472,7 @@ export declare const crypto: Crypto;
477
472
  * [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/cache/)
478
473
  */
479
474
  export declare const caches: CacheStorage;
475
+ /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/scheduler) */
480
476
  export declare const scheduler: Scheduler;
481
477
  /**
482
478
  * The Workers runtime supports a subset of the Performance API, used to measure timing and performance,
@@ -672,10 +668,7 @@ export declare abstract class DurableObjectNamespace<
672
668
  ): DurableObjectNamespace<T>;
673
669
  }
674
670
  export type DurableObjectJurisdiction =
675
- | "eu"
676
- | "fedramp"
677
- | "fedramp-high"
678
- | "us";
671
+ "eu" | "fedramp" | "fedramp-high" | "us";
679
672
  export interface DurableObjectNamespaceNewUniqueIdOptions {
680
673
  jurisdiction?: DurableObjectJurisdiction;
681
674
  }
@@ -847,8 +840,7 @@ export interface DurableObjectFacets {
847
840
  get<T extends Rpc.DurableObjectBranded | undefined = undefined>(
848
841
  name: string,
849
842
  getStartupOptions: () =>
850
- | FacetStartupOptions<T>
851
- | Promise<FacetStartupOptions<T>>,
843
+ FacetStartupOptions<T> | Promise<FacetStartupOptions<T>>,
852
844
  ): Fetcher<T>;
853
845
  abort(name: string, reason: any): void;
854
846
  delete(name: string): void;
@@ -872,26 +864,26 @@ export interface AnalyticsEngineDataPoint {
872
864
  blobs?: ((ArrayBuffer | string) | null)[];
873
865
  }
874
866
  /**
875
- * The **`Event`** interface represents an event which takes place on an `EventTarget`.
867
+ * The **`Event`** interface represents an event which takes place on an EventTarget.
876
868
  *
877
869
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event)
878
870
  */
879
871
  export declare class Event {
880
872
  constructor(type: string, init?: EventInit);
881
873
  /**
882
- * The **`type`** read-only property of the Event interface returns a string containing the event's type.
874
+ * The **`type`** read-only property of the Event interface returns a string containing the event's type. It is set when the event is constructed and is the name commonly used to refer to the specific event, such as click, load, or error.
883
875
  *
884
876
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/type)
885
877
  */
886
878
  get type(): string;
887
879
  /**
888
- * The **`eventPhase`** read-only property of the being evaluated.
880
+ * The **`eventPhase`** read-only property of the Event interface indicates which phase of the event flow is currently being evaluated.
889
881
  *
890
882
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/eventPhase)
891
883
  */
892
884
  get eventPhase(): number;
893
885
  /**
894
- * The read-only **`composed`** property of the or not the event will propagate across the shadow DOM boundary into the standard DOM.
886
+ * The read-only **`composed`** property of the Event interface returns a boolean value which indicates whether or not the event will propagate across the shadow DOM boundary into the standard DOM.
895
887
  *
896
888
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/composed)
897
889
  */
@@ -928,13 +920,13 @@ export declare class Event {
928
920
  */
929
921
  get currentTarget(): EventTarget | null;
930
922
  /**
931
- * The read-only **`target`** property of the dispatched.
923
+ * The read-only **`target`** property of the Event interface is a reference to the object onto which the event was dispatched. It is different from Event.currentTarget when the event handler is called during the bubbling or capturing phase of the event.
932
924
  *
933
925
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/target)
934
926
  */
935
927
  get target(): EventTarget | undefined;
936
928
  /**
937
- * The deprecated **`Event.srcElement`** is an alias for the Event.target property.
929
+ * The deprecated **`Event.srcElement`** is an alias for the Event.target property. Use Event.target instead.
938
930
  * @deprecated
939
931
  *
940
932
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/srcElement)
@@ -947,45 +939,45 @@ export declare class Event {
947
939
  */
948
940
  get timeStamp(): number;
949
941
  /**
950
- * The **`isTrusted`** read-only property of the when the event was generated by the user agent (including via user actions and programmatic methods such as HTMLElement.focus()), and `false` when the event was dispatched via The only exception is the `click` event, which initializes the `isTrusted` property to `false` in user agents.
942
+ * The **`isTrusted`** read-only property of the Event interface is a boolean value that is true when the event was generated by the user agent (including via user actions and programmatic methods such as HTMLElement.focus()), and false when the event was dispatched via EventTarget.dispatchEvent(). The only exception is the click event, which initializes the isTrusted property to false in user agents.
951
943
  *
952
944
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/isTrusted)
953
945
  */
954
946
  readonly isTrusted: boolean;
955
947
  /**
956
- * The **`cancelBubble`** property of the Event interface is deprecated.
948
+ * The **`cancelBubble`** property of the Event interface is deprecated. Use Event.stopPropagation() instead. Setting its value to true before returning from an event handler prevents propagation of the event. In later implementations, setting this to false does nothing. See Browser compatibility for details.
957
949
  * @deprecated
958
950
  *
959
951
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/cancelBubble)
960
952
  */
961
953
  get cancelBubble(): boolean;
962
954
  /**
963
- * The **`cancelBubble`** property of the Event interface is deprecated.
955
+ * The **`cancelBubble`** property of the Event interface is deprecated. Use Event.stopPropagation() instead. Setting its value to true before returning from an event handler prevents propagation of the event. In later implementations, setting this to false does nothing. See Browser compatibility for details.
964
956
  * @deprecated
965
957
  *
966
958
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/cancelBubble)
967
959
  */
968
960
  set cancelBubble(value: boolean);
969
961
  /**
970
- * The **`stopImmediatePropagation()`** method of the If several listeners are attached to the same element for the same event type, they are called in the order in which they were added.
962
+ * The **`stopImmediatePropagation()`** method of the Event interface prevents other listeners of the same event from being called.
971
963
  *
972
964
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/stopImmediatePropagation)
973
965
  */
974
966
  stopImmediatePropagation(): void;
975
967
  /**
976
- * The **`preventDefault()`** method of the Event interface tells the user agent that if the event does not get explicitly handled, its default action should not be taken as it normally would be.
968
+ * The **`preventDefault()`** method of the Event interface tells the user agent that the event is being explicitly handled, so its default action, such as page scrolling, link navigation, or pasting text, should not be taken.
977
969
  *
978
970
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/preventDefault)
979
971
  */
980
972
  preventDefault(): void;
981
973
  /**
982
- * The **`stopPropagation()`** method of the Event interface prevents further propagation of the current event in the capturing and bubbling phases.
974
+ * The **`stopPropagation()`** method of the Event interface prevents further propagation of the current event in the capturing and bubbling phases. It does not, however, prevent any default behaviors from occurring; for instance, clicks on links are still processed. If you want to stop those behaviors, see the preventDefault() method. It also does not prevent propagation to other event-handlers of the current element. If you want to stop those, see stopImmediatePropagation().
983
975
  *
984
976
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/stopPropagation)
985
977
  */
986
978
  stopPropagation(): void;
987
979
  /**
988
- * The **`composedPath()`** method of the Event interface returns the event's path which is an array of the objects on which listeners will be invoked.
980
+ * The **`composedPath()`** method of the Event interface returns the event's path which is an array of the objects on which listeners will be invoked. This does not include nodes in shadow trees if the shadow root was created with its ShadowRoot.mode closed.
989
981
  *
990
982
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/composedPath)
991
983
  */
@@ -1010,7 +1002,7 @@ export type EventListenerOrEventListenerObject<
1010
1002
  EventType extends Event = Event,
1011
1003
  > = EventListener<EventType> | EventListenerObject<EventType>;
1012
1004
  /**
1013
- * The **`EventTarget`** interface is implemented by objects that can receive events and may have listeners for them.
1005
+ * The **`EventTarget`** interface is implemented by objects that can receive events and may have listeners for them. In other words, any target of events implements the three methods associated with this interface.
1014
1006
  *
1015
1007
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget)
1016
1008
  */
@@ -1029,7 +1021,7 @@ export declare class EventTarget<
1029
1021
  options?: EventTargetAddEventListenerOptions | boolean,
1030
1022
  ): void;
1031
1023
  /**
1032
- * The **`removeEventListener()`** method of the EventTarget interface removes an event listener previously registered with EventTarget.addEventListener() from the target.
1024
+ * The **`removeEventListener()`** method of the EventTarget interface removes an event listener previously registered with EventTarget.addEventListener() from the target. The event listener to be removed is identified using a combination of the event type, the event listener function itself, and various optional options that may affect the matching process; see Matching event listeners for removal.
1033
1025
  *
1034
1026
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/removeEventListener)
1035
1027
  */
@@ -1039,7 +1031,7 @@ export declare class EventTarget<
1039
1031
  options?: EventTargetEventListenerOptions | boolean,
1040
1032
  ): void;
1041
1033
  /**
1042
- * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order.
1034
+ * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order. The normal event processing rules (including the capturing and optional bubbling phase) also apply to events dispatched manually with dispatchEvent().
1043
1035
  *
1044
1036
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/dispatchEvent)
1045
1037
  */
@@ -1071,7 +1063,7 @@ export declare class AbortController {
1071
1063
  */
1072
1064
  get signal(): AbortSignal;
1073
1065
  /**
1074
- * The **`abort()`** method of the AbortController interface aborts an asynchronous operation before it has completed.
1066
+ * The **`abort()`** method of the AbortController interface aborts an asynchronous operation before it has completed. This is able to abort fetch requests, the consumption of any response bodies, or streams.
1075
1067
  *
1076
1068
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortController/abort)
1077
1069
  */
@@ -1084,7 +1076,7 @@ export declare class AbortController {
1084
1076
  */
1085
1077
  export declare abstract class AbortSignal extends EventTarget {
1086
1078
  /**
1087
- * The **`AbortSignal.abort()`** static method returns an AbortSignal that is already set as aborted (and which does not trigger an AbortSignal/abort_event event).
1079
+ * The **`AbortSignal.abort()`** static method returns an AbortSignal that is already set as aborted (and which does not trigger an abort event).
1088
1080
  *
1089
1081
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/abort_static)
1090
1082
  */
@@ -1096,13 +1088,13 @@ export declare abstract class AbortSignal extends EventTarget {
1096
1088
  */
1097
1089
  static timeout(delay: number): AbortSignal;
1098
1090
  /**
1099
- * The **`AbortSignal.any()`** static method takes an iterable of abort signals and returns an AbortSignal.
1091
+ * The **`AbortSignal.any()`** static method takes an iterable of abort signals and returns an AbortSignal. The returned abort signal is aborted when any of the input iterable abort signals are aborted. The abort reason will be set to the reason of the first signal that is aborted. If any of the given abort signals are already aborted then so will be the returned AbortSignal.
1100
1092
  *
1101
1093
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/any_static)
1102
1094
  */
1103
1095
  static any(signals: AbortSignal[]): AbortSignal;
1104
1096
  /**
1105
- * The **`aborted`** read-only property returns a value that indicates whether the asynchronous operations the signal is communicating with are aborted (`true`) or not (`false`).
1097
+ * The **`aborted`** read-only property returns a value that indicates whether the asynchronous operations the signal is communicating with are aborted (true) or not (false).
1106
1098
  *
1107
1099
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/aborted)
1108
1100
  */
@@ -1118,12 +1110,17 @@ export declare abstract class AbortSignal extends EventTarget {
1118
1110
  /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/abort_event) */
1119
1111
  set onabort(value: any | null);
1120
1112
  /**
1121
- * The **`throwIfAborted()`** method throws the signal's abort AbortSignal.reason if the signal has been aborted; otherwise it does nothing.
1113
+ * The **`throwIfAborted()`** method throws the signal's abort reason if the signal has been aborted; otherwise it does nothing.
1122
1114
  *
1123
1115
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/throwIfAborted)
1124
1116
  */
1125
1117
  throwIfAborted(): void;
1126
1118
  }
1119
+ /**
1120
+ * The **`Scheduler`** interface of the Prioritized Task Scheduling API provides methods for scheduling prioritized tasks.
1121
+ *
1122
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Scheduler)
1123
+ */
1127
1124
  export interface Scheduler {
1128
1125
  wait(delay: number, maybeOptions?: SchedulerWaitOptions): Promise<void>;
1129
1126
  }
@@ -1131,20 +1128,20 @@ export interface SchedulerWaitOptions {
1131
1128
  signal?: AbortSignal;
1132
1129
  }
1133
1130
  /**
1134
- * The **`ExtendableEvent`** interface extends the lifetime of the `install` and `activate` events dispatched on the global scope as part of the service worker lifecycle.
1131
+ * The **`ExtendableEvent`** interface extends the lifetime of the install and activate events dispatched on the global scope as part of the service worker lifecycle. This ensures that any functional events (like FetchEvent) are not dispatched until it upgrades database schemas and deletes the outdated cache entries.
1135
1132
  *
1136
1133
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ExtendableEvent)
1137
1134
  */
1138
1135
  export declare abstract class ExtendableEvent extends Event {
1139
1136
  /**
1140
- * The **`ExtendableEvent.waitUntil()`** method tells the event dispatcher that work is ongoing.
1137
+ * The **`ExtendableEvent.waitUntil()`** method tells the event dispatcher that work is ongoing. It can also be used to detect whether that work was successful. In service workers, waitUntil() tells the browser that work is ongoing until the promise settles, and it shouldn't terminate the service worker if it wants that work to complete.
1141
1138
  *
1142
1139
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ExtendableEvent/waitUntil)
1143
1140
  */
1144
1141
  waitUntil(promise: Promise<any>): void;
1145
1142
  }
1146
1143
  /**
1147
- * The **`CustomEvent`** interface represents events initialized by an application for any purpose.
1144
+ * The **`CustomEvent`** interface can be used to attach custom data to an event generated by an application.
1148
1145
  *
1149
1146
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomEvent)
1150
1147
  */
@@ -1186,7 +1183,7 @@ export declare class Blob {
1186
1183
  */
1187
1184
  get type(): string;
1188
1185
  /**
1189
- * The **`slice()`** method of the Blob interface creates and returns a new `Blob` object which contains data from a subset of the blob on which it's called.
1186
+ * The **`slice()`** method of the Blob interface creates and returns a new Blob object which contains data from a subset of the blob on which it's called.
1190
1187
  *
1191
1188
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/slice)
1192
1189
  */
@@ -1204,13 +1201,13 @@ export declare class Blob {
1204
1201
  */
1205
1202
  bytes(): Promise<Uint8Array>;
1206
1203
  /**
1207
- * The **`text()`** method of the string containing the contents of the blob, interpreted as UTF-8.
1204
+ * The **`text()`** method of the Blob interface returns a Promise that resolves with a string containing the contents of the blob, interpreted as UTF-8.
1208
1205
  *
1209
1206
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/text)
1210
1207
  */
1211
1208
  text(): Promise<string>;
1212
1209
  /**
1213
- * The **`stream()`** method of the Blob interface returns a ReadableStream which upon reading returns the data contained within the `Blob`.
1210
+ * The **`stream()`** method of the Blob interface returns a ReadableStream which upon reading returns the data contained within the Blob.
1214
1211
  *
1215
1212
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/stream)
1216
1213
  */
@@ -1231,13 +1228,13 @@ export declare class File extends Blob {
1231
1228
  options?: FileOptions,
1232
1229
  );
1233
1230
  /**
1234
- * The **`name`** read-only property of the File interface returns the name of the file represented by a File object.
1231
+ * The **`name`** read-only property of the File interface returns the name of the file represented by a File object. For security reasons, the path is excluded from this property.
1235
1232
  *
1236
1233
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/name)
1237
1234
  */
1238
1235
  get name(): string;
1239
1236
  /**
1240
- * The **`lastModified`** read-only property of the File interface provides the last modified date of the file as the number of milliseconds since the Unix epoch (January 1, 1970 at midnight).
1237
+ * The **`lastModified`** read-only property of the File interface provides the last modified date of the file as the number of milliseconds since the Unix epoch (January 1, 1970 at midnight). Files without a known last modified date return the current date.
1241
1238
  *
1242
1239
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/lastModified)
1243
1240
  */
@@ -1254,7 +1251,7 @@ export interface FileOptions {
1254
1251
  */
1255
1252
  export declare abstract class CacheStorage {
1256
1253
  /**
1257
- * The **`open()`** method of the the Cache object matching the `cacheName`.
1254
+ * The **`open()`** method of the CacheStorage interface returns a Promise that resolves to the Cache object matching the cacheName.
1258
1255
  *
1259
1256
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CacheStorage/open)
1260
1257
  */
@@ -1293,14 +1290,14 @@ export interface CacheQueryOptions {
1293
1290
  */
1294
1291
  export declare abstract class Crypto {
1295
1292
  /**
1296
- * The **`Crypto.subtle`** read-only property returns a cryptographic operations.
1293
+ * The **`Crypto.subtle`** read-only property returns a SubtleCrypto which can then be used to perform low-level cryptographic operations.
1297
1294
  * Available only in secure contexts.
1298
1295
  *
1299
1296
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Crypto/subtle)
1300
1297
  */
1301
1298
  get subtle(): SubtleCrypto;
1302
1299
  /**
1303
- * The **`Crypto.getRandomValues()`** method lets you get cryptographically strong random values.
1300
+ * The **`Crypto.getRandomValues()`** method lets you get cryptographically strong random values. The array given as the parameter is filled with random numbers (random in its cryptographic meaning).
1304
1301
  *
1305
1302
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Crypto/getRandomValues)
1306
1303
  */
@@ -1342,7 +1339,7 @@ export declare abstract class SubtleCrypto {
1342
1339
  plainText: ArrayBuffer | ArrayBufferView,
1343
1340
  ): Promise<ArrayBuffer>;
1344
1341
  /**
1345
- * The **`decrypt()`** method of the SubtleCrypto interface decrypts some encrypted data.
1342
+ * The **`decrypt()`** method of the SubtleCrypto interface decrypts some encrypted data. It takes as arguments a key to decrypt with, some optional extra parameters, and the data to decrypt (also known as "ciphertext"). It returns a Promise which will be fulfilled with the decrypted data (also known as "plaintext").
1346
1343
  *
1347
1344
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/decrypt)
1348
1345
  */
@@ -1373,7 +1370,7 @@ export declare abstract class SubtleCrypto {
1373
1370
  data: ArrayBuffer | ArrayBufferView,
1374
1371
  ): Promise<boolean>;
1375
1372
  /**
1376
- * The **`digest()`** method of the SubtleCrypto interface generates a _digest_ of the given data, using the specified hash function.
1373
+ * The **`digest()`** method of the SubtleCrypto interface generates a digest of the given data, using the specified hash function. A digest is a short fixed-length value derived from some variable-length input. Cryptographic digests should exhibit collision-resistance, meaning that it's hard to come up with two different inputs that have the same digest value.
1377
1374
  *
1378
1375
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/digest)
1379
1376
  */
@@ -1404,7 +1401,7 @@ export declare abstract class SubtleCrypto {
1404
1401
  keyUsages: string[],
1405
1402
  ): Promise<CryptoKey>;
1406
1403
  /**
1407
- * The **`deriveBits()`** method of the key.
1404
+ * The **`deriveBits()`** method of the SubtleCrypto interface can be used to derive an array of bits from a base key.
1408
1405
  *
1409
1406
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/deriveBits)
1410
1407
  */
@@ -1432,7 +1429,7 @@ export declare abstract class SubtleCrypto {
1432
1429
  */
1433
1430
  exportKey(format: string, key: CryptoKey): Promise<ArrayBuffer | JsonWebKey>;
1434
1431
  /**
1435
- * The **`wrapKey()`** method of the SubtleCrypto interface 'wraps' a key.
1432
+ * The **`wrapKey()`** method of the SubtleCrypto interface "wraps" a key. This means that it exports the key in an external, portable format, then encrypts the exported key. Wrapping a key helps protect it in untrusted environments, such as inside an otherwise unprotected data store or in transmission over an unprotected network.
1436
1433
  *
1437
1434
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/wrapKey)
1438
1435
  */
@@ -1443,7 +1440,7 @@ export declare abstract class SubtleCrypto {
1443
1440
  wrapAlgorithm: string | SubtleCryptoEncryptAlgorithm,
1444
1441
  ): Promise<ArrayBuffer>;
1445
1442
  /**
1446
- * The **`unwrapKey()`** method of the SubtleCrypto interface 'unwraps' a key.
1443
+ * The **`unwrapKey()`** method of the SubtleCrypto interface "unwraps" a key. This means that it takes as its input a key that has been exported and then encrypted (also called "wrapped"). It decrypts the key and then imports it, returning a CryptoKey object that can be used in the Web Crypto API.
1447
1444
  *
1448
1445
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/unwrapKey)
1449
1446
  */
@@ -1462,20 +1459,20 @@ export declare abstract class SubtleCrypto {
1462
1459
  ): boolean;
1463
1460
  }
1464
1461
  /**
1465
- * The **`CryptoKey`** interface of the Web Crypto API represents a cryptographic key obtained from one of the SubtleCrypto methods SubtleCrypto.generateKey, SubtleCrypto.deriveKey, SubtleCrypto.importKey, or SubtleCrypto.unwrapKey.
1462
+ * The **`CryptoKey`** interface of the Web Crypto API represents a cryptographic key obtained from one of the SubtleCrypto methods generateKey(), deriveKey(), importKey(), or unwrapKey().
1466
1463
  * Available only in secure contexts.
1467
1464
  *
1468
1465
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey)
1469
1466
  */
1470
1467
  export declare abstract class CryptoKey {
1471
1468
  /**
1472
- * The read-only **`type`** property of the CryptoKey interface indicates which kind of key is represented by the object.
1469
+ * The read-only **`type`** property of the CryptoKey interface indicates which kind of key is represented by the object. It can have the following values:
1473
1470
  *
1474
1471
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/type)
1475
1472
  */
1476
1473
  readonly type: string;
1477
1474
  /**
1478
- * The read-only **`extractable`** property of the CryptoKey interface indicates whether or not the key may be extracted using `SubtleCrypto.exportKey()` or `SubtleCrypto.wrapKey()`.
1475
+ * The read-only **`extractable`** property of the CryptoKey interface indicates whether or not the key may be extracted using SubtleCrypto.exportKey() or SubtleCrypto.wrapKey().
1479
1476
  *
1480
1477
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/extractable)
1481
1478
  */
@@ -1605,7 +1602,7 @@ export declare class DigestStream extends WritableStream<
1605
1602
  get bytesWritten(): number | bigint;
1606
1603
  }
1607
1604
  /**
1608
- * The **`TextDecoder`** interface represents a decoder for a specific text encoding, such as `UTF-8`, `ISO-8859-2`, `KOI8-R`, `GBK`, etc.
1605
+ * The **`TextDecoder`** interface represents a decoder for a specific text encoding, such as UTF-8, ISO-8859-2, or GBK. A decoder takes an array of bytes as input and returns a JavaScript string.
1609
1606
  *
1610
1607
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoder)
1611
1608
  */
@@ -1625,20 +1622,20 @@ export declare class TextDecoder {
1625
1622
  get ignoreBOM(): boolean;
1626
1623
  }
1627
1624
  /**
1628
- * The **`TextEncoder`** interface takes a stream of code points as input and emits a stream of UTF-8 bytes.
1625
+ * The **`TextEncoder`** interface enables you to encode a JavaScript string using UTF-8.
1629
1626
  *
1630
1627
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder)
1631
1628
  */
1632
1629
  export declare class TextEncoder {
1633
1630
  constructor();
1634
1631
  /**
1635
- * The **`TextEncoder.encode()`** method takes a string as input, and returns a Global_Objects/Uint8Array containing the text given in parameters encoded with the specific method for that TextEncoder object.
1632
+ * The **`TextEncoder.encode()`** method takes a string as input, and returns a Uint8Array containing the string encoded using UTF-8.
1636
1633
  *
1637
1634
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encode)
1638
1635
  */
1639
1636
  encode(input?: string): Uint8Array;
1640
1637
  /**
1641
- * The **`TextEncoder.encodeInto()`** method takes a string to encode and a destination Uint8Array to put resulting UTF-8 encoded text into, and returns a dictionary object indicating the progress of the encoding.
1638
+ * The **`TextEncoder.encodeInto()`** method takes a string to encode and a destination Uint8Array to put resulting UTF-8 encoded text into, and returns an object indicating the progress of the encoding. This is potentially more performant than the encode() method — especially when the target buffer is a view into a Wasm heap.
1642
1639
  *
1643
1640
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encodeInto)
1644
1641
  */
@@ -1709,31 +1706,31 @@ export interface ErrorEventErrorEventInit {
1709
1706
  export declare class MessageEvent extends Event {
1710
1707
  constructor(type: string, initializer: MessageEventInit);
1711
1708
  /**
1712
- * The **`data`** read-only property of the The data sent by the message emitter; this can be any data type, depending on what originated this event.
1709
+ * The **`data`** read-only property of the MessageEvent interface represents the data sent by the message emitter.
1713
1710
  *
1714
1711
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/data)
1715
1712
  */
1716
1713
  readonly data: any;
1717
1714
  /**
1718
- * The **`origin`** read-only property of the origin of the message emitter.
1715
+ * The **`origin`** read-only property of the MessageEvent interface is a string representing the origin of the message emitter.
1719
1716
  *
1720
1717
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/origin)
1721
1718
  */
1722
1719
  readonly origin: string | null;
1723
1720
  /**
1724
- * The **`lastEventId`** read-only property of the unique ID for the event.
1721
+ * The **`lastEventId`** read-only property of the MessageEvent interface is a string representing a unique ID for the event.
1725
1722
  *
1726
1723
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/lastEventId)
1727
1724
  */
1728
1725
  readonly lastEventId: string;
1729
1726
  /**
1730
- * The **`source`** read-only property of the a WindowProxy, MessagePort, or a `MessageEventSource` (which can be a WindowProxy, message emitter.
1727
+ * The **`source`** read-only property of the MessageEvent interface is a MessageEventSource (which can be a WindowProxy, MessagePort, or ServiceWorker object) representing the message emitter.
1731
1728
  *
1732
1729
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/source)
1733
1730
  */
1734
1731
  readonly source: MessagePort | null;
1735
1732
  /**
1736
- * The **`ports`** read-only property of the containing all MessagePort objects sent with the message, in order.
1733
+ * The **`ports`** read-only property of the MessageEvent interface is an array of MessagePort objects containing all MessagePort objects sent with the message, in order.
1737
1734
  *
1738
1735
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/ports)
1739
1736
  */
@@ -1743,96 +1740,93 @@ export interface MessageEventInit {
1743
1740
  data: ArrayBuffer | string;
1744
1741
  }
1745
1742
  /**
1746
- * The **`PromiseRejectionEvent`** interface represents events which are sent to the global script context when JavaScript Promises are rejected.
1743
+ * The **`PromiseRejectionEvent`** interface represents events which are sent to the global script context when JavaScript Promises are rejected. These events are particularly useful for telemetry and debugging purposes.
1747
1744
  *
1748
1745
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent)
1749
1746
  */
1750
1747
  export declare abstract class PromiseRejectionEvent extends Event {
1751
1748
  /**
1752
- * The PromiseRejectionEvent interface's **`promise`** read-only property indicates the JavaScript rejected.
1749
+ * The PromiseRejectionEvent interface's **`promise`** read-only property indicates the JavaScript Promise which was rejected. You can examine the event's PromiseRejectionEvent.reason property to learn why the promise was rejected.
1753
1750
  *
1754
1751
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/promise)
1755
1752
  */
1756
1753
  readonly promise: Promise<any>;
1757
1754
  /**
1758
- * The PromiseRejectionEvent **`reason`** read-only property is any JavaScript value or Object which provides the reason passed into Promise.reject().
1755
+ * The PromiseRejectionEvent **`reason`** read-only property is any JavaScript value or Object which provides the reason passed into Promise.reject(). This in theory provides information about why the promise was rejected.
1759
1756
  *
1760
1757
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/reason)
1761
1758
  */
1762
1759
  readonly reason: any;
1763
1760
  }
1764
1761
  /**
1765
- * The **`FormData`** interface provides a way to construct a set of key/value pairs representing form fields and their values, which can be sent using the Window/fetch, XMLHttpRequest.send() or navigator.sendBeacon() methods.
1762
+ * The **`FormData`** interface provides a way to construct a set of key/value pairs representing form fields and their values, which can be sent using the fetch(), XMLHttpRequest.send() or navigator.sendBeacon() methods. It uses the same format a form would use if the encoding type were set to "multipart/form-data".
1766
1763
  *
1767
1764
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData)
1768
1765
  */
1769
1766
  export declare class FormData {
1770
1767
  constructor();
1771
1768
  /**
1772
- * The **`append()`** method of the FormData interface appends a new value onto an existing key inside a `FormData` object, or adds the key if it does not already exist.
1769
+ * The **`append()`** method of the FormData interface appends a new value onto an existing key inside a FormData object, or adds the key if it does not already exist.
1773
1770
  *
1774
1771
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/append)
1775
1772
  */
1776
1773
  append(name: string, value: string | Blob): void;
1777
1774
  /**
1778
- * The **`append()`** method of the FormData interface appends a new value onto an existing key inside a `FormData` object, or adds the key if it does not already exist.
1775
+ * The **`append()`** method of the FormData interface appends a new value onto an existing key inside a FormData object, or adds the key if it does not already exist.
1779
1776
  *
1780
1777
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/append)
1781
1778
  */
1782
1779
  append(name: string, value: string): void;
1783
1780
  /**
1784
- * The **`append()`** method of the FormData interface appends a new value onto an existing key inside a `FormData` object, or adds the key if it does not already exist.
1781
+ * The **`append()`** method of the FormData interface appends a new value onto an existing key inside a FormData object, or adds the key if it does not already exist.
1785
1782
  *
1786
1783
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/append)
1787
1784
  */
1788
1785
  append(name: string, value: Blob, filename?: string): void;
1789
1786
  /**
1790
- * The **`delete()`** method of the FormData interface deletes a key and its value(s) from a `FormData` object.
1787
+ * The **`delete()`** method of the FormData interface deletes a key and its value(s) from a FormData object.
1791
1788
  *
1792
1789
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/delete)
1793
1790
  */
1794
1791
  delete(name: string): void;
1795
1792
  /**
1796
- * The **`get()`** method of the FormData interface returns the first value associated with a given key from within a `FormData` object.
1793
+ * The **`get()`** method of the FormData interface returns the first value associated with a given key from within a FormData object. If you expect multiple values and want all of them, use the getAll() method instead.
1797
1794
  *
1798
1795
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/get)
1799
1796
  */
1800
1797
  get(name: string): (File | string) | null;
1801
1798
  /**
1802
- * The **`getAll()`** method of the FormData interface returns all the values associated with a given key from within a `FormData` object.
1799
+ * The **`getAll()`** method of the FormData interface returns all the values associated with a given key from within a FormData object.
1803
1800
  *
1804
1801
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/getAll)
1805
1802
  */
1806
1803
  getAll(name: string): (File | string)[];
1807
1804
  /**
1808
- * The **`has()`** method of the FormData interface returns whether a `FormData` object contains a certain key.
1805
+ * The **`has()`** method of the FormData interface returns whether a FormData object contains a certain key.
1809
1806
  *
1810
1807
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/has)
1811
1808
  */
1812
1809
  has(name: string): boolean;
1813
1810
  /**
1814
- * The **`set()`** method of the FormData interface sets a new value for an existing key inside a `FormData` object, or adds the key/value if it does not already exist.
1811
+ * The **`set()`** method of the FormData interface sets a new value for an existing key inside a FormData object, or adds the key/value if it does not already exist.
1815
1812
  *
1816
1813
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/set)
1817
1814
  */
1818
1815
  set(name: string, value: string | Blob): void;
1819
1816
  /**
1820
- * The **`set()`** method of the FormData interface sets a new value for an existing key inside a `FormData` object, or adds the key/value if it does not already exist.
1817
+ * The **`set()`** method of the FormData interface sets a new value for an existing key inside a FormData object, or adds the key/value if it does not already exist.
1821
1818
  *
1822
1819
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/set)
1823
1820
  */
1824
1821
  set(name: string, value: string): void;
1825
1822
  /**
1826
- * The **`set()`** method of the FormData interface sets a new value for an existing key inside a `FormData` object, or adds the key/value if it does not already exist.
1823
+ * The **`set()`** method of the FormData interface sets a new value for an existing key inside a FormData object, or adds the key/value if it does not already exist.
1827
1824
  *
1828
1825
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/set)
1829
1826
  */
1830
1827
  set(name: string, value: Blob, filename?: string): void;
1831
- /* Returns an array of key, value pairs for every entry in the list. */
1832
1828
  entries(): IterableIterator<[key: string, value: File | string]>;
1833
- /* Returns a list of keys in the list. */
1834
1829
  keys(): IterableIterator<string>;
1835
- /* Returns a list of values in the list. */
1836
1830
  values(): IterableIterator<File | string>;
1837
1831
  forEach<This = unknown>(
1838
1832
  callback: (
@@ -1952,19 +1946,19 @@ export interface DocumentEnd {
1952
1946
  append(content: string, options?: ContentOptions): DocumentEnd;
1953
1947
  }
1954
1948
  /**
1955
- * This is the event type for `fetch` events dispatched on the ServiceWorkerGlobalScope.
1949
+ * This is the event type for fetch events dispatched on the service worker global scope. It contains information about the fetch, including the request and how the receiver will treat the response. It provides the event.respondWith() method, which allows us to provide a response to this fetch.
1956
1950
  *
1957
1951
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent)
1958
1952
  */
1959
1953
  export declare abstract class FetchEvent extends ExtendableEvent {
1960
1954
  /**
1961
- * The **`request`** read-only property of the the event handler.
1955
+ * The **`request`** read-only property of the FetchEvent interface returns the Request that triggered the event handler.
1962
1956
  *
1963
1957
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent/request)
1964
1958
  */
1965
1959
  readonly request: Request;
1966
1960
  /**
1967
- * The **`respondWith()`** method of allows you to provide a promise for a Response yourself.
1961
+ * The **`respondWith()`** method of FetchEvent prevents the browser's default fetch handling, and allows you to provide a promise for a Response yourself.
1968
1962
  *
1969
1963
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent/respondWith)
1970
1964
  */
@@ -1972,49 +1966,47 @@ export declare abstract class FetchEvent extends ExtendableEvent {
1972
1966
  passThroughOnException(): void;
1973
1967
  }
1974
1968
  export type HeadersInit =
1975
- | Headers
1976
- | Iterable<Iterable<string>>
1977
- | Record<string, string>;
1969
+ Headers | Iterable<Iterable<string>> | Record<string, string>;
1978
1970
  /**
1979
- * The **`Headers`** interface of the Fetch API allows you to perform various actions on HTTP request and response headers.
1971
+ * The **`Headers`** interface of the Fetch API allows you to perform various actions on HTTP request and response headers. These actions include retrieving, setting, adding to, and removing headers from the list of the request's headers.
1980
1972
  *
1981
1973
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers)
1982
1974
  */
1983
1975
  export declare class Headers {
1984
1976
  constructor(init?: HeadersInit);
1985
1977
  /**
1986
- * The **`get()`** method of the Headers interface returns a byte string of all the values of a header within a `Headers` object with a given name.
1978
+ * The **`get()`** method of the Headers interface returns a byte string of all the values of a header within a Headers object with a given name. If the requested header doesn't exist in the Headers object, it returns null.
1987
1979
  *
1988
1980
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/get)
1989
1981
  */
1990
1982
  get(name: string): string | null;
1991
1983
  getAll(name: string): string[];
1992
1984
  /**
1993
- * The **`getSetCookie()`** method of the Headers interface returns an array containing the values of all Set-Cookie headers associated with a response.
1985
+ * The **`getSetCookie()`** method of the Headers interface returns an array containing the values of all Set-Cookie headers associated with a response. This allows Headers objects to handle having multiple Set-Cookie headers, which wasn't possible prior to its implementation.
1994
1986
  *
1995
1987
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/getSetCookie)
1996
1988
  */
1997
1989
  getSetCookie(): string[];
1998
1990
  /**
1999
- * The **`has()`** method of the Headers interface returns a boolean stating whether a `Headers` object contains a certain header.
1991
+ * The **`has()`** method of the Headers interface returns a boolean stating whether a Headers object contains a certain header.
2000
1992
  *
2001
1993
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/has)
2002
1994
  */
2003
1995
  has(name: string): boolean;
2004
1996
  /**
2005
- * The **`set()`** method of the Headers interface sets a new value for an existing header inside a `Headers` object, or adds the header if it does not already exist.
1997
+ * The **`set()`** method of the Headers interface sets a new value for an existing header inside a Headers object, or adds the header if it does not already exist.
2006
1998
  *
2007
1999
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/set)
2008
2000
  */
2009
2001
  set(name: string, value: string): void;
2010
2002
  /**
2011
- * The **`append()`** method of the Headers interface appends a new value onto an existing header inside a `Headers` object, or adds the header if it does not already exist.
2003
+ * The **`append()`** method of the Headers interface appends a new value onto an existing header inside a Headers object, or adds the header if it does not already exist.
2012
2004
  *
2013
2005
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/append)
2014
2006
  */
2015
2007
  append(name: string, value: string): void;
2016
2008
  /**
2017
- * The **`delete()`** method of the Headers interface deletes a header from the current `Headers` object.
2009
+ * The **`delete()`** method of the Headers interface deletes a header from the current Headers object.
2018
2010
  *
2019
2011
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/delete)
2020
2012
  */
@@ -2023,11 +2015,8 @@ export declare class Headers {
2023
2015
  callback: (this: This, value: string, key: string, parent: Headers) => void,
2024
2016
  thisArg?: This,
2025
2017
  ): void;
2026
- /* Returns an iterator allowing to go through all key/value pairs contained in this object. */
2027
2018
  entries(): IterableIterator<[key: string, value: string]>;
2028
- /* Returns an iterator allowing to go through all keys of the key/value pairs contained in this object. */
2029
2019
  keys(): IterableIterator<string>;
2030
- /* Returns an iterator allowing to go through all values of the key/value pairs contained in this object. */
2031
2020
  values(): IterableIterator<string>;
2032
2021
  [Symbol.iterator](): IterableIterator<[key: string, value: string]>;
2033
2022
  }
@@ -2096,7 +2085,7 @@ export interface Response extends Body {
2096
2085
  */
2097
2086
  statusText: string;
2098
2087
  /**
2099
- * The **`headers`** read-only property of the with the response.
2088
+ * The **`headers`** read-only property of the Response interface contains the Headers object associated with the response.
2100
2089
  *
2101
2090
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/headers)
2102
2091
  */
@@ -2114,7 +2103,7 @@ export interface Response extends Body {
2114
2103
  */
2115
2104
  redirected: boolean;
2116
2105
  /**
2117
- * The **`url`** read-only property of the Response interface contains the URL of the response.
2106
+ * The **`url`** read-only property of the Response interface contains the URL of the response. The value of the url property will be the final URL obtained after any redirects.
2118
2107
  *
2119
2108
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/url)
2120
2109
  */
@@ -2122,7 +2111,7 @@ export interface Response extends Body {
2122
2111
  webSocket: WebSocket | null;
2123
2112
  cf: any | undefined;
2124
2113
  /**
2125
- * The **`type`** read-only property of the Response interface contains the type of the response.
2114
+ * The **`type`** read-only property of the Response interface contains the type of the response. The type determines whether scripts are able to access the response body and headers.
2126
2115
  *
2127
2116
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/type)
2128
2117
  */
@@ -2162,13 +2151,13 @@ export interface Request<
2162
2151
  Cf = CfProperties<CfHostMetadata>,
2163
2152
  > extends Body {
2164
2153
  /**
2165
- * The **`clone()`** method of the Request interface creates a copy of the current `Request` object.
2154
+ * The **`clone()`** method of the Request interface creates a copy of the current Request object.
2166
2155
  *
2167
2156
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/clone)
2168
2157
  */
2169
2158
  clone(): Request<CfHostMetadata, Cf>;
2170
2159
  /**
2171
- * The **`method`** read-only property of the `POST`, etc.) A String indicating the method of the request.
2160
+ * The **`method`** read-only property of the Request interface contains the request's method (GET, POST, etc.)
2172
2161
  *
2173
2162
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/method)
2174
2163
  */
@@ -2180,7 +2169,7 @@ export interface Request<
2180
2169
  */
2181
2170
  url: string;
2182
2171
  /**
2183
- * The **`headers`** read-only property of the with the request.
2172
+ * The **`headers`** read-only property of the Request interface contains the Headers object associated with the request.
2184
2173
  *
2185
2174
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/headers)
2186
2175
  */
@@ -2206,13 +2195,13 @@ export interface Request<
2206
2195
  */
2207
2196
  integrity: string;
2208
2197
  /**
2209
- * The **`keepalive`** read-only property of the Request interface contains the request's `keepalive` setting (`true` or `false`), which indicates whether the browser will keep the associated request alive if the page that initiated it is unloaded before the request is complete.
2198
+ * The **`keepalive`** read-only property of the Request interface contains the request's keepalive setting (true or false), which indicates whether the browser will keep the associated request alive if the page that initiated it is unloaded before the request is complete.
2210
2199
  *
2211
2200
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/keepalive)
2212
2201
  */
2213
2202
  keepalive: boolean;
2214
2203
  /**
2215
- * The **`cache`** read-only property of the Request interface contains the cache mode of the request.
2204
+ * The **`cache`** read-only property of the Request interface contains the cache mode of the request. It controls how the request will interact with the browser's HTTP cache.
2216
2205
  *
2217
2206
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/cache)
2218
2207
  */
@@ -2560,12 +2549,7 @@ export interface R2Bucket {
2560
2549
  put(
2561
2550
  key: string,
2562
2551
  value:
2563
- | ReadableStream
2564
- | ArrayBuffer
2565
- | ArrayBufferView
2566
- | string
2567
- | null
2568
- | Blob,
2552
+ ReadableStream | ArrayBuffer | ArrayBufferView | string | null | Blob,
2569
2553
  options?: R2PutOptions & {
2570
2554
  onlyIf: R2Conditional | Headers;
2571
2555
  },
@@ -2573,12 +2557,7 @@ export interface R2Bucket {
2573
2557
  put(
2574
2558
  key: string,
2575
2559
  value:
2576
- | ReadableStream
2577
- | ArrayBuffer
2578
- | ArrayBufferView
2579
- | string
2580
- | null
2581
- | Blob,
2560
+ ReadableStream | ArrayBuffer | ArrayBufferView | string | null | Blob,
2582
2561
  options?: R2PutOptions,
2583
2562
  ): Promise<R2Object>;
2584
2563
  createMultipartUpload(
@@ -2809,7 +2788,7 @@ export type ReadableStreamReadResult<R = any> =
2809
2788
  value?: undefined;
2810
2789
  };
2811
2790
  /**
2812
- * The `ReadableStream` interface of the Streams API represents a readable stream of byte data.
2791
+ * The **`ReadableStream`** interface of the Streams API represents a readable stream of byte data. The Fetch API offers a concrete instance of a ReadableStream through the body property of a Response object.
2813
2792
  *
2814
2793
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream)
2815
2794
  */
@@ -2827,13 +2806,13 @@ export interface ReadableStream<R = any> {
2827
2806
  */
2828
2807
  cancel(reason?: any): Promise<void>;
2829
2808
  /**
2830
- * The **`getReader()`** method of the ReadableStream interface creates a reader and locks the stream to it.
2809
+ * The **`getReader()`** method of the ReadableStream interface creates a reader and locks the stream to it. While the stream is locked, no other reader can be acquired until this one is released.
2831
2810
  *
2832
2811
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/getReader)
2833
2812
  */
2834
2813
  getReader(): ReadableStreamDefaultReader<R>;
2835
2814
  /**
2836
- * The **`getReader()`** method of the ReadableStream interface creates a reader and locks the stream to it.
2815
+ * The **`getReader()`** method of the ReadableStream interface creates a reader and locks the stream to it. While the stream is locked, no other reader can be acquired until this one is released.
2837
2816
  *
2838
2817
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/getReader)
2839
2818
  */
@@ -2848,7 +2827,7 @@ export interface ReadableStream<R = any> {
2848
2827
  options?: StreamPipeOptions,
2849
2828
  ): ReadableStream<T>;
2850
2829
  /**
2851
- * The **`pipeTo()`** method of the ReadableStream interface pipes the current `ReadableStream` to a given WritableStream and returns a Promise that fulfills when the piping process completes successfully, or rejects if any errors were encountered.
2830
+ * The **`pipeTo()`** method of the ReadableStream interface pipes the current ReadableStream to a given WritableStream and returns a Promise that fulfills when the piping process completes successfully, or rejects if any errors were encountered.
2852
2831
  *
2853
2832
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/pipeTo)
2854
2833
  */
@@ -2857,7 +2836,7 @@ export interface ReadableStream<R = any> {
2857
2836
  options?: StreamPipeOptions,
2858
2837
  ): Promise<void>;
2859
2838
  /**
2860
- * The **`tee()`** method of the two-element array containing the two resulting branches as new ReadableStream instances.
2839
+ * The **`tee()`** method of the ReadableStream interface tees the current readable stream, returning a two-element array containing the two resulting branches as new ReadableStream instances.
2861
2840
  *
2862
2841
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/tee)
2863
2842
  */
@@ -2868,7 +2847,7 @@ export interface ReadableStream<R = any> {
2868
2847
  ): AsyncIterableIterator<R>;
2869
2848
  }
2870
2849
  /**
2871
- * The `ReadableStream` interface of the Streams API represents a readable stream of byte data.
2850
+ * The **`ReadableStream`** interface of the Streams API represents a readable stream of byte data. The Fetch API offers a concrete instance of a ReadableStream through the body property of a Response object.
2872
2851
  *
2873
2852
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream)
2874
2853
  */
@@ -2906,7 +2885,7 @@ export declare class ReadableStreamDefaultReader<R = any> {
2906
2885
  releaseLock(): void;
2907
2886
  }
2908
2887
  /**
2909
- * The `ReadableStreamBYOBReader` interface of the Streams API defines a reader for a ReadableStream that supports zero-copy reading from an underlying byte source.
2888
+ * The **`ReadableStreamBYOBReader`** interface of the Streams API defines a reader for a ReadableStream that supports zero-copy reading from an underlying byte source. It is used for efficient copying from underlying sources where the data is delivered as an "anonymous" sequence of bytes, such as files.
2910
2889
  *
2911
2890
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader)
2912
2891
  */
@@ -2915,7 +2894,7 @@ export declare class ReadableStreamBYOBReader {
2915
2894
  get closed(): Promise<void>;
2916
2895
  cancel(reason?: any): Promise<void>;
2917
2896
  /**
2918
- * The **`read()`** method of the ReadableStreamBYOBReader interface is used to read data into a view on a user-supplied buffer from an associated readable byte stream.
2897
+ * The **`read()`** method of the ReadableStreamBYOBReader interface is used to read data into a view on a user-supplied buffer from an associated readable byte stream. A request for data will be satisfied from the stream's internal queues if there is any data present. If the stream queues are empty, the request may be supplied as a zero-copy transfer from the underlying byte source.
2919
2898
  *
2920
2899
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/read)
2921
2900
  */
@@ -2923,7 +2902,7 @@ export declare class ReadableStreamBYOBReader {
2923
2902
  view: T,
2924
2903
  ): Promise<ReadableStreamReadResult<T>>;
2925
2904
  /**
2926
- * The **`releaseLock()`** method of the ReadableStreamBYOBReader interface releases the reader's lock on the stream.
2905
+ * The **`releaseLock()`** method of the ReadableStreamBYOBReader interface releases the reader's lock on the stream. After the lock is released, the reader is no longer active.
2927
2906
  *
2928
2907
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/releaseLock)
2929
2908
  */
@@ -2945,7 +2924,7 @@ export interface ReadableStreamGetReaderOptions {
2945
2924
  mode: "byob";
2946
2925
  }
2947
2926
  /**
2948
- * The **`ReadableStreamBYOBRequest`** interface of the Streams API represents a 'pull request' for data from an underlying source that will made as a zero-copy transfer to a consumer (bypassing the stream's internal queues).
2927
+ * The **`ReadableStreamBYOBRequest`** interface of the Streams API represents a "pull request" for data from an underlying source that will made as a zero-copy transfer to a consumer (bypassing the stream's internal queues).
2949
2928
  *
2950
2929
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest)
2951
2930
  */
@@ -2971,13 +2950,13 @@ export declare abstract class ReadableStreamBYOBRequest {
2971
2950
  get atLeast(): number | null;
2972
2951
  }
2973
2952
  /**
2974
- * The **`ReadableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a ReadableStream's state and internal queue.
2953
+ * The **`ReadableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a ReadableStream's state and internal queue. Default controllers are for streams that are not byte streams.
2975
2954
  *
2976
2955
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController)
2977
2956
  */
2978
2957
  export declare abstract class ReadableStreamDefaultController<R = any> {
2979
2958
  /**
2980
- * The **`desiredSize`** read-only property of the required to fill the stream's internal queue.
2959
+ * The **`desiredSize`** read-only property of the ReadableStreamDefaultController interface returns the desired size required to fill the stream's internal queue.
2981
2960
  *
2982
2961
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/desiredSize)
2983
2962
  */
@@ -2989,32 +2968,32 @@ export declare abstract class ReadableStreamDefaultController<R = any> {
2989
2968
  */
2990
2969
  close(): void;
2991
2970
  /**
2992
- * The **`enqueue()`** method of the ```js-nolint enqueue(chunk) ``` - `chunk` - : The chunk to enqueue.
2971
+ * The **`enqueue()`** method of the ReadableStreamDefaultController interface enqueues a given chunk in the associated stream.
2993
2972
  *
2994
2973
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/enqueue)
2995
2974
  */
2996
2975
  enqueue(chunk?: R): void;
2997
2976
  /**
2998
- * The **`error()`** method of the with the associated stream to error.
2977
+ * The **`error()`** method of the ReadableStreamDefaultController interface causes any future interactions with the associated stream to error.
2999
2978
  *
3000
2979
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/error)
3001
2980
  */
3002
2981
  error(reason: any): void;
3003
2982
  }
3004
2983
  /**
3005
- * The **`ReadableByteStreamController`** interface of the Streams API represents a controller for a readable byte stream.
2984
+ * The **`ReadableByteStreamController`** interface of the Streams API represents a controller for a readable byte stream. It allows control of the state and internal queue of a ReadableStream with an underlying byte source, and enables efficient zero-copy transfer of data from the underlying source to a consumer when the stream's internal queue is empty.
3006
2985
  *
3007
2986
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController)
3008
2987
  */
3009
2988
  export declare abstract class ReadableByteStreamController {
3010
2989
  /**
3011
- * The **`byobRequest`** read-only property of the ReadableByteStreamController interface returns the current BYOB request, or `null` if there are no pending requests.
2990
+ * The **`byobRequest`** read-only property of the ReadableByteStreamController interface returns the current BYOB request, or null if there are no pending requests.
3012
2991
  *
3013
2992
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/byobRequest)
3014
2993
  */
3015
2994
  get byobRequest(): ReadableStreamBYOBRequest | null;
3016
2995
  /**
3017
- * The **`desiredSize`** read-only property of the ReadableByteStreamController interface returns the number of bytes required to fill the stream's internal queue to its 'desired size'.
2996
+ * The **`desiredSize`** read-only property of the ReadableByteStreamController interface returns the number of bytes required to fill the stream's internal queue to its "desired size".
3018
2997
  *
3019
2998
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/desiredSize)
3020
2999
  */
@@ -3026,7 +3005,7 @@ export declare abstract class ReadableByteStreamController {
3026
3005
  */
3027
3006
  close(): void;
3028
3007
  /**
3029
- * The **`enqueue()`** method of the ReadableByteStreamController interface enqueues a given chunk on the associated readable byte stream (the chunk is copied into the stream's internal queues).
3008
+ * The **`enqueue()`** method of the ReadableByteStreamController interface enqueues a given chunk on the associated readable byte stream (the chunk is transferred into the stream's internal queues).
3030
3009
  *
3031
3010
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/enqueue)
3032
3011
  */
@@ -3039,7 +3018,7 @@ export declare abstract class ReadableByteStreamController {
3039
3018
  error(reason: any): void;
3040
3019
  }
3041
3020
  /**
3042
- * The **`WritableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a WritableStream's state.
3021
+ * The **`WritableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a WritableStream's state. When constructing a WritableStream, the underlying sink is given a corresponding WritableStreamDefaultController instance to manipulate.
3043
3022
  *
3044
3023
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController)
3045
3024
  */
@@ -3051,7 +3030,7 @@ export declare abstract class WritableStreamDefaultController {
3051
3030
  */
3052
3031
  get signal(): AbortSignal;
3053
3032
  /**
3054
- * The **`error()`** method of the with the associated stream to error.
3033
+ * The **`error()`** method of the WritableStreamDefaultController interface causes any future interactions with the associated stream to error.
3055
3034
  *
3056
3035
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController/error)
3057
3036
  */
@@ -3076,7 +3055,7 @@ export declare abstract class TransformStreamDefaultController<O = any> {
3076
3055
  */
3077
3056
  enqueue(chunk?: O): void;
3078
3057
  /**
3079
- * The **`error()`** method of the TransformStreamDefaultController interface errors both sides of the stream.
3058
+ * The **`error()`** method of the TransformStreamDefaultController interface errors both sides of the stream. Any further interactions with it will fail with the given error message, and any chunks in the queue will be discarded.
3080
3059
  *
3081
3060
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/error)
3082
3061
  */
@@ -3098,7 +3077,7 @@ export interface ReadableWritablePair<R = any, W = any> {
3098
3077
  writable: WritableStream<W>;
3099
3078
  }
3100
3079
  /**
3101
- * The **`WritableStream`** interface of the Streams API provides a standard abstraction for writing streaming data to a destination, known as a sink.
3080
+ * The **`WritableStream`** interface of the Streams API provides a standard abstraction for writing streaming data to a destination, known as a sink. This object comes with built-in backpressure and queuing.
3102
3081
  *
3103
3082
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream)
3104
3083
  */
@@ -3108,7 +3087,7 @@ export declare class WritableStream<W = any> {
3108
3087
  queuingStrategy?: QueuingStrategy,
3109
3088
  );
3110
3089
  /**
3111
- * The **`locked`** read-only property of the WritableStream interface returns a boolean indicating whether the `WritableStream` is locked to a writer.
3090
+ * The **`locked`** read-only property of the WritableStream interface returns a boolean indicating whether the WritableStream is locked to a writer.
3112
3091
  *
3113
3092
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/locked)
3114
3093
  */
@@ -3120,70 +3099,70 @@ export declare class WritableStream<W = any> {
3120
3099
  */
3121
3100
  abort(reason?: any): Promise<void>;
3122
3101
  /**
3123
- * The **`close()`** method of the WritableStream interface closes the associated stream.
3102
+ * The **`close()`** method of the WritableStream interface closes the associated stream. All chunks written before this method is called are sent before the returned promise is fulfilled.
3124
3103
  *
3125
3104
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/close)
3126
3105
  */
3127
3106
  close(): Promise<void>;
3128
3107
  /**
3129
- * The **`getWriter()`** method of the WritableStream interface returns a new instance of WritableStreamDefaultWriter and locks the stream to that instance.
3108
+ * The **`getWriter()`** method of the WritableStream interface returns a new instance of WritableStreamDefaultWriter and locks the stream to that instance. While the stream is locked, no other writer can be acquired until this one is released.
3130
3109
  *
3131
3110
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/getWriter)
3132
3111
  */
3133
3112
  getWriter(): WritableStreamDefaultWriter<W>;
3134
3113
  }
3135
3114
  /**
3136
- * The **`WritableStreamDefaultWriter`** interface of the Streams API is the object returned by WritableStream.getWriter() and once created locks the writer to the `WritableStream` ensuring that no other streams can write to the underlying sink.
3115
+ * The **`WritableStreamDefaultWriter`** interface of the Streams API is the object returned by WritableStream.getWriter() and once created locks the writer to the WritableStream ensuring that no other streams can write to the underlying sink.
3137
3116
  *
3138
3117
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter)
3139
3118
  */
3140
3119
  export declare class WritableStreamDefaultWriter<W = any> {
3141
3120
  constructor(stream: WritableStream);
3142
3121
  /**
3143
- * The **`closed`** read-only property of the the stream errors or the writer's lock is released.
3122
+ * The **`closed`** read-only property of the WritableStreamDefaultWriter interface returns a Promise that fulfills if the stream becomes closed, or rejects if the stream errors or the writer's lock is released.
3144
3123
  *
3145
3124
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/closed)
3146
3125
  */
3147
3126
  get closed(): Promise<void>;
3148
3127
  /**
3149
- * The **`ready`** read-only property of the that resolves when the desired size of the stream's internal queue transitions from non-positive to positive, signaling that it is no longer applying backpressure.
3128
+ * The **`ready`** read-only property of the WritableStreamDefaultWriter interface returns a Promise that resolves when the desired size of the stream's internal queue transitions from non-positive to positive, signaling that it is no longer applying backpressure.
3150
3129
  *
3151
3130
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/ready)
3152
3131
  */
3153
3132
  get ready(): Promise<void>;
3154
3133
  /**
3155
- * The **`desiredSize`** read-only property of the to fill the stream's internal queue.
3134
+ * The **`desiredSize`** read-only property of the WritableStreamDefaultWriter interface returns the desired size required to fill the stream's internal queue.
3156
3135
  *
3157
3136
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/desiredSize)
3158
3137
  */
3159
3138
  get desiredSize(): number | null;
3160
3139
  /**
3161
- * The **`abort()`** method of the the producer can no longer successfully write to the stream and it is to be immediately moved to an error state, with any queued writes discarded.
3140
+ * The **`abort()`** method of the WritableStreamDefaultWriter interface aborts the stream, signaling that the producer can no longer successfully write to the stream and it is to be immediately moved to an error state, with any queued writes discarded.
3162
3141
  *
3163
3142
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/abort)
3164
3143
  */
3165
3144
  abort(reason?: any): Promise<void>;
3166
3145
  /**
3167
- * The **`close()`** method of the stream.
3146
+ * The **`close()`** method of the WritableStreamDefaultWriter interface closes the associated writable stream.
3168
3147
  *
3169
3148
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/close)
3170
3149
  */
3171
3150
  close(): Promise<void>;
3172
3151
  /**
3173
- * The **`write()`** method of the operation.
3152
+ * The **`write()`** method of the WritableStreamDefaultWriter interface writes a passed chunk of data to a WritableStream and its underlying sink, then returns a Promise that resolves to indicate the success or failure of the write operation.
3174
3153
  *
3175
3154
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/write)
3176
3155
  */
3177
3156
  write(chunk?: W): Promise<void>;
3178
3157
  /**
3179
- * The **`releaseLock()`** method of the corresponding stream.
3158
+ * The **`releaseLock()`** method of the WritableStreamDefaultWriter interface releases the writer's lock on the corresponding stream. After the lock is released, the writer is no longer active. If the associated stream is errored when the lock is released, the writer will appear errored in the same way from now on; otherwise, the writer will appear closed.
3180
3159
  *
3181
3160
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/releaseLock)
3182
3161
  */
3183
3162
  releaseLock(): void;
3184
3163
  }
3185
3164
  /**
3186
- * The **`TransformStream`** interface of the Streams API represents a concrete implementation of the pipe chain _transform stream_ concept.
3165
+ * The **`TransformStream`** interface of the Streams API represents a concrete implementation of the pipe chain transform stream concept.
3187
3166
  *
3188
3167
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream)
3189
3168
  */
@@ -3194,13 +3173,13 @@ export declare class TransformStream<I = any, O = any> {
3194
3173
  readableStrategy?: QueuingStrategy<O>,
3195
3174
  );
3196
3175
  /**
3197
- * The **`readable`** read-only property of the TransformStream interface returns the ReadableStream instance controlled by this `TransformStream`.
3176
+ * The **`readable`** read-only property of the TransformStream interface returns the ReadableStream instance controlled by this TransformStream. This stream emits the transformed output data.
3198
3177
  *
3199
3178
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/readable)
3200
3179
  */
3201
3180
  get readable(): ReadableStream<O>;
3202
3181
  /**
3203
- * The **`writable`** read-only property of the TransformStream interface returns the WritableStream instance controlled by this `TransformStream`.
3182
+ * The **`writable`** read-only property of the TransformStream interface returns the WritableStream instance controlled by this TransformStream. This stream accepts input data that will be transformed and emitted to the readable stream.
3204
3183
  *
3205
3184
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/writable)
3206
3185
  */
@@ -3225,7 +3204,7 @@ export interface ReadableStreamValuesOptions {
3225
3204
  preventCancel?: boolean;
3226
3205
  }
3227
3206
  /**
3228
- * The **`CompressionStream`** interface of the Compression Streams API is an API for compressing a stream of data.
3207
+ * The **`CompressionStream`** interface of the Compression Streams API compresses a stream of data. It implements the same shape as a TransformStream, allowing it to be used in ReadableStream.pipeThrough() and similar methods.
3229
3208
  *
3230
3209
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CompressionStream)
3231
3210
  */
@@ -3236,7 +3215,7 @@ export declare class CompressionStream extends TransformStream<
3236
3215
  constructor(format: "gzip" | "deflate" | "deflate-raw");
3237
3216
  }
3238
3217
  /**
3239
- * The **`DecompressionStream`** interface of the Compression Streams API is an API for decompressing a stream of data.
3218
+ * The **`DecompressionStream`** interface of the Compression Streams API decompresses a stream of data. It implements the same shape as a TransformStream, allowing it to be used in ReadableStream.pipeThrough() and similar methods.
3240
3219
  *
3241
3220
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DecompressionStream)
3242
3221
  */
@@ -3247,7 +3226,7 @@ export declare class DecompressionStream extends TransformStream<
3247
3226
  constructor(format: "gzip" | "deflate" | "deflate-raw");
3248
3227
  }
3249
3228
  /**
3250
- * The **`TextEncoderStream`** interface of the Encoding API converts a stream of strings into bytes in the UTF-8 encoding.
3229
+ * The **`TextEncoderStream`** interface of the Encoding API converts a stream of strings into bytes in the UTF-8 encoding. It is the streaming equivalent of TextEncoder. It implements the same shape as a TransformStream, allowing it to be used in ReadableStream.pipeThrough() and similar methods.
3251
3230
  *
3252
3231
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoderStream)
3253
3232
  */
@@ -3259,7 +3238,7 @@ export declare class TextEncoderStream extends TransformStream<
3259
3238
  get encoding(): string;
3260
3239
  }
3261
3240
  /**
3262
- * The **`TextDecoderStream`** interface of the Encoding API converts a stream of text in a binary encoding, such as UTF-8 etc., to a stream of strings.
3241
+ * The **`TextDecoderStream`** interface of the Encoding API converts a stream of text in a binary encoding, such as UTF-8 etc., to a stream of strings. It is the streaming equivalent of TextDecoder. It implements the same shape as a TransformStream, allowing it to be used in ReadableStream.pipeThrough() and similar methods.
3263
3242
  *
3264
3243
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoderStream)
3265
3244
  */
@@ -3451,7 +3430,7 @@ export interface UnsafeTraceMetrics {
3451
3430
  fromTrace(item: TraceItem): TraceMetrics;
3452
3431
  }
3453
3432
  /**
3454
- * The **`URL`** interface is used to parse, construct, normalize, and encode URL.
3433
+ * The **`URL`** interface is used to parse, construct, normalize, and encode URLs. It works by providing properties which allow you to easily read and modify the components of a URL.
3455
3434
  *
3456
3435
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL)
3457
3436
  */
@@ -3476,121 +3455,121 @@ export declare class URL {
3476
3455
  */
3477
3456
  set href(value: string);
3478
3457
  /**
3479
- * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final `':'`.
3458
+ * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final ":".
3480
3459
  *
3481
3460
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/protocol)
3482
3461
  */
3483
3462
  get protocol(): string;
3484
3463
  /**
3485
- * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final `':'`.
3464
+ * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final ":".
3486
3465
  *
3487
3466
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/protocol)
3488
3467
  */
3489
3468
  set protocol(value: string);
3490
3469
  /**
3491
- * The **`username`** property of the URL interface is a string containing the username component of the URL.
3470
+ * The **`username`** property of the URL interface is a string containing the username component of the URL. If the URL does not have a username, this property contains an empty string, "".
3492
3471
  *
3493
3472
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/username)
3494
3473
  */
3495
3474
  get username(): string;
3496
3475
  /**
3497
- * The **`username`** property of the URL interface is a string containing the username component of the URL.
3476
+ * The **`username`** property of the URL interface is a string containing the username component of the URL. If the URL does not have a username, this property contains an empty string, "".
3498
3477
  *
3499
3478
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/username)
3500
3479
  */
3501
3480
  set username(value: string);
3502
3481
  /**
3503
- * The **`password`** property of the URL interface is a string containing the password component of the URL.
3482
+ * The **`password`** property of the URL interface is a string containing the password component of the URL. If the URL does not have a password, this property contains an empty string, "".
3504
3483
  *
3505
3484
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/password)
3506
3485
  */
3507
3486
  get password(): string;
3508
3487
  /**
3509
- * The **`password`** property of the URL interface is a string containing the password component of the URL.
3488
+ * The **`password`** property of the URL interface is a string containing the password component of the URL. If the URL does not have a password, this property contains an empty string, "".
3510
3489
  *
3511
3490
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/password)
3512
3491
  */
3513
3492
  set password(value: string);
3514
3493
  /**
3515
- * The **`host`** property of the URL interface is a string containing the host, which is the URL.hostname, and then, if the port of the URL is nonempty, a `':'`, followed by the URL.port of the URL.
3494
+ * The **`host`** property of the URL interface is a string containing the host, which is the hostname, and then, if the port of the URL is nonempty, a ":", followed by the port of the URL. If the URL does not have a hostname, this property contains an empty string, "".
3516
3495
  *
3517
3496
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/host)
3518
3497
  */
3519
3498
  get host(): string;
3520
3499
  /**
3521
- * The **`host`** property of the URL interface is a string containing the host, which is the URL.hostname, and then, if the port of the URL is nonempty, a `':'`, followed by the URL.port of the URL.
3500
+ * The **`host`** property of the URL interface is a string containing the host, which is the hostname, and then, if the port of the URL is nonempty, a ":", followed by the port of the URL. If the URL does not have a hostname, this property contains an empty string, "".
3522
3501
  *
3523
3502
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/host)
3524
3503
  */
3525
3504
  set host(value: string);
3526
3505
  /**
3527
- * The **`hostname`** property of the URL interface is a string containing either the domain name or IP address of the URL.
3506
+ * The **`hostname`** property of the URL interface is a string containing either the domain name or IP address of the URL. If the URL does not have a hostname, this property contains an empty string, "". IPv4 and IPv6 addresses are normalized, such as stripping leading zeros, and domain names are converted to IDN.
3528
3507
  *
3529
3508
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hostname)
3530
3509
  */
3531
3510
  get hostname(): string;
3532
3511
  /**
3533
- * The **`hostname`** property of the URL interface is a string containing either the domain name or IP address of the URL.
3512
+ * The **`hostname`** property of the URL interface is a string containing either the domain name or IP address of the URL. If the URL does not have a hostname, this property contains an empty string, "". IPv4 and IPv6 addresses are normalized, such as stripping leading zeros, and domain names are converted to IDN.
3534
3513
  *
3535
3514
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hostname)
3536
3515
  */
3537
3516
  set hostname(value: string);
3538
3517
  /**
3539
- * The **`port`** property of the URL interface is a string containing the port number of the URL.
3518
+ * The **`port`** property of the URL interface is a string containing the port number of the URL. If the port is the default for the protocol (80 for ws: and http:, 443 for wss: and https:, and 21 for ftp:), this property contains an empty string, "".
3540
3519
  *
3541
3520
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/port)
3542
3521
  */
3543
3522
  get port(): string;
3544
3523
  /**
3545
- * The **`port`** property of the URL interface is a string containing the port number of the URL.
3524
+ * The **`port`** property of the URL interface is a string containing the port number of the URL. If the port is the default for the protocol (80 for ws: and http:, 443 for wss: and https:, and 21 for ftp:), this property contains an empty string, "".
3546
3525
  *
3547
3526
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/port)
3548
3527
  */
3549
3528
  set port(value: string);
3550
3529
  /**
3551
- * The **`pathname`** property of the URL interface represents a location in a hierarchical structure.
3530
+ * The **`pathname`** property of the URL interface represents a location in a hierarchical structure. It is a string constructed from a list of path segments, each of which is prefixed by a / character.
3552
3531
  *
3553
3532
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/pathname)
3554
3533
  */
3555
3534
  get pathname(): string;
3556
3535
  /**
3557
- * The **`pathname`** property of the URL interface represents a location in a hierarchical structure.
3536
+ * The **`pathname`** property of the URL interface represents a location in a hierarchical structure. It is a string constructed from a list of path segments, each of which is prefixed by a / character.
3558
3537
  *
3559
3538
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/pathname)
3560
3539
  */
3561
3540
  set pathname(value: string);
3562
3541
  /**
3563
- * The **`search`** property of the URL interface is a search string, also called a _query string_, that is a string containing a `'?'` followed by the parameters of the URL.
3542
+ * The **`search`** property of the URL interface is a search string, also called a query string, that is a string containing a "?" followed by the parameters of the URL. If the URL does not have a search query, this property contains an empty string, "".
3564
3543
  *
3565
3544
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/search)
3566
3545
  */
3567
3546
  get search(): string;
3568
3547
  /**
3569
- * The **`search`** property of the URL interface is a search string, also called a _query string_, that is a string containing a `'?'` followed by the parameters of the URL.
3548
+ * The **`search`** property of the URL interface is a search string, also called a query string, that is a string containing a "?" followed by the parameters of the URL. If the URL does not have a search query, this property contains an empty string, "".
3570
3549
  *
3571
3550
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/search)
3572
3551
  */
3573
3552
  set search(value: string);
3574
3553
  /**
3575
- * The **`hash`** property of the URL interface is a string containing a `'#'` followed by the fragment identifier of the URL.
3554
+ * The **`hash`** property of the URL interface is a string containing a "#" followed by the fragment identifier of the URL. If the URL does not have a fragment identifier, this property contains an empty string, "".
3576
3555
  *
3577
3556
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hash)
3578
3557
  */
3579
3558
  get hash(): string;
3580
3559
  /**
3581
- * The **`hash`** property of the URL interface is a string containing a `'#'` followed by the fragment identifier of the URL.
3560
+ * The **`hash`** property of the URL interface is a string containing a "#" followed by the fragment identifier of the URL. If the URL does not have a fragment identifier, this property contains an empty string, "".
3582
3561
  *
3583
3562
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hash)
3584
3563
  */
3585
3564
  set hash(value: string);
3586
3565
  /**
3587
- * The **`searchParams`** read-only property of the access to the [MISSING: httpmethod('GET')] decoded query arguments contained in the URL.
3566
+ * The **`searchParams`** read-only property of the URL interface returns a URLSearchParams object allowing access to the GET decoded query arguments contained in the URL.
3588
3567
  *
3589
3568
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/searchParams)
3590
3569
  */
3591
3570
  get searchParams(): URLSearchParams;
3592
3571
  /**
3593
- * The **`toJSON()`** method of the URL interface returns a string containing a serialized version of the URL, although in practice it seems to have the same effect as ```js-nolint toJSON() ``` None.
3572
+ * The **`toJSON()`** method of the URL interface returns a string containing a serialized version of the URL, although in practice it seems to have the same effect as URL.toString().
3594
3573
  *
3595
3574
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/toJSON)
3596
3575
  */
@@ -3610,13 +3589,13 @@ export declare class URL {
3610
3589
  */
3611
3590
  static parse(url: string, base?: string): URL | null;
3612
3591
  /**
3613
- * The **`createObjectURL()`** static method of the URL interface creates a string containing a URL representing the object given in the parameter.
3592
+ * The **`createObjectURL()`** static method of the URL interface creates a string containing a blob URL pointing to the object given in the parameter.
3614
3593
  *
3615
3594
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/createObjectURL_static)
3616
3595
  */
3617
3596
  static createObjectURL(object: File | Blob): string;
3618
3597
  /**
3619
- * The **`revokeObjectURL()`** static method of the URL interface releases an existing object URL which was previously created by calling Call this method when you've finished using an object URL to let the browser know not to keep the reference to the file any longer.
3598
+ * The **`revokeObjectURL()`** static method of the URL interface releases an existing object URL which was previously created by calling URL.createObjectURL().
3620
3599
  *
3621
3600
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/revokeObjectURL_static)
3622
3601
  */
@@ -3668,22 +3647,19 @@ export declare class URLSearchParams {
3668
3647
  */
3669
3648
  has(name: string, value?: string): boolean;
3670
3649
  /**
3671
- * The **`set()`** method of the URLSearchParams interface sets the value associated with a given search parameter to the given value.
3650
+ * The **`set()`** method of the URLSearchParams interface sets the value associated with a given search parameter to the given value. If there were several matching values, this method deletes the others. If the search parameter doesn't exist, this method creates it.
3672
3651
  *
3673
3652
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/set)
3674
3653
  */
3675
3654
  set(name: string, value: string): void;
3676
3655
  /**
3677
- * The **`URLSearchParams.sort()`** method sorts all key/value pairs contained in this object in place and returns `undefined`.
3656
+ * The **`URLSearchParams.sort()`** method sorts all key/value pairs contained in this object in place and returns undefined. Key/value pairs are sorted by the values of the UTF-16 code units of the keys. This method uses a stable sorting algorithm (i.e., the relative order between key/value pairs with equal keys will be preserved).
3678
3657
  *
3679
3658
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/sort)
3680
3659
  */
3681
3660
  sort(): void;
3682
- /* Returns an array of key, value pairs for every entry in the search params. */
3683
3661
  entries(): IterableIterator<[key: string, value: string]>;
3684
- /* Returns a list of keys in the search params. */
3685
3662
  keys(): IterableIterator<string>;
3686
- /* Returns a list of values in the search params. */
3687
3663
  values(): IterableIterator<string>;
3688
3664
  forEach<This = unknown>(
3689
3665
  callback: (
@@ -3698,22 +3674,82 @@ export declare class URLSearchParams {
3698
3674
  toString(): string;
3699
3675
  [Symbol.iterator](): IterableIterator<[key: string, value: string]>;
3700
3676
  }
3677
+ /**
3678
+ * The **`URLPattern`** interface of the URL Pattern API matches URLs or parts of URLs against a pattern. The pattern can contain capturing groups that extract parts of the matched URL.
3679
+ *
3680
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern)
3681
+ */
3701
3682
  export declare class URLPattern {
3702
3683
  constructor(
3703
3684
  input?: string | URLPatternInit,
3704
3685
  baseURL?: string | URLPatternOptions,
3705
3686
  patternOptions?: URLPatternOptions,
3706
3687
  );
3688
+ /**
3689
+ * The **`protocol`** read-only property of the URLPattern interface is a string containing the pattern used to match the protocol part of a URL.
3690
+ *
3691
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/protocol)
3692
+ */
3707
3693
  get protocol(): string;
3694
+ /**
3695
+ * The **`username`** read-only property of the URLPattern interface is a string containing the pattern used to match the username part of a URL.
3696
+ *
3697
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/username)
3698
+ */
3708
3699
  get username(): string;
3700
+ /**
3701
+ * The **`password`** read-only property of the URLPattern interface is a string containing the pattern used to match the password part of a URL.
3702
+ *
3703
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/password)
3704
+ */
3709
3705
  get password(): string;
3706
+ /**
3707
+ * The **`hostname`** read-only property of the URLPattern interface is a string containing the pattern used to match the hostname part of a URL.
3708
+ *
3709
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/hostname)
3710
+ */
3710
3711
  get hostname(): string;
3712
+ /**
3713
+ * The **`port`** read-only property of the URLPattern interface is a string containing the pattern used to match the port part of a URL.
3714
+ *
3715
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/port)
3716
+ */
3711
3717
  get port(): string;
3718
+ /**
3719
+ * The **`pathname`** read-only property of the URLPattern interface is a string containing the pattern used to match the pathname part of a URL.
3720
+ *
3721
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/pathname)
3722
+ */
3712
3723
  get pathname(): string;
3724
+ /**
3725
+ * The **`search`** read-only property of the URLPattern interface is a string containing the pattern used to match the search part of a URL.
3726
+ *
3727
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/search)
3728
+ */
3713
3729
  get search(): string;
3730
+ /**
3731
+ * The **`hash`** read-only property of the URLPattern interface is a string containing the pattern used to match the fragment part of a URL.
3732
+ *
3733
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/hash)
3734
+ */
3714
3735
  get hash(): string;
3736
+ /**
3737
+ * The **`hasRegExpGroups`** read-only property of the URLPattern interface is a boolean indicating whether or not any of the URLPattern components contain regular expression capturing groups.
3738
+ *
3739
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/hasRegExpGroups)
3740
+ */
3715
3741
  get hasRegExpGroups(): boolean;
3742
+ /**
3743
+ * The **`test()`** method of the URLPattern interface takes a URL string or object of URL parts, and returns a boolean indicating if the given input matches the current pattern.
3744
+ *
3745
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/test)
3746
+ */
3716
3747
  test(input?: string | URLPatternInit, baseURL?: string): boolean;
3748
+ /**
3749
+ * The **`exec()`** method of the URLPattern interface takes a URL or object of URL parts, and returns either an object containing the results of matching the URL to the pattern, or null if the URL does not match the pattern.
3750
+ *
3751
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/exec)
3752
+ */
3717
3753
  exec(
3718
3754
  input?: string | URLPatternInit,
3719
3755
  baseURL?: string,
@@ -3749,7 +3785,7 @@ export interface URLPatternOptions {
3749
3785
  ignoreCase?: boolean;
3750
3786
  }
3751
3787
  /**
3752
- * A `CloseEvent` is sent to clients using WebSockets when the connection is closed.
3788
+ * A **`CloseEvent`** is sent to clients using WebSockets when the connection is closed. This is delivered to the listener indicated by the WebSocket object's onclose attribute.
3753
3789
  *
3754
3790
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CloseEvent)
3755
3791
  */
@@ -3768,7 +3804,7 @@ export declare class CloseEvent extends Event {
3768
3804
  */
3769
3805
  readonly reason: string;
3770
3806
  /**
3771
- * The **`wasClean`** read-only property of the CloseEvent interface returns `true` if the connection closed cleanly.
3807
+ * The **`wasClean`** read-only property of the CloseEvent interface returns true if the connection closed cleanly.
3772
3808
  *
3773
3809
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CloseEvent/wasClean)
3774
3810
  */
@@ -3786,7 +3822,7 @@ export type WebSocketEventMap = {
3786
3822
  error: ErrorEvent;
3787
3823
  };
3788
3824
  /**
3789
- * The `WebSocket` object provides the API for creating and managing a WebSocket connection to a server, as well as for sending and receiving data on the connection.
3825
+ * The **`WebSocket`** object provides the API for creating and managing a WebSocket connection to a server, as well as for sending and receiving data on the connection.
3790
3826
  *
3791
3827
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket)
3792
3828
  */
@@ -3803,20 +3839,20 @@ export declare var WebSocket: {
3803
3839
  readonly CLOSED: number;
3804
3840
  };
3805
3841
  /**
3806
- * The `WebSocket` object provides the API for creating and managing a WebSocket connection to a server, as well as for sending and receiving data on the connection.
3842
+ * The **`WebSocket`** object provides the API for creating and managing a WebSocket connection to a server, as well as for sending and receiving data on the connection.
3807
3843
  *
3808
3844
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket)
3809
3845
  */
3810
3846
  export interface WebSocket extends EventTarget<WebSocketEventMap> {
3811
3847
  accept(options?: WebSocketAcceptOptions): void;
3812
3848
  /**
3813
- * The **`WebSocket.send()`** method enqueues the specified data to be transmitted to the server over the WebSocket connection, increasing the value of `bufferedAmount` by the number of bytes needed to contain the data.
3849
+ * The **`WebSocket.send()`** method enqueues the specified data to be transmitted to the server over the WebSocket connection, increasing the value of bufferedAmount by the number of bytes needed to contain the data. If the data can't be sent (for example, because it needs to be buffered but the buffer is full), the socket is closed automatically. The browser will throw an exception if you call send() when the connection is in the CONNECTING state. If you call send() when the connection is in the CLOSING or CLOSED states, the browser will silently discard the data.
3814
3850
  *
3815
3851
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/send)
3816
3852
  */
3817
3853
  send(message: (ArrayBuffer | ArrayBufferView) | string): void;
3818
3854
  /**
3819
- * The **`WebSocket.close()`** method closes the already `CLOSED`, this method does nothing.
3855
+ * The **`WebSocket.close()`** method closes the WebSocket connection or connection attempt, if any. If the connection is already CLOSED, this method does nothing.
3820
3856
  *
3821
3857
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/close)
3822
3858
  */
@@ -3836,13 +3872,13 @@ export interface WebSocket extends EventTarget<WebSocketEventMap> {
3836
3872
  */
3837
3873
  url: string | null;
3838
3874
  /**
3839
- * The **`WebSocket.protocol`** read-only property returns the name of the sub-protocol the server selected; this will be one of the strings specified in the `protocols` parameter when creating the WebSocket object, or the empty string if no connection is established.
3875
+ * The **`WebSocket.protocol`** read-only property returns the name of the sub-protocol the server selected; this will be one of the strings specified in the protocols parameter when creating the WebSocket object, or the empty string if no connection is established.
3840
3876
  *
3841
3877
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/protocol)
3842
3878
  */
3843
3879
  protocol: string | null;
3844
3880
  /**
3845
- * The **`WebSocket.extensions`** read-only property returns the extensions selected by the server.
3881
+ * The **`WebSocket.extensions`** read-only property returns the extensions selected by the server. This is currently only the empty string or a list of extensions as negotiated by the connection.
3846
3882
  *
3847
3883
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/extensions)
3848
3884
  */
@@ -3945,25 +3981,25 @@ export interface SocketInfo {
3945
3981
  export declare class EventSource extends EventTarget {
3946
3982
  constructor(url: string, init?: EventSourceEventSourceInit);
3947
3983
  /**
3948
- * The **`close()`** method of the EventSource interface closes the connection, if one is made, and sets the ```js-nolint close() ``` None.
3984
+ * The **`close()`** method of the EventSource interface closes the connection, if one is made, and sets the EventSource.readyState attribute to 2 (closed).
3949
3985
  *
3950
3986
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/close)
3951
3987
  */
3952
3988
  close(): void;
3953
3989
  /**
3954
- * The **`url`** read-only property of the URL of the source.
3990
+ * The **`url`** read-only property of the EventSource interface returns a string representing the URL of the source.
3955
3991
  *
3956
3992
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/url)
3957
3993
  */
3958
3994
  get url(): string;
3959
3995
  /**
3960
- * The **`withCredentials`** read-only property of the the `EventSource` object was instantiated with CORS credentials set.
3996
+ * The **`withCredentials`** read-only property of the EventSource interface returns a boolean value indicating whether the EventSource object was instantiated with CORS credentials set.
3961
3997
  *
3962
3998
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/withCredentials)
3963
3999
  */
3964
4000
  get withCredentials(): boolean;
3965
4001
  /**
3966
- * The **`readyState`** read-only property of the connection.
4002
+ * The **`readyState`** read-only property of the EventSource interface returns a number representing the state of the connection.
3967
4003
  *
3968
4004
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/readyState)
3969
4005
  */
@@ -4097,26 +4133,26 @@ export interface ContainerStartResources {
4097
4133
  diskMb: number;
4098
4134
  }
4099
4135
  /**
4100
- * The **`FileSystemHandle`** interface of the File System API is an object which represents a file or directory entry.
4136
+ * The **`FileSystemHandle`** interface of the File System API is an object which represents a file or directory entry. Multiple handles can represent the same entry. For the most part you do not work with FileSystemHandle directly but rather its child interfaces FileSystemFileHandle and FileSystemDirectoryHandle.
4101
4137
  * Available only in secure contexts.
4102
4138
  *
4103
4139
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle)
4104
4140
  */
4105
4141
  export declare abstract class FileSystemHandle {
4106
4142
  /**
4107
- * The **`kind`** read-only property of the `'file'` if the associated entry is a file or `'directory'`.
4143
+ * The **`kind`** read-only property of the FileSystemHandle interface returns the type of entry. This is 'file' if the associated entry is a file or 'directory'. It is used to distinguish files from directories when iterating over the contents of a directory.
4108
4144
  *
4109
4145
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/kind)
4110
4146
  */
4111
4147
  get kind(): string;
4112
4148
  /**
4113
- * The **`name`** read-only property of the handle.
4149
+ * The **`name`** read-only property of the FileSystemHandle interface returns the name of the entry represented by handle.
4114
4150
  *
4115
4151
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/name)
4116
4152
  */
4117
4153
  get name(): string;
4118
4154
  /**
4119
- * The **`isSameEntry()`** method of the ```js-nolint isSameEntry(fileSystemHandle) ``` - FileSystemHandle - : The `FileSystemHandle` to match against the handle on which the method is invoked.
4155
+ * The **`isSameEntry()`** method of the FileSystemHandle interface compares two handles to see if the associated entries (either a file or directory) match.
4120
4156
  *
4121
4157
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/isSameEntry)
4122
4158
  */
@@ -4125,20 +4161,20 @@ export declare abstract class FileSystemHandle {
4125
4161
  remove(options?: FileSystemHandleRemoveOptions): Promise<void>;
4126
4162
  }
4127
4163
  /**
4128
- * The **`FileSystemFileHandle`** interface of the File System API represents a handle to a file system entry.
4164
+ * The **`FileSystemFileHandle`** interface of the File System API represents a handle to a file system entry. The interface is accessed through the window.showOpenFilePicker() method.
4129
4165
  * Available only in secure contexts.
4130
4166
  *
4131
4167
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemFileHandle)
4132
4168
  */
4133
4169
  export declare abstract class FileSystemFileHandle extends FileSystemHandle {
4134
4170
  /**
4135
- * The **`getFile()`** method of the If the file on disk changes or is removed after this method is called, the returned ```js-nolint getFile() ``` None.
4171
+ * The **`getFile()`** method of the FileSystemFileHandle interface returns a Promise which resolves to a File object representing the state on disk of the entry represented by the handle.
4136
4172
  *
4137
4173
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemFileHandle/getFile)
4138
4174
  */
4139
4175
  getFile(): Promise<File>;
4140
4176
  /**
4141
- * The **`createWritable()`** method of the FileSystemFileHandle interface creates a FileSystemWritableFileStream that can be used to write to a file.
4177
+ * The **`createWritable()`** method of the FileSystemFileHandle interface creates a FileSystemWritableFileStream that can be used to write to a file. The method returns a Promise which resolves to this created stream.
4142
4178
  *
4143
4179
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemFileHandle/createWritable)
4144
4180
  */
@@ -4154,7 +4190,7 @@ export declare abstract class FileSystemFileHandle extends FileSystemHandle {
4154
4190
  */
4155
4191
  export declare abstract class FileSystemDirectoryHandle extends FileSystemHandle {
4156
4192
  /**
4157
- * The **`getFileHandle()`** method of the directory the method is called.
4193
+ * The **`getFileHandle()`** method of the FileSystemDirectoryHandle interface returns a FileSystemFileHandle for a file with the specified name, within the directory the method is called.
4158
4194
  *
4159
4195
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/getFileHandle)
4160
4196
  */
@@ -4163,7 +4199,7 @@ export declare abstract class FileSystemDirectoryHandle extends FileSystemHandle
4163
4199
  options?: FileSystemDirectoryHandleFileSystemGetFileOptions,
4164
4200
  ): Promise<FileSystemFileHandle>;
4165
4201
  /**
4166
- * The **`getDirectoryHandle()`** method of the within the directory handle on which the method is called.
4202
+ * The **`getDirectoryHandle()`** method of the FileSystemDirectoryHandle interface returns a FileSystemDirectoryHandle for a subdirectory with the specified name within the directory handle on which the method is called.
4167
4203
  *
4168
4204
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/getDirectoryHandle)
4169
4205
  */
@@ -4172,7 +4208,7 @@ export declare abstract class FileSystemDirectoryHandle extends FileSystemHandle
4172
4208
  options?: FileSystemDirectoryHandleFileSystemGetDirectoryOptions,
4173
4209
  ): Promise<FileSystemDirectoryHandle>;
4174
4210
  /**
4175
- * The **`removeEntry()`** method of the directory handle contains a file or directory called the name specified.
4211
+ * The **`removeEntry()`** method of the FileSystemDirectoryHandle interface attempts to remove an entry if the directory handle contains a file or directory called the name specified.
4176
4212
  *
4177
4213
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/removeEntry)
4178
4214
  */
@@ -4181,7 +4217,7 @@ export declare abstract class FileSystemDirectoryHandle extends FileSystemHandle
4181
4217
  options?: FileSystemDirectoryHandleFileSystemRemoveOptions,
4182
4218
  ): Promise<void>;
4183
4219
  /**
4184
- * The **`resolve()`** method of the directory names from the parent handle to the specified child entry, with the name of the child entry as the last array item.
4220
+ * The **`resolve()`** method of the FileSystemDirectoryHandle interface returns an Array of directory names from the parent handle to the specified child entry, with the name of the child entry as the last array item.
4185
4221
  *
4186
4222
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/resolve)
4187
4223
  */
@@ -4200,7 +4236,7 @@ export declare abstract class FileSystemDirectoryHandle extends FileSystemHandle
4200
4236
  [Symbol.asyncIterator](): AsyncIterableIterator<[string, FileSystemHandle]>;
4201
4237
  }
4202
4238
  /**
4203
- * The **`FileSystemWritableFileStream`** interface of the File System API is a WritableStream object with additional convenience methods, which operates on a single file on disk.
4239
+ * The **`FileSystemWritableFileStream`** interface of the File System API is a WritableStream object with additional convenience methods, which operates on a single file on disk. The interface is accessed through the FileSystemFileHandle.createWritable() method.
4204
4240
  * Available only in secure contexts.
4205
4241
  *
4206
4242
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemWritableFileStream)
@@ -4232,7 +4268,7 @@ export declare abstract class FileSystemWritableFileStream extends WritableStrea
4232
4268
  truncate(size: number): Promise<void>;
4233
4269
  }
4234
4270
  /**
4235
- * The **`StorageManager`** interface of the Storage API provides an interface for managing persistence permissions and estimating available storage.
4271
+ * The **`StorageManager`** interface of the Storage API provides an interface for managing persistence permissions and estimating available storage. You can get a reference to this interface using either navigator.storage or WorkerNavigator.storage.
4236
4272
  * Available only in secure contexts.
4237
4273
  *
4238
4274
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/StorageManager)
@@ -4273,7 +4309,7 @@ export interface FileSystemHandleRemoveOptions {
4273
4309
  */
4274
4310
  export declare abstract class MessagePort extends EventTarget {
4275
4311
  /**
4276
- * The **`postMessage()`** method of the transfers ownership of objects to other browsing contexts.
4312
+ * The **`postMessage()`** method of the MessagePort interface sends a message from the port, and optionally, transfers ownership of objects to other browsing contexts.
4277
4313
  *
4278
4314
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/postMessage)
4279
4315
  */
@@ -4282,13 +4318,13 @@ export declare abstract class MessagePort extends EventTarget {
4282
4318
  options?: any[] | MessagePortPostMessageOptions,
4283
4319
  ): void;
4284
4320
  /**
4285
- * The **`close()`** method of the MessagePort interface disconnects the port, so it is no longer active.
4321
+ * The **`close()`** method of the MessagePort interface disconnects the port, so it is no longer active. This stops the flow of messages to that port.
4286
4322
  *
4287
4323
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/close)
4288
4324
  */
4289
4325
  close(): void;
4290
4326
  /**
4291
- * The **`start()`** method of the MessagePort interface starts the sending of messages queued on the port.
4327
+ * The **`start()`** method of the MessagePort interface starts the sending of messages queued on the port. This method is only needed when using EventTarget.addEventListener; it is implied when using onmessage.
4292
4328
  *
4293
4329
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/start)
4294
4330
  */
@@ -4304,13 +4340,13 @@ export declare abstract class MessagePort extends EventTarget {
4304
4340
  export declare class MessageChannel {
4305
4341
  constructor();
4306
4342
  /**
4307
- * The **`port1`** read-only property of the the port attached to the context that originated the channel.
4343
+ * The **`port1`** read-only property of the MessageChannel interface returns the first port of the message channel — the port attached to the context that originated the channel.
4308
4344
  *
4309
4345
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageChannel/port1)
4310
4346
  */
4311
4347
  readonly port1: MessagePort;
4312
4348
  /**
4313
- * The **`port2`** read-only property of the the port attached to the context at the other end of the channel, which the message is initially sent to.
4349
+ * The **`port2`** read-only property of the MessageChannel interface returns the second port of the message channel — the port attached to the context at the other end of the channel, which the message is initially sent to.
4314
4350
  *
4315
4351
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageChannel/port2)
4316
4352
  */
@@ -4440,7 +4476,7 @@ export declare abstract class Performance extends EventTarget {
4440
4476
  */
4441
4477
  clearMeasures(name?: string): void;
4442
4478
  /**
4443
- * The **`clearResourceTimings()`** method removes all performance entries with an PerformanceEntry.entryType of `'resource'` from the browser's performance timeline and sets the size of the performance resource data buffer to zero.
4479
+ * The **`clearResourceTimings()`** method removes all performance entries with an entryType of "resource" from the browser's performance timeline and sets the size of the performance resource data buffer to zero.
4444
4480
  *
4445
4481
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/clearResourceTimings)
4446
4482
  */
@@ -4452,13 +4488,13 @@ export declare abstract class Performance extends EventTarget {
4452
4488
  */
4453
4489
  getEntries(): PerformanceEntry[];
4454
4490
  /**
4455
- * The **`getEntriesByName()`** method returns an array of PerformanceEntry objects currently present in the performance timeline with the given _name_ and _type_.
4491
+ * The **`getEntriesByName()`** method returns an array of PerformanceEntry objects currently present in the performance timeline with the given name and type.
4456
4492
  *
4457
4493
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/getEntriesByName)
4458
4494
  */
4459
4495
  getEntriesByName(name: string, type?: string): PerformanceEntry[];
4460
4496
  /**
4461
- * The **`getEntriesByType()`** method returns an array of PerformanceEntry objects currently present in the performance timeline for a given _type_.
4497
+ * The **`getEntriesByType()`** method returns an array of PerformanceEntry objects currently present in the performance timeline for a given type.
4462
4498
  *
4463
4499
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/getEntriesByType)
4464
4500
  */
@@ -4480,13 +4516,13 @@ export declare abstract class Performance extends EventTarget {
4480
4516
  maybeEndMark?: string,
4481
4517
  ): PerformanceMeasure;
4482
4518
  /**
4483
- * The **`setResourceTimingBufferSize()`** method sets the desired size of the browser's resource timing buffer which stores the `'resource'` performance entries.
4519
+ * The **`setResourceTimingBufferSize()`** method sets the desired size of the browser's resource timing buffer which stores the "resource" performance entries.
4484
4520
  *
4485
4521
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/setResourceTimingBufferSize)
4486
4522
  */
4487
4523
  setResourceTimingBufferSize(size: number): void;
4488
4524
  /**
4489
- * The **`toJSON()`** method of the Performance interface is a Serialization; it returns a JSON representation of the Performance object.
4525
+ * The **`toJSON()`** method of the Performance interface is a serializer; it returns a JSON representation of the Performance object.
4490
4526
  *
4491
4527
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/toJSON)
4492
4528
  */
@@ -4518,14 +4554,14 @@ export interface UvMetricsInfo {
4518
4554
  eventsWaiting: number;
4519
4555
  }
4520
4556
  /**
4521
- * **`PerformanceMark`** is an interface for PerformanceEntry objects with an PerformanceEntry.entryType of `'mark'`.
4557
+ * **`PerformanceMark`** is an interface for PerformanceEntry objects with an entryType of "mark".
4522
4558
  *
4523
4559
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMark)
4524
4560
  */
4525
4561
  export declare class PerformanceMark extends PerformanceEntry {
4526
4562
  constructor(name: string, maybeOptions?: PerformanceMarkOptions);
4527
4563
  /**
4528
- * The read-only **`detail`** property returns arbitrary metadata that was included in the mark upon construction (either when using Performance.mark or the PerformanceMark.PerformanceMark constructor).
4564
+ * The read-only **`detail`** property returns arbitrary metadata that was included in the mark upon construction (either when using performance.mark() or the PerformanceMark() constructor).
4529
4565
  *
4530
4566
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMark/detail)
4531
4567
  */
@@ -4533,13 +4569,13 @@ export declare class PerformanceMark extends PerformanceEntry {
4533
4569
  toJSON(): object;
4534
4570
  }
4535
4571
  /**
4536
- * **`PerformanceMeasure`** is an _abstract_ interface for PerformanceEntry objects with an PerformanceEntry.entryType of `'measure'`.
4572
+ * **`PerformanceMeasure`** is an abstract interface for PerformanceEntry objects with an entryType of "measure". Entries of this type are created by calling performance.measure() to add a named DOMHighResTimeStamp (the measure) between two marks to the browser's performance timeline.
4537
4573
  *
4538
4574
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMeasure)
4539
4575
  */
4540
4576
  export declare abstract class PerformanceMeasure extends PerformanceEntry {
4541
4577
  /**
4542
- * The read-only **`detail`** property returns arbitrary metadata that was included in the mark upon construction (when using Performance.measure.
4578
+ * The read-only **`detail`** property returns arbitrary metadata that was included in the mark upon construction (when using performance.measure().
4543
4579
  *
4544
4580
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMeasure/detail)
4545
4581
  */
@@ -4557,25 +4593,25 @@ export interface PerformanceMeasureOptions {
4557
4593
  end?: number;
4558
4594
  }
4559
4595
  /**
4560
- * The **`PerformanceObserverEntryList`** interface is a list of PerformanceEntry that were explicitly observed via the PerformanceObserver.observe method.
4596
+ * The **`PerformanceObserverEntryList`** interface is a list of performance events that were explicitly observed via the observe() method.
4561
4597
  *
4562
4598
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList)
4563
4599
  */
4564
4600
  export declare abstract class PerformanceObserverEntryList {
4565
4601
  /**
4566
- * The **`getEntries()`** method of the PerformanceObserverEntryList interface returns a list of explicitly observed PerformanceEntry objects.
4602
+ * The **`getEntries()`** method of the PerformanceObserverEntryList interface returns a list of explicitly observed performance entry objects. The list's members are determined by the set of entry types specified in the call to the observe() method. The list is available in the observer's callback function (as the first parameter in the callback).
4567
4603
  *
4568
4604
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntries)
4569
4605
  */
4570
4606
  getEntries(): PerformanceEntry[];
4571
4607
  /**
4572
- * The **`getEntriesByType()`** method of the PerformanceObserverEntryList returns a list of explicitly _observed_ PerformanceEntry objects for a given PerformanceEntry.entryType.
4608
+ * The **`getEntriesByType()`** method of the PerformanceObserverEntryList returns a list of explicitly observed performance entry objects for a given performance entry type. The list's members are determined by the set of entry types specified in the call to the observe() method. The list is available in the observer's callback function (as the first parameter in the callback).
4573
4609
  *
4574
4610
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntriesByType)
4575
4611
  */
4576
4612
  getEntriesByType(type: string): PerformanceEntry[];
4577
4613
  /**
4578
- * The **`getEntriesByName()`** method of the PerformanceObserverEntryList interface returns a list of explicitly observed PerformanceEntry objects for a given PerformanceEntry.name and PerformanceEntry.entryType.
4614
+ * The **`getEntriesByName()`** method of the PerformanceObserverEntryList interface returns a list of explicitly observed PerformanceEntry objects for a given name and entryType. The list's members are determined by the set of entry types specified in the call to the observe() method. The list is available in the observer's callback function (as the first parameter in the callback).
4579
4615
  *
4580
4616
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntriesByName)
4581
4617
  */
@@ -4588,7 +4624,7 @@ export declare abstract class PerformanceObserverEntryList {
4588
4624
  */
4589
4625
  export declare abstract class PerformanceEntry {
4590
4626
  /**
4591
- * The read-only **`name`** property of the PerformanceEntry interface is a string representing the name for a performance entry.
4627
+ * The read-only **`name`** property of the PerformanceEntry interface is a string representing the name for a performance entry. It acts as an identifier, but it does not have to be unique. The value depends on the subclass.
4592
4628
  *
4593
4629
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/name)
4594
4630
  */
@@ -4600,68 +4636,68 @@ export declare abstract class PerformanceEntry {
4600
4636
  */
4601
4637
  get entryType(): string;
4602
4638
  /**
4603
- * The read-only **`startTime`** property returns the first DOMHighResTimeStamp recorded for this PerformanceEntry.
4639
+ * The read-only **`startTime`** property returns the first timestamp recorded for this PerformanceEntry. The meaning of this property depends on the value of this entry's entryType.
4604
4640
  *
4605
4641
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/startTime)
4606
4642
  */
4607
4643
  get startTime(): number;
4608
4644
  /**
4609
- * The read-only **`duration`** property returns a DOMHighResTimeStamp that is the duration of the PerformanceEntry.
4645
+ * The read-only **`duration`** property returns a timestamp that is the duration of the performance entry. The meaning of this property depends on the value of this entry's entryType.
4610
4646
  *
4611
4647
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/duration)
4612
4648
  */
4613
4649
  get duration(): number;
4614
4650
  /**
4615
- * The **`toJSON()`** method is a Serialization; it returns a JSON representation of the PerformanceEntry object.
4651
+ * The **`toJSON()`** method is a serializer; it returns a JSON representation of the PerformanceEntry object.
4616
4652
  *
4617
4653
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/toJSON)
4618
4654
  */
4619
4655
  toJSON(): object;
4620
4656
  }
4621
4657
  /**
4622
- * The **`PerformanceResourceTiming`** interface enables retrieval and analysis of detailed network timing data regarding the loading of an application's resources.
4658
+ * The **`PerformanceResourceTiming`** interface enables retrieval and analysis of detailed network timing data regarding the loading of an application's resources. An application can use the timing metrics to determine, for example, the length of time it takes to fetch a specific resource, such as an XMLHttpRequest, <SVG>, image, or script.
4623
4659
  *
4624
4660
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming)
4625
4661
  */
4626
4662
  export declare abstract class PerformanceResourceTiming extends PerformanceEntry {
4627
4663
  /**
4628
- * The **`connectEnd`** read-only property returns the DOMHighResTimeStamp immediately after the browser finishes establishing the connection to the server to retrieve the resource.
4664
+ * The **`connectEnd`** read-only property returns the timestamp immediately after the browser finishes establishing the connection to the server to retrieve the resource. The timestamp value includes the time interval to establish the transport connection, as well as other time intervals such as TLS handshake and SOCKS authentication.
4629
4665
  *
4630
4666
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/connectEnd)
4631
4667
  */
4632
4668
  get connectEnd(): number;
4633
4669
  /**
4634
- * The **`connectStart`** read-only property returns the DOMHighResTimeStamp immediately before the user agent starts establishing the connection to the server to retrieve the resource.
4670
+ * The **`connectStart`** read-only property returns the timestamp immediately before the user agent starts establishing the connection to the server to retrieve the resource.
4635
4671
  *
4636
4672
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/connectStart)
4637
4673
  */
4638
4674
  get connectStart(): number;
4639
4675
  /**
4640
- * The **`decodedBodySize`** read-only property returns the size (in octets) received from the fetch (HTTP or cache) of the message body after removing any applied content encoding (like gzip or Brotli).
4676
+ * The **`decodedBodySize`** read-only property returns the size (in octets) received from the fetch (HTTP or cache) of the message body after removing any applied content encoding (like gzip or Brotli). If the resource is retrieved from an application cache or local resources, it returns the size of the payload after removing any applied content encoding.
4641
4677
  *
4642
4678
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/decodedBodySize)
4643
4679
  */
4644
4680
  get decodedBodySize(): number;
4645
4681
  /**
4646
- * The **`domainLookupEnd`** read-only property returns the DOMHighResTimeStamp immediately after the browser finishes the domain-name lookup for the resource.
4682
+ * The **`domainLookupEnd`** read-only property returns the timestamp immediately after the browser finishes the domain-name lookup for the resource.
4647
4683
  *
4648
4684
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/domainLookupEnd)
4649
4685
  */
4650
4686
  get domainLookupEnd(): number;
4651
4687
  /**
4652
- * The **`domainLookupStart`** read-only property returns the DOMHighResTimeStamp immediately before the browser starts the domain name lookup for the resource.
4688
+ * The **`domainLookupStart`** read-only property returns the timestamp immediately before the browser starts the domain name lookup for the resource.
4653
4689
  *
4654
4690
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/domainLookupStart)
4655
4691
  */
4656
4692
  get domainLookupStart(): number;
4657
4693
  /**
4658
- * The **`encodedBodySize`** read-only property represents the size (in octets) received from the fetch (HTTP or cache) of the payload body before removing any applied content encodings (like gzip or Brotli).
4694
+ * The **`encodedBodySize`** read-only property represents the size (in octets) received from the fetch (HTTP or cache) of the payload body before removing any applied content encodings (like gzip or Brotli). If the resource is retrieved from an application cache or a local resource, it must return the size of the payload body before removing any applied content encoding.
4659
4695
  *
4660
4696
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/encodedBodySize)
4661
4697
  */
4662
4698
  get encodedBodySize(): number;
4663
4699
  /**
4664
- * The **`fetchStart`** read-only property represents a DOMHighResTimeStamp immediately before the browser starts to fetch the resource.
4700
+ * The **`fetchStart`** read-only property represents a timestamp immediately before the browser starts to fetch the resource.
4665
4701
  *
4666
4702
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/fetchStart)
4667
4703
  */
@@ -4679,31 +4715,31 @@ export declare abstract class PerformanceResourceTiming extends PerformanceEntry
4679
4715
  */
4680
4716
  get nextHopProtocol(): string;
4681
4717
  /**
4682
- * The **`redirectEnd`** read-only property returns a DOMHighResTimeStamp immediately after receiving the last byte of the response of the last redirect.
4718
+ * The **`redirectEnd`** read-only property returns a timestamp immediately after receiving the last byte of the response of the last redirect.
4683
4719
  *
4684
4720
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/redirectEnd)
4685
4721
  */
4686
4722
  get redirectEnd(): number;
4687
4723
  /**
4688
- * The **`redirectStart`** read-only property returns a DOMHighResTimeStamp representing the start time of the fetch which that initiates the redirect.
4724
+ * The **`redirectStart`** read-only property returns a timestamp representing the start time of the fetch which that initiates the redirect.
4689
4725
  *
4690
4726
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/redirectStart)
4691
4727
  */
4692
4728
  get redirectStart(): number;
4693
4729
  /**
4694
- * The **`requestStart`** read-only property returns a DOMHighResTimeStamp of the time immediately before the browser starts requesting the resource from the server, cache, or local resource.
4730
+ * The **`requestStart`** read-only property returns a timestamp of the time immediately before the browser starts requesting the resource from the server, cache, or local resource. If the transport connection fails and the browser retries the request, the value returned will be the start of the retry request.
4695
4731
  *
4696
4732
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/requestStart)
4697
4733
  */
4698
4734
  get requestStart(): number;
4699
4735
  /**
4700
- * The **`responseEnd`** read-only property returns a DOMHighResTimeStamp immediately after the browser receives the last byte of the resource or immediately before the transport connection is closed, whichever comes first.
4736
+ * The **`responseEnd`** read-only property returns a timestamp immediately after the browser receives the last byte of the resource or immediately before the transport connection is closed, whichever comes first.
4701
4737
  *
4702
4738
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/responseEnd)
4703
4739
  */
4704
4740
  get responseEnd(): number;
4705
4741
  /**
4706
- * The **`responseStart`** read-only property returns a DOMHighResTimeStamp immediately after the browser receives the first byte of the response from the server, cache, or local resource.
4742
+ * The **`responseStart`** read-only property returns a timestamp immediately after the browser receives the first byte of the response from the server, cache, or local resource.
4707
4743
  *
4708
4744
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/responseStart)
4709
4745
  */
@@ -4715,39 +4751,39 @@ export declare abstract class PerformanceResourceTiming extends PerformanceEntry
4715
4751
  */
4716
4752
  get responseStatus(): number;
4717
4753
  /**
4718
- * The **`secureConnectionStart`** read-only property returns a DOMHighResTimeStamp immediately before the browser starts the handshake process to secure the current connection.
4754
+ * The **`secureConnectionStart`** read-only property returns a timestamp immediately before the browser starts the handshake process to secure the current connection. If a secure connection is not used, the property returns zero.
4719
4755
  *
4720
4756
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/secureConnectionStart)
4721
4757
  */
4722
4758
  get secureConnectionStart(): number | undefined;
4723
4759
  /**
4724
- * The **`transferSize`** read-only property represents the size (in octets) of the fetched resource.
4760
+ * The **`transferSize`** read-only property represents the size (in octets) of the fetched resource. The size includes the response header fields plus the response payload body (as defined by RFC7230).
4725
4761
  *
4726
4762
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/transferSize)
4727
4763
  */
4728
4764
  get transferSize(): number;
4729
4765
  /**
4730
- * The **`workerStart`** read-only property of the PerformanceResourceTiming interface returns a The `workerStart` property can have the following values: - A DOMHighResTimeStamp.
4766
+ * The **`workerStart`** read-only property of the PerformanceResourceTiming interface returns a DOMHighResTimeStamp immediately before dispatching the FetchEvent if a Service Worker thread is already running, or immediately before starting the Service Worker thread if it is not already running. If the resource is not intercepted by a Service Worker the property will always return 0.
4731
4767
  *
4732
4768
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/workerStart)
4733
4769
  */
4734
4770
  get workerStart(): number;
4735
4771
  }
4736
4772
  /**
4737
- * The **`PerformanceObserver`** interface is used to observe performance measurement events and be notified of new PerformanceEntry as they are recorded in the browser's _performance timeline_.
4773
+ * The **`PerformanceObserver`** interface is used to observe performance measurement events and be notified of new performance entries as they are recorded in the browser's performance timeline.
4738
4774
  *
4739
4775
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver)
4740
4776
  */
4741
4777
  export declare class PerformanceObserver {
4742
4778
  constructor(callback: any);
4743
4779
  /**
4744
- * The **`disconnect()`** method of the PerformanceObserver interface is used to stop the performance observer from receiving any PerformanceEntry events.
4780
+ * The **`disconnect()`** method of the PerformanceObserver interface is used to stop the performance observer from receiving any performance entry events.
4745
4781
  *
4746
4782
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver/disconnect)
4747
4783
  */
4748
4784
  disconnect(): void;
4749
4785
  /**
4750
- * The **`observe()`** method of the **PerformanceObserver** interface is used to specify the set of performance entry types to observe.
4786
+ * The **`observe()`** method of the PerformanceObserver interface is used to specify the set of performance entry types to observe.
4751
4787
  *
4752
4788
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver/observe)
4753
4789
  */
@@ -5335,10 +5371,7 @@ export type AiSearchInstanceInfo = {
5335
5371
  max_num_results?: number;
5336
5372
  cache?: boolean;
5337
5373
  cache_threshold?:
5338
- | "super_strict_match"
5339
- | "close_enough"
5340
- | "flexible_friend"
5341
- | "anything_goes";
5374
+ "super_strict_match" | "close_enough" | "flexible_friend" | "anything_goes";
5342
5375
  custom_metadata?: Array<{
5343
5376
  field_name: string;
5344
5377
  data_type: "text" | "number" | "boolean" | "datetime";
@@ -5416,10 +5449,7 @@ export type AiSearchConfig = {
5416
5449
  cache?: boolean;
5417
5450
  /** Similarity threshold for cache hits. Stricter = fewer cache hits but higher relevance. */
5418
5451
  cache_threshold?:
5419
- | "super_strict_match"
5420
- | "close_enough"
5421
- | "flexible_friend"
5422
- | "anything_goes";
5452
+ "super_strict_match" | "close_enough" | "flexible_friend" | "anything_goes";
5423
5453
  custom_metadata?: Array<{
5424
5454
  field_name: string;
5425
5455
  data_type: "text" | "number" | "boolean" | "datetime";
@@ -5465,12 +5495,7 @@ export type AiSearchListItemsParams = {
5465
5495
  sort_by?: "status" | "modified_at";
5466
5496
  /** Filter items by processing status. */
5467
5497
  status?:
5468
- | "queued"
5469
- | "running"
5470
- | "completed"
5471
- | "error"
5472
- | "skipped"
5473
- | "outdated";
5498
+ "queued" | "running" | "completed" | "error" | "skipped" | "outdated";
5474
5499
  /** Filter items by source (e.g. "builtin" or "web-crawler:https://example.com"). */
5475
5500
  source?: string;
5476
5501
  /** JSON-encoded Vectorize filter for metadata filtering. */
@@ -6015,11 +6040,7 @@ export declare abstract class BaseAiTextEmbeddings {
6015
6040
  }
6016
6041
  export type RoleScopedChatInput = {
6017
6042
  role:
6018
- | "user"
6019
- | "assistant"
6020
- | "system"
6021
- | "tool"
6022
- | (string & NonNullable<unknown>);
6043
+ "user" | "assistant" | "system" | "tool" | (string & NonNullable<unknown>);
6023
6044
  content: string;
6024
6045
  name?: string;
6025
6046
  };
@@ -6214,8 +6235,7 @@ export type ChatCompletionCustomToolTextFormat = {
6214
6235
  type: "text";
6215
6236
  };
6216
6237
  export type ChatCompletionCustomToolFormat =
6217
- | ChatCompletionCustomToolTextFormat
6218
- | ChatCompletionCustomToolGrammarFormat;
6238
+ ChatCompletionCustomToolTextFormat | ChatCompletionCustomToolGrammarFormat;
6219
6239
  export type ChatCompletionCustomTool = {
6220
6240
  type: "custom";
6221
6241
  custom: {
@@ -6225,8 +6245,7 @@ export type ChatCompletionCustomTool = {
6225
6245
  };
6226
6246
  };
6227
6247
  export type ChatCompletionTool =
6228
- | ChatCompletionFunctionTool
6229
- | ChatCompletionCustomTool;
6248
+ ChatCompletionFunctionTool | ChatCompletionCustomTool;
6230
6249
  export type ChatCompletionMessageFunctionToolCall = {
6231
6250
  id: string;
6232
6251
  type: "function";
@@ -6245,8 +6264,7 @@ export type ChatCompletionMessageCustomToolCall = {
6245
6264
  };
6246
6265
  };
6247
6266
  export type ChatCompletionMessageToolCall =
6248
- | ChatCompletionMessageFunctionToolCall
6249
- | ChatCompletionMessageCustomToolCall;
6267
+ ChatCompletionMessageFunctionToolCall | ChatCompletionMessageCustomToolCall;
6250
6268
  export type ChatCompletionToolChoiceFunction = {
6251
6269
  type: "function";
6252
6270
  function: {
@@ -6525,11 +6543,7 @@ export type ChatCompletionChoice = {
6525
6543
  index: number;
6526
6544
  message: ChatCompletionResponseMessage;
6527
6545
  finish_reason:
6528
- | "stop"
6529
- | "length"
6530
- | "tool_calls"
6531
- | "content_filter"
6532
- | "function_call";
6546
+ "stop" | "length" | "tool_calls" | "content_filter" | "function_call";
6533
6547
  logprobs: ChatCompletionLogprobs | null;
6534
6548
  };
6535
6549
  export type ChatCompletionsMessagesInput = {
@@ -6724,8 +6738,7 @@ export type ResponseFunctionCallArgumentsDoneEvent = {
6724
6738
  type: "response.function_call_arguments.done";
6725
6739
  };
6726
6740
  export type ResponseFunctionCallOutputItem =
6727
- | ResponseInputTextContent
6728
- | ResponseInputImageContent;
6741
+ ResponseInputTextContent | ResponseInputImageContent;
6729
6742
  export type ResponseFunctionCallOutputItemList =
6730
6743
  Array<ResponseFunctionCallOutputItem>;
6731
6744
  export type ResponseFunctionToolCall = {
@@ -6747,8 +6760,7 @@ export type ResponseFunctionToolCallOutputItem = {
6747
6760
  status?: "in_progress" | "completed" | "incomplete";
6748
6761
  };
6749
6762
  export type ResponseIncludable =
6750
- | "message.input_image.image_url"
6751
- | "message.output_text.logprobs";
6763
+ "message.input_image.image_url" | "message.output_text.logprobs";
6752
6764
  export type ResponseIncompleteEvent = {
6753
6765
  response: Response;
6754
6766
  sequence_number: number;
@@ -6814,9 +6826,7 @@ export type ResponseItem =
6814
6826
  | ResponseFunctionToolCallItem
6815
6827
  | ResponseFunctionToolCallOutputItem;
6816
6828
  export type ResponseOutputItem =
6817
- | ResponseOutputMessage
6818
- | ResponseFunctionToolCall
6819
- | ResponseReasoningItem;
6829
+ ResponseOutputMessage | ResponseFunctionToolCall | ResponseReasoningItem;
6820
6830
  export type ResponseOutputItemAddedEvent = {
6821
6831
  item: ResponseOutputItem;
6822
6832
  output_index: number;
@@ -8450,8 +8460,7 @@ export declare abstract class Base_Ai_Cf_Qwen_Qwen2_5_Coder_32B_Instruct {
8450
8460
  postProcessedOutputs: Ai_Cf_Qwen_Qwen2_5_Coder_32B_Instruct_Output;
8451
8461
  }
8452
8462
  export type Ai_Cf_Qwen_Qwq_32B_Input =
8453
- | Ai_Cf_Qwen_Qwq_32B_Prompt
8454
- | Ai_Cf_Qwen_Qwq_32B_Messages;
8463
+ Ai_Cf_Qwen_Qwq_32B_Prompt | Ai_Cf_Qwen_Qwq_32B_Messages;
8455
8464
  export interface Ai_Cf_Qwen_Qwq_32B_Prompt {
8456
8465
  /**
8457
8466
  * The input text prompt for the model to generate a response.
@@ -8998,8 +9007,7 @@ export declare abstract class Base_Ai_Cf_Mistralai_Mistral_Small_3_1_24B_Instruc
8998
9007
  postProcessedOutputs: Ai_Cf_Mistralai_Mistral_Small_3_1_24B_Instruct_Output;
8999
9008
  }
9000
9009
  export type Ai_Cf_Google_Gemma_3_12B_It_Input =
9001
- | Ai_Cf_Google_Gemma_3_12B_It_Prompt
9002
- | Ai_Cf_Google_Gemma_3_12B_It_Messages;
9010
+ Ai_Cf_Google_Gemma_3_12B_It_Prompt | Ai_Cf_Google_Gemma_3_12B_It_Messages;
9003
9011
  export interface Ai_Cf_Google_Gemma_3_12B_It_Prompt {
9004
9012
  /**
9005
9013
  * The input text prompt for the model to generate a response.
@@ -11538,11 +11546,7 @@ export interface Ai_Cf_Deepgram_Flux_Output {
11538
11546
  * The type of event being reported.
11539
11547
  */
11540
11548
  event?:
11541
- | "Update"
11542
- | "StartOfTurn"
11543
- | "EagerEndOfTurn"
11544
- | "TurnResumed"
11545
- | "EndOfTurn";
11549
+ "Update" | "StartOfTurn" | "EagerEndOfTurn" | "TurnResumed" | "EndOfTurn";
11546
11550
  /**
11547
11551
  * The index of the current turn
11548
11552
  */
@@ -12078,8 +12082,7 @@ export type AIGatewayProviders =
12078
12082
  | "adobe-firefly";
12079
12083
  export type AIGatewayHeaders = {
12080
12084
  "cf-aig-metadata":
12081
- | Record<string, number | string | boolean | null | bigint>
12082
- | string;
12085
+ Record<string, number | string | boolean | null | bigint> | string;
12083
12086
  "cf-aig-custom-cost":
12084
12087
  | {
12085
12088
  per_token_in?: number;
@@ -12502,10 +12505,7 @@ export declare abstract class AutoRAG {
12502
12505
  ): Promise<AutoRagAiSearchResponse | Response>;
12503
12506
  }
12504
12507
  export type BrowserRunLifecycleEvent =
12505
- | "load"
12506
- | "domcontentloaded"
12507
- | "networkidle0"
12508
- | "networkidle2";
12508
+ "load" | "domcontentloaded" | "networkidle0" | "networkidle2";
12509
12509
  export type BrowserRunResourceType =
12510
12510
  | "document"
12511
12511
  | "stylesheet"
@@ -13128,9 +13128,7 @@ export interface RequestInitCfProperties extends Record<string, unknown> {
13128
13128
  * response header.
13129
13129
  */
13130
13130
  export type RequestInitCfPropertiesVaryAction =
13131
- | "normalize"
13132
- | "passthrough"
13133
- | "bypass";
13131
+ "normalize" | "passthrough" | "bypass";
13134
13132
  /** Configuration for Workers Standard Vary support. */
13135
13133
  export interface RequestInitCfPropertiesVary {
13136
13134
  /** The fallback action for varied request headers not listed in `headers`. */
@@ -13407,7 +13405,8 @@ export interface RequestInitCfPropertiesImageDraw extends BasicImageTransformati
13407
13405
  /**
13408
13406
  * How to combine the foreground and backdrop pixels to create the result
13409
13407
  */
13410
- composite?: /** Foreground drawn on top of backdrop (default) */
13408
+ composite?:
13409
+ /** Foreground drawn on top of backdrop (default) */
13411
13410
  | "over"
13412
13411
  /** Foreground shown only where backdrop is opaque */
13413
13412
  | "in"
@@ -14218,16 +14217,9 @@ export declare type Iso3166Alpha2Code =
14218
14217
  | "ZW";
14219
14218
  /** The 2-letter continent codes Cloudflare uses */
14220
14219
  export declare type ContinentCode =
14221
- | "AF"
14222
- | "AN"
14223
- | "AS"
14224
- | "EU"
14225
- | "NA"
14226
- | "OC"
14227
- | "SA";
14220
+ "AF" | "AN" | "AS" | "EU" | "NA" | "OC" | "SA";
14228
14221
  export type CfProperties<HostMetadata = unknown> =
14229
- | IncomingRequestCfProperties<HostMetadata>
14230
- | RequestInitCfProperties;
14222
+ IncomingRequestCfProperties<HostMetadata> | RequestInitCfProperties;
14231
14223
  export interface D1Meta {
14232
14224
  duration: number;
14233
14225
  size_after: number;
@@ -15169,9 +15161,7 @@ export declare namespace Rpc {
15169
15161
  [__WORKFLOW_ENTRYPOINT_BRAND]: never;
15170
15162
  }
15171
15163
  export type EntrypointBranded =
15172
- | WorkerEntrypointBranded
15173
- | DurableObjectBranded
15174
- | WorkflowEntrypointBranded;
15164
+ WorkerEntrypointBranded | DurableObjectBranded | WorkflowEntrypointBranded;
15175
15165
  // Types that can be used through `Stub`s
15176
15166
  export type Stubable = RpcTargetBranded | ((...args: any[]) => any);
15177
15167
  // Types that can be passed over RPC
@@ -15413,16 +15403,9 @@ export declare namespace CloudflareWorkersModule {
15413
15403
  webSocketError?(ws: WebSocket, error: unknown): void | Promise<void>;
15414
15404
  }
15415
15405
  export type WorkflowDurationLabel =
15416
- | "second"
15417
- | "minute"
15418
- | "hour"
15419
- | "day"
15420
- | "week"
15421
- | "month"
15422
- | "year";
15406
+ "second" | "minute" | "hour" | "day" | "week" | "month" | "year";
15423
15407
  export type WorkflowSleepDuration =
15424
- | `${number} ${WorkflowDurationLabel}${"s" | ""}`
15425
- | number;
15408
+ `${number} ${WorkflowDurationLabel}${"s" | ""}` | number;
15426
15409
  export type WorkflowDelayDuration = WorkflowSleepDuration;
15427
15410
  export type WorkflowDynamicDelayContext = {
15428
15411
  ctx: WorkflowStepContext<WorkflowDelayFunction>;
@@ -16219,11 +16202,7 @@ export type StreamDownloadGetResponse = {
16219
16202
  default?: StreamDownload;
16220
16203
  };
16221
16204
  export type StreamWatermarkPosition =
16222
- | "upperRight"
16223
- | "upperLeft"
16224
- | "lowerLeft"
16225
- | "lowerRight"
16226
- | "center";
16205
+ "upperRight" | "upperLeft" | "lowerLeft" | "lowerRight" | "center";
16227
16206
  export type StreamWatermark = {
16228
16207
  /**
16229
16208
  * The unique identifier for a watermark profile.
@@ -16707,8 +16686,7 @@ export type VectorizeVectorMetadataValue = string | number | boolean | string[];
16707
16686
  * Additional information to associate with a vector.
16708
16687
  */
16709
16688
  export type VectorizeVectorMetadata =
16710
- | VectorizeVectorMetadataValue
16711
- | Record<string, VectorizeVectorMetadataValue>;
16689
+ VectorizeVectorMetadataValue | Record<string, VectorizeVectorMetadataValue>;
16712
16690
  export type VectorFloatArray = Float32Array | Float64Array;
16713
16691
  export interface VectorizeError {
16714
16692
  code?: number;
@@ -16720,12 +16698,7 @@ export interface VectorizeError {
16720
16698
  * This list is expected to grow as support for more operations are released.
16721
16699
  */
16722
16700
  export type VectorizeVectorMetadataFilterOp =
16723
- | "$eq"
16724
- | "$ne"
16725
- | "$lt"
16726
- | "$lte"
16727
- | "$gt"
16728
- | "$gte";
16701
+ "$eq" | "$ne" | "$lt" | "$lte" | "$gt" | "$gte";
16729
16702
  export type VectorizeVectorMetadataFilterCollectionOp = "$in" | "$nin";
16730
16703
  /**
16731
16704
  * Filter criteria for vector metadata used to limit the retrieved query result set.
@@ -17154,16 +17127,9 @@ export type WorkflowBatchDeleteResult = {
17154
17127
  }[];
17155
17128
  };
17156
17129
  export type WorkflowDurationLabel =
17157
- | "second"
17158
- | "minute"
17159
- | "hour"
17160
- | "day"
17161
- | "week"
17162
- | "month"
17163
- | "year";
17130
+ "second" | "minute" | "hour" | "day" | "week" | "month" | "year";
17164
17131
  export type WorkflowSleepDuration =
17165
- | `${number} ${WorkflowDurationLabel}${"s" | ""}`
17166
- | number;
17132
+ `${number} ${WorkflowDurationLabel}${"s" | ""}` | number;
17167
17133
  export type WorkflowRetentionDuration = WorkflowSleepDuration;
17168
17134
  export interface WorkflowInstanceCreateOptions<PARAMS = unknown> {
17169
17135
  /**