@cloudflare/workers-types 5.20260810.1 → 5.20260812.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
  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
  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 @@ declare abstract class WorkerGlobalScope extends EventTarget<WorkerGlobalScopeEv
85
85
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console)
86
86
  */
87
87
  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 @@ 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 @@ 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 @@ 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 @@ 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;
@@ -408,7 +403,7 @@ declare function removeEventListener<
408
403
  options?: EventTargetEventListenerOptions | boolean,
409
404
  ): void;
410
405
  /**
411
- * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order.
406
+ * 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().
412
407
  *
413
408
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/dispatchEvent)
414
409
  */
@@ -475,6 +470,7 @@ declare const crypto: Crypto;
475
470
  * [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/cache/)
476
471
  */
477
472
  declare const caches: CacheStorage;
473
+ /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Window/scheduler) */
478
474
  declare const scheduler: Scheduler;
479
475
  /**
480
476
  * The Workers runtime supports a subset of the Performance API, used to measure timing and performance,
@@ -841,8 +837,7 @@ interface DurableObjectFacets {
841
837
  get<T extends Rpc.DurableObjectBranded | undefined = undefined>(
842
838
  name: string,
843
839
  getStartupOptions: () =>
844
- | FacetStartupOptions<T>
845
- | Promise<FacetStartupOptions<T>>,
840
+ FacetStartupOptions<T> | Promise<FacetStartupOptions<T>>,
846
841
  ): Fetcher<T>;
847
842
  abort(name: string, reason: any): void;
848
843
  delete(name: string): void;
@@ -866,26 +861,26 @@ interface AnalyticsEngineDataPoint {
866
861
  blobs?: ((ArrayBuffer | string) | null)[];
867
862
  }
868
863
  /**
869
- * The **`Event`** interface represents an event which takes place on an `EventTarget`.
864
+ * The **`Event`** interface represents an event which takes place on an EventTarget.
870
865
  *
871
866
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event)
872
867
  */
873
868
  declare class Event {
874
869
  constructor(type: string, init?: EventInit);
875
870
  /**
876
- * The **`type`** read-only property of the Event interface returns a string containing the event's type.
871
+ * 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.
877
872
  *
878
873
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/type)
879
874
  */
880
875
  get type(): string;
881
876
  /**
882
- * The **`eventPhase`** read-only property of the being evaluated.
877
+ * The **`eventPhase`** read-only property of the Event interface indicates which phase of the event flow is currently being evaluated.
883
878
  *
884
879
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/eventPhase)
885
880
  */
886
881
  get eventPhase(): number;
887
882
  /**
888
- * The read-only **`composed`** property of the or not the event will propagate across the shadow DOM boundary into the standard DOM.
883
+ * 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.
889
884
  *
890
885
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/composed)
891
886
  */
@@ -922,13 +917,13 @@ declare class Event {
922
917
  */
923
918
  get currentTarget(): EventTarget | null;
924
919
  /**
925
- * The read-only **`target`** property of the dispatched.
920
+ * 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.
926
921
  *
927
922
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/target)
928
923
  */
929
924
  get target(): EventTarget | undefined;
930
925
  /**
931
- * The deprecated **`Event.srcElement`** is an alias for the Event.target property.
926
+ * The deprecated **`Event.srcElement`** is an alias for the Event.target property. Use Event.target instead.
932
927
  * @deprecated
933
928
  *
934
929
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/srcElement)
@@ -941,45 +936,45 @@ declare class Event {
941
936
  */
942
937
  get timeStamp(): number;
943
938
  /**
944
- * 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.
939
+ * 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.
945
940
  *
946
941
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/isTrusted)
947
942
  */
948
943
  readonly isTrusted: boolean;
949
944
  /**
950
- * The **`cancelBubble`** property of the Event interface is deprecated.
945
+ * 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.
951
946
  * @deprecated
952
947
  *
953
948
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/cancelBubble)
954
949
  */
955
950
  get cancelBubble(): boolean;
956
951
  /**
957
- * The **`cancelBubble`** property of the Event interface is deprecated.
952
+ * 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.
958
953
  * @deprecated
959
954
  *
960
955
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/cancelBubble)
961
956
  */
962
957
  set cancelBubble(value: boolean);
963
958
  /**
964
- * 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.
959
+ * The **`stopImmediatePropagation()`** method of the Event interface prevents other listeners of the same event from being called.
965
960
  *
966
961
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/stopImmediatePropagation)
967
962
  */
968
963
  stopImmediatePropagation(): void;
969
964
  /**
970
- * 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.
965
+ * 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.
971
966
  *
972
967
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/preventDefault)
973
968
  */
974
969
  preventDefault(): void;
975
970
  /**
976
- * The **`stopPropagation()`** method of the Event interface prevents further propagation of the current event in the capturing and bubbling phases.
971
+ * 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().
977
972
  *
978
973
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/stopPropagation)
979
974
  */
980
975
  stopPropagation(): void;
981
976
  /**
982
- * 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.
977
+ * 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.
983
978
  *
984
979
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/composedPath)
985
980
  */
@@ -1001,10 +996,9 @@ interface EventListenerObject<EventType extends Event = Event> {
1001
996
  handleEvent(event: EventType): void;
1002
997
  }
1003
998
  type EventListenerOrEventListenerObject<EventType extends Event = Event> =
1004
- | EventListener<EventType>
1005
- | EventListenerObject<EventType>;
999
+ EventListener<EventType> | EventListenerObject<EventType>;
1006
1000
  /**
1007
- * The **`EventTarget`** interface is implemented by objects that can receive events and may have listeners for them.
1001
+ * 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.
1008
1002
  *
1009
1003
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget)
1010
1004
  */
@@ -1023,7 +1017,7 @@ declare class EventTarget<
1023
1017
  options?: EventTargetAddEventListenerOptions | boolean,
1024
1018
  ): void;
1025
1019
  /**
1026
- * The **`removeEventListener()`** method of the EventTarget interface removes an event listener previously registered with EventTarget.addEventListener() from the target.
1020
+ * 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.
1027
1021
  *
1028
1022
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/removeEventListener)
1029
1023
  */
@@ -1033,7 +1027,7 @@ declare class EventTarget<
1033
1027
  options?: EventTargetEventListenerOptions | boolean,
1034
1028
  ): void;
1035
1029
  /**
1036
- * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order.
1030
+ * 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().
1037
1031
  *
1038
1032
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/dispatchEvent)
1039
1033
  */
@@ -1065,7 +1059,7 @@ declare class AbortController {
1065
1059
  */
1066
1060
  get signal(): AbortSignal;
1067
1061
  /**
1068
- * The **`abort()`** method of the AbortController interface aborts an asynchronous operation before it has completed.
1062
+ * 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.
1069
1063
  *
1070
1064
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortController/abort)
1071
1065
  */
@@ -1078,7 +1072,7 @@ declare class AbortController {
1078
1072
  */
1079
1073
  declare abstract class AbortSignal extends EventTarget {
1080
1074
  /**
1081
- * The **`AbortSignal.abort()`** static method returns an AbortSignal that is already set as aborted (and which does not trigger an AbortSignal/abort_event event).
1075
+ * The **`AbortSignal.abort()`** static method returns an AbortSignal that is already set as aborted (and which does not trigger an abort event).
1082
1076
  *
1083
1077
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/abort_static)
1084
1078
  */
@@ -1090,13 +1084,13 @@ declare abstract class AbortSignal extends EventTarget {
1090
1084
  */
1091
1085
  static timeout(delay: number): AbortSignal;
1092
1086
  /**
1093
- * The **`AbortSignal.any()`** static method takes an iterable of abort signals and returns an AbortSignal.
1087
+ * 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.
1094
1088
  *
1095
1089
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/any_static)
1096
1090
  */
1097
1091
  static any(signals: AbortSignal[]): AbortSignal;
1098
1092
  /**
1099
- * 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`).
1093
+ * 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).
1100
1094
  *
1101
1095
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/aborted)
1102
1096
  */
@@ -1112,12 +1106,17 @@ declare abstract class AbortSignal extends EventTarget {
1112
1106
  /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/abort_event) */
1113
1107
  set onabort(value: any | null);
1114
1108
  /**
1115
- * The **`throwIfAborted()`** method throws the signal's abort AbortSignal.reason if the signal has been aborted; otherwise it does nothing.
1109
+ * The **`throwIfAborted()`** method throws the signal's abort reason if the signal has been aborted; otherwise it does nothing.
1116
1110
  *
1117
1111
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/throwIfAborted)
1118
1112
  */
1119
1113
  throwIfAborted(): void;
1120
1114
  }
1115
+ /**
1116
+ * The **`Scheduler`** interface of the Prioritized Task Scheduling API provides methods for scheduling prioritized tasks.
1117
+ *
1118
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Scheduler)
1119
+ */
1121
1120
  interface Scheduler {
1122
1121
  wait(delay: number, maybeOptions?: SchedulerWaitOptions): Promise<void>;
1123
1122
  }
@@ -1125,20 +1124,20 @@ interface SchedulerWaitOptions {
1125
1124
  signal?: AbortSignal;
1126
1125
  }
1127
1126
  /**
1128
- * The **`ExtendableEvent`** interface extends the lifetime of the `install` and `activate` events dispatched on the global scope as part of the service worker lifecycle.
1127
+ * 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.
1129
1128
  *
1130
1129
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ExtendableEvent)
1131
1130
  */
1132
1131
  declare abstract class ExtendableEvent extends Event {
1133
1132
  /**
1134
- * The **`ExtendableEvent.waitUntil()`** method tells the event dispatcher that work is ongoing.
1133
+ * 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.
1135
1134
  *
1136
1135
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ExtendableEvent/waitUntil)
1137
1136
  */
1138
1137
  waitUntil(promise: Promise<any>): void;
1139
1138
  }
1140
1139
  /**
1141
- * The **`CustomEvent`** interface represents events initialized by an application for any purpose.
1140
+ * The **`CustomEvent`** interface can be used to attach custom data to an event generated by an application.
1142
1141
  *
1143
1142
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomEvent)
1144
1143
  */
@@ -1180,7 +1179,7 @@ declare class Blob {
1180
1179
  */
1181
1180
  get type(): string;
1182
1181
  /**
1183
- * 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.
1182
+ * 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.
1184
1183
  *
1185
1184
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/slice)
1186
1185
  */
@@ -1198,13 +1197,13 @@ declare class Blob {
1198
1197
  */
1199
1198
  bytes(): Promise<Uint8Array>;
1200
1199
  /**
1201
- * The **`text()`** method of the string containing the contents of the blob, interpreted as UTF-8.
1200
+ * 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.
1202
1201
  *
1203
1202
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/text)
1204
1203
  */
1205
1204
  text(): Promise<string>;
1206
1205
  /**
1207
- * The **`stream()`** method of the Blob interface returns a ReadableStream which upon reading returns the data contained within the `Blob`.
1206
+ * The **`stream()`** method of the Blob interface returns a ReadableStream which upon reading returns the data contained within the Blob.
1208
1207
  *
1209
1208
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/stream)
1210
1209
  */
@@ -1225,13 +1224,13 @@ declare class File extends Blob {
1225
1224
  options?: FileOptions,
1226
1225
  );
1227
1226
  /**
1228
- * The **`name`** read-only property of the File interface returns the name of the file represented by a File object.
1227
+ * 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.
1229
1228
  *
1230
1229
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/name)
1231
1230
  */
1232
1231
  get name(): string;
1233
1232
  /**
1234
- * 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).
1233
+ * 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.
1235
1234
  *
1236
1235
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/lastModified)
1237
1236
  */
@@ -1248,7 +1247,7 @@ interface FileOptions {
1248
1247
  */
1249
1248
  declare abstract class CacheStorage {
1250
1249
  /**
1251
- * The **`open()`** method of the the Cache object matching the `cacheName`.
1250
+ * The **`open()`** method of the CacheStorage interface returns a Promise that resolves to the Cache object matching the cacheName.
1252
1251
  *
1253
1252
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CacheStorage/open)
1254
1253
  */
@@ -1287,14 +1286,14 @@ interface CacheQueryOptions {
1287
1286
  */
1288
1287
  declare abstract class Crypto {
1289
1288
  /**
1290
- * The **`Crypto.subtle`** read-only property returns a cryptographic operations.
1289
+ * The **`Crypto.subtle`** read-only property returns a SubtleCrypto which can then be used to perform low-level cryptographic operations.
1291
1290
  * Available only in secure contexts.
1292
1291
  *
1293
1292
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Crypto/subtle)
1294
1293
  */
1295
1294
  get subtle(): SubtleCrypto;
1296
1295
  /**
1297
- * The **`Crypto.getRandomValues()`** method lets you get cryptographically strong random values.
1296
+ * 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).
1298
1297
  *
1299
1298
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Crypto/getRandomValues)
1300
1299
  */
@@ -1336,7 +1335,7 @@ declare abstract class SubtleCrypto {
1336
1335
  plainText: ArrayBuffer | ArrayBufferView,
1337
1336
  ): Promise<ArrayBuffer>;
1338
1337
  /**
1339
- * The **`decrypt()`** method of the SubtleCrypto interface decrypts some encrypted data.
1338
+ * 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").
1340
1339
  *
1341
1340
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/decrypt)
1342
1341
  */
@@ -1367,7 +1366,7 @@ declare abstract class SubtleCrypto {
1367
1366
  data: ArrayBuffer | ArrayBufferView,
1368
1367
  ): Promise<boolean>;
1369
1368
  /**
1370
- * The **`digest()`** method of the SubtleCrypto interface generates a _digest_ of the given data, using the specified hash function.
1369
+ * 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.
1371
1370
  *
1372
1371
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/digest)
1373
1372
  */
@@ -1398,7 +1397,7 @@ declare abstract class SubtleCrypto {
1398
1397
  keyUsages: string[],
1399
1398
  ): Promise<CryptoKey>;
1400
1399
  /**
1401
- * The **`deriveBits()`** method of the key.
1400
+ * The **`deriveBits()`** method of the SubtleCrypto interface can be used to derive an array of bits from a base key.
1402
1401
  *
1403
1402
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/deriveBits)
1404
1403
  */
@@ -1426,7 +1425,7 @@ declare abstract class SubtleCrypto {
1426
1425
  */
1427
1426
  exportKey(format: string, key: CryptoKey): Promise<ArrayBuffer | JsonWebKey>;
1428
1427
  /**
1429
- * The **`wrapKey()`** method of the SubtleCrypto interface 'wraps' a key.
1428
+ * 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.
1430
1429
  *
1431
1430
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/wrapKey)
1432
1431
  */
@@ -1437,7 +1436,7 @@ declare abstract class SubtleCrypto {
1437
1436
  wrapAlgorithm: string | SubtleCryptoEncryptAlgorithm,
1438
1437
  ): Promise<ArrayBuffer>;
1439
1438
  /**
1440
- * The **`unwrapKey()`** method of the SubtleCrypto interface 'unwraps' a key.
1439
+ * 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.
1441
1440
  *
1442
1441
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/unwrapKey)
1443
1442
  */
@@ -1456,20 +1455,20 @@ declare abstract class SubtleCrypto {
1456
1455
  ): boolean;
1457
1456
  }
1458
1457
  /**
1459
- * 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.
1458
+ * The **`CryptoKey`** interface of the Web Crypto API represents a cryptographic key obtained from one of the SubtleCrypto methods generateKey(), deriveKey(), importKey(), or unwrapKey().
1460
1459
  * Available only in secure contexts.
1461
1460
  *
1462
1461
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey)
1463
1462
  */
1464
1463
  declare abstract class CryptoKey {
1465
1464
  /**
1466
- * The read-only **`type`** property of the CryptoKey interface indicates which kind of key is represented by the object.
1465
+ * 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:
1467
1466
  *
1468
1467
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/type)
1469
1468
  */
1470
1469
  readonly type: string;
1471
1470
  /**
1472
- * The read-only **`extractable`** property of the CryptoKey interface indicates whether or not the key may be extracted using `SubtleCrypto.exportKey()` or `SubtleCrypto.wrapKey()`.
1471
+ * The read-only **`extractable`** property of the CryptoKey interface indicates whether or not the key may be extracted using SubtleCrypto.exportKey() or SubtleCrypto.wrapKey().
1473
1472
  *
1474
1473
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/extractable)
1475
1474
  */
@@ -1599,7 +1598,7 @@ declare class DigestStream extends WritableStream<
1599
1598
  get bytesWritten(): number | bigint;
1600
1599
  }
1601
1600
  /**
1602
- * The **`TextDecoder`** interface represents a decoder for a specific text encoding, such as `UTF-8`, `ISO-8859-2`, `KOI8-R`, `GBK`, etc.
1601
+ * 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.
1603
1602
  *
1604
1603
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoder)
1605
1604
  */
@@ -1619,20 +1618,20 @@ declare class TextDecoder {
1619
1618
  get ignoreBOM(): boolean;
1620
1619
  }
1621
1620
  /**
1622
- * The **`TextEncoder`** interface takes a stream of code points as input and emits a stream of UTF-8 bytes.
1621
+ * The **`TextEncoder`** interface enables you to encode a JavaScript string using UTF-8.
1623
1622
  *
1624
1623
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder)
1625
1624
  */
1626
1625
  declare class TextEncoder {
1627
1626
  constructor();
1628
1627
  /**
1629
- * 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.
1628
+ * The **`TextEncoder.encode()`** method takes a string as input, and returns a Uint8Array containing the string encoded using UTF-8.
1630
1629
  *
1631
1630
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encode)
1632
1631
  */
1633
1632
  encode(input?: string): Uint8Array;
1634
1633
  /**
1635
- * 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.
1634
+ * 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.
1636
1635
  *
1637
1636
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encodeInto)
1638
1637
  */
@@ -1703,31 +1702,31 @@ interface ErrorEventErrorEventInit {
1703
1702
  declare class MessageEvent extends Event {
1704
1703
  constructor(type: string, initializer: MessageEventInit);
1705
1704
  /**
1706
- * 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.
1705
+ * The **`data`** read-only property of the MessageEvent interface represents the data sent by the message emitter.
1707
1706
  *
1708
1707
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/data)
1709
1708
  */
1710
1709
  readonly data: any;
1711
1710
  /**
1712
- * The **`origin`** read-only property of the origin of the message emitter.
1711
+ * The **`origin`** read-only property of the MessageEvent interface is a string representing the origin of the message emitter.
1713
1712
  *
1714
1713
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/origin)
1715
1714
  */
1716
1715
  readonly origin: string | null;
1717
1716
  /**
1718
- * The **`lastEventId`** read-only property of the unique ID for the event.
1717
+ * The **`lastEventId`** read-only property of the MessageEvent interface is a string representing a unique ID for the event.
1719
1718
  *
1720
1719
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/lastEventId)
1721
1720
  */
1722
1721
  readonly lastEventId: string;
1723
1722
  /**
1724
- * The **`source`** read-only property of the a WindowProxy, MessagePort, or a `MessageEventSource` (which can be a WindowProxy, message emitter.
1723
+ * 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.
1725
1724
  *
1726
1725
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/source)
1727
1726
  */
1728
1727
  readonly source: MessagePort | null;
1729
1728
  /**
1730
- * The **`ports`** read-only property of the containing all MessagePort objects sent with the message, in order.
1729
+ * 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.
1731
1730
  *
1732
1731
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/ports)
1733
1732
  */
@@ -1737,96 +1736,93 @@ interface MessageEventInit {
1737
1736
  data: ArrayBuffer | string;
1738
1737
  }
1739
1738
  /**
1740
- * The **`PromiseRejectionEvent`** interface represents events which are sent to the global script context when JavaScript Promises are rejected.
1739
+ * 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.
1741
1740
  *
1742
1741
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent)
1743
1742
  */
1744
1743
  declare abstract class PromiseRejectionEvent extends Event {
1745
1744
  /**
1746
- * The PromiseRejectionEvent interface's **`promise`** read-only property indicates the JavaScript rejected.
1745
+ * 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.
1747
1746
  *
1748
1747
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/promise)
1749
1748
  */
1750
1749
  readonly promise: Promise<any>;
1751
1750
  /**
1752
- * The PromiseRejectionEvent **`reason`** read-only property is any JavaScript value or Object which provides the reason passed into Promise.reject().
1751
+ * 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.
1753
1752
  *
1754
1753
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/reason)
1755
1754
  */
1756
1755
  readonly reason: any;
1757
1756
  }
1758
1757
  /**
1759
- * 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.
1758
+ * 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".
1760
1759
  *
1761
1760
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData)
1762
1761
  */
1763
1762
  declare class FormData {
1764
1763
  constructor();
1765
1764
  /**
1766
- * 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.
1765
+ * 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.
1767
1766
  *
1768
1767
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/append)
1769
1768
  */
1770
1769
  append(name: string, value: string | Blob): void;
1771
1770
  /**
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.
1771
+ * 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
1772
  *
1774
1773
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/append)
1775
1774
  */
1776
1775
  append(name: string, value: string): void;
1777
1776
  /**
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.
1777
+ * 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
1778
  *
1780
1779
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/append)
1781
1780
  */
1782
1781
  append(name: string, value: Blob, filename?: string): void;
1783
1782
  /**
1784
- * The **`delete()`** method of the FormData interface deletes a key and its value(s) from a `FormData` object.
1783
+ * The **`delete()`** method of the FormData interface deletes a key and its value(s) from a FormData object.
1785
1784
  *
1786
1785
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/delete)
1787
1786
  */
1788
1787
  delete(name: string): void;
1789
1788
  /**
1790
- * The **`get()`** method of the FormData interface returns the first value associated with a given key from within a `FormData` object.
1789
+ * 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.
1791
1790
  *
1792
1791
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/get)
1793
1792
  */
1794
1793
  get(name: string): (File | string) | null;
1795
1794
  /**
1796
- * The **`getAll()`** method of the FormData interface returns all the values associated with a given key from within a `FormData` object.
1795
+ * The **`getAll()`** method of the FormData interface returns all the values associated with a given key from within a FormData object.
1797
1796
  *
1798
1797
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/getAll)
1799
1798
  */
1800
1799
  getAll(name: string): (File | string)[];
1801
1800
  /**
1802
- * The **`has()`** method of the FormData interface returns whether a `FormData` object contains a certain key.
1801
+ * The **`has()`** method of the FormData interface returns whether a FormData object contains a certain key.
1803
1802
  *
1804
1803
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/has)
1805
1804
  */
1806
1805
  has(name: string): boolean;
1807
1806
  /**
1808
- * 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.
1807
+ * 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.
1809
1808
  *
1810
1809
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/set)
1811
1810
  */
1812
1811
  set(name: string, value: string | Blob): void;
1813
1812
  /**
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.
1813
+ * 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
1814
  *
1816
1815
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/set)
1817
1816
  */
1818
1817
  set(name: string, value: string): void;
1819
1818
  /**
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.
1819
+ * 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
1820
  *
1822
1821
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/set)
1823
1822
  */
1824
1823
  set(name: string, value: Blob, filename?: string): void;
1825
- /* Returns an array of key, value pairs for every entry in the list. */
1826
1824
  entries(): IterableIterator<[key: string, value: File | string]>;
1827
- /* Returns a list of keys in the list. */
1828
1825
  keys(): IterableIterator<string>;
1829
- /* Returns a list of values in the list. */
1830
1826
  values(): IterableIterator<File | string>;
1831
1827
  forEach<This = unknown>(
1832
1828
  callback: (
@@ -1946,19 +1942,19 @@ interface DocumentEnd {
1946
1942
  append(content: string, options?: ContentOptions): DocumentEnd;
1947
1943
  }
1948
1944
  /**
1949
- * This is the event type for `fetch` events dispatched on the ServiceWorkerGlobalScope.
1945
+ * 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.
1950
1946
  *
1951
1947
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent)
1952
1948
  */
1953
1949
  declare abstract class FetchEvent extends ExtendableEvent {
1954
1950
  /**
1955
- * The **`request`** read-only property of the the event handler.
1951
+ * The **`request`** read-only property of the FetchEvent interface returns the Request that triggered the event handler.
1956
1952
  *
1957
1953
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent/request)
1958
1954
  */
1959
1955
  readonly request: Request;
1960
1956
  /**
1961
- * The **`respondWith()`** method of allows you to provide a promise for a Response yourself.
1957
+ * The **`respondWith()`** method of FetchEvent prevents the browser's default fetch handling, and allows you to provide a promise for a Response yourself.
1962
1958
  *
1963
1959
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent/respondWith)
1964
1960
  */
@@ -1966,49 +1962,47 @@ declare abstract class FetchEvent extends ExtendableEvent {
1966
1962
  passThroughOnException(): void;
1967
1963
  }
1968
1964
  type HeadersInit =
1969
- | Headers
1970
- | Iterable<Iterable<string>>
1971
- | Record<string, string>;
1965
+ Headers | Iterable<Iterable<string>> | Record<string, string>;
1972
1966
  /**
1973
- * The **`Headers`** interface of the Fetch API allows you to perform various actions on HTTP request and response headers.
1967
+ * 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.
1974
1968
  *
1975
1969
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers)
1976
1970
  */
1977
1971
  declare class Headers {
1978
1972
  constructor(init?: HeadersInit);
1979
1973
  /**
1980
- * 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.
1974
+ * 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.
1981
1975
  *
1982
1976
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/get)
1983
1977
  */
1984
1978
  get(name: string): string | null;
1985
1979
  getAll(name: string): string[];
1986
1980
  /**
1987
- * The **`getSetCookie()`** method of the Headers interface returns an array containing the values of all Set-Cookie headers associated with a response.
1981
+ * 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.
1988
1982
  *
1989
1983
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/getSetCookie)
1990
1984
  */
1991
1985
  getSetCookie(): string[];
1992
1986
  /**
1993
- * The **`has()`** method of the Headers interface returns a boolean stating whether a `Headers` object contains a certain header.
1987
+ * The **`has()`** method of the Headers interface returns a boolean stating whether a Headers object contains a certain header.
1994
1988
  *
1995
1989
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/has)
1996
1990
  */
1997
1991
  has(name: string): boolean;
1998
1992
  /**
1999
- * 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.
1993
+ * 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.
2000
1994
  *
2001
1995
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/set)
2002
1996
  */
2003
1997
  set(name: string, value: string): void;
2004
1998
  /**
2005
- * 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.
1999
+ * 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.
2006
2000
  *
2007
2001
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/append)
2008
2002
  */
2009
2003
  append(name: string, value: string): void;
2010
2004
  /**
2011
- * The **`delete()`** method of the Headers interface deletes a header from the current `Headers` object.
2005
+ * The **`delete()`** method of the Headers interface deletes a header from the current Headers object.
2012
2006
  *
2013
2007
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/delete)
2014
2008
  */
@@ -2017,11 +2011,8 @@ declare class Headers {
2017
2011
  callback: (this: This, value: string, key: string, parent: Headers) => void,
2018
2012
  thisArg?: This,
2019
2013
  ): void;
2020
- /* Returns an iterator allowing to go through all key/value pairs contained in this object. */
2021
2014
  entries(): IterableIterator<[key: string, value: string]>;
2022
- /* Returns an iterator allowing to go through all keys of the key/value pairs contained in this object. */
2023
2015
  keys(): IterableIterator<string>;
2024
- /* Returns an iterator allowing to go through all values of the key/value pairs contained in this object. */
2025
2016
  values(): IterableIterator<string>;
2026
2017
  [Symbol.iterator](): IterableIterator<[key: string, value: string]>;
2027
2018
  }
@@ -2090,7 +2081,7 @@ interface Response extends Body {
2090
2081
  */
2091
2082
  statusText: string;
2092
2083
  /**
2093
- * The **`headers`** read-only property of the with the response.
2084
+ * The **`headers`** read-only property of the Response interface contains the Headers object associated with the response.
2094
2085
  *
2095
2086
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/headers)
2096
2087
  */
@@ -2108,7 +2099,7 @@ interface Response extends Body {
2108
2099
  */
2109
2100
  redirected: boolean;
2110
2101
  /**
2111
- * The **`url`** read-only property of the Response interface contains the URL of the response.
2102
+ * 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.
2112
2103
  *
2113
2104
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/url)
2114
2105
  */
@@ -2116,7 +2107,7 @@ interface Response extends Body {
2116
2107
  webSocket: WebSocket | null;
2117
2108
  cf: any | undefined;
2118
2109
  /**
2119
- * The **`type`** read-only property of the Response interface contains the type of the response.
2110
+ * 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.
2120
2111
  *
2121
2112
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/type)
2122
2113
  */
@@ -2131,8 +2122,7 @@ interface ResponseInit {
2131
2122
  encodeBody?: "automatic" | "manual";
2132
2123
  }
2133
2124
  type RequestInfo<CfHostMetadata = unknown, Cf = CfProperties<CfHostMetadata>> =
2134
- | Request<CfHostMetadata, Cf>
2135
- | string;
2125
+ Request<CfHostMetadata, Cf> | string;
2136
2126
  /**
2137
2127
  * The **`Request`** interface of the Fetch API represents a resource request.
2138
2128
  *
@@ -2155,13 +2145,13 @@ interface Request<
2155
2145
  Cf = CfProperties<CfHostMetadata>,
2156
2146
  > extends Body {
2157
2147
  /**
2158
- * The **`clone()`** method of the Request interface creates a copy of the current `Request` object.
2148
+ * The **`clone()`** method of the Request interface creates a copy of the current Request object.
2159
2149
  *
2160
2150
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/clone)
2161
2151
  */
2162
2152
  clone(): Request<CfHostMetadata, Cf>;
2163
2153
  /**
2164
- * The **`method`** read-only property of the `POST`, etc.) A String indicating the method of the request.
2154
+ * The **`method`** read-only property of the Request interface contains the request's method (GET, POST, etc.)
2165
2155
  *
2166
2156
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/method)
2167
2157
  */
@@ -2173,7 +2163,7 @@ interface Request<
2173
2163
  */
2174
2164
  url: string;
2175
2165
  /**
2176
- * The **`headers`** read-only property of the with the request.
2166
+ * The **`headers`** read-only property of the Request interface contains the Headers object associated with the request.
2177
2167
  *
2178
2168
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/headers)
2179
2169
  */
@@ -2199,13 +2189,13 @@ interface Request<
2199
2189
  */
2200
2190
  integrity: string;
2201
2191
  /**
2202
- * 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.
2192
+ * 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.
2203
2193
  *
2204
2194
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/keepalive)
2205
2195
  */
2206
2196
  keepalive: boolean;
2207
2197
  /**
2208
- * The **`cache`** read-only property of the Request interface contains the cache mode of the request.
2198
+ * 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.
2209
2199
  *
2210
2200
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/cache)
2211
2201
  */
@@ -2553,12 +2543,7 @@ interface R2Bucket {
2553
2543
  put(
2554
2544
  key: string,
2555
2545
  value:
2556
- | ReadableStream
2557
- | ArrayBuffer
2558
- | ArrayBufferView
2559
- | string
2560
- | null
2561
- | Blob,
2546
+ ReadableStream | ArrayBuffer | ArrayBufferView | string | null | Blob,
2562
2547
  options?: R2PutOptions & {
2563
2548
  onlyIf: R2Conditional | Headers;
2564
2549
  },
@@ -2566,12 +2551,7 @@ interface R2Bucket {
2566
2551
  put(
2567
2552
  key: string,
2568
2553
  value:
2569
- | ReadableStream
2570
- | ArrayBuffer
2571
- | ArrayBufferView
2572
- | string
2573
- | null
2574
- | Blob,
2554
+ ReadableStream | ArrayBuffer | ArrayBufferView | string | null | Blob,
2575
2555
  options?: R2PutOptions,
2576
2556
  ): Promise<R2Object>;
2577
2557
  createMultipartUpload(
@@ -2802,7 +2782,7 @@ type ReadableStreamReadResult<R = any> =
2802
2782
  value?: undefined;
2803
2783
  };
2804
2784
  /**
2805
- * The `ReadableStream` interface of the Streams API represents a readable stream of byte data.
2785
+ * 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.
2806
2786
  *
2807
2787
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream)
2808
2788
  */
@@ -2820,13 +2800,13 @@ interface ReadableStream<R = any> {
2820
2800
  */
2821
2801
  cancel(reason?: any): Promise<void>;
2822
2802
  /**
2823
- * The **`getReader()`** method of the ReadableStream interface creates a reader and locks the stream to it.
2803
+ * 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.
2824
2804
  *
2825
2805
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/getReader)
2826
2806
  */
2827
2807
  getReader(): ReadableStreamDefaultReader<R>;
2828
2808
  /**
2829
- * 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.
2830
2810
  *
2831
2811
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/getReader)
2832
2812
  */
@@ -2841,7 +2821,7 @@ interface ReadableStream<R = any> {
2841
2821
  options?: StreamPipeOptions,
2842
2822
  ): ReadableStream<T>;
2843
2823
  /**
2844
- * 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.
2824
+ * 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.
2845
2825
  *
2846
2826
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/pipeTo)
2847
2827
  */
@@ -2850,7 +2830,7 @@ interface ReadableStream<R = any> {
2850
2830
  options?: StreamPipeOptions,
2851
2831
  ): Promise<void>;
2852
2832
  /**
2853
- * The **`tee()`** method of the two-element array containing the two resulting branches as new ReadableStream instances.
2833
+ * 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.
2854
2834
  *
2855
2835
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/tee)
2856
2836
  */
@@ -2861,7 +2841,7 @@ interface ReadableStream<R = any> {
2861
2841
  ): AsyncIterableIterator<R>;
2862
2842
  }
2863
2843
  /**
2864
- * The `ReadableStream` interface of the Streams API represents a readable stream of byte data.
2844
+ * 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.
2865
2845
  *
2866
2846
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream)
2867
2847
  */
@@ -2899,7 +2879,7 @@ declare class ReadableStreamDefaultReader<R = any> {
2899
2879
  releaseLock(): void;
2900
2880
  }
2901
2881
  /**
2902
- * The `ReadableStreamBYOBReader` interface of the Streams API defines a reader for a ReadableStream that supports zero-copy reading from an underlying byte source.
2882
+ * 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.
2903
2883
  *
2904
2884
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader)
2905
2885
  */
@@ -2908,7 +2888,7 @@ declare class ReadableStreamBYOBReader {
2908
2888
  get closed(): Promise<void>;
2909
2889
  cancel(reason?: any): Promise<void>;
2910
2890
  /**
2911
- * 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.
2891
+ * 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.
2912
2892
  *
2913
2893
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/read)
2914
2894
  */
@@ -2916,7 +2896,7 @@ declare class ReadableStreamBYOBReader {
2916
2896
  view: T,
2917
2897
  ): Promise<ReadableStreamReadResult<T>>;
2918
2898
  /**
2919
- * The **`releaseLock()`** method of the ReadableStreamBYOBReader interface releases the reader's lock on the stream.
2899
+ * 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.
2920
2900
  *
2921
2901
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/releaseLock)
2922
2902
  */
@@ -2938,7 +2918,7 @@ interface ReadableStreamGetReaderOptions {
2938
2918
  mode: "byob";
2939
2919
  }
2940
2920
  /**
2941
- * 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).
2921
+ * 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).
2942
2922
  *
2943
2923
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest)
2944
2924
  */
@@ -2964,13 +2944,13 @@ declare abstract class ReadableStreamBYOBRequest {
2964
2944
  get atLeast(): number | null;
2965
2945
  }
2966
2946
  /**
2967
- * The **`ReadableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a ReadableStream's state and internal queue.
2947
+ * 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.
2968
2948
  *
2969
2949
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController)
2970
2950
  */
2971
2951
  declare abstract class ReadableStreamDefaultController<R = any> {
2972
2952
  /**
2973
- * The **`desiredSize`** read-only property of the required to fill the stream's internal queue.
2953
+ * The **`desiredSize`** read-only property of the ReadableStreamDefaultController interface returns the desired size required to fill the stream's internal queue.
2974
2954
  *
2975
2955
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/desiredSize)
2976
2956
  */
@@ -2982,32 +2962,32 @@ declare abstract class ReadableStreamDefaultController<R = any> {
2982
2962
  */
2983
2963
  close(): void;
2984
2964
  /**
2985
- * The **`enqueue()`** method of the ```js-nolint enqueue(chunk) ``` - `chunk` - : The chunk to enqueue.
2965
+ * The **`enqueue()`** method of the ReadableStreamDefaultController interface enqueues a given chunk in the associated stream.
2986
2966
  *
2987
2967
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/enqueue)
2988
2968
  */
2989
2969
  enqueue(chunk?: R): void;
2990
2970
  /**
2991
- * The **`error()`** method of the with the associated stream to error.
2971
+ * The **`error()`** method of the ReadableStreamDefaultController interface causes any future interactions with the associated stream to error.
2992
2972
  *
2993
2973
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/error)
2994
2974
  */
2995
2975
  error(reason: any): void;
2996
2976
  }
2997
2977
  /**
2998
- * The **`ReadableByteStreamController`** interface of the Streams API represents a controller for a readable byte stream.
2978
+ * 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.
2999
2979
  *
3000
2980
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController)
3001
2981
  */
3002
2982
  declare abstract class ReadableByteStreamController {
3003
2983
  /**
3004
- * The **`byobRequest`** read-only property of the ReadableByteStreamController interface returns the current BYOB request, or `null` if there are no pending requests.
2984
+ * The **`byobRequest`** read-only property of the ReadableByteStreamController interface returns the current BYOB request, or null if there are no pending requests.
3005
2985
  *
3006
2986
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/byobRequest)
3007
2987
  */
3008
2988
  get byobRequest(): ReadableStreamBYOBRequest | null;
3009
2989
  /**
3010
- * 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'.
2990
+ * 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".
3011
2991
  *
3012
2992
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/desiredSize)
3013
2993
  */
@@ -3019,7 +2999,7 @@ declare abstract class ReadableByteStreamController {
3019
2999
  */
3020
3000
  close(): void;
3021
3001
  /**
3022
- * 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).
3002
+ * 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).
3023
3003
  *
3024
3004
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/enqueue)
3025
3005
  */
@@ -3032,7 +3012,7 @@ declare abstract class ReadableByteStreamController {
3032
3012
  error(reason: any): void;
3033
3013
  }
3034
3014
  /**
3035
- * The **`WritableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a WritableStream's state.
3015
+ * 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.
3036
3016
  *
3037
3017
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController)
3038
3018
  */
@@ -3044,7 +3024,7 @@ declare abstract class WritableStreamDefaultController {
3044
3024
  */
3045
3025
  get signal(): AbortSignal;
3046
3026
  /**
3047
- * The **`error()`** method of the with the associated stream to error.
3027
+ * The **`error()`** method of the WritableStreamDefaultController interface causes any future interactions with the associated stream to error.
3048
3028
  *
3049
3029
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController/error)
3050
3030
  */
@@ -3069,7 +3049,7 @@ declare abstract class TransformStreamDefaultController<O = any> {
3069
3049
  */
3070
3050
  enqueue(chunk?: O): void;
3071
3051
  /**
3072
- * The **`error()`** method of the TransformStreamDefaultController interface errors both sides of the stream.
3052
+ * 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.
3073
3053
  *
3074
3054
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/error)
3075
3055
  */
@@ -3091,7 +3071,7 @@ interface ReadableWritablePair<R = any, W = any> {
3091
3071
  writable: WritableStream<W>;
3092
3072
  }
3093
3073
  /**
3094
- * The **`WritableStream`** interface of the Streams API provides a standard abstraction for writing streaming data to a destination, known as a sink.
3074
+ * 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.
3095
3075
  *
3096
3076
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream)
3097
3077
  */
@@ -3101,7 +3081,7 @@ declare class WritableStream<W = any> {
3101
3081
  queuingStrategy?: QueuingStrategy,
3102
3082
  );
3103
3083
  /**
3104
- * The **`locked`** read-only property of the WritableStream interface returns a boolean indicating whether the `WritableStream` is locked to a writer.
3084
+ * The **`locked`** read-only property of the WritableStream interface returns a boolean indicating whether the WritableStream is locked to a writer.
3105
3085
  *
3106
3086
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/locked)
3107
3087
  */
@@ -3113,70 +3093,70 @@ declare class WritableStream<W = any> {
3113
3093
  */
3114
3094
  abort(reason?: any): Promise<void>;
3115
3095
  /**
3116
- * The **`close()`** method of the WritableStream interface closes the associated stream.
3096
+ * 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.
3117
3097
  *
3118
3098
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/close)
3119
3099
  */
3120
3100
  close(): Promise<void>;
3121
3101
  /**
3122
- * The **`getWriter()`** method of the WritableStream interface returns a new instance of WritableStreamDefaultWriter and locks the stream to that instance.
3102
+ * 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.
3123
3103
  *
3124
3104
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/getWriter)
3125
3105
  */
3126
3106
  getWriter(): WritableStreamDefaultWriter<W>;
3127
3107
  }
3128
3108
  /**
3129
- * 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.
3109
+ * 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.
3130
3110
  *
3131
3111
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter)
3132
3112
  */
3133
3113
  declare class WritableStreamDefaultWriter<W = any> {
3134
3114
  constructor(stream: WritableStream);
3135
3115
  /**
3136
- * The **`closed`** read-only property of the the stream errors or the writer's lock is released.
3116
+ * 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.
3137
3117
  *
3138
3118
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/closed)
3139
3119
  */
3140
3120
  get closed(): Promise<void>;
3141
3121
  /**
3142
- * 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.
3122
+ * 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.
3143
3123
  *
3144
3124
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/ready)
3145
3125
  */
3146
3126
  get ready(): Promise<void>;
3147
3127
  /**
3148
- * The **`desiredSize`** read-only property of the to fill the stream's internal queue.
3128
+ * The **`desiredSize`** read-only property of the WritableStreamDefaultWriter interface returns the desired size required to fill the stream's internal queue.
3149
3129
  *
3150
3130
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/desiredSize)
3151
3131
  */
3152
3132
  get desiredSize(): number | null;
3153
3133
  /**
3154
- * 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.
3134
+ * 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.
3155
3135
  *
3156
3136
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/abort)
3157
3137
  */
3158
3138
  abort(reason?: any): Promise<void>;
3159
3139
  /**
3160
- * The **`close()`** method of the stream.
3140
+ * The **`close()`** method of the WritableStreamDefaultWriter interface closes the associated writable stream.
3161
3141
  *
3162
3142
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/close)
3163
3143
  */
3164
3144
  close(): Promise<void>;
3165
3145
  /**
3166
- * The **`write()`** method of the operation.
3146
+ * 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.
3167
3147
  *
3168
3148
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/write)
3169
3149
  */
3170
3150
  write(chunk?: W): Promise<void>;
3171
3151
  /**
3172
- * The **`releaseLock()`** method of the corresponding stream.
3152
+ * 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.
3173
3153
  *
3174
3154
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/releaseLock)
3175
3155
  */
3176
3156
  releaseLock(): void;
3177
3157
  }
3178
3158
  /**
3179
- * The **`TransformStream`** interface of the Streams API represents a concrete implementation of the pipe chain _transform stream_ concept.
3159
+ * The **`TransformStream`** interface of the Streams API represents a concrete implementation of the pipe chain transform stream concept.
3180
3160
  *
3181
3161
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream)
3182
3162
  */
@@ -3187,13 +3167,13 @@ declare class TransformStream<I = any, O = any> {
3187
3167
  readableStrategy?: QueuingStrategy<O>,
3188
3168
  );
3189
3169
  /**
3190
- * The **`readable`** read-only property of the TransformStream interface returns the ReadableStream instance controlled by this `TransformStream`.
3170
+ * The **`readable`** read-only property of the TransformStream interface returns the ReadableStream instance controlled by this TransformStream. This stream emits the transformed output data.
3191
3171
  *
3192
3172
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/readable)
3193
3173
  */
3194
3174
  get readable(): ReadableStream<O>;
3195
3175
  /**
3196
- * The **`writable`** read-only property of the TransformStream interface returns the WritableStream instance controlled by this `TransformStream`.
3176
+ * 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.
3197
3177
  *
3198
3178
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/writable)
3199
3179
  */
@@ -3218,7 +3198,7 @@ interface ReadableStreamValuesOptions {
3218
3198
  preventCancel?: boolean;
3219
3199
  }
3220
3200
  /**
3221
- * The **`CompressionStream`** interface of the Compression Streams API is an API for compressing a stream of data.
3201
+ * 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.
3222
3202
  *
3223
3203
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CompressionStream)
3224
3204
  */
@@ -3229,7 +3209,7 @@ declare class CompressionStream extends TransformStream<
3229
3209
  constructor(format: "gzip" | "deflate" | "deflate-raw");
3230
3210
  }
3231
3211
  /**
3232
- * The **`DecompressionStream`** interface of the Compression Streams API is an API for decompressing a stream of data.
3212
+ * 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.
3233
3213
  *
3234
3214
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DecompressionStream)
3235
3215
  */
@@ -3240,7 +3220,7 @@ declare class DecompressionStream extends TransformStream<
3240
3220
  constructor(format: "gzip" | "deflate" | "deflate-raw");
3241
3221
  }
3242
3222
  /**
3243
- * The **`TextEncoderStream`** interface of the Encoding API converts a stream of strings into bytes in the UTF-8 encoding.
3223
+ * 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.
3244
3224
  *
3245
3225
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoderStream)
3246
3226
  */
@@ -3249,7 +3229,7 @@ declare class TextEncoderStream extends TransformStream<string, Uint8Array> {
3249
3229
  get encoding(): string;
3250
3230
  }
3251
3231
  /**
3252
- * 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.
3232
+ * 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.
3253
3233
  *
3254
3234
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoderStream)
3255
3235
  */
@@ -3441,7 +3421,7 @@ interface UnsafeTraceMetrics {
3441
3421
  fromTrace(item: TraceItem): TraceMetrics;
3442
3422
  }
3443
3423
  /**
3444
- * The **`URL`** interface is used to parse, construct, normalize, and encode URL.
3424
+ * 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.
3445
3425
  *
3446
3426
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL)
3447
3427
  */
@@ -3466,121 +3446,121 @@ declare class URL {
3466
3446
  */
3467
3447
  set href(value: string);
3468
3448
  /**
3469
- * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final `':'`.
3449
+ * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final ":".
3470
3450
  *
3471
3451
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/protocol)
3472
3452
  */
3473
3453
  get protocol(): string;
3474
3454
  /**
3475
- * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final `':'`.
3455
+ * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final ":".
3476
3456
  *
3477
3457
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/protocol)
3478
3458
  */
3479
3459
  set protocol(value: string);
3480
3460
  /**
3481
- * The **`username`** property of the URL interface is a string containing the username component of the URL.
3461
+ * 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, "".
3482
3462
  *
3483
3463
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/username)
3484
3464
  */
3485
3465
  get username(): string;
3486
3466
  /**
3487
- * The **`username`** property of the URL interface is a string containing the username component of the URL.
3467
+ * 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, "".
3488
3468
  *
3489
3469
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/username)
3490
3470
  */
3491
3471
  set username(value: string);
3492
3472
  /**
3493
- * The **`password`** property of the URL interface is a string containing the password component of the URL.
3473
+ * 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, "".
3494
3474
  *
3495
3475
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/password)
3496
3476
  */
3497
3477
  get password(): string;
3498
3478
  /**
3499
- * The **`password`** property of the URL interface is a string containing the password component of the URL.
3479
+ * 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, "".
3500
3480
  *
3501
3481
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/password)
3502
3482
  */
3503
3483
  set password(value: string);
3504
3484
  /**
3505
- * 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.
3485
+ * 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, "".
3506
3486
  *
3507
3487
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/host)
3508
3488
  */
3509
3489
  get host(): string;
3510
3490
  /**
3511
- * 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.
3491
+ * 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, "".
3512
3492
  *
3513
3493
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/host)
3514
3494
  */
3515
3495
  set host(value: string);
3516
3496
  /**
3517
- * The **`hostname`** property of the URL interface is a string containing either the domain name or IP address of the URL.
3497
+ * 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.
3518
3498
  *
3519
3499
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hostname)
3520
3500
  */
3521
3501
  get hostname(): string;
3522
3502
  /**
3523
- * The **`hostname`** property of the URL interface is a string containing either the domain name or IP address of the URL.
3503
+ * 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.
3524
3504
  *
3525
3505
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hostname)
3526
3506
  */
3527
3507
  set hostname(value: string);
3528
3508
  /**
3529
- * The **`port`** property of the URL interface is a string containing the port number of the URL.
3509
+ * 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, "".
3530
3510
  *
3531
3511
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/port)
3532
3512
  */
3533
3513
  get port(): string;
3534
3514
  /**
3535
- * The **`port`** property of the URL interface is a string containing the port number of the URL.
3515
+ * 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, "".
3536
3516
  *
3537
3517
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/port)
3538
3518
  */
3539
3519
  set port(value: string);
3540
3520
  /**
3541
- * The **`pathname`** property of the URL interface represents a location in a hierarchical structure.
3521
+ * 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.
3542
3522
  *
3543
3523
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/pathname)
3544
3524
  */
3545
3525
  get pathname(): string;
3546
3526
  /**
3547
- * The **`pathname`** property of the URL interface represents a location in a hierarchical structure.
3527
+ * 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.
3548
3528
  *
3549
3529
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/pathname)
3550
3530
  */
3551
3531
  set pathname(value: string);
3552
3532
  /**
3553
- * 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.
3533
+ * 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, "".
3554
3534
  *
3555
3535
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/search)
3556
3536
  */
3557
3537
  get search(): string;
3558
3538
  /**
3559
- * 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.
3539
+ * 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, "".
3560
3540
  *
3561
3541
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/search)
3562
3542
  */
3563
3543
  set search(value: string);
3564
3544
  /**
3565
- * The **`hash`** property of the URL interface is a string containing a `'#'` followed by the fragment identifier of the URL.
3545
+ * 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, "".
3566
3546
  *
3567
3547
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hash)
3568
3548
  */
3569
3549
  get hash(): string;
3570
3550
  /**
3571
- * The **`hash`** property of the URL interface is a string containing a `'#'` followed by the fragment identifier of the URL.
3551
+ * 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, "".
3572
3552
  *
3573
3553
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hash)
3574
3554
  */
3575
3555
  set hash(value: string);
3576
3556
  /**
3577
- * The **`searchParams`** read-only property of the access to the [MISSING: httpmethod('GET')] decoded query arguments contained in the URL.
3557
+ * 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.
3578
3558
  *
3579
3559
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/searchParams)
3580
3560
  */
3581
3561
  get searchParams(): URLSearchParams;
3582
3562
  /**
3583
- * 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.
3563
+ * 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().
3584
3564
  *
3585
3565
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/toJSON)
3586
3566
  */
@@ -3600,13 +3580,13 @@ declare class URL {
3600
3580
  */
3601
3581
  static parse(url: string, base?: string): URL | null;
3602
3582
  /**
3603
- * The **`createObjectURL()`** static method of the URL interface creates a string containing a URL representing the object given in the parameter.
3583
+ * The **`createObjectURL()`** static method of the URL interface creates a string containing a blob URL pointing to the object given in the parameter.
3604
3584
  *
3605
3585
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/createObjectURL_static)
3606
3586
  */
3607
3587
  static createObjectURL(object: File | Blob): string;
3608
3588
  /**
3609
- * 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.
3589
+ * The **`revokeObjectURL()`** static method of the URL interface releases an existing object URL which was previously created by calling URL.createObjectURL().
3610
3590
  *
3611
3591
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/revokeObjectURL_static)
3612
3592
  */
@@ -3658,22 +3638,19 @@ declare class URLSearchParams {
3658
3638
  */
3659
3639
  has(name: string, value?: string): boolean;
3660
3640
  /**
3661
- * The **`set()`** method of the URLSearchParams interface sets the value associated with a given search parameter to the given value.
3641
+ * 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.
3662
3642
  *
3663
3643
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/set)
3664
3644
  */
3665
3645
  set(name: string, value: string): void;
3666
3646
  /**
3667
- * The **`URLSearchParams.sort()`** method sorts all key/value pairs contained in this object in place and returns `undefined`.
3647
+ * 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).
3668
3648
  *
3669
3649
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/sort)
3670
3650
  */
3671
3651
  sort(): void;
3672
- /* Returns an array of key, value pairs for every entry in the search params. */
3673
3652
  entries(): IterableIterator<[key: string, value: string]>;
3674
- /* Returns a list of keys in the search params. */
3675
3653
  keys(): IterableIterator<string>;
3676
- /* Returns a list of values in the search params. */
3677
3654
  values(): IterableIterator<string>;
3678
3655
  forEach<This = unknown>(
3679
3656
  callback: (
@@ -3688,22 +3665,82 @@ declare class URLSearchParams {
3688
3665
  toString(): string;
3689
3666
  [Symbol.iterator](): IterableIterator<[key: string, value: string]>;
3690
3667
  }
3668
+ /**
3669
+ * 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.
3670
+ *
3671
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern)
3672
+ */
3691
3673
  declare class URLPattern {
3692
3674
  constructor(
3693
3675
  input?: string | URLPatternInit,
3694
3676
  baseURL?: string | URLPatternOptions,
3695
3677
  patternOptions?: URLPatternOptions,
3696
3678
  );
3679
+ /**
3680
+ * The **`protocol`** read-only property of the URLPattern interface is a string containing the pattern used to match the protocol part of a URL.
3681
+ *
3682
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/protocol)
3683
+ */
3697
3684
  get protocol(): string;
3685
+ /**
3686
+ * The **`username`** read-only property of the URLPattern interface is a string containing the pattern used to match the username part of a URL.
3687
+ *
3688
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/username)
3689
+ */
3698
3690
  get username(): string;
3691
+ /**
3692
+ * The **`password`** read-only property of the URLPattern interface is a string containing the pattern used to match the password part of a URL.
3693
+ *
3694
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/password)
3695
+ */
3699
3696
  get password(): string;
3697
+ /**
3698
+ * The **`hostname`** read-only property of the URLPattern interface is a string containing the pattern used to match the hostname part of a URL.
3699
+ *
3700
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/hostname)
3701
+ */
3700
3702
  get hostname(): string;
3703
+ /**
3704
+ * The **`port`** read-only property of the URLPattern interface is a string containing the pattern used to match the port part of a URL.
3705
+ *
3706
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/port)
3707
+ */
3701
3708
  get port(): string;
3709
+ /**
3710
+ * The **`pathname`** read-only property of the URLPattern interface is a string containing the pattern used to match the pathname part of a URL.
3711
+ *
3712
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/pathname)
3713
+ */
3702
3714
  get pathname(): string;
3715
+ /**
3716
+ * The **`search`** read-only property of the URLPattern interface is a string containing the pattern used to match the search part of a URL.
3717
+ *
3718
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/search)
3719
+ */
3703
3720
  get search(): string;
3721
+ /**
3722
+ * The **`hash`** read-only property of the URLPattern interface is a string containing the pattern used to match the fragment part of a URL.
3723
+ *
3724
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/hash)
3725
+ */
3704
3726
  get hash(): string;
3727
+ /**
3728
+ * 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.
3729
+ *
3730
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/hasRegExpGroups)
3731
+ */
3705
3732
  get hasRegExpGroups(): boolean;
3733
+ /**
3734
+ * 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.
3735
+ *
3736
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/test)
3737
+ */
3706
3738
  test(input?: string | URLPatternInit, baseURL?: string): boolean;
3739
+ /**
3740
+ * 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.
3741
+ *
3742
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLPattern/exec)
3743
+ */
3707
3744
  exec(
3708
3745
  input?: string | URLPatternInit,
3709
3746
  baseURL?: string,
@@ -3739,7 +3776,7 @@ interface URLPatternOptions {
3739
3776
  ignoreCase?: boolean;
3740
3777
  }
3741
3778
  /**
3742
- * A `CloseEvent` is sent to clients using WebSockets when the connection is closed.
3779
+ * 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.
3743
3780
  *
3744
3781
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CloseEvent)
3745
3782
  */
@@ -3758,7 +3795,7 @@ declare class CloseEvent extends Event {
3758
3795
  */
3759
3796
  readonly reason: string;
3760
3797
  /**
3761
- * The **`wasClean`** read-only property of the CloseEvent interface returns `true` if the connection closed cleanly.
3798
+ * The **`wasClean`** read-only property of the CloseEvent interface returns true if the connection closed cleanly.
3762
3799
  *
3763
3800
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CloseEvent/wasClean)
3764
3801
  */
@@ -3776,7 +3813,7 @@ type WebSocketEventMap = {
3776
3813
  error: ErrorEvent;
3777
3814
  };
3778
3815
  /**
3779
- * 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.
3816
+ * 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.
3780
3817
  *
3781
3818
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket)
3782
3819
  */
@@ -3793,20 +3830,20 @@ declare var WebSocket: {
3793
3830
  readonly CLOSED: number;
3794
3831
  };
3795
3832
  /**
3796
- * 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.
3833
+ * 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.
3797
3834
  *
3798
3835
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket)
3799
3836
  */
3800
3837
  interface WebSocket extends EventTarget<WebSocketEventMap> {
3801
3838
  accept(options?: WebSocketAcceptOptions): void;
3802
3839
  /**
3803
- * 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.
3840
+ * 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.
3804
3841
  *
3805
3842
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/send)
3806
3843
  */
3807
3844
  send(message: (ArrayBuffer | ArrayBufferView) | string): void;
3808
3845
  /**
3809
- * The **`WebSocket.close()`** method closes the already `CLOSED`, this method does nothing.
3846
+ * The **`WebSocket.close()`** method closes the WebSocket connection or connection attempt, if any. If the connection is already CLOSED, this method does nothing.
3810
3847
  *
3811
3848
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/close)
3812
3849
  */
@@ -3826,13 +3863,13 @@ interface WebSocket extends EventTarget<WebSocketEventMap> {
3826
3863
  */
3827
3864
  url: string | null;
3828
3865
  /**
3829
- * 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.
3866
+ * 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.
3830
3867
  *
3831
3868
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/protocol)
3832
3869
  */
3833
3870
  protocol: string | null;
3834
3871
  /**
3835
- * The **`WebSocket.extensions`** read-only property returns the extensions selected by the server.
3872
+ * 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.
3836
3873
  *
3837
3874
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/extensions)
3838
3875
  */
@@ -3935,25 +3972,25 @@ interface SocketInfo {
3935
3972
  declare class EventSource extends EventTarget {
3936
3973
  constructor(url: string, init?: EventSourceEventSourceInit);
3937
3974
  /**
3938
- * The **`close()`** method of the EventSource interface closes the connection, if one is made, and sets the ```js-nolint close() ``` None.
3975
+ * The **`close()`** method of the EventSource interface closes the connection, if one is made, and sets the EventSource.readyState attribute to 2 (closed).
3939
3976
  *
3940
3977
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/close)
3941
3978
  */
3942
3979
  close(): void;
3943
3980
  /**
3944
- * The **`url`** read-only property of the URL of the source.
3981
+ * The **`url`** read-only property of the EventSource interface returns a string representing the URL of the source.
3945
3982
  *
3946
3983
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/url)
3947
3984
  */
3948
3985
  get url(): string;
3949
3986
  /**
3950
- * The **`withCredentials`** read-only property of the the `EventSource` object was instantiated with CORS credentials set.
3987
+ * The **`withCredentials`** read-only property of the EventSource interface returns a boolean value indicating whether the EventSource object was instantiated with CORS credentials set.
3951
3988
  *
3952
3989
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/withCredentials)
3953
3990
  */
3954
3991
  get withCredentials(): boolean;
3955
3992
  /**
3956
- * The **`readyState`** read-only property of the connection.
3993
+ * The **`readyState`** read-only property of the EventSource interface returns a number representing the state of the connection.
3957
3994
  *
3958
3995
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/readyState)
3959
3996
  */
@@ -4087,26 +4124,26 @@ interface ContainerStartResources {
4087
4124
  diskMb: number;
4088
4125
  }
4089
4126
  /**
4090
- * The **`FileSystemHandle`** interface of the File System API is an object which represents a file or directory entry.
4127
+ * 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.
4091
4128
  * Available only in secure contexts.
4092
4129
  *
4093
4130
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle)
4094
4131
  */
4095
4132
  declare abstract class FileSystemHandle {
4096
4133
  /**
4097
- * The **`kind`** read-only property of the `'file'` if the associated entry is a file or `'directory'`.
4134
+ * 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.
4098
4135
  *
4099
4136
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/kind)
4100
4137
  */
4101
4138
  get kind(): string;
4102
4139
  /**
4103
- * The **`name`** read-only property of the handle.
4140
+ * The **`name`** read-only property of the FileSystemHandle interface returns the name of the entry represented by handle.
4104
4141
  *
4105
4142
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/name)
4106
4143
  */
4107
4144
  get name(): string;
4108
4145
  /**
4109
- * The **`isSameEntry()`** method of the ```js-nolint isSameEntry(fileSystemHandle) ``` - FileSystemHandle - : The `FileSystemHandle` to match against the handle on which the method is invoked.
4146
+ * The **`isSameEntry()`** method of the FileSystemHandle interface compares two handles to see if the associated entries (either a file or directory) match.
4110
4147
  *
4111
4148
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/isSameEntry)
4112
4149
  */
@@ -4115,20 +4152,20 @@ declare abstract class FileSystemHandle {
4115
4152
  remove(options?: FileSystemHandleRemoveOptions): Promise<void>;
4116
4153
  }
4117
4154
  /**
4118
- * The **`FileSystemFileHandle`** interface of the File System API represents a handle to a file system entry.
4155
+ * 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.
4119
4156
  * Available only in secure contexts.
4120
4157
  *
4121
4158
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemFileHandle)
4122
4159
  */
4123
4160
  declare abstract class FileSystemFileHandle extends FileSystemHandle {
4124
4161
  /**
4125
- * 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.
4162
+ * 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.
4126
4163
  *
4127
4164
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemFileHandle/getFile)
4128
4165
  */
4129
4166
  getFile(): Promise<File>;
4130
4167
  /**
4131
- * The **`createWritable()`** method of the FileSystemFileHandle interface creates a FileSystemWritableFileStream that can be used to write to a file.
4168
+ * 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.
4132
4169
  *
4133
4170
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemFileHandle/createWritable)
4134
4171
  */
@@ -4144,7 +4181,7 @@ declare abstract class FileSystemFileHandle extends FileSystemHandle {
4144
4181
  */
4145
4182
  declare abstract class FileSystemDirectoryHandle extends FileSystemHandle {
4146
4183
  /**
4147
- * The **`getFileHandle()`** method of the directory the method is called.
4184
+ * The **`getFileHandle()`** method of the FileSystemDirectoryHandle interface returns a FileSystemFileHandle for a file with the specified name, within the directory the method is called.
4148
4185
  *
4149
4186
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/getFileHandle)
4150
4187
  */
@@ -4153,7 +4190,7 @@ declare abstract class FileSystemDirectoryHandle extends FileSystemHandle {
4153
4190
  options?: FileSystemDirectoryHandleFileSystemGetFileOptions,
4154
4191
  ): Promise<FileSystemFileHandle>;
4155
4192
  /**
4156
- * The **`getDirectoryHandle()`** method of the within the directory handle on which the method is called.
4193
+ * 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.
4157
4194
  *
4158
4195
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/getDirectoryHandle)
4159
4196
  */
@@ -4162,7 +4199,7 @@ declare abstract class FileSystemDirectoryHandle extends FileSystemHandle {
4162
4199
  options?: FileSystemDirectoryHandleFileSystemGetDirectoryOptions,
4163
4200
  ): Promise<FileSystemDirectoryHandle>;
4164
4201
  /**
4165
- * The **`removeEntry()`** method of the directory handle contains a file or directory called the name specified.
4202
+ * 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.
4166
4203
  *
4167
4204
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/removeEntry)
4168
4205
  */
@@ -4171,7 +4208,7 @@ declare abstract class FileSystemDirectoryHandle extends FileSystemHandle {
4171
4208
  options?: FileSystemDirectoryHandleFileSystemRemoveOptions,
4172
4209
  ): Promise<void>;
4173
4210
  /**
4174
- * 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.
4211
+ * 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.
4175
4212
  *
4176
4213
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/resolve)
4177
4214
  */
@@ -4190,7 +4227,7 @@ declare abstract class FileSystemDirectoryHandle extends FileSystemHandle {
4190
4227
  [Symbol.asyncIterator](): AsyncIterableIterator<[string, FileSystemHandle]>;
4191
4228
  }
4192
4229
  /**
4193
- * The **`FileSystemWritableFileStream`** interface of the File System API is a WritableStream object with additional convenience methods, which operates on a single file on disk.
4230
+ * 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.
4194
4231
  * Available only in secure contexts.
4195
4232
  *
4196
4233
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemWritableFileStream)
@@ -4222,7 +4259,7 @@ declare abstract class FileSystemWritableFileStream extends WritableStream {
4222
4259
  truncate(size: number): Promise<void>;
4223
4260
  }
4224
4261
  /**
4225
- * The **`StorageManager`** interface of the Storage API provides an interface for managing persistence permissions and estimating available storage.
4262
+ * 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.
4226
4263
  * Available only in secure contexts.
4227
4264
  *
4228
4265
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/StorageManager)
@@ -4263,7 +4300,7 @@ interface FileSystemHandleRemoveOptions {
4263
4300
  */
4264
4301
  declare abstract class MessagePort extends EventTarget {
4265
4302
  /**
4266
- * The **`postMessage()`** method of the transfers ownership of objects to other browsing contexts.
4303
+ * The **`postMessage()`** method of the MessagePort interface sends a message from the port, and optionally, transfers ownership of objects to other browsing contexts.
4267
4304
  *
4268
4305
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/postMessage)
4269
4306
  */
@@ -4272,13 +4309,13 @@ declare abstract class MessagePort extends EventTarget {
4272
4309
  options?: any[] | MessagePortPostMessageOptions,
4273
4310
  ): void;
4274
4311
  /**
4275
- * The **`close()`** method of the MessagePort interface disconnects the port, so it is no longer active.
4312
+ * 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.
4276
4313
  *
4277
4314
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/close)
4278
4315
  */
4279
4316
  close(): void;
4280
4317
  /**
4281
- * The **`start()`** method of the MessagePort interface starts the sending of messages queued on the port.
4318
+ * 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.
4282
4319
  *
4283
4320
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/start)
4284
4321
  */
@@ -4294,13 +4331,13 @@ declare abstract class MessagePort extends EventTarget {
4294
4331
  declare class MessageChannel {
4295
4332
  constructor();
4296
4333
  /**
4297
- * The **`port1`** read-only property of the the port attached to the context that originated the channel.
4334
+ * 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.
4298
4335
  *
4299
4336
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageChannel/port1)
4300
4337
  */
4301
4338
  readonly port1: MessagePort;
4302
4339
  /**
4303
- * 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.
4340
+ * 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.
4304
4341
  *
4305
4342
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageChannel/port2)
4306
4343
  */
@@ -4430,7 +4467,7 @@ declare abstract class Performance extends EventTarget {
4430
4467
  */
4431
4468
  clearMeasures(name?: string): void;
4432
4469
  /**
4433
- * 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.
4470
+ * 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.
4434
4471
  *
4435
4472
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/clearResourceTimings)
4436
4473
  */
@@ -4442,13 +4479,13 @@ declare abstract class Performance extends EventTarget {
4442
4479
  */
4443
4480
  getEntries(): PerformanceEntry[];
4444
4481
  /**
4445
- * The **`getEntriesByName()`** method returns an array of PerformanceEntry objects currently present in the performance timeline with the given _name_ and _type_.
4482
+ * The **`getEntriesByName()`** method returns an array of PerformanceEntry objects currently present in the performance timeline with the given name and type.
4446
4483
  *
4447
4484
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/getEntriesByName)
4448
4485
  */
4449
4486
  getEntriesByName(name: string, type?: string): PerformanceEntry[];
4450
4487
  /**
4451
- * The **`getEntriesByType()`** method returns an array of PerformanceEntry objects currently present in the performance timeline for a given _type_.
4488
+ * The **`getEntriesByType()`** method returns an array of PerformanceEntry objects currently present in the performance timeline for a given type.
4452
4489
  *
4453
4490
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/getEntriesByType)
4454
4491
  */
@@ -4470,13 +4507,13 @@ declare abstract class Performance extends EventTarget {
4470
4507
  maybeEndMark?: string,
4471
4508
  ): PerformanceMeasure;
4472
4509
  /**
4473
- * The **`setResourceTimingBufferSize()`** method sets the desired size of the browser's resource timing buffer which stores the `'resource'` performance entries.
4510
+ * The **`setResourceTimingBufferSize()`** method sets the desired size of the browser's resource timing buffer which stores the "resource" performance entries.
4474
4511
  *
4475
4512
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/setResourceTimingBufferSize)
4476
4513
  */
4477
4514
  setResourceTimingBufferSize(size: number): void;
4478
4515
  /**
4479
- * The **`toJSON()`** method of the Performance interface is a Serialization; it returns a JSON representation of the Performance object.
4516
+ * The **`toJSON()`** method of the Performance interface is a serializer; it returns a JSON representation of the Performance object.
4480
4517
  *
4481
4518
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/toJSON)
4482
4519
  */
@@ -4508,14 +4545,14 @@ interface UvMetricsInfo {
4508
4545
  eventsWaiting: number;
4509
4546
  }
4510
4547
  /**
4511
- * **`PerformanceMark`** is an interface for PerformanceEntry objects with an PerformanceEntry.entryType of `'mark'`.
4548
+ * **`PerformanceMark`** is an interface for PerformanceEntry objects with an entryType of "mark".
4512
4549
  *
4513
4550
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMark)
4514
4551
  */
4515
4552
  declare class PerformanceMark extends PerformanceEntry {
4516
4553
  constructor(name: string, maybeOptions?: PerformanceMarkOptions);
4517
4554
  /**
4518
- * 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).
4555
+ * 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).
4519
4556
  *
4520
4557
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMark/detail)
4521
4558
  */
@@ -4523,13 +4560,13 @@ declare class PerformanceMark extends PerformanceEntry {
4523
4560
  toJSON(): object;
4524
4561
  }
4525
4562
  /**
4526
- * **`PerformanceMeasure`** is an _abstract_ interface for PerformanceEntry objects with an PerformanceEntry.entryType of `'measure'`.
4563
+ * **`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.
4527
4564
  *
4528
4565
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMeasure)
4529
4566
  */
4530
4567
  declare abstract class PerformanceMeasure extends PerformanceEntry {
4531
4568
  /**
4532
- * The read-only **`detail`** property returns arbitrary metadata that was included in the mark upon construction (when using Performance.measure.
4569
+ * The read-only **`detail`** property returns arbitrary metadata that was included in the mark upon construction (when using performance.measure().
4533
4570
  *
4534
4571
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMeasure/detail)
4535
4572
  */
@@ -4547,25 +4584,25 @@ interface PerformanceMeasureOptions {
4547
4584
  end?: number;
4548
4585
  }
4549
4586
  /**
4550
- * The **`PerformanceObserverEntryList`** interface is a list of PerformanceEntry that were explicitly observed via the PerformanceObserver.observe method.
4587
+ * The **`PerformanceObserverEntryList`** interface is a list of performance events that were explicitly observed via the observe() method.
4551
4588
  *
4552
4589
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList)
4553
4590
  */
4554
4591
  declare abstract class PerformanceObserverEntryList {
4555
4592
  /**
4556
- * The **`getEntries()`** method of the PerformanceObserverEntryList interface returns a list of explicitly observed PerformanceEntry objects.
4593
+ * 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).
4557
4594
  *
4558
4595
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntries)
4559
4596
  */
4560
4597
  getEntries(): PerformanceEntry[];
4561
4598
  /**
4562
- * The **`getEntriesByType()`** method of the PerformanceObserverEntryList returns a list of explicitly _observed_ PerformanceEntry objects for a given PerformanceEntry.entryType.
4599
+ * 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).
4563
4600
  *
4564
4601
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntriesByType)
4565
4602
  */
4566
4603
  getEntriesByType(type: string): PerformanceEntry[];
4567
4604
  /**
4568
- * The **`getEntriesByName()`** method of the PerformanceObserverEntryList interface returns a list of explicitly observed PerformanceEntry objects for a given PerformanceEntry.name and PerformanceEntry.entryType.
4605
+ * 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).
4569
4606
  *
4570
4607
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntriesByName)
4571
4608
  */
@@ -4578,7 +4615,7 @@ declare abstract class PerformanceObserverEntryList {
4578
4615
  */
4579
4616
  declare abstract class PerformanceEntry {
4580
4617
  /**
4581
- * The read-only **`name`** property of the PerformanceEntry interface is a string representing the name for a performance entry.
4618
+ * 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.
4582
4619
  *
4583
4620
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/name)
4584
4621
  */
@@ -4590,68 +4627,68 @@ declare abstract class PerformanceEntry {
4590
4627
  */
4591
4628
  get entryType(): string;
4592
4629
  /**
4593
- * The read-only **`startTime`** property returns the first DOMHighResTimeStamp recorded for this PerformanceEntry.
4630
+ * 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.
4594
4631
  *
4595
4632
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/startTime)
4596
4633
  */
4597
4634
  get startTime(): number;
4598
4635
  /**
4599
- * The read-only **`duration`** property returns a DOMHighResTimeStamp that is the duration of the PerformanceEntry.
4636
+ * 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.
4600
4637
  *
4601
4638
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/duration)
4602
4639
  */
4603
4640
  get duration(): number;
4604
4641
  /**
4605
- * The **`toJSON()`** method is a Serialization; it returns a JSON representation of the PerformanceEntry object.
4642
+ * The **`toJSON()`** method is a serializer; it returns a JSON representation of the PerformanceEntry object.
4606
4643
  *
4607
4644
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/toJSON)
4608
4645
  */
4609
4646
  toJSON(): object;
4610
4647
  }
4611
4648
  /**
4612
- * The **`PerformanceResourceTiming`** interface enables retrieval and analysis of detailed network timing data regarding the loading of an application's resources.
4649
+ * 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.
4613
4650
  *
4614
4651
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming)
4615
4652
  */
4616
4653
  declare abstract class PerformanceResourceTiming extends PerformanceEntry {
4617
4654
  /**
4618
- * The **`connectEnd`** read-only property returns the DOMHighResTimeStamp immediately after the browser finishes establishing the connection to the server to retrieve the resource.
4655
+ * 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.
4619
4656
  *
4620
4657
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/connectEnd)
4621
4658
  */
4622
4659
  get connectEnd(): number;
4623
4660
  /**
4624
- * The **`connectStart`** read-only property returns the DOMHighResTimeStamp immediately before the user agent starts establishing the connection to the server to retrieve the resource.
4661
+ * The **`connectStart`** read-only property returns the timestamp immediately before the user agent starts establishing the connection to the server to retrieve the resource.
4625
4662
  *
4626
4663
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/connectStart)
4627
4664
  */
4628
4665
  get connectStart(): number;
4629
4666
  /**
4630
- * 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).
4667
+ * 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.
4631
4668
  *
4632
4669
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/decodedBodySize)
4633
4670
  */
4634
4671
  get decodedBodySize(): number;
4635
4672
  /**
4636
- * The **`domainLookupEnd`** read-only property returns the DOMHighResTimeStamp immediately after the browser finishes the domain-name lookup for the resource.
4673
+ * The **`domainLookupEnd`** read-only property returns the timestamp immediately after the browser finishes the domain-name lookup for the resource.
4637
4674
  *
4638
4675
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/domainLookupEnd)
4639
4676
  */
4640
4677
  get domainLookupEnd(): number;
4641
4678
  /**
4642
- * The **`domainLookupStart`** read-only property returns the DOMHighResTimeStamp immediately before the browser starts the domain name lookup for the resource.
4679
+ * The **`domainLookupStart`** read-only property returns the timestamp immediately before the browser starts the domain name lookup for the resource.
4643
4680
  *
4644
4681
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/domainLookupStart)
4645
4682
  */
4646
4683
  get domainLookupStart(): number;
4647
4684
  /**
4648
- * 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).
4685
+ * 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.
4649
4686
  *
4650
4687
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/encodedBodySize)
4651
4688
  */
4652
4689
  get encodedBodySize(): number;
4653
4690
  /**
4654
- * The **`fetchStart`** read-only property represents a DOMHighResTimeStamp immediately before the browser starts to fetch the resource.
4691
+ * The **`fetchStart`** read-only property represents a timestamp immediately before the browser starts to fetch the resource.
4655
4692
  *
4656
4693
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/fetchStart)
4657
4694
  */
@@ -4669,31 +4706,31 @@ declare abstract class PerformanceResourceTiming extends PerformanceEntry {
4669
4706
  */
4670
4707
  get nextHopProtocol(): string;
4671
4708
  /**
4672
- * The **`redirectEnd`** read-only property returns a DOMHighResTimeStamp immediately after receiving the last byte of the response of the last redirect.
4709
+ * The **`redirectEnd`** read-only property returns a timestamp immediately after receiving the last byte of the response of the last redirect.
4673
4710
  *
4674
4711
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/redirectEnd)
4675
4712
  */
4676
4713
  get redirectEnd(): number;
4677
4714
  /**
4678
- * The **`redirectStart`** read-only property returns a DOMHighResTimeStamp representing the start time of the fetch which that initiates the redirect.
4715
+ * The **`redirectStart`** read-only property returns a timestamp representing the start time of the fetch which that initiates the redirect.
4679
4716
  *
4680
4717
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/redirectStart)
4681
4718
  */
4682
4719
  get redirectStart(): number;
4683
4720
  /**
4684
- * 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.
4721
+ * 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.
4685
4722
  *
4686
4723
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/requestStart)
4687
4724
  */
4688
4725
  get requestStart(): number;
4689
4726
  /**
4690
- * 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.
4727
+ * 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.
4691
4728
  *
4692
4729
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/responseEnd)
4693
4730
  */
4694
4731
  get responseEnd(): number;
4695
4732
  /**
4696
- * 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.
4733
+ * 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.
4697
4734
  *
4698
4735
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/responseStart)
4699
4736
  */
@@ -4705,39 +4742,39 @@ declare abstract class PerformanceResourceTiming extends PerformanceEntry {
4705
4742
  */
4706
4743
  get responseStatus(): number;
4707
4744
  /**
4708
- * The **`secureConnectionStart`** read-only property returns a DOMHighResTimeStamp immediately before the browser starts the handshake process to secure the current connection.
4745
+ * 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.
4709
4746
  *
4710
4747
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/secureConnectionStart)
4711
4748
  */
4712
4749
  get secureConnectionStart(): number | undefined;
4713
4750
  /**
4714
- * The **`transferSize`** read-only property represents the size (in octets) of the fetched resource.
4751
+ * 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).
4715
4752
  *
4716
4753
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/transferSize)
4717
4754
  */
4718
4755
  get transferSize(): number;
4719
4756
  /**
4720
- * The **`workerStart`** read-only property of the PerformanceResourceTiming interface returns a The `workerStart` property can have the following values: - A DOMHighResTimeStamp.
4757
+ * 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.
4721
4758
  *
4722
4759
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/workerStart)
4723
4760
  */
4724
4761
  get workerStart(): number;
4725
4762
  }
4726
4763
  /**
4727
- * 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_.
4764
+ * 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.
4728
4765
  *
4729
4766
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver)
4730
4767
  */
4731
4768
  declare class PerformanceObserver {
4732
4769
  constructor(callback: any);
4733
4770
  /**
4734
- * The **`disconnect()`** method of the PerformanceObserver interface is used to stop the performance observer from receiving any PerformanceEntry events.
4771
+ * The **`disconnect()`** method of the PerformanceObserver interface is used to stop the performance observer from receiving any performance entry events.
4735
4772
  *
4736
4773
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver/disconnect)
4737
4774
  */
4738
4775
  disconnect(): void;
4739
4776
  /**
4740
- * The **`observe()`** method of the **PerformanceObserver** interface is used to specify the set of performance entry types to observe.
4777
+ * The **`observe()`** method of the PerformanceObserver interface is used to specify the set of performance entry types to observe.
4741
4778
  *
4742
4779
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver/observe)
4743
4780
  */
@@ -5324,10 +5361,7 @@ type AiSearchInstanceInfo = {
5324
5361
  max_num_results?: number;
5325
5362
  cache?: boolean;
5326
5363
  cache_threshold?:
5327
- | "super_strict_match"
5328
- | "close_enough"
5329
- | "flexible_friend"
5330
- | "anything_goes";
5364
+ "super_strict_match" | "close_enough" | "flexible_friend" | "anything_goes";
5331
5365
  custom_metadata?: Array<{
5332
5366
  field_name: string;
5333
5367
  data_type: "text" | "number" | "boolean" | "datetime";
@@ -5405,10 +5439,7 @@ type AiSearchConfig = {
5405
5439
  cache?: boolean;
5406
5440
  /** Similarity threshold for cache hits. Stricter = fewer cache hits but higher relevance. */
5407
5441
  cache_threshold?:
5408
- | "super_strict_match"
5409
- | "close_enough"
5410
- | "flexible_friend"
5411
- | "anything_goes";
5442
+ "super_strict_match" | "close_enough" | "flexible_friend" | "anything_goes";
5412
5443
  custom_metadata?: Array<{
5413
5444
  field_name: string;
5414
5445
  data_type: "text" | "number" | "boolean" | "datetime";
@@ -5454,12 +5485,7 @@ type AiSearchListItemsParams = {
5454
5485
  sort_by?: "status" | "modified_at";
5455
5486
  /** Filter items by processing status. */
5456
5487
  status?:
5457
- | "queued"
5458
- | "running"
5459
- | "completed"
5460
- | "error"
5461
- | "skipped"
5462
- | "outdated";
5488
+ "queued" | "running" | "completed" | "error" | "skipped" | "outdated";
5463
5489
  /** Filter items by source (e.g. "builtin" or "web-crawler:https://example.com"). */
5464
5490
  source?: string;
5465
5491
  /** JSON-encoded Vectorize filter for metadata filtering. */
@@ -6004,11 +6030,7 @@ declare abstract class BaseAiTextEmbeddings {
6004
6030
  }
6005
6031
  type RoleScopedChatInput = {
6006
6032
  role:
6007
- | "user"
6008
- | "assistant"
6009
- | "system"
6010
- | "tool"
6011
- | (string & NonNullable<unknown>);
6033
+ "user" | "assistant" | "system" | "tool" | (string & NonNullable<unknown>);
6012
6034
  content: string;
6013
6035
  name?: string;
6014
6036
  };
@@ -6203,8 +6225,7 @@ type ChatCompletionCustomToolTextFormat = {
6203
6225
  type: "text";
6204
6226
  };
6205
6227
  type ChatCompletionCustomToolFormat =
6206
- | ChatCompletionCustomToolTextFormat
6207
- | ChatCompletionCustomToolGrammarFormat;
6228
+ ChatCompletionCustomToolTextFormat | ChatCompletionCustomToolGrammarFormat;
6208
6229
  type ChatCompletionCustomTool = {
6209
6230
  type: "custom";
6210
6231
  custom: {
@@ -6232,8 +6253,7 @@ type ChatCompletionMessageCustomToolCall = {
6232
6253
  };
6233
6254
  };
6234
6255
  type ChatCompletionMessageToolCall =
6235
- | ChatCompletionMessageFunctionToolCall
6236
- | ChatCompletionMessageCustomToolCall;
6256
+ ChatCompletionMessageFunctionToolCall | ChatCompletionMessageCustomToolCall;
6237
6257
  type ChatCompletionToolChoiceFunction = {
6238
6258
  type: "function";
6239
6259
  function: {
@@ -6512,11 +6532,7 @@ type ChatCompletionChoice = {
6512
6532
  index: number;
6513
6533
  message: ChatCompletionResponseMessage;
6514
6534
  finish_reason:
6515
- | "stop"
6516
- | "length"
6517
- | "tool_calls"
6518
- | "content_filter"
6519
- | "function_call";
6535
+ "stop" | "length" | "tool_calls" | "content_filter" | "function_call";
6520
6536
  logprobs: ChatCompletionLogprobs | null;
6521
6537
  };
6522
6538
  type ChatCompletionsMessagesInput = {
@@ -6711,8 +6727,7 @@ type ResponseFunctionCallArgumentsDoneEvent = {
6711
6727
  type: "response.function_call_arguments.done";
6712
6728
  };
6713
6729
  type ResponseFunctionCallOutputItem =
6714
- | ResponseInputTextContent
6715
- | ResponseInputImageContent;
6730
+ ResponseInputTextContent | ResponseInputImageContent;
6716
6731
  type ResponseFunctionCallOutputItemList = Array<ResponseFunctionCallOutputItem>;
6717
6732
  type ResponseFunctionToolCall = {
6718
6733
  arguments: string;
@@ -6733,8 +6748,7 @@ type ResponseFunctionToolCallOutputItem = {
6733
6748
  status?: "in_progress" | "completed" | "incomplete";
6734
6749
  };
6735
6750
  type ResponseIncludable =
6736
- | "message.input_image.image_url"
6737
- | "message.output_text.logprobs";
6751
+ "message.input_image.image_url" | "message.output_text.logprobs";
6738
6752
  type ResponseIncompleteEvent = {
6739
6753
  response: Response;
6740
6754
  sequence_number: number;
@@ -6800,9 +6814,7 @@ type ResponseItem =
6800
6814
  | ResponseFunctionToolCallItem
6801
6815
  | ResponseFunctionToolCallOutputItem;
6802
6816
  type ResponseOutputItem =
6803
- | ResponseOutputMessage
6804
- | ResponseFunctionToolCall
6805
- | ResponseReasoningItem;
6817
+ ResponseOutputMessage | ResponseFunctionToolCall | ResponseReasoningItem;
6806
6818
  type ResponseOutputItemAddedEvent = {
6807
6819
  item: ResponseOutputItem;
6808
6820
  output_index: number;
@@ -8436,8 +8448,7 @@ declare abstract class Base_Ai_Cf_Qwen_Qwen2_5_Coder_32B_Instruct {
8436
8448
  postProcessedOutputs: Ai_Cf_Qwen_Qwen2_5_Coder_32B_Instruct_Output;
8437
8449
  }
8438
8450
  type Ai_Cf_Qwen_Qwq_32B_Input =
8439
- | Ai_Cf_Qwen_Qwq_32B_Prompt
8440
- | Ai_Cf_Qwen_Qwq_32B_Messages;
8451
+ Ai_Cf_Qwen_Qwq_32B_Prompt | Ai_Cf_Qwen_Qwq_32B_Messages;
8441
8452
  interface Ai_Cf_Qwen_Qwq_32B_Prompt {
8442
8453
  /**
8443
8454
  * The input text prompt for the model to generate a response.
@@ -8984,8 +8995,7 @@ declare abstract class Base_Ai_Cf_Mistralai_Mistral_Small_3_1_24B_Instruct {
8984
8995
  postProcessedOutputs: Ai_Cf_Mistralai_Mistral_Small_3_1_24B_Instruct_Output;
8985
8996
  }
8986
8997
  type Ai_Cf_Google_Gemma_3_12B_It_Input =
8987
- | Ai_Cf_Google_Gemma_3_12B_It_Prompt
8988
- | Ai_Cf_Google_Gemma_3_12B_It_Messages;
8998
+ Ai_Cf_Google_Gemma_3_12B_It_Prompt | Ai_Cf_Google_Gemma_3_12B_It_Messages;
8989
8999
  interface Ai_Cf_Google_Gemma_3_12B_It_Prompt {
8990
9000
  /**
8991
9001
  * The input text prompt for the model to generate a response.
@@ -11524,11 +11534,7 @@ interface Ai_Cf_Deepgram_Flux_Output {
11524
11534
  * The type of event being reported.
11525
11535
  */
11526
11536
  event?:
11527
- | "Update"
11528
- | "StartOfTurn"
11529
- | "EagerEndOfTurn"
11530
- | "TurnResumed"
11531
- | "EndOfTurn";
11537
+ "Update" | "StartOfTurn" | "EagerEndOfTurn" | "TurnResumed" | "EndOfTurn";
11532
11538
  /**
11533
11539
  * The index of the current turn
11534
11540
  */
@@ -12062,8 +12068,7 @@ type AIGatewayProviders =
12062
12068
  | "adobe-firefly";
12063
12069
  type AIGatewayHeaders = {
12064
12070
  "cf-aig-metadata":
12065
- | Record<string, number | string | boolean | null | bigint>
12066
- | string;
12071
+ Record<string, number | string | boolean | null | bigint> | string;
12067
12072
  "cf-aig-custom-cost":
12068
12073
  | {
12069
12074
  per_token_in?: number;
@@ -12486,10 +12491,7 @@ declare abstract class AutoRAG {
12486
12491
  ): Promise<AutoRagAiSearchResponse | Response>;
12487
12492
  }
12488
12493
  type BrowserRunLifecycleEvent =
12489
- | "load"
12490
- | "domcontentloaded"
12491
- | "networkidle0"
12492
- | "networkidle2";
12494
+ "load" | "domcontentloaded" | "networkidle0" | "networkidle2";
12493
12495
  type BrowserRunResourceType =
12494
12496
  | "document"
12495
12497
  | "stylesheet"
@@ -13388,7 +13390,8 @@ interface RequestInitCfPropertiesImageDraw extends BasicImageTransformations {
13388
13390
  /**
13389
13391
  * How to combine the foreground and backdrop pixels to create the result
13390
13392
  */
13391
- composite?: /** Foreground drawn on top of backdrop (default) */
13393
+ composite?:
13394
+ /** Foreground drawn on top of backdrop (default) */
13392
13395
  | "over"
13393
13396
  /** Foreground shown only where backdrop is opaque */
13394
13397
  | "in"
@@ -14195,8 +14198,7 @@ declare type Iso3166Alpha2Code =
14195
14198
  /** The 2-letter continent codes Cloudflare uses */
14196
14199
  declare type ContinentCode = "AF" | "AN" | "AS" | "EU" | "NA" | "OC" | "SA";
14197
14200
  type CfProperties<HostMetadata = unknown> =
14198
- | IncomingRequestCfProperties<HostMetadata>
14199
- | RequestInitCfProperties;
14201
+ IncomingRequestCfProperties<HostMetadata> | RequestInitCfProperties;
14200
14202
  interface D1Meta {
14201
14203
  duration: number;
14202
14204
  size_after: number;
@@ -15191,9 +15193,7 @@ declare namespace Rpc {
15191
15193
  [__WORKFLOW_ENTRYPOINT_BRAND]: never;
15192
15194
  }
15193
15195
  export type EntrypointBranded =
15194
- | WorkerEntrypointBranded
15195
- | DurableObjectBranded
15196
- | WorkflowEntrypointBranded;
15196
+ WorkerEntrypointBranded | DurableObjectBranded | WorkflowEntrypointBranded;
15197
15197
  // Types that can be used through `Stub`s
15198
15198
  export type Stubable = RpcTargetBranded | ((...args: any[]) => any);
15199
15199
  // Types that can be passed over RPC
@@ -15435,16 +15435,9 @@ declare namespace CloudflareWorkersModule {
15435
15435
  webSocketError?(ws: WebSocket, error: unknown): void | Promise<void>;
15436
15436
  }
15437
15437
  export type WorkflowDurationLabel =
15438
- | "second"
15439
- | "minute"
15440
- | "hour"
15441
- | "day"
15442
- | "week"
15443
- | "month"
15444
- | "year";
15438
+ "second" | "minute" | "hour" | "day" | "week" | "month" | "year";
15445
15439
  export type WorkflowSleepDuration =
15446
- | `${number} ${WorkflowDurationLabel}${"s" | ""}`
15447
- | number;
15440
+ `${number} ${WorkflowDurationLabel}${"s" | ""}` | number;
15448
15441
  export type WorkflowDelayDuration = WorkflowSleepDuration;
15449
15442
  export type WorkflowDynamicDelayContext = {
15450
15443
  ctx: WorkflowStepContext<WorkflowDelayFunction>;
@@ -16251,11 +16244,7 @@ type StreamDownloadGetResponse = {
16251
16244
  default?: StreamDownload;
16252
16245
  };
16253
16246
  type StreamWatermarkPosition =
16254
- | "upperRight"
16255
- | "upperLeft"
16256
- | "lowerLeft"
16257
- | "lowerRight"
16258
- | "center";
16247
+ "upperRight" | "upperLeft" | "lowerLeft" | "lowerRight" | "center";
16259
16248
  type StreamWatermark = {
16260
16249
  /**
16261
16250
  * The unique identifier for a watermark profile.
@@ -16739,8 +16728,7 @@ type VectorizeVectorMetadataValue = string | number | boolean | string[];
16739
16728
  * Additional information to associate with a vector.
16740
16729
  */
16741
16730
  type VectorizeVectorMetadata =
16742
- | VectorizeVectorMetadataValue
16743
- | Record<string, VectorizeVectorMetadataValue>;
16731
+ VectorizeVectorMetadataValue | Record<string, VectorizeVectorMetadataValue>;
16744
16732
  type VectorFloatArray = Float32Array | Float64Array;
16745
16733
  interface VectorizeError {
16746
16734
  code?: number;
@@ -16752,12 +16740,7 @@ interface VectorizeError {
16752
16740
  * This list is expected to grow as support for more operations are released.
16753
16741
  */
16754
16742
  type VectorizeVectorMetadataFilterOp =
16755
- | "$eq"
16756
- | "$ne"
16757
- | "$lt"
16758
- | "$lte"
16759
- | "$gt"
16760
- | "$gte";
16743
+ "$eq" | "$ne" | "$lt" | "$lte" | "$gt" | "$gte";
16761
16744
  type VectorizeVectorMetadataFilterCollectionOp = "$in" | "$nin";
16762
16745
  /**
16763
16746
  * Filter criteria for vector metadata used to limit the retrieved query result set.
@@ -17195,16 +17178,9 @@ type WorkflowBatchDeleteResult = {
17195
17178
  }[];
17196
17179
  };
17197
17180
  type WorkflowDurationLabel =
17198
- | "second"
17199
- | "minute"
17200
- | "hour"
17201
- | "day"
17202
- | "week"
17203
- | "month"
17204
- | "year";
17181
+ "second" | "minute" | "hour" | "day" | "week" | "month" | "year";
17205
17182
  type WorkflowSleepDuration =
17206
- | `${number} ${WorkflowDurationLabel}${"s" | ""}`
17207
- | number;
17183
+ `${number} ${WorkflowDurationLabel}${"s" | ""}` | number;
17208
17184
  type WorkflowRetentionDuration = WorkflowSleepDuration;
17209
17185
  interface WorkflowInstanceCreateOptions<PARAMS = unknown> {
17210
17186
  /**