@cloudflare/workers-types 4.20251011.0 → 4.20251106.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,17 +16,26 @@ and limitations under the License.
16
16
  // noinspection JSUnusedGlobalSymbols
17
17
  export declare var onmessage: never;
18
18
  /**
19
- * An abnormal event (called an exception) which 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.
20
20
  *
21
21
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException)
22
22
  */
23
23
  export declare class DOMException extends Error {
24
24
  constructor(message?: string, name?: string);
25
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/message) */
25
+ /**
26
+ * The **`message`** read-only property of the a message or description associated with the given error name.
27
+ *
28
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/message)
29
+ */
26
30
  readonly message: string;
27
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/name) */
31
+ /**
32
+ * The **`name`** read-only property of the one of the strings associated with an error name.
33
+ *
34
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/name)
35
+ */
28
36
  readonly name: string;
29
37
  /**
38
+ * The **`code`** read-only property of the DOMException interface returns one of the legacy error code constants, or `0` if none match.
30
39
  * @deprecated
31
40
  *
32
41
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/code)
@@ -70,45 +79,121 @@ export type WorkerGlobalScopeEventMap = {
70
79
  export declare abstract class WorkerGlobalScope extends EventTarget<WorkerGlobalScopeEventMap> {
71
80
  EventTarget: typeof EventTarget;
72
81
  }
73
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/console) */
82
+ /* The **`console`** object provides access to the debugging console (e.g., the Web console in Firefox). *
83
+ * The **`console`** object provides access to the debugging console (e.g., the Web console in Firefox).
84
+ *
85
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console)
86
+ */
74
87
  export interface Console {
75
88
  "assert"(condition?: boolean, ...data: any[]): void;
76
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/clear_static) */
89
+ /**
90
+ * The **`console.clear()`** static method clears the console if possible.
91
+ *
92
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/clear_static)
93
+ */
77
94
  clear(): void;
78
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/count_static) */
95
+ /**
96
+ * The **`console.count()`** static method logs the number of times that this particular call to `count()` has been called.
97
+ *
98
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/count_static)
99
+ */
79
100
  count(label?: string): void;
80
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/countReset_static) */
101
+ /**
102
+ * The **`console.countReset()`** static method resets counter used with console/count_static.
103
+ *
104
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/countReset_static)
105
+ */
81
106
  countReset(label?: string): void;
82
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/debug_static) */
107
+ /**
108
+ * The **`console.debug()`** static method outputs a message to the console at the 'debug' log level.
109
+ *
110
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/debug_static)
111
+ */
83
112
  debug(...data: any[]): void;
84
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/dir_static) */
113
+ /**
114
+ * The **`console.dir()`** static method displays a list of the properties of the specified JavaScript object.
115
+ *
116
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/dir_static)
117
+ */
85
118
  dir(item?: any, options?: any): void;
86
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/dirxml_static) */
119
+ /**
120
+ * The **`console.dirxml()`** static method displays an interactive tree of the descendant elements of the specified XML/HTML element.
121
+ *
122
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/dirxml_static)
123
+ */
87
124
  dirxml(...data: any[]): void;
88
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/error_static) */
125
+ /**
126
+ * The **`console.error()`** static method outputs a message to the console at the 'error' log level.
127
+ *
128
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/error_static)
129
+ */
89
130
  error(...data: any[]): void;
90
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/group_static) */
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.
133
+ *
134
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/group_static)
135
+ */
91
136
  group(...data: any[]): void;
92
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/groupCollapsed_static) */
137
+ /**
138
+ * The **`console.groupCollapsed()`** static method creates a new inline group in the console.
139
+ *
140
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/groupCollapsed_static)
141
+ */
93
142
  groupCollapsed(...data: any[]): void;
94
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/groupEnd_static) */
143
+ /**
144
+ * The **`console.groupEnd()`** static method exits the current inline group in the console.
145
+ *
146
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/groupEnd_static)
147
+ */
95
148
  groupEnd(): void;
96
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/info_static) */
149
+ /**
150
+ * The **`console.info()`** static method outputs a message to the console at the 'info' log level.
151
+ *
152
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/info_static)
153
+ */
97
154
  info(...data: any[]): void;
98
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/log_static) */
155
+ /**
156
+ * The **`console.log()`** static method outputs a message to the console.
157
+ *
158
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/log_static)
159
+ */
99
160
  log(...data: any[]): void;
100
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/table_static) */
161
+ /**
162
+ * The **`console.table()`** static method displays tabular data as a table.
163
+ *
164
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/table_static)
165
+ */
101
166
  table(tabularData?: any, properties?: string[]): void;
102
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/time_static) */
167
+ /**
168
+ * The **`console.time()`** static method starts a timer you can use to track how long an operation takes.
169
+ *
170
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/time_static)
171
+ */
103
172
  time(label?: string): void;
104
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/timeEnd_static) */
173
+ /**
174
+ * The **`console.timeEnd()`** static method stops a timer that was previously started by calling console/time_static.
175
+ *
176
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/timeEnd_static)
177
+ */
105
178
  timeEnd(label?: string): void;
106
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/timeLog_static) */
179
+ /**
180
+ * The **`console.timeLog()`** static method logs the current value of a timer that was previously started by calling console/time_static.
181
+ *
182
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/timeLog_static)
183
+ */
107
184
  timeLog(label?: string, ...data: any[]): void;
108
185
  timeStamp(label?: string): void;
109
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/trace_static) */
186
+ /**
187
+ * The **`console.trace()`** static method outputs a stack trace to the console.
188
+ *
189
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/trace_static)
190
+ */
110
191
  trace(...data: any[]): void;
111
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/warn_static) */
192
+ /**
193
+ * The **`console.warn()`** static method outputs a warning message to the console at the 'warning' log level.
194
+ *
195
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/warn_static)
196
+ */
112
197
  warn(...data: any[]): void;
113
198
  }
114
199
  export declare const console: Console;
@@ -200,7 +285,7 @@ export declare namespace WebAssembly {
200
285
  function validate(bytes: BufferSource): boolean;
201
286
  }
202
287
  /**
203
- * This ServiceWorker API interface represents the global execution context of a service worker.
288
+ * The **`ServiceWorkerGlobalScope`** interface of the Service Worker API represents the global execution context of a service worker.
204
289
  * Available only in secure contexts.
205
290
  *
206
291
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ServiceWorkerGlobalScope)
@@ -324,7 +409,7 @@ export declare function removeEventListener<
324
409
  options?: EventTargetEventListenerOptions | boolean,
325
410
  ): void;
326
411
  /**
327
- * Dispatches a synthetic event event to target and returns true if either event's cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise.
412
+ * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order.
328
413
  *
329
414
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/dispatchEvent)
330
415
  */
@@ -465,13 +550,6 @@ export interface ExportedHandler<
465
550
  export interface StructuredSerializeOptions {
466
551
  transfer?: any[];
467
552
  }
468
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent) */
469
- export declare abstract class PromiseRejectionEvent extends Event {
470
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/promise) */
471
- readonly promise: Promise<any>;
472
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/reason) */
473
- readonly reason: any;
474
- }
475
553
  export declare abstract class Navigator {
476
554
  sendBeacon(
477
555
  url: string,
@@ -725,116 +803,120 @@ export interface AnalyticsEngineDataPoint {
725
803
  blobs?: ((ArrayBuffer | string) | null)[];
726
804
  }
727
805
  /**
728
- * An event which takes place in the DOM.
806
+ * The **`Event`** interface represents an event which takes place on an `EventTarget`.
729
807
  *
730
808
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event)
731
809
  */
732
810
  export declare class Event {
733
811
  constructor(type: string, init?: EventInit);
734
812
  /**
735
- * Returns the type of event, e.g. "click", "hashchange", or "submit".
813
+ * The **`type`** read-only property of the Event interface returns a string containing the event's type.
736
814
  *
737
815
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/type)
738
816
  */
739
817
  get type(): string;
740
818
  /**
741
- * Returns the event's phase, which is one of NONE, CAPTURING_PHASE, AT_TARGET, and BUBBLING_PHASE.
819
+ * The **`eventPhase`** read-only property of the being evaluated.
742
820
  *
743
821
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/eventPhase)
744
822
  */
745
823
  get eventPhase(): number;
746
824
  /**
747
- * Returns true or false depending on how event was initialized. True if event invokes listeners past a ShadowRoot node that is the root of its target, and false otherwise.
825
+ * The read-only **`composed`** property of the or not the event will propagate across the shadow DOM boundary into the standard DOM.
748
826
  *
749
827
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/composed)
750
828
  */
751
829
  get composed(): boolean;
752
830
  /**
753
- * Returns true or false depending on how event was initialized. True if event goes through its target's ancestors in reverse tree order, and false otherwise.
831
+ * The **`bubbles`** read-only property of the Event interface indicates whether the event bubbles up through the DOM tree or not.
754
832
  *
755
833
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/bubbles)
756
834
  */
757
835
  get bubbles(): boolean;
758
836
  /**
759
- * Returns true or false depending on how event was initialized. Its return value does not always carry meaning, but true can indicate that part of the operation during which event was dispatched, can be canceled by invoking the preventDefault() method.
837
+ * The **`cancelable`** read-only property of the Event interface indicates whether the event can be canceled, and therefore prevented as if the event never happened.
760
838
  *
761
839
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/cancelable)
762
840
  */
763
841
  get cancelable(): boolean;
764
842
  /**
765
- * Returns true if preventDefault() was invoked successfully to indicate cancelation, and false otherwise.
843
+ * The **`defaultPrevented`** read-only property of the Event interface returns a boolean value indicating whether or not the call to Event.preventDefault() canceled the event.
766
844
  *
767
845
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/defaultPrevented)
768
846
  */
769
847
  get defaultPrevented(): boolean;
770
848
  /**
849
+ * The Event property **`returnValue`** indicates whether the default action for this event has been prevented or not.
771
850
  * @deprecated
772
851
  *
773
852
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/returnValue)
774
853
  */
775
854
  get returnValue(): boolean;
776
855
  /**
777
- * Returns the object whose event listener's callback is currently being invoked.
856
+ * The **`currentTarget`** read-only property of the Event interface identifies the element to which the event handler has been attached.
778
857
  *
779
858
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/currentTarget)
780
859
  */
781
860
  get currentTarget(): EventTarget | null;
782
861
  /**
783
- * Returns the object to which event is dispatched (its target).
862
+ * The read-only **`target`** property of the dispatched.
784
863
  *
785
864
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/target)
786
865
  */
787
866
  get target(): EventTarget | undefined;
788
867
  /**
868
+ * The deprecated **`Event.srcElement`** is an alias for the Event.target property.
789
869
  * @deprecated
790
870
  *
791
871
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/srcElement)
792
872
  */
793
873
  get srcElement(): EventTarget | undefined;
794
874
  /**
795
- * Returns the event's timestamp as the number of milliseconds measured relative to the time origin.
875
+ * The **`timeStamp`** read-only property of the Event interface returns the time (in milliseconds) at which the event was created.
796
876
  *
797
877
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/timeStamp)
798
878
  */
799
879
  get timeStamp(): number;
800
880
  /**
801
- * Returns true if event was dispatched by the user agent, and false otherwise.
881
+ * 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.
802
882
  *
803
883
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/isTrusted)
804
884
  */
805
885
  readonly isTrusted: boolean;
806
886
  /**
887
+ * The **`cancelBubble`** property of the Event interface is deprecated.
807
888
  * @deprecated
808
889
  *
809
890
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/cancelBubble)
810
891
  */
811
892
  get cancelBubble(): boolean;
812
893
  /**
894
+ * The **`cancelBubble`** property of the Event interface is deprecated.
813
895
  * @deprecated
814
896
  *
815
897
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/cancelBubble)
816
898
  */
817
899
  set cancelBubble(value: boolean);
818
900
  /**
819
- * Invoking this method prevents event from reaching any registered event listeners after the current one finishes running and, when dispatched in a tree, also prevents event from reaching any other objects.
901
+ * 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.
820
902
  *
821
903
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/stopImmediatePropagation)
822
904
  */
823
905
  stopImmediatePropagation(): void;
824
906
  /**
825
- * If invoked when the cancelable attribute value is true, and while executing a listener for the event with passive set to false, signals to the operation that caused event to be dispatched that it needs to be canceled.
907
+ * 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.
826
908
  *
827
909
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/preventDefault)
828
910
  */
829
911
  preventDefault(): void;
830
912
  /**
831
- * When dispatched in a tree, invoking this method prevents event from reaching any objects other than the current object.
913
+ * The **`stopPropagation()`** method of the Event interface prevents further propagation of the current event in the capturing and bubbling phases.
832
914
  *
833
915
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/stopPropagation)
834
916
  */
835
917
  stopPropagation(): void;
836
918
  /**
837
- * Returns the invocation target objects of event's path (objects on which listeners will be invoked), except for any nodes in shadow trees of which the shadow root's mode is "closed" that are not reachable from event's currentTarget.
919
+ * 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.
838
920
  *
839
921
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/composedPath)
840
922
  */
@@ -859,7 +941,7 @@ export type EventListenerOrEventListenerObject<
859
941
  EventType extends Event = Event,
860
942
  > = EventListener<EventType> | EventListenerObject<EventType>;
861
943
  /**
862
- * EventTarget is a DOM interface implemented by objects that can receive events and may have listeners for them.
944
+ * The **`EventTarget`** interface is implemented by objects that can receive events and may have listeners for them.
863
945
  *
864
946
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget)
865
947
  */
@@ -868,19 +950,7 @@ export declare class EventTarget<
868
950
  > {
869
951
  constructor();
870
952
  /**
871
- * Appends an event listener for events whose type attribute value is type. The callback argument sets the callback that will be invoked when the event is dispatched.
872
- *
873
- * The options argument sets listener-specific options. For compatibility this can be a boolean, in which case the method behaves exactly as if the value was specified as options's capture.
874
- *
875
- * When set to true, options's capture prevents callback from being invoked when the event's eventPhase attribute value is BUBBLING_PHASE. When false (or not present), callback will not be invoked when event's eventPhase attribute value is CAPTURING_PHASE. Either way, callback will be invoked if event's eventPhase attribute value is AT_TARGET.
876
- *
877
- * When set to true, options's passive indicates that the callback will not cancel the event by invoking preventDefault(). This is used to enable performance optimizations described in § 2.8 Observing event listeners.
878
- *
879
- * When set to true, options's once indicates that the callback will only be invoked once after which the event listener will be removed.
880
- *
881
- * If an AbortSignal is passed for options's signal, then the event listener will be removed when signal is aborted.
882
- *
883
- * The event listener is appended to target's event listener list and is not appended if it has the same type, callback, and capture.
953
+ * The **`addEventListener()`** method of the EventTarget interface sets up a function that will be called whenever the specified event is delivered to the target.
884
954
  *
885
955
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/addEventListener)
886
956
  */
@@ -890,7 +960,7 @@ export declare class EventTarget<
890
960
  options?: EventTargetAddEventListenerOptions | boolean,
891
961
  ): void;
892
962
  /**
893
- * Removes the event listener in target's event listener list with the same type, callback, and options.
963
+ * The **`removeEventListener()`** method of the EventTarget interface removes an event listener previously registered with EventTarget.addEventListener() from the target.
894
964
  *
895
965
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/removeEventListener)
896
966
  */
@@ -900,7 +970,7 @@ export declare class EventTarget<
900
970
  options?: EventTargetEventListenerOptions | boolean,
901
971
  ): void;
902
972
  /**
903
- * Dispatches a synthetic event event to target and returns true if either event's cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise.
973
+ * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order.
904
974
  *
905
975
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/dispatchEvent)
906
976
  */
@@ -919,50 +989,70 @@ export interface EventTargetHandlerObject {
919
989
  handleEvent: (event: Event) => any | undefined;
920
990
  }
921
991
  /**
922
- * A controller object that allows you to abort one or more DOM requests as and when desired.
992
+ * The **`AbortController`** interface represents a controller object that allows you to abort one or more Web requests as and when desired.
923
993
  *
924
994
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortController)
925
995
  */
926
996
  export declare class AbortController {
927
997
  constructor();
928
998
  /**
929
- * Returns the AbortSignal object associated with this object.
999
+ * The **`signal`** read-only property of the AbortController interface returns an AbortSignal object instance, which can be used to communicate with/abort an asynchronous operation as desired.
930
1000
  *
931
1001
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortController/signal)
932
1002
  */
933
1003
  get signal(): AbortSignal;
934
1004
  /**
935
- * Invoking this method will set this object's AbortSignal's aborted flag and signal to any observers that the associated activity is to be aborted.
1005
+ * The **`abort()`** method of the AbortController interface aborts an asynchronous operation before it has completed.
936
1006
  *
937
1007
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortController/abort)
938
1008
  */
939
1009
  abort(reason?: any): void;
940
1010
  }
941
1011
  /**
942
- * A signal object that allows you to communicate with a DOM request (such as a Fetch) and abort it if required via an AbortController object.
1012
+ * The **`AbortSignal`** interface represents a signal object that allows you to communicate with an asynchronous operation (such as a fetch request) and abort it if required via an AbortController object.
943
1013
  *
944
1014
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal)
945
1015
  */
946
1016
  export declare abstract class AbortSignal extends EventTarget {
947
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/abort_static) */
1017
+ /**
1018
+ * The **`AbortSignal.abort()`** static method returns an AbortSignal that is already set as aborted (and which does not trigger an AbortSignal/abort_event event).
1019
+ *
1020
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/abort_static)
1021
+ */
948
1022
  static abort(reason?: any): AbortSignal;
949
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/timeout_static) */
1023
+ /**
1024
+ * The **`AbortSignal.timeout()`** static method returns an AbortSignal that will automatically abort after a specified time.
1025
+ *
1026
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/timeout_static)
1027
+ */
950
1028
  static timeout(delay: number): AbortSignal;
951
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/any_static) */
1029
+ /**
1030
+ * The **`AbortSignal.any()`** static method takes an iterable of abort signals and returns an AbortSignal.
1031
+ *
1032
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/any_static)
1033
+ */
952
1034
  static any(signals: AbortSignal[]): AbortSignal;
953
1035
  /**
954
- * Returns true if this AbortSignal's AbortController has signaled to abort, and false otherwise.
1036
+ * 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`).
955
1037
  *
956
1038
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/aborted)
957
1039
  */
958
1040
  get aborted(): boolean;
959
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/reason) */
1041
+ /**
1042
+ * The **`reason`** read-only property returns a JavaScript value that indicates the abort reason.
1043
+ *
1044
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/reason)
1045
+ */
960
1046
  get reason(): any;
961
1047
  /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/abort_event) */
962
1048
  get onabort(): any | null;
963
1049
  /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/abort_event) */
964
1050
  set onabort(value: any | null);
965
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/throwIfAborted) */
1051
+ /**
1052
+ * The **`throwIfAborted()`** method throws the signal's abort AbortSignal.reason if the signal has been aborted; otherwise it does nothing.
1053
+ *
1054
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/throwIfAborted)
1055
+ */
966
1056
  throwIfAborted(): void;
967
1057
  }
968
1058
  export interface Scheduler {
@@ -972,19 +1062,27 @@ export interface SchedulerWaitOptions {
972
1062
  signal?: AbortSignal;
973
1063
  }
974
1064
  /**
975
- * 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.
1065
+ * The **`ExtendableEvent`** interface extends the lifetime of the `install` and `activate` events dispatched on the global scope as part of the service worker lifecycle.
976
1066
  *
977
1067
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ExtendableEvent)
978
1068
  */
979
1069
  export declare abstract class ExtendableEvent extends Event {
980
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ExtendableEvent/waitUntil) */
1070
+ /**
1071
+ * The **`ExtendableEvent.waitUntil()`** method tells the event dispatcher that work is ongoing.
1072
+ *
1073
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ExtendableEvent/waitUntil)
1074
+ */
981
1075
  waitUntil(promise: Promise<any>): void;
982
1076
  }
983
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomEvent) */
1077
+ /**
1078
+ * The **`CustomEvent`** interface represents events initialized by an application for any purpose.
1079
+ *
1080
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomEvent)
1081
+ */
984
1082
  export declare class CustomEvent<T = any> extends Event {
985
1083
  constructor(type: string, init?: CustomEventCustomEventInit);
986
1084
  /**
987
- * Returns any custom data event was created with. Typically used for synthetic events.
1085
+ * The read-only **`detail`** property of the CustomEvent interface returns any data passed when initializing the event.
988
1086
  *
989
1087
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomEvent/detail)
990
1088
  */
@@ -997,7 +1095,7 @@ export interface CustomEventCustomEventInit {
997
1095
  detail?: any;
998
1096
  }
999
1097
  /**
1000
- * A file-like object of immutable, raw data. Blobs represent data that isn't necessarily in a JavaScript-native format. The File interface is based on Blob, inheriting blob functionality and expanding it to support files on the user's system.
1098
+ * The **`Blob`** interface represents a blob, which is a file-like object of immutable, raw data; they can be read as text or binary data, or converted into a ReadableStream so its methods can be used for processing the data.
1001
1099
  *
1002
1100
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob)
1003
1101
  */
@@ -1006,26 +1104,54 @@ export declare class Blob {
1006
1104
  type?: ((ArrayBuffer | ArrayBufferView) | string | Blob)[],
1007
1105
  options?: BlobOptions,
1008
1106
  );
1009
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/size) */
1107
+ /**
1108
+ * The **`size`** read-only property of the Blob interface returns the size of the Blob or File in bytes.
1109
+ *
1110
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/size)
1111
+ */
1010
1112
  get size(): number;
1011
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/type) */
1113
+ /**
1114
+ * The **`type`** read-only property of the Blob interface returns the MIME type of the file.
1115
+ *
1116
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/type)
1117
+ */
1012
1118
  get type(): string;
1013
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/slice) */
1119
+ /**
1120
+ * 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.
1121
+ *
1122
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/slice)
1123
+ */
1014
1124
  slice(start?: number, end?: number, type?: string): Blob;
1015
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/arrayBuffer) */
1125
+ /**
1126
+ * The **`arrayBuffer()`** method of the Blob interface returns a Promise that resolves with the contents of the blob as binary data contained in an ArrayBuffer.
1127
+ *
1128
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/arrayBuffer)
1129
+ */
1016
1130
  arrayBuffer(): Promise<ArrayBuffer>;
1017
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/bytes) */
1131
+ /**
1132
+ * The **`bytes()`** method of the Blob interface returns a Promise that resolves with a Uint8Array containing the contents of the blob as an array of bytes.
1133
+ *
1134
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/bytes)
1135
+ */
1018
1136
  bytes(): Promise<Uint8Array>;
1019
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/text) */
1137
+ /**
1138
+ * The **`text()`** method of the string containing the contents of the blob, interpreted as UTF-8.
1139
+ *
1140
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/text)
1141
+ */
1020
1142
  text(): Promise<string>;
1021
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/stream) */
1143
+ /**
1144
+ * The **`stream()`** method of the Blob interface returns a ReadableStream which upon reading returns the data contained within the `Blob`.
1145
+ *
1146
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/stream)
1147
+ */
1022
1148
  stream(): ReadableStream;
1023
1149
  }
1024
1150
  export interface BlobOptions {
1025
1151
  type?: string;
1026
1152
  }
1027
1153
  /**
1028
- * Provides information about files and allows JavaScript in a web page to access their content.
1154
+ * The **`File`** interface provides information about files and allows JavaScript in a web page to access their content.
1029
1155
  *
1030
1156
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/File)
1031
1157
  */
@@ -1035,9 +1161,17 @@ export declare class File extends Blob {
1035
1161
  name: string,
1036
1162
  options?: FileOptions,
1037
1163
  );
1038
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/name) */
1164
+ /**
1165
+ * The **`name`** read-only property of the File interface returns the name of the file represented by a File object.
1166
+ *
1167
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/name)
1168
+ */
1039
1169
  get name(): string;
1040
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/lastModified) */
1170
+ /**
1171
+ * 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).
1172
+ *
1173
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/lastModified)
1174
+ */
1041
1175
  get lastModified(): number;
1042
1176
  }
1043
1177
  export interface FileOptions {
@@ -1050,7 +1184,11 @@ export interface FileOptions {
1050
1184
  * [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/cache/)
1051
1185
  */
1052
1186
  export declare abstract class CacheStorage {
1053
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CacheStorage/open) */
1187
+ /**
1188
+ * The **`open()`** method of the the Cache object matching the `cacheName`.
1189
+ *
1190
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CacheStorage/open)
1191
+ */
1054
1192
  open(cacheName: string): Promise<Cache>;
1055
1193
  readonly default: Cache;
1056
1194
  }
@@ -1086,12 +1224,17 @@ export interface CacheQueryOptions {
1086
1224
  */
1087
1225
  export declare abstract class Crypto {
1088
1226
  /**
1227
+ * The **`Crypto.subtle`** read-only property returns a cryptographic operations.
1089
1228
  * Available only in secure contexts.
1090
1229
  *
1091
1230
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Crypto/subtle)
1092
1231
  */
1093
1232
  get subtle(): SubtleCrypto;
1094
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Crypto/getRandomValues) */
1233
+ /**
1234
+ * The **`Crypto.getRandomValues()`** method lets you get cryptographically strong random values.
1235
+ *
1236
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Crypto/getRandomValues)
1237
+ */
1095
1238
  getRandomValues<
1096
1239
  T extends
1097
1240
  | Int8Array
@@ -1104,6 +1247,7 @@ export declare abstract class Crypto {
1104
1247
  | BigUint64Array,
1105
1248
  >(buffer: T): T;
1106
1249
  /**
1250
+ * The **`randomUUID()`** method of the Crypto interface is used to generate a v4 UUID using a cryptographically secure random number generator.
1107
1251
  * Available only in secure contexts.
1108
1252
  *
1109
1253
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Crypto/randomUUID)
@@ -1112,49 +1256,77 @@ export declare abstract class Crypto {
1112
1256
  DigestStream: typeof DigestStream;
1113
1257
  }
1114
1258
  /**
1115
- * This Web Crypto API interface provides a number of low-level cryptographic functions. It is accessed via the Crypto.subtle properties available in a window context (via Window.crypto).
1259
+ * The **`SubtleCrypto`** interface of the Web Crypto API provides a number of low-level cryptographic functions.
1116
1260
  * Available only in secure contexts.
1117
1261
  *
1118
1262
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto)
1119
1263
  */
1120
1264
  export declare abstract class SubtleCrypto {
1121
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/encrypt) */
1265
+ /**
1266
+ * The **`encrypt()`** method of the SubtleCrypto interface encrypts data.
1267
+ *
1268
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/encrypt)
1269
+ */
1122
1270
  encrypt(
1123
1271
  algorithm: string | SubtleCryptoEncryptAlgorithm,
1124
1272
  key: CryptoKey,
1125
1273
  plainText: ArrayBuffer | ArrayBufferView,
1126
1274
  ): Promise<ArrayBuffer>;
1127
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/decrypt) */
1275
+ /**
1276
+ * The **`decrypt()`** method of the SubtleCrypto interface decrypts some encrypted data.
1277
+ *
1278
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/decrypt)
1279
+ */
1128
1280
  decrypt(
1129
1281
  algorithm: string | SubtleCryptoEncryptAlgorithm,
1130
1282
  key: CryptoKey,
1131
1283
  cipherText: ArrayBuffer | ArrayBufferView,
1132
1284
  ): Promise<ArrayBuffer>;
1133
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/sign) */
1285
+ /**
1286
+ * The **`sign()`** method of the SubtleCrypto interface generates a digital signature.
1287
+ *
1288
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/sign)
1289
+ */
1134
1290
  sign(
1135
1291
  algorithm: string | SubtleCryptoSignAlgorithm,
1136
1292
  key: CryptoKey,
1137
1293
  data: ArrayBuffer | ArrayBufferView,
1138
1294
  ): Promise<ArrayBuffer>;
1139
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/verify) */
1295
+ /**
1296
+ * The **`verify()`** method of the SubtleCrypto interface verifies a digital signature.
1297
+ *
1298
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/verify)
1299
+ */
1140
1300
  verify(
1141
1301
  algorithm: string | SubtleCryptoSignAlgorithm,
1142
1302
  key: CryptoKey,
1143
1303
  signature: ArrayBuffer | ArrayBufferView,
1144
1304
  data: ArrayBuffer | ArrayBufferView,
1145
1305
  ): Promise<boolean>;
1146
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/digest) */
1306
+ /**
1307
+ * The **`digest()`** method of the SubtleCrypto interface generates a _digest_ of the given data, using the specified hash function.
1308
+ *
1309
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/digest)
1310
+ */
1147
1311
  digest(
1148
1312
  algorithm: string | SubtleCryptoHashAlgorithm,
1149
1313
  data: ArrayBuffer | ArrayBufferView,
1150
1314
  ): Promise<ArrayBuffer>;
1151
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/generateKey) */
1315
+ /**
1316
+ * The **`generateKey()`** method of the SubtleCrypto interface is used to generate a new key (for symmetric algorithms) or key pair (for public-key algorithms).
1317
+ *
1318
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/generateKey)
1319
+ */
1152
1320
  generateKey(
1153
1321
  algorithm: string | SubtleCryptoGenerateKeyAlgorithm,
1154
1322
  extractable: boolean,
1155
1323
  keyUsages: string[],
1156
1324
  ): Promise<CryptoKey | CryptoKeyPair>;
1157
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/deriveKey) */
1325
+ /**
1326
+ * The **`deriveKey()`** method of the SubtleCrypto interface can be used to derive a secret key from a master key.
1327
+ *
1328
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/deriveKey)
1329
+ */
1158
1330
  deriveKey(
1159
1331
  algorithm: string | SubtleCryptoDeriveKeyAlgorithm,
1160
1332
  baseKey: CryptoKey,
@@ -1162,13 +1334,21 @@ export declare abstract class SubtleCrypto {
1162
1334
  extractable: boolean,
1163
1335
  keyUsages: string[],
1164
1336
  ): Promise<CryptoKey>;
1165
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/deriveBits) */
1337
+ /**
1338
+ * The **`deriveBits()`** method of the key.
1339
+ *
1340
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/deriveBits)
1341
+ */
1166
1342
  deriveBits(
1167
1343
  algorithm: string | SubtleCryptoDeriveKeyAlgorithm,
1168
1344
  baseKey: CryptoKey,
1169
1345
  length?: number | null,
1170
1346
  ): Promise<ArrayBuffer>;
1171
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/importKey) */
1347
+ /**
1348
+ * The **`importKey()`** method of the SubtleCrypto interface imports a key: that is, it takes as input a key in an external, portable format and gives you a CryptoKey object that you can use in the Web Crypto API.
1349
+ *
1350
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/importKey)
1351
+ */
1172
1352
  importKey(
1173
1353
  format: string,
1174
1354
  keyData: (ArrayBuffer | ArrayBufferView) | JsonWebKey,
@@ -1176,16 +1356,28 @@ export declare abstract class SubtleCrypto {
1176
1356
  extractable: boolean,
1177
1357
  keyUsages: string[],
1178
1358
  ): Promise<CryptoKey>;
1179
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/exportKey) */
1359
+ /**
1360
+ * The **`exportKey()`** method of the SubtleCrypto interface exports a key: that is, it takes as input a CryptoKey object and gives you the key in an external, portable format.
1361
+ *
1362
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/exportKey)
1363
+ */
1180
1364
  exportKey(format: string, key: CryptoKey): Promise<ArrayBuffer | JsonWebKey>;
1181
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/wrapKey) */
1365
+ /**
1366
+ * The **`wrapKey()`** method of the SubtleCrypto interface 'wraps' a key.
1367
+ *
1368
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/wrapKey)
1369
+ */
1182
1370
  wrapKey(
1183
1371
  format: string,
1184
1372
  key: CryptoKey,
1185
1373
  wrappingKey: CryptoKey,
1186
1374
  wrapAlgorithm: string | SubtleCryptoEncryptAlgorithm,
1187
1375
  ): Promise<ArrayBuffer>;
1188
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/unwrapKey) */
1376
+ /**
1377
+ * The **`unwrapKey()`** method of the SubtleCrypto interface 'unwraps' a key.
1378
+ *
1379
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/unwrapKey)
1380
+ */
1189
1381
  unwrapKey(
1190
1382
  format: string,
1191
1383
  wrappedKey: ArrayBuffer | ArrayBufferView,
@@ -1201,17 +1393,29 @@ export declare abstract class SubtleCrypto {
1201
1393
  ): boolean;
1202
1394
  }
1203
1395
  /**
1204
- * The CryptoKey dictionary of the Web Crypto API represents a cryptographic key.
1396
+ * 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.
1205
1397
  * Available only in secure contexts.
1206
1398
  *
1207
1399
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey)
1208
1400
  */
1209
1401
  export declare abstract class CryptoKey {
1210
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/type) */
1402
+ /**
1403
+ * The read-only **`type`** property of the CryptoKey interface indicates which kind of key is represented by the object.
1404
+ *
1405
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/type)
1406
+ */
1211
1407
  readonly type: string;
1212
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/extractable) */
1408
+ /**
1409
+ * The read-only **`extractable`** property of the CryptoKey interface indicates whether or not the key may be extracted using `SubtleCrypto.exportKey()` or `SubtleCrypto.wrapKey()`.
1410
+ *
1411
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/extractable)
1412
+ */
1213
1413
  readonly extractable: boolean;
1214
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/algorithm) */
1414
+ /**
1415
+ * The read-only **`algorithm`** property of the CryptoKey interface returns an object describing the algorithm for which this key can be used, and any associated extra parameters.
1416
+ *
1417
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/algorithm)
1418
+ */
1215
1419
  readonly algorithm:
1216
1420
  | CryptoKeyKeyAlgorithm
1217
1421
  | CryptoKeyAesKeyAlgorithm
@@ -1219,7 +1423,11 @@ export declare abstract class CryptoKey {
1219
1423
  | CryptoKeyRsaKeyAlgorithm
1220
1424
  | CryptoKeyEllipticKeyAlgorithm
1221
1425
  | CryptoKeyArbitraryKeyAlgorithm;
1222
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/usages) */
1426
+ /**
1427
+ * The read-only **`usages`** property of the CryptoKey interface indicates what can be done with the key.
1428
+ *
1429
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/usages)
1430
+ */
1223
1431
  readonly usages: string[];
1224
1432
  }
1225
1433
  export interface CryptoKeyPair {
@@ -1328,24 +1536,14 @@ export declare class DigestStream extends WritableStream<
1328
1536
  get bytesWritten(): number | bigint;
1329
1537
  }
1330
1538
  /**
1331
- * A decoder for a specific method, that is a specific character encoding, like utf-8, iso-8859-2, koi8, cp1261, gbk, etc. A decoder takes a stream of bytes as input and emits a stream of code points. For a more scalable, non-native library, see StringView – a C-like representation of strings based on typed arrays.
1539
+ * The **`TextDecoder`** interface represents a decoder for a specific text encoding, such as `UTF-8`, `ISO-8859-2`, `KOI8-R`, `GBK`, etc.
1332
1540
  *
1333
1541
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoder)
1334
1542
  */
1335
1543
  export declare class TextDecoder {
1336
1544
  constructor(label?: string, options?: TextDecoderConstructorOptions);
1337
1545
  /**
1338
- * Returns the result of running encoding's decoder. The method can be invoked zero or more times with options's stream set to true, and then once without options's stream (or set to false), to process a fragmented input. If the invocation without options's stream (or set to false) has no input, it's clearest to omit both arguments.
1339
- *
1340
- * ```
1341
- * var string = "", decoder = new TextDecoder(encoding), buffer;
1342
- * while(buffer = next_chunk()) {
1343
- * string += decoder.decode(buffer, {stream:true});
1344
- * }
1345
- * string += decoder.decode(); // end-of-queue
1346
- * ```
1347
- *
1348
- * If the error mode is "fatal" and encoding's decoder returns error, throws a TypeError.
1546
+ * The **`TextDecoder.decode()`** method returns a string containing text decoded from the buffer passed as a parameter.
1349
1547
  *
1350
1548
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoder/decode)
1351
1549
  */
@@ -1358,27 +1556,24 @@ export declare class TextDecoder {
1358
1556
  get ignoreBOM(): boolean;
1359
1557
  }
1360
1558
  /**
1361
- * TextEncoder takes a stream of code points as input and emits a stream of bytes. For a more scalable, non-native library, see StringView – a C-like representation of strings based on typed arrays.
1559
+ * The **`TextEncoder`** interface takes a stream of code points as input and emits a stream of UTF-8 bytes.
1362
1560
  *
1363
1561
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder)
1364
1562
  */
1365
1563
  export declare class TextEncoder {
1366
1564
  constructor();
1367
1565
  /**
1368
- * Returns the result of running UTF-8's encoder.
1566
+ * 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.
1369
1567
  *
1370
1568
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encode)
1371
1569
  */
1372
1570
  encode(input?: string): Uint8Array;
1373
1571
  /**
1374
- * Runs the UTF-8 encoder on source, stores the result of that operation into destination, and returns the progress made as an object wherein read is the number of converted code units of source and written is the number of bytes modified in destination.
1572
+ * 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.
1375
1573
  *
1376
1574
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encodeInto)
1377
1575
  */
1378
- encodeInto(
1379
- input: string,
1380
- buffer: ArrayBuffer | ArrayBufferView,
1381
- ): TextEncoderEncodeIntoResult;
1576
+ encodeInto(input: string, buffer: Uint8Array): TextEncoderEncodeIntoResult;
1382
1577
  get encoding(): string;
1383
1578
  }
1384
1579
  export interface TextDecoderConstructorOptions {
@@ -1393,21 +1588,41 @@ export interface TextEncoderEncodeIntoResult {
1393
1588
  written: number;
1394
1589
  }
1395
1590
  /**
1396
- * Events providing information related to errors in scripts or in files.
1591
+ * The **`ErrorEvent`** interface represents events providing information related to errors in scripts or in files.
1397
1592
  *
1398
1593
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent)
1399
1594
  */
1400
1595
  export declare class ErrorEvent extends Event {
1401
1596
  constructor(type: string, init?: ErrorEventErrorEventInit);
1402
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/filename) */
1597
+ /**
1598
+ * The **`filename`** read-only property of the ErrorEvent interface returns a string containing the name of the script file in which the error occurred.
1599
+ *
1600
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/filename)
1601
+ */
1403
1602
  get filename(): string;
1404
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/message) */
1603
+ /**
1604
+ * The **`message`** read-only property of the ErrorEvent interface returns a string containing a human-readable error message describing the problem.
1605
+ *
1606
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/message)
1607
+ */
1405
1608
  get message(): string;
1406
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/lineno) */
1609
+ /**
1610
+ * The **`lineno`** read-only property of the ErrorEvent interface returns an integer containing the line number of the script file on which the error occurred.
1611
+ *
1612
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/lineno)
1613
+ */
1407
1614
  get lineno(): number;
1408
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/colno) */
1615
+ /**
1616
+ * The **`colno`** read-only property of the ErrorEvent interface returns an integer containing the column number of the script file on which the error occurred.
1617
+ *
1618
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/colno)
1619
+ */
1409
1620
  get colno(): number;
1410
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/error) */
1621
+ /**
1622
+ * The **`error`** read-only property of the ErrorEvent interface returns a JavaScript value, such as an Error or DOMException, representing the error associated with this event.
1623
+ *
1624
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/error)
1625
+ */
1411
1626
  get error(): any;
1412
1627
  }
1413
1628
  export interface ErrorEventErrorEventInit {
@@ -1418,38 +1633,38 @@ export interface ErrorEventErrorEventInit {
1418
1633
  error?: any;
1419
1634
  }
1420
1635
  /**
1421
- * A message received by a target object.
1636
+ * The **`MessageEvent`** interface represents a message received by a target object.
1422
1637
  *
1423
1638
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent)
1424
1639
  */
1425
1640
  export declare class MessageEvent extends Event {
1426
1641
  constructor(type: string, initializer: MessageEventInit);
1427
1642
  /**
1428
- * Returns the data of the message.
1643
+ * 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.
1429
1644
  *
1430
1645
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/data)
1431
1646
  */
1432
1647
  readonly data: any;
1433
1648
  /**
1434
- * Returns the origin of the message, for server-sent events and cross-document messaging.
1649
+ * The **`origin`** read-only property of the origin of the message emitter.
1435
1650
  *
1436
1651
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/origin)
1437
1652
  */
1438
1653
  readonly origin: string | null;
1439
1654
  /**
1440
- * Returns the last event ID string, for server-sent events.
1655
+ * The **`lastEventId`** read-only property of the unique ID for the event.
1441
1656
  *
1442
1657
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/lastEventId)
1443
1658
  */
1444
1659
  readonly lastEventId: string;
1445
1660
  /**
1446
- * Returns the WindowProxy of the source window, for cross-document messaging, and the MessagePort being attached, in the connect event fired at SharedWorkerGlobalScope objects.
1661
+ * The **`source`** read-only property of the a WindowProxy, MessagePort, or a `MessageEventSource` (which can be a WindowProxy, message emitter.
1447
1662
  *
1448
1663
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/source)
1449
1664
  */
1450
1665
  readonly source: MessagePort | null;
1451
1666
  /**
1452
- * Returns the MessagePort array sent with the message, for cross-document messaging and channel messaging.
1667
+ * The **`ports`** read-only property of the containing all MessagePort objects sent with the message, in order.
1453
1668
  *
1454
1669
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/ports)
1455
1670
  */
@@ -1459,27 +1674,78 @@ export interface MessageEventInit {
1459
1674
  data: ArrayBuffer | string;
1460
1675
  }
1461
1676
  /**
1462
- * Provides a way to easily construct a set of key/value pairs representing form fields and their values, which can then be easily sent using the XMLHttpRequest.send() method. It uses the same format a form would use if the encoding type were set to "multipart/form-data".
1677
+ * The **`PromiseRejectionEvent`** interface represents events which are sent to the global script context when JavaScript Promises are rejected.
1678
+ *
1679
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent)
1680
+ */
1681
+ export declare abstract class PromiseRejectionEvent extends Event {
1682
+ /**
1683
+ * The PromiseRejectionEvent interface's **`promise`** read-only property indicates the JavaScript rejected.
1684
+ *
1685
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/promise)
1686
+ */
1687
+ readonly promise: Promise<any>;
1688
+ /**
1689
+ * The PromiseRejectionEvent **`reason`** read-only property is any JavaScript value or Object which provides the reason passed into Promise.reject().
1690
+ *
1691
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/reason)
1692
+ */
1693
+ readonly reason: any;
1694
+ }
1695
+ /**
1696
+ * 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.
1463
1697
  *
1464
1698
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData)
1465
1699
  */
1466
1700
  export declare class FormData {
1467
1701
  constructor();
1468
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/append) */
1702
+ /**
1703
+ * 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.
1704
+ *
1705
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/append)
1706
+ */
1469
1707
  append(name: string, value: string): void;
1470
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/append) */
1708
+ /**
1709
+ * 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.
1710
+ *
1711
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/append)
1712
+ */
1471
1713
  append(name: string, value: Blob, filename?: string): void;
1472
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/delete) */
1714
+ /**
1715
+ * The **`delete()`** method of the FormData interface deletes a key and its value(s) from a `FormData` object.
1716
+ *
1717
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/delete)
1718
+ */
1473
1719
  delete(name: string): void;
1474
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/get) */
1720
+ /**
1721
+ * The **`get()`** method of the FormData interface returns the first value associated with a given key from within a `FormData` object.
1722
+ *
1723
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/get)
1724
+ */
1475
1725
  get(name: string): (File | string) | null;
1476
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/getAll) */
1726
+ /**
1727
+ * The **`getAll()`** method of the FormData interface returns all the values associated with a given key from within a `FormData` object.
1728
+ *
1729
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/getAll)
1730
+ */
1477
1731
  getAll(name: string): (File | string)[];
1478
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/has) */
1732
+ /**
1733
+ * The **`has()`** method of the FormData interface returns whether a `FormData` object contains a certain key.
1734
+ *
1735
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/has)
1736
+ */
1479
1737
  has(name: string): boolean;
1480
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/set) */
1738
+ /**
1739
+ * 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.
1740
+ *
1741
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/set)
1742
+ */
1481
1743
  set(name: string, value: string): void;
1482
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/set) */
1744
+ /**
1745
+ * 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.
1746
+ *
1747
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/set)
1748
+ */
1483
1749
  set(name: string, value: Blob, filename?: string): void;
1484
1750
  /* Returns an array of key, value pairs for every entry in the list. */
1485
1751
  entries(): IterableIterator<[key: string, value: File | string]>;
@@ -1605,14 +1871,22 @@ export interface DocumentEnd {
1605
1871
  append(content: string, options?: ContentOptions): DocumentEnd;
1606
1872
  }
1607
1873
  /**
1608
- * 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.
1874
+ * This is the event type for `fetch` events dispatched on the ServiceWorkerGlobalScope.
1609
1875
  *
1610
1876
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent)
1611
1877
  */
1612
1878
  export declare abstract class FetchEvent extends ExtendableEvent {
1613
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent/request) */
1879
+ /**
1880
+ * The **`request`** read-only property of the the event handler.
1881
+ *
1882
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent/request)
1883
+ */
1614
1884
  readonly request: Request;
1615
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent/respondWith) */
1885
+ /**
1886
+ * The **`respondWith()`** method of allows you to provide a promise for a Response yourself.
1887
+ *
1888
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent/respondWith)
1889
+ */
1616
1890
  respondWith(promise: Response | Promise<Response>): void;
1617
1891
  passThroughOnException(): void;
1618
1892
  }
@@ -1621,24 +1895,48 @@ export type HeadersInit =
1621
1895
  | Iterable<Iterable<string>>
1622
1896
  | Record<string, string>;
1623
1897
  /**
1624
- * This Fetch API interface allows you to perform various actions on HTTP request and response headers. These actions include retrieving, setting, adding to, and removing. A Headers object has an associated header list, which is initially empty and consists of zero or more name and value pairs.  You can add to this using methods like append() (see Examples.) In all methods of this interface, header names are matched by case-insensitive byte sequence.
1898
+ * The **`Headers`** interface of the Fetch API allows you to perform various actions on HTTP request and response headers.
1625
1899
  *
1626
1900
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers)
1627
1901
  */
1628
1902
  export declare class Headers {
1629
1903
  constructor(init?: HeadersInit);
1630
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/get) */
1904
+ /**
1905
+ * 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.
1906
+ *
1907
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/get)
1908
+ */
1631
1909
  get(name: string): string | null;
1632
1910
  getAll(name: string): string[];
1633
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/getSetCookie) */
1911
+ /**
1912
+ * The **`getSetCookie()`** method of the Headers interface returns an array containing the values of all Set-Cookie headers associated with a response.
1913
+ *
1914
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/getSetCookie)
1915
+ */
1634
1916
  getSetCookie(): string[];
1635
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/has) */
1917
+ /**
1918
+ * The **`has()`** method of the Headers interface returns a boolean stating whether a `Headers` object contains a certain header.
1919
+ *
1920
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/has)
1921
+ */
1636
1922
  has(name: string): boolean;
1637
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/set) */
1923
+ /**
1924
+ * 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.
1925
+ *
1926
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/set)
1927
+ */
1638
1928
  set(name: string, value: string): void;
1639
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/append) */
1929
+ /**
1930
+ * 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.
1931
+ *
1932
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/append)
1933
+ */
1640
1934
  append(name: string, value: string): void;
1641
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/delete) */
1935
+ /**
1936
+ * The **`delete()`** method of the Headers interface deletes a header from the current `Headers` object.
1937
+ *
1938
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/delete)
1939
+ */
1642
1940
  delete(name: string): void;
1643
1941
  forEach<This = unknown>(
1644
1942
  callback: (this: This, value: string, key: string, parent: Headers) => void,
@@ -1679,7 +1977,7 @@ export declare abstract class Body {
1679
1977
  blob(): Promise<Blob>;
1680
1978
  }
1681
1979
  /**
1682
- * This Fetch API interface represents the response to a request.
1980
+ * The **`Response`** interface of the Fetch API represents the response to a request.
1683
1981
  *
1684
1982
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response)
1685
1983
  */
@@ -1691,28 +1989,60 @@ export declare var Response: {
1691
1989
  json(any: any, maybeInit?: ResponseInit | Response): Response;
1692
1990
  };
1693
1991
  /**
1694
- * This Fetch API interface represents the response to a request.
1992
+ * The **`Response`** interface of the Fetch API represents the response to a request.
1695
1993
  *
1696
1994
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response)
1697
1995
  */
1698
1996
  export interface Response extends Body {
1699
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/clone) */
1997
+ /**
1998
+ * The **`clone()`** method of the Response interface creates a clone of a response object, identical in every way, but stored in a different variable.
1999
+ *
2000
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/clone)
2001
+ */
1700
2002
  clone(): Response;
1701
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/status) */
2003
+ /**
2004
+ * The **`status`** read-only property of the Response interface contains the HTTP status codes of the response.
2005
+ *
2006
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/status)
2007
+ */
1702
2008
  status: number;
1703
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/statusText) */
2009
+ /**
2010
+ * The **`statusText`** read-only property of the Response interface contains the status message corresponding to the HTTP status code in Response.status.
2011
+ *
2012
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/statusText)
2013
+ */
1704
2014
  statusText: string;
1705
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/headers) */
2015
+ /**
2016
+ * The **`headers`** read-only property of the with the response.
2017
+ *
2018
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/headers)
2019
+ */
1706
2020
  headers: Headers;
1707
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/ok) */
2021
+ /**
2022
+ * The **`ok`** read-only property of the Response interface contains a Boolean stating whether the response was successful (status in the range 200-299) or not.
2023
+ *
2024
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/ok)
2025
+ */
1708
2026
  ok: boolean;
1709
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/redirected) */
2027
+ /**
2028
+ * The **`redirected`** read-only property of the Response interface indicates whether or not the response is the result of a request you made which was redirected.
2029
+ *
2030
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/redirected)
2031
+ */
1710
2032
  redirected: boolean;
1711
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/url) */
2033
+ /**
2034
+ * The **`url`** read-only property of the Response interface contains the URL of the response.
2035
+ *
2036
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/url)
2037
+ */
1712
2038
  url: string;
1713
2039
  webSocket: WebSocket | null;
1714
2040
  cf: any | undefined;
1715
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/type) */
2041
+ /**
2042
+ * The **`type`** read-only property of the Response interface contains the type of the response.
2043
+ *
2044
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/type)
2045
+ */
1716
2046
  type: "default" | "error";
1717
2047
  }
1718
2048
  export interface ResponseInit {
@@ -1728,7 +2058,7 @@ export type RequestInfo<
1728
2058
  Cf = CfProperties<CfHostMetadata>,
1729
2059
  > = Request<CfHostMetadata, Cf> | string;
1730
2060
  /**
1731
- * This Fetch API interface represents a resource request.
2061
+ * The **`Request`** interface of the Fetch API represents a resource request.
1732
2062
  *
1733
2063
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request)
1734
2064
  */
@@ -1740,7 +2070,7 @@ export declare var Request: {
1740
2070
  ): Request<CfHostMetadata, Cf>;
1741
2071
  };
1742
2072
  /**
1743
- * This Fetch API interface represents a resource request.
2073
+ * The **`Request`** interface of the Fetch API represents a resource request.
1744
2074
  *
1745
2075
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request)
1746
2076
  */
@@ -1748,58 +2078,62 @@ export interface Request<
1748
2078
  CfHostMetadata = unknown,
1749
2079
  Cf = CfProperties<CfHostMetadata>,
1750
2080
  > extends Body {
1751
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/clone) */
2081
+ /**
2082
+ * The **`clone()`** method of the Request interface creates a copy of the current `Request` object.
2083
+ *
2084
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/clone)
2085
+ */
1752
2086
  clone(): Request<CfHostMetadata, Cf>;
1753
2087
  /**
1754
- * Returns request's HTTP method, which is "GET" by default.
2088
+ * The **`method`** read-only property of the `POST`, etc.) A String indicating the method of the request.
1755
2089
  *
1756
2090
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/method)
1757
2091
  */
1758
2092
  method: string;
1759
2093
  /**
1760
- * Returns the URL of request as a string.
2094
+ * The **`url`** read-only property of the Request interface contains the URL of the request.
1761
2095
  *
1762
2096
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/url)
1763
2097
  */
1764
2098
  url: string;
1765
2099
  /**
1766
- * Returns a Headers object consisting of the headers associated with request. Note that headers added in the network layer by the user agent will not be accounted for in this object, e.g., the "Host" header.
2100
+ * The **`headers`** read-only property of the with the request.
1767
2101
  *
1768
2102
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/headers)
1769
2103
  */
1770
2104
  headers: Headers;
1771
2105
  /**
1772
- * Returns the redirect mode associated with request, which is a string indicating how redirects for the request will be handled during fetching. A request will follow redirects by default.
2106
+ * The **`redirect`** read-only property of the Request interface contains the mode for how redirects are handled.
1773
2107
  *
1774
2108
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/redirect)
1775
2109
  */
1776
2110
  redirect: string;
1777
2111
  fetcher: Fetcher | null;
1778
2112
  /**
1779
- * Returns the signal associated with request, which is an AbortSignal object indicating whether or not request has been aborted, and its abort event handler.
2113
+ * The read-only **`signal`** property of the Request interface returns the AbortSignal associated with the request.
1780
2114
  *
1781
2115
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/signal)
1782
2116
  */
1783
2117
  signal: AbortSignal;
1784
2118
  cf: Cf | undefined;
1785
2119
  /**
1786
- * Returns request's subresource integrity metadata, which is a cryptographic hash of the resource being fetched. Its value consists of multiple hashes separated by whitespace. [SRI]
2120
+ * The **`integrity`** read-only property of the Request interface contains the subresource integrity value of the request.
1787
2121
  *
1788
2122
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/integrity)
1789
2123
  */
1790
2124
  integrity: string;
1791
2125
  /**
1792
- * Returns a boolean indicating whether or not request can outlive the global in which it was created.
2126
+ * 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.
1793
2127
  *
1794
2128
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/keepalive)
1795
2129
  */
1796
2130
  keepalive: boolean;
1797
2131
  /**
1798
- * Returns the cache mode associated with request, which is a string indicating how the request will interact with the browser's cache when fetching.
2132
+ * The **`cache`** read-only property of the Request interface contains the cache mode of the request.
1799
2133
  *
1800
2134
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/cache)
1801
2135
  */
1802
- cache?: "no-store" | "no-cache";
2136
+ cache?: "no-store" | "no-cache" | "reload";
1803
2137
  }
1804
2138
  export interface RequestInit<Cf = CfProperties> {
1805
2139
  /* A string to set request's method. */
@@ -1813,7 +2147,7 @@ export interface RequestInit<Cf = CfProperties> {
1813
2147
  fetcher?: Fetcher | null;
1814
2148
  cf?: Cf;
1815
2149
  /* A string indicating how the request will interact with the browser's cache to set request's cache. */
1816
- cache?: "no-store" | "no-cache";
2150
+ cache?: "no-store" | "no-cache" | "reload";
1817
2151
  /* A cryptographic hash of the resource to be fetched by request. Sets request's integrity. */
1818
2152
  integrity?: string;
1819
2153
  /* An AbortSignal to set request's signal. */
@@ -2353,30 +2687,58 @@ export type ReadableStreamReadResult<R = any> =
2353
2687
  value?: undefined;
2354
2688
  };
2355
2689
  /**
2356
- * This Streams API interface 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.
2690
+ * The `ReadableStream` interface of the Streams API represents a readable stream of byte data.
2357
2691
  *
2358
2692
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream)
2359
2693
  */
2360
2694
  export interface ReadableStream<R = any> {
2361
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/locked) */
2695
+ /**
2696
+ * The **`locked`** read-only property of the ReadableStream interface returns whether or not the readable stream is locked to a reader.
2697
+ *
2698
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/locked)
2699
+ */
2362
2700
  get locked(): boolean;
2363
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/cancel) */
2701
+ /**
2702
+ * The **`cancel()`** method of the ReadableStream interface returns a Promise that resolves when the stream is canceled.
2703
+ *
2704
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/cancel)
2705
+ */
2364
2706
  cancel(reason?: any): Promise<void>;
2365
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/getReader) */
2707
+ /**
2708
+ * The **`getReader()`** method of the ReadableStream interface creates a reader and locks the stream to it.
2709
+ *
2710
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/getReader)
2711
+ */
2366
2712
  getReader(): ReadableStreamDefaultReader<R>;
2367
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/getReader) */
2713
+ /**
2714
+ * The **`getReader()`** method of the ReadableStream interface creates a reader and locks the stream to it.
2715
+ *
2716
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/getReader)
2717
+ */
2368
2718
  getReader(options: ReadableStreamGetReaderOptions): ReadableStreamBYOBReader;
2369
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/pipeThrough) */
2719
+ /**
2720
+ * The **`pipeThrough()`** method of the ReadableStream interface provides a chainable way of piping the current stream through a transform stream or any other writable/readable pair.
2721
+ *
2722
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/pipeThrough)
2723
+ */
2370
2724
  pipeThrough<T>(
2371
2725
  transform: ReadableWritablePair<T, R>,
2372
2726
  options?: StreamPipeOptions,
2373
2727
  ): ReadableStream<T>;
2374
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/pipeTo) */
2728
+ /**
2729
+ * 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.
2730
+ *
2731
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/pipeTo)
2732
+ */
2375
2733
  pipeTo(
2376
2734
  destination: WritableStream<R>,
2377
2735
  options?: StreamPipeOptions,
2378
2736
  ): Promise<void>;
2379
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/tee) */
2737
+ /**
2738
+ * The **`tee()`** method of the two-element array containing the two resulting branches as new ReadableStream instances.
2739
+ *
2740
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/tee)
2741
+ */
2380
2742
  tee(): [ReadableStream<R>, ReadableStream<R>];
2381
2743
  values(options?: ReadableStreamValuesOptions): AsyncIterableIterator<R>;
2382
2744
  [Symbol.asyncIterator](
@@ -2384,7 +2746,7 @@ export interface ReadableStream<R = any> {
2384
2746
  ): AsyncIterableIterator<R>;
2385
2747
  }
2386
2748
  /**
2387
- * This Streams API interface 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.
2749
+ * The `ReadableStream` interface of the Streams API represents a readable stream of byte data.
2388
2750
  *
2389
2751
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream)
2390
2752
  */
@@ -2399,26 +2761,50 @@ export declare const ReadableStream: {
2399
2761
  strategy?: QueuingStrategy<R>,
2400
2762
  ): ReadableStream<R>;
2401
2763
  };
2402
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultReader) */
2764
+ /**
2765
+ * The **`ReadableStreamDefaultReader`** interface of the Streams API represents a default reader that can be used to read stream data supplied from a network (such as a fetch request).
2766
+ *
2767
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultReader)
2768
+ */
2403
2769
  export declare class ReadableStreamDefaultReader<R = any> {
2404
2770
  constructor(stream: ReadableStream);
2405
2771
  get closed(): Promise<void>;
2406
2772
  cancel(reason?: any): Promise<void>;
2407
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultReader/read) */
2773
+ /**
2774
+ * The **`read()`** method of the ReadableStreamDefaultReader interface returns a Promise providing access to the next chunk in the stream's internal queue.
2775
+ *
2776
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultReader/read)
2777
+ */
2408
2778
  read(): Promise<ReadableStreamReadResult<R>>;
2409
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultReader/releaseLock) */
2779
+ /**
2780
+ * The **`releaseLock()`** method of the ReadableStreamDefaultReader interface releases the reader's lock on the stream.
2781
+ *
2782
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultReader/releaseLock)
2783
+ */
2410
2784
  releaseLock(): void;
2411
2785
  }
2412
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader) */
2786
+ /**
2787
+ * The `ReadableStreamBYOBReader` interface of the Streams API defines a reader for a ReadableStream that supports zero-copy reading from an underlying byte source.
2788
+ *
2789
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader)
2790
+ */
2413
2791
  export declare class ReadableStreamBYOBReader {
2414
2792
  constructor(stream: ReadableStream);
2415
2793
  get closed(): Promise<void>;
2416
2794
  cancel(reason?: any): Promise<void>;
2417
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/read) */
2795
+ /**
2796
+ * 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.
2797
+ *
2798
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/read)
2799
+ */
2418
2800
  read<T extends ArrayBufferView>(
2419
2801
  view: T,
2420
2802
  ): Promise<ReadableStreamReadResult<T>>;
2421
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/releaseLock) */
2803
+ /**
2804
+ * The **`releaseLock()`** method of the ReadableStreamBYOBReader interface releases the reader's lock on the stream.
2805
+ *
2806
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/releaseLock)
2807
+ */
2422
2808
  releaseLock(): void;
2423
2809
  readAtLeast<T extends ArrayBufferView>(
2424
2810
  minElements: number,
@@ -2436,60 +2822,148 @@ export interface ReadableStreamGetReaderOptions {
2436
2822
  */
2437
2823
  mode: "byob";
2438
2824
  }
2439
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest) */
2825
+ /**
2826
+ * 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).
2827
+ *
2828
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest)
2829
+ */
2440
2830
  export declare abstract class ReadableStreamBYOBRequest {
2441
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest/view) */
2831
+ /**
2832
+ * The **`view`** getter property of the ReadableStreamBYOBRequest interface returns the current view.
2833
+ *
2834
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest/view)
2835
+ */
2442
2836
  get view(): Uint8Array | null;
2443
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest/respond) */
2837
+ /**
2838
+ * The **`respond()`** method of the ReadableStreamBYOBRequest interface is used to signal to the associated readable byte stream that the specified number of bytes were written into the ReadableStreamBYOBRequest.view.
2839
+ *
2840
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest/respond)
2841
+ */
2444
2842
  respond(bytesWritten: number): void;
2445
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest/respondWithNewView) */
2843
+ /**
2844
+ * The **`respondWithNewView()`** method of the ReadableStreamBYOBRequest interface specifies a new view that the consumer of the associated readable byte stream should write to instead of ReadableStreamBYOBRequest.view.
2845
+ *
2846
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest/respondWithNewView)
2847
+ */
2446
2848
  respondWithNewView(view: ArrayBuffer | ArrayBufferView): void;
2447
2849
  get atLeast(): number | null;
2448
2850
  }
2449
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController) */
2851
+ /**
2852
+ * The **`ReadableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a ReadableStream's state and internal queue.
2853
+ *
2854
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController)
2855
+ */
2450
2856
  export declare abstract class ReadableStreamDefaultController<R = any> {
2451
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/desiredSize) */
2857
+ /**
2858
+ * The **`desiredSize`** read-only property of the required to fill the stream's internal queue.
2859
+ *
2860
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/desiredSize)
2861
+ */
2452
2862
  get desiredSize(): number | null;
2453
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/close) */
2863
+ /**
2864
+ * The **`close()`** method of the ReadableStreamDefaultController interface closes the associated stream.
2865
+ *
2866
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/close)
2867
+ */
2454
2868
  close(): void;
2455
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/enqueue) */
2869
+ /**
2870
+ * The **`enqueue()`** method of the ```js-nolint enqueue(chunk) ``` - `chunk` - : The chunk to enqueue.
2871
+ *
2872
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/enqueue)
2873
+ */
2456
2874
  enqueue(chunk?: R): void;
2457
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/error) */
2875
+ /**
2876
+ * The **`error()`** method of the with the associated stream to error.
2877
+ *
2878
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/error)
2879
+ */
2458
2880
  error(reason: any): void;
2459
2881
  }
2460
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController) */
2882
+ /**
2883
+ * The **`ReadableByteStreamController`** interface of the Streams API represents a controller for a readable byte stream.
2884
+ *
2885
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController)
2886
+ */
2461
2887
  export declare abstract class ReadableByteStreamController {
2462
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/byobRequest) */
2888
+ /**
2889
+ * The **`byobRequest`** read-only property of the ReadableByteStreamController interface returns the current BYOB request, or `null` if there are no pending requests.
2890
+ *
2891
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/byobRequest)
2892
+ */
2463
2893
  get byobRequest(): ReadableStreamBYOBRequest | null;
2464
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/desiredSize) */
2894
+ /**
2895
+ * 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'.
2896
+ *
2897
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/desiredSize)
2898
+ */
2465
2899
  get desiredSize(): number | null;
2466
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/close) */
2900
+ /**
2901
+ * The **`close()`** method of the ReadableByteStreamController interface closes the associated stream.
2902
+ *
2903
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/close)
2904
+ */
2467
2905
  close(): void;
2468
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/enqueue) */
2906
+ /**
2907
+ * 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).
2908
+ *
2909
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/enqueue)
2910
+ */
2469
2911
  enqueue(chunk: ArrayBuffer | ArrayBufferView): void;
2470
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/error) */
2912
+ /**
2913
+ * The **`error()`** method of the ReadableByteStreamController interface causes any future interactions with the associated stream to error with the specified reason.
2914
+ *
2915
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/error)
2916
+ */
2471
2917
  error(reason: any): void;
2472
2918
  }
2473
2919
  /**
2474
- * This Streams API interface 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.
2920
+ * The **`WritableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a WritableStream's state.
2475
2921
  *
2476
2922
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController)
2477
2923
  */
2478
2924
  export declare abstract class WritableStreamDefaultController {
2479
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController/signal) */
2925
+ /**
2926
+ * The read-only **`signal`** property of the WritableStreamDefaultController interface returns the AbortSignal associated with the controller.
2927
+ *
2928
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController/signal)
2929
+ */
2480
2930
  get signal(): AbortSignal;
2481
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController/error) */
2931
+ /**
2932
+ * The **`error()`** method of the with the associated stream to error.
2933
+ *
2934
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController/error)
2935
+ */
2482
2936
  error(reason?: any): void;
2483
2937
  }
2484
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController) */
2938
+ /**
2939
+ * The **`TransformStreamDefaultController`** interface of the Streams API provides methods to manipulate the associated ReadableStream and WritableStream.
2940
+ *
2941
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController)
2942
+ */
2485
2943
  export declare abstract class TransformStreamDefaultController<O = any> {
2486
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/desiredSize) */
2944
+ /**
2945
+ * The **`desiredSize`** read-only property of the TransformStreamDefaultController interface returns the desired size to fill the queue of the associated ReadableStream.
2946
+ *
2947
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/desiredSize)
2948
+ */
2487
2949
  get desiredSize(): number | null;
2488
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/enqueue) */
2950
+ /**
2951
+ * The **`enqueue()`** method of the TransformStreamDefaultController interface enqueues the given chunk in the readable side of the stream.
2952
+ *
2953
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/enqueue)
2954
+ */
2489
2955
  enqueue(chunk?: O): void;
2490
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/error) */
2956
+ /**
2957
+ * The **`error()`** method of the TransformStreamDefaultController interface errors both sides of the stream.
2958
+ *
2959
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/error)
2960
+ */
2491
2961
  error(reason: any): void;
2492
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/terminate) */
2962
+ /**
2963
+ * The **`terminate()`** method of the TransformStreamDefaultController interface closes the readable side and errors the writable side of the stream.
2964
+ *
2965
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/terminate)
2966
+ */
2493
2967
  terminate(): void;
2494
2968
  }
2495
2969
  export interface ReadableWritablePair<R = any, W = any> {
@@ -2502,7 +2976,7 @@ export interface ReadableWritablePair<R = any, W = any> {
2502
2976
  readable: ReadableStream<R>;
2503
2977
  }
2504
2978
  /**
2505
- * This Streams API interface provides a standard abstraction for writing streaming data to a destination, known as a sink. This object comes with built-in backpressure and queuing.
2979
+ * The **`WritableStream`** interface of the Streams API provides a standard abstraction for writing streaming data to a destination, known as a sink.
2506
2980
  *
2507
2981
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream)
2508
2982
  */
@@ -2511,47 +2985,103 @@ export declare class WritableStream<W = any> {
2511
2985
  underlyingSink?: UnderlyingSink,
2512
2986
  queuingStrategy?: QueuingStrategy,
2513
2987
  );
2514
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/locked) */
2988
+ /**
2989
+ * The **`locked`** read-only property of the WritableStream interface returns a boolean indicating whether the `WritableStream` is locked to a writer.
2990
+ *
2991
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/locked)
2992
+ */
2515
2993
  get locked(): boolean;
2516
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/abort) */
2994
+ /**
2995
+ * The **`abort()`** method of the WritableStream 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.
2996
+ *
2997
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/abort)
2998
+ */
2517
2999
  abort(reason?: any): Promise<void>;
2518
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/close) */
3000
+ /**
3001
+ * The **`close()`** method of the WritableStream interface closes the associated stream.
3002
+ *
3003
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/close)
3004
+ */
2519
3005
  close(): Promise<void>;
2520
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/getWriter) */
3006
+ /**
3007
+ * The **`getWriter()`** method of the WritableStream interface returns a new instance of WritableStreamDefaultWriter and locks the stream to that instance.
3008
+ *
3009
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/getWriter)
3010
+ */
2521
3011
  getWriter(): WritableStreamDefaultWriter<W>;
2522
3012
  }
2523
3013
  /**
2524
- * This Streams API interface 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.
3014
+ * 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.
2525
3015
  *
2526
3016
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter)
2527
3017
  */
2528
3018
  export declare class WritableStreamDefaultWriter<W = any> {
2529
3019
  constructor(stream: WritableStream);
2530
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/closed) */
3020
+ /**
3021
+ * The **`closed`** read-only property of the the stream errors or the writer's lock is released.
3022
+ *
3023
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/closed)
3024
+ */
2531
3025
  get closed(): Promise<void>;
2532
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/ready) */
3026
+ /**
3027
+ * 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.
3028
+ *
3029
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/ready)
3030
+ */
2533
3031
  get ready(): Promise<void>;
2534
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/desiredSize) */
3032
+ /**
3033
+ * The **`desiredSize`** read-only property of the to fill the stream's internal queue.
3034
+ *
3035
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/desiredSize)
3036
+ */
2535
3037
  get desiredSize(): number | null;
2536
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/abort) */
3038
+ /**
3039
+ * 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.
3040
+ *
3041
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/abort)
3042
+ */
2537
3043
  abort(reason?: any): Promise<void>;
2538
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/close) */
3044
+ /**
3045
+ * The **`close()`** method of the stream.
3046
+ *
3047
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/close)
3048
+ */
2539
3049
  close(): Promise<void>;
2540
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/write) */
3050
+ /**
3051
+ * The **`write()`** method of the operation.
3052
+ *
3053
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/write)
3054
+ */
2541
3055
  write(chunk?: W): Promise<void>;
2542
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/releaseLock) */
3056
+ /**
3057
+ * The **`releaseLock()`** method of the corresponding stream.
3058
+ *
3059
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/releaseLock)
3060
+ */
2543
3061
  releaseLock(): void;
2544
3062
  }
2545
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream) */
3063
+ /**
3064
+ * The **`TransformStream`** interface of the Streams API represents a concrete implementation of the pipe chain _transform stream_ concept.
3065
+ *
3066
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream)
3067
+ */
2546
3068
  export declare class TransformStream<I = any, O = any> {
2547
3069
  constructor(
2548
3070
  transformer?: Transformer<I, O>,
2549
3071
  writableStrategy?: QueuingStrategy<I>,
2550
3072
  readableStrategy?: QueuingStrategy<O>,
2551
3073
  );
2552
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/readable) */
3074
+ /**
3075
+ * The **`readable`** read-only property of the TransformStream interface returns the ReadableStream instance controlled by this `TransformStream`.
3076
+ *
3077
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/readable)
3078
+ */
2553
3079
  get readable(): ReadableStream<O>;
2554
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/writable) */
3080
+ /**
3081
+ * The **`writable`** read-only property of the TransformStream interface returns the WritableStream instance controlled by this `TransformStream`.
3082
+ *
3083
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/writable)
3084
+ */
2555
3085
  get writable(): WritableStream<I>;
2556
3086
  }
2557
3087
  export declare class FixedLengthStream extends IdentityTransformStream {
@@ -2572,21 +3102,33 @@ export interface IdentityTransformStreamQueuingStrategy {
2572
3102
  export interface ReadableStreamValuesOptions {
2573
3103
  preventCancel?: boolean;
2574
3104
  }
2575
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CompressionStream) */
3105
+ /**
3106
+ * The **`CompressionStream`** interface of the Compression Streams API is an API for compressing a stream of data.
3107
+ *
3108
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CompressionStream)
3109
+ */
2576
3110
  export declare class CompressionStream extends TransformStream<
2577
3111
  ArrayBuffer | ArrayBufferView,
2578
3112
  Uint8Array
2579
3113
  > {
2580
3114
  constructor(format: "gzip" | "deflate" | "deflate-raw");
2581
3115
  }
2582
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/DecompressionStream) */
3116
+ /**
3117
+ * The **`DecompressionStream`** interface of the Compression Streams API is an API for decompressing a stream of data.
3118
+ *
3119
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DecompressionStream)
3120
+ */
2583
3121
  export declare class DecompressionStream extends TransformStream<
2584
3122
  ArrayBuffer | ArrayBufferView,
2585
3123
  Uint8Array
2586
3124
  > {
2587
3125
  constructor(format: "gzip" | "deflate" | "deflate-raw");
2588
3126
  }
2589
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoderStream) */
3127
+ /**
3128
+ * The **`TextEncoderStream`** interface of the Encoding API converts a stream of strings into bytes in the UTF-8 encoding.
3129
+ *
3130
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoderStream)
3131
+ */
2590
3132
  export declare class TextEncoderStream extends TransformStream<
2591
3133
  string,
2592
3134
  Uint8Array
@@ -2594,7 +3136,11 @@ export declare class TextEncoderStream extends TransformStream<
2594
3136
  constructor();
2595
3137
  get encoding(): string;
2596
3138
  }
2597
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoderStream) */
3139
+ /**
3140
+ * 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.
3141
+ *
3142
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoderStream)
3143
+ */
2598
3144
  export declare class TextDecoderStream extends TransformStream<
2599
3145
  ArrayBuffer | ArrayBufferView,
2600
3146
  string
@@ -2609,7 +3155,7 @@ export interface TextDecoderStreamTextDecoderStreamInit {
2609
3155
  ignoreBOM?: boolean;
2610
3156
  }
2611
3157
  /**
2612
- * This Streams API interface provides a built-in byte length queuing strategy that can be used when constructing streams.
3158
+ * The **`ByteLengthQueuingStrategy`** interface of the Streams API provides a built-in byte length queuing strategy that can be used when constructing streams.
2613
3159
  *
2614
3160
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ByteLengthQueuingStrategy)
2615
3161
  */
@@ -2617,19 +3163,27 @@ export declare class ByteLengthQueuingStrategy
2617
3163
  implements QueuingStrategy<ArrayBufferView>
2618
3164
  {
2619
3165
  constructor(init: QueuingStrategyInit);
2620
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ByteLengthQueuingStrategy/highWaterMark) */
3166
+ /**
3167
+ * The read-only **`ByteLengthQueuingStrategy.highWaterMark`** property returns the total number of bytes that can be contained in the internal queue before backpressure is applied.
3168
+ *
3169
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ByteLengthQueuingStrategy/highWaterMark)
3170
+ */
2621
3171
  get highWaterMark(): number;
2622
3172
  /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ByteLengthQueuingStrategy/size) */
2623
3173
  get size(): (chunk?: any) => number;
2624
3174
  }
2625
3175
  /**
2626
- * This Streams API interface provides a built-in byte length queuing strategy that can be used when constructing streams.
3176
+ * The **`CountQueuingStrategy`** interface of the Streams API provides a built-in chunk counting queuing strategy that can be used when constructing streams.
2627
3177
  *
2628
3178
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CountQueuingStrategy)
2629
3179
  */
2630
3180
  export declare class CountQueuingStrategy implements QueuingStrategy {
2631
3181
  constructor(init: QueuingStrategyInit);
2632
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CountQueuingStrategy/highWaterMark) */
3182
+ /**
3183
+ * The read-only **`CountQueuingStrategy.highWaterMark`** property returns the total number of chunks that can be contained in the internal queue before backpressure is applied.
3184
+ *
3185
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CountQueuingStrategy/highWaterMark)
3186
+ */
2633
3187
  get highWaterMark(): number;
2634
3188
  /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CountQueuingStrategy/size) */
2635
3189
  get size(): (chunk?: any) => number;
@@ -2762,113 +3316,233 @@ export interface UnsafeTraceMetrics {
2762
3316
  fromTrace(item: TraceItem): TraceMetrics;
2763
3317
  }
2764
3318
  /**
2765
- * The URL interface represents an object providing static methods used for creating object URLs.
3319
+ * The **`URL`** interface is used to parse, construct, normalize, and encode URL.
2766
3320
  *
2767
3321
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL)
2768
3322
  */
2769
3323
  export declare class URL {
2770
3324
  constructor(url: string | URL, base?: string | URL);
2771
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/origin) */
3325
+ /**
3326
+ * The **`origin`** read-only property of the URL interface returns a string containing the Unicode serialization of the origin of the represented URL.
3327
+ *
3328
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/origin)
3329
+ */
2772
3330
  get origin(): string;
2773
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/href) */
3331
+ /**
3332
+ * The **`href`** property of the URL interface is a string containing the whole URL.
3333
+ *
3334
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/href)
3335
+ */
2774
3336
  get href(): string;
2775
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/href) */
3337
+ /**
3338
+ * The **`href`** property of the URL interface is a string containing the whole URL.
3339
+ *
3340
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/href)
3341
+ */
2776
3342
  set href(value: string);
2777
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/protocol) */
3343
+ /**
3344
+ * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final `':'`.
3345
+ *
3346
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/protocol)
3347
+ */
2778
3348
  get protocol(): string;
2779
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/protocol) */
3349
+ /**
3350
+ * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final `':'`.
3351
+ *
3352
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/protocol)
3353
+ */
2780
3354
  set protocol(value: string);
2781
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/username) */
3355
+ /**
3356
+ * The **`username`** property of the URL interface is a string containing the username component of the URL.
3357
+ *
3358
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/username)
3359
+ */
2782
3360
  get username(): string;
2783
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/username) */
3361
+ /**
3362
+ * The **`username`** property of the URL interface is a string containing the username component of the URL.
3363
+ *
3364
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/username)
3365
+ */
2784
3366
  set username(value: string);
2785
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/password) */
3367
+ /**
3368
+ * The **`password`** property of the URL interface is a string containing the password component of the URL.
3369
+ *
3370
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/password)
3371
+ */
2786
3372
  get password(): string;
2787
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/password) */
3373
+ /**
3374
+ * The **`password`** property of the URL interface is a string containing the password component of the URL.
3375
+ *
3376
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/password)
3377
+ */
2788
3378
  set password(value: string);
2789
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/host) */
3379
+ /**
3380
+ * 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.
3381
+ *
3382
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/host)
3383
+ */
2790
3384
  get host(): string;
2791
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/host) */
3385
+ /**
3386
+ * 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.
3387
+ *
3388
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/host)
3389
+ */
2792
3390
  set host(value: string);
2793
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hostname) */
3391
+ /**
3392
+ * The **`hostname`** property of the URL interface is a string containing either the domain name or IP address of the URL.
3393
+ *
3394
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hostname)
3395
+ */
2794
3396
  get hostname(): string;
2795
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hostname) */
3397
+ /**
3398
+ * The **`hostname`** property of the URL interface is a string containing either the domain name or IP address of the URL.
3399
+ *
3400
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hostname)
3401
+ */
2796
3402
  set hostname(value: string);
2797
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/port) */
3403
+ /**
3404
+ * The **`port`** property of the URL interface is a string containing the port number of the URL.
3405
+ *
3406
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/port)
3407
+ */
2798
3408
  get port(): string;
2799
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/port) */
3409
+ /**
3410
+ * The **`port`** property of the URL interface is a string containing the port number of the URL.
3411
+ *
3412
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/port)
3413
+ */
2800
3414
  set port(value: string);
2801
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/pathname) */
3415
+ /**
3416
+ * The **`pathname`** property of the URL interface represents a location in a hierarchical structure.
3417
+ *
3418
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/pathname)
3419
+ */
2802
3420
  get pathname(): string;
2803
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/pathname) */
3421
+ /**
3422
+ * The **`pathname`** property of the URL interface represents a location in a hierarchical structure.
3423
+ *
3424
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/pathname)
3425
+ */
2804
3426
  set pathname(value: string);
2805
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/search) */
3427
+ /**
3428
+ * 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.
3429
+ *
3430
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/search)
3431
+ */
2806
3432
  get search(): string;
2807
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/search) */
3433
+ /**
3434
+ * 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.
3435
+ *
3436
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/search)
3437
+ */
2808
3438
  set search(value: string);
2809
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hash) */
3439
+ /**
3440
+ * The **`hash`** property of the URL interface is a string containing a `'#'` followed by the fragment identifier of the URL.
3441
+ *
3442
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hash)
3443
+ */
2810
3444
  get hash(): string;
2811
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hash) */
3445
+ /**
3446
+ * The **`hash`** property of the URL interface is a string containing a `'#'` followed by the fragment identifier of the URL.
3447
+ *
3448
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hash)
3449
+ */
2812
3450
  set hash(value: string);
2813
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/searchParams) */
3451
+ /**
3452
+ * The **`searchParams`** read-only property of the access to the [MISSING: httpmethod('GET')] decoded query arguments contained in the URL.
3453
+ *
3454
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/searchParams)
3455
+ */
2814
3456
  get searchParams(): URLSearchParams;
2815
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/toJSON) */
3457
+ /**
3458
+ * 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.
3459
+ *
3460
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/toJSON)
3461
+ */
2816
3462
  toJSON(): string;
2817
3463
  /*function toString() { [native code] }*/
2818
3464
  toString(): string;
2819
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/canParse_static) */
3465
+ /**
3466
+ * The **`URL.canParse()`** static method of the URL interface returns a boolean indicating whether or not an absolute URL, or a relative URL combined with a base URL, are parsable and valid.
3467
+ *
3468
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/canParse_static)
3469
+ */
2820
3470
  static canParse(url: string, base?: string): boolean;
2821
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/parse_static) */
3471
+ /**
3472
+ * The **`URL.parse()`** static method of the URL interface returns a newly created URL object representing the URL defined by the parameters.
3473
+ *
3474
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/parse_static)
3475
+ */
2822
3476
  static parse(url: string, base?: string): URL | null;
2823
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/createObjectURL_static) */
3477
+ /**
3478
+ * The **`createObjectURL()`** static method of the URL interface creates a string containing a URL representing the object given in the parameter.
3479
+ *
3480
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/createObjectURL_static)
3481
+ */
2824
3482
  static createObjectURL(object: File | Blob): string;
2825
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/revokeObjectURL_static) */
3483
+ /**
3484
+ * 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.
3485
+ *
3486
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/revokeObjectURL_static)
3487
+ */
2826
3488
  static revokeObjectURL(object_url: string): void;
2827
3489
  }
2828
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams) */
3490
+ /**
3491
+ * The **`URLSearchParams`** interface defines utility methods to work with the query string of a URL.
3492
+ *
3493
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams)
3494
+ */
2829
3495
  export declare class URLSearchParams {
2830
3496
  constructor(
2831
3497
  init?: Iterable<Iterable<string>> | Record<string, string> | string,
2832
3498
  );
2833
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/size) */
3499
+ /**
3500
+ * The **`size`** read-only property of the URLSearchParams interface indicates the total number of search parameter entries.
3501
+ *
3502
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/size)
3503
+ */
2834
3504
  get size(): number;
2835
3505
  /**
2836
- * Appends a specified key/value pair as a new search parameter.
3506
+ * The **`append()`** method of the URLSearchParams interface appends a specified key/value pair as a new search parameter.
2837
3507
  *
2838
3508
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/append)
2839
3509
  */
2840
3510
  append(name: string, value: string): void;
2841
3511
  /**
2842
- * Deletes the given search parameter, and its associated value, from the list of all search parameters.
3512
+ * The **`delete()`** method of the URLSearchParams interface deletes specified parameters and their associated value(s) from the list of all search parameters.
2843
3513
  *
2844
3514
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/delete)
2845
3515
  */
2846
3516
  delete(name: string, value?: string): void;
2847
3517
  /**
2848
- * Returns the first value associated to the given search parameter.
3518
+ * The **`get()`** method of the URLSearchParams interface returns the first value associated to the given search parameter.
2849
3519
  *
2850
3520
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/get)
2851
3521
  */
2852
3522
  get(name: string): string | null;
2853
3523
  /**
2854
- * Returns all the values association with a given search parameter.
3524
+ * The **`getAll()`** method of the URLSearchParams interface returns all the values associated with a given search parameter as an array.
2855
3525
  *
2856
3526
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/getAll)
2857
3527
  */
2858
3528
  getAll(name: string): string[];
2859
3529
  /**
2860
- * Returns a Boolean indicating if such a search parameter exists.
3530
+ * The **`has()`** method of the URLSearchParams interface returns a boolean value that indicates whether the specified parameter is in the search parameters.
2861
3531
  *
2862
3532
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/has)
2863
3533
  */
2864
3534
  has(name: string, value?: string): boolean;
2865
3535
  /**
2866
- * Sets the value associated to a given search parameter to the given value. If there were several values, delete the others.
3536
+ * The **`set()`** method of the URLSearchParams interface sets the value associated with a given search parameter to the given value.
2867
3537
  *
2868
3538
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/set)
2869
3539
  */
2870
3540
  set(name: string, value: string): void;
2871
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/sort) */
3541
+ /**
3542
+ * The **`URLSearchParams.sort()`** method sorts all key/value pairs contained in this object in place and returns `undefined`.
3543
+ *
3544
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/sort)
3545
+ */
2872
3546
  sort(): void;
2873
3547
  /* Returns an array of key, value pairs for every entry in the search params. */
2874
3548
  entries(): IterableIterator<[key: string, value: string]>;
@@ -2885,7 +3559,7 @@ export declare class URLSearchParams {
2885
3559
  ) => void,
2886
3560
  thisArg?: This,
2887
3561
  ): void;
2888
- /*function toString() { [native code] } Returns a string containing a query string suitable for use in a URL. Does not include the question mark. */
3562
+ /*function toString() { [native code] }*/
2889
3563
  toString(): string;
2890
3564
  [Symbol.iterator](): IterableIterator<[key: string, value: string]>;
2891
3565
  }
@@ -2940,26 +3614,26 @@ export interface URLPatternOptions {
2940
3614
  ignoreCase?: boolean;
2941
3615
  }
2942
3616
  /**
2943
- * 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.
3617
+ * A `CloseEvent` is sent to clients using WebSockets when the connection is closed.
2944
3618
  *
2945
3619
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CloseEvent)
2946
3620
  */
2947
3621
  export declare class CloseEvent extends Event {
2948
3622
  constructor(type: string, initializer?: CloseEventInit);
2949
3623
  /**
2950
- * Returns the WebSocket connection close code provided by the server.
3624
+ * The **`code`** read-only property of the CloseEvent interface returns a WebSocket connection close code indicating the reason the connection was closed.
2951
3625
  *
2952
3626
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CloseEvent/code)
2953
3627
  */
2954
3628
  readonly code: number;
2955
3629
  /**
2956
- * Returns the WebSocket connection close reason provided by the server.
3630
+ * The **`reason`** read-only property of the CloseEvent interface returns the WebSocket connection close reason the server gave for closing the connection; that is, a concise human-readable prose explanation for the closure.
2957
3631
  *
2958
3632
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CloseEvent/reason)
2959
3633
  */
2960
3634
  readonly reason: string;
2961
3635
  /**
2962
- * Returns true if the connection closed cleanly; false otherwise.
3636
+ * The **`wasClean`** read-only property of the CloseEvent interface returns `true` if the connection closed cleanly.
2963
3637
  *
2964
3638
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CloseEvent/wasClean)
2965
3639
  */
@@ -2977,7 +3651,7 @@ export type WebSocketEventMap = {
2977
3651
  error: ErrorEvent;
2978
3652
  };
2979
3653
  /**
2980
- * Provides the API for creating and managing a WebSocket connection to a server, as well as for sending and receiving data on the connection.
3654
+ * 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.
2981
3655
  *
2982
3656
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket)
2983
3657
  */
@@ -2994,20 +3668,20 @@ export declare var WebSocket: {
2994
3668
  readonly CLOSED: number;
2995
3669
  };
2996
3670
  /**
2997
- * Provides the API for creating and managing a WebSocket connection to a server, as well as for sending and receiving data on the connection.
3671
+ * 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.
2998
3672
  *
2999
3673
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket)
3000
3674
  */
3001
3675
  export interface WebSocket extends EventTarget<WebSocketEventMap> {
3002
3676
  accept(): void;
3003
3677
  /**
3004
- * Transmits data using the WebSocket connection. data can be a string, a Blob, an ArrayBuffer, or an ArrayBufferView.
3678
+ * 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.
3005
3679
  *
3006
3680
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/send)
3007
3681
  */
3008
3682
  send(message: (ArrayBuffer | ArrayBufferView) | string): void;
3009
3683
  /**
3010
- * Closes the WebSocket connection, optionally using code as the the WebSocket connection close code and reason as the the WebSocket connection close reason.
3684
+ * The **`WebSocket.close()`** method closes the already `CLOSED`, this method does nothing.
3011
3685
  *
3012
3686
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/close)
3013
3687
  */
@@ -3015,25 +3689,25 @@ export interface WebSocket extends EventTarget<WebSocketEventMap> {
3015
3689
  serializeAttachment(attachment: any): void;
3016
3690
  deserializeAttachment(): any | null;
3017
3691
  /**
3018
- * Returns the state of the WebSocket object's connection. It can have the values described below.
3692
+ * The **`WebSocket.readyState`** read-only property returns the current state of the WebSocket connection.
3019
3693
  *
3020
3694
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/readyState)
3021
3695
  */
3022
3696
  readyState: number;
3023
3697
  /**
3024
- * Returns the URL that was used to establish the WebSocket connection.
3698
+ * The **`WebSocket.url`** read-only property returns the absolute URL of the WebSocket as resolved by the constructor.
3025
3699
  *
3026
3700
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/url)
3027
3701
  */
3028
3702
  url: string | null;
3029
3703
  /**
3030
- * Returns the subprotocol selected by the server, if any. It can be used in conjunction with the array form of the constructor's second argument to perform subprotocol negotiation.
3704
+ * 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.
3031
3705
  *
3032
3706
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/protocol)
3033
3707
  */
3034
3708
  protocol: string | null;
3035
3709
  /**
3036
- * Returns the extensions selected by the server, if any.
3710
+ * The **`WebSocket.extensions`** read-only property returns the extensions selected by the server.
3037
3711
  *
3038
3712
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/extensions)
3039
3713
  */
@@ -3112,29 +3786,33 @@ export interface SocketInfo {
3112
3786
  remoteAddress?: string;
3113
3787
  localAddress?: string;
3114
3788
  }
3115
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource) */
3789
+ /**
3790
+ * The **`EventSource`** interface is web content's interface to server-sent events.
3791
+ *
3792
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource)
3793
+ */
3116
3794
  export declare class EventSource extends EventTarget {
3117
3795
  constructor(url: string, init?: EventSourceEventSourceInit);
3118
3796
  /**
3119
- * Aborts any instances of the fetch algorithm started for this EventSource object, and sets the readyState attribute to CLOSED.
3797
+ * The **`close()`** method of the EventSource interface closes the connection, if one is made, and sets the ```js-nolint close() ``` None.
3120
3798
  *
3121
3799
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/close)
3122
3800
  */
3123
3801
  close(): void;
3124
3802
  /**
3125
- * Returns the URL providing the event stream.
3803
+ * The **`url`** read-only property of the URL of the source.
3126
3804
  *
3127
3805
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/url)
3128
3806
  */
3129
3807
  get url(): string;
3130
3808
  /**
3131
- * Returns true if the credentials mode for connection requests to the URL providing the event stream is set to "include", and false otherwise.
3809
+ * The **`withCredentials`** read-only property of the the `EventSource` object was instantiated with CORS credentials set.
3132
3810
  *
3133
3811
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/withCredentials)
3134
3812
  */
3135
3813
  get withCredentials(): boolean;
3136
3814
  /**
3137
- * Returns the state of this EventSource object's connection. It can have the values described below.
3815
+ * The **`readyState`** read-only property of the connection.
3138
3816
  *
3139
3817
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/readyState)
3140
3818
  */
@@ -3173,57 +3851,97 @@ export interface ContainerStartupOptions {
3173
3851
  entrypoint?: string[];
3174
3852
  enableInternet: boolean;
3175
3853
  env?: Record<string, string>;
3854
+ hardTimeout?: number | bigint;
3176
3855
  }
3177
3856
  /**
3857
+ * The **`FileSystemHandle`** interface of the File System API is an object which represents a file or directory entry.
3178
3858
  * Available only in secure contexts.
3179
3859
  *
3180
3860
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle)
3181
3861
  */
3182
3862
  export declare abstract class FileSystemHandle {
3183
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/kind) */
3863
+ /**
3864
+ * The **`kind`** read-only property of the `'file'` if the associated entry is a file or `'directory'`.
3865
+ *
3866
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/kind)
3867
+ */
3184
3868
  get kind(): string;
3185
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/name) */
3869
+ /**
3870
+ * The **`name`** read-only property of the handle.
3871
+ *
3872
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/name)
3873
+ */
3186
3874
  get name(): string;
3187
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/isSameEntry) */
3875
+ /**
3876
+ * The **`isSameEntry()`** method of the ```js-nolint isSameEntry(fileSystemHandle) ``` - FileSystemHandle - : The `FileSystemHandle` to match against the handle on which the method is invoked.
3877
+ *
3878
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/isSameEntry)
3879
+ */
3188
3880
  isSameEntry(other: FileSystemHandle): Promise<boolean>;
3189
3881
  getUniqueId(): Promise<string>;
3190
3882
  remove(options?: FileSystemHandleRemoveOptions): Promise<void>;
3191
3883
  }
3192
3884
  /**
3885
+ * The **`FileSystemFileHandle`** interface of the File System API represents a handle to a file system entry.
3193
3886
  * Available only in secure contexts.
3194
3887
  *
3195
3888
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemFileHandle)
3196
3889
  */
3197
3890
  export declare abstract class FileSystemFileHandle extends FileSystemHandle {
3198
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemFileHandle/getFile) */
3891
+ /**
3892
+ * 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.
3893
+ *
3894
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemFileHandle/getFile)
3895
+ */
3199
3896
  getFile(): Promise<File>;
3200
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemFileHandle/createWritable) */
3897
+ /**
3898
+ * The **`createWritable()`** method of the FileSystemFileHandle interface creates a FileSystemWritableFileStream that can be used to write to a file.
3899
+ *
3900
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemFileHandle/createWritable)
3901
+ */
3201
3902
  createWritable(
3202
3903
  options?: FileSystemFileHandleFileSystemCreateWritableOptions,
3203
3904
  ): Promise<FileSystemWritableFileStream>;
3204
3905
  }
3205
3906
  /**
3907
+ * The **`FileSystemDirectoryHandle`** interface of the File System API provides a handle to a file system directory.
3206
3908
  * Available only in secure contexts.
3207
3909
  *
3208
3910
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle)
3209
3911
  */
3210
3912
  export declare abstract class FileSystemDirectoryHandle extends FileSystemHandle {
3211
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/getFileHandle) */
3913
+ /**
3914
+ * The **`getFileHandle()`** method of the directory the method is called.
3915
+ *
3916
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/getFileHandle)
3917
+ */
3212
3918
  getFileHandle(
3213
3919
  name: string,
3214
3920
  options?: FileSystemDirectoryHandleFileSystemGetFileOptions,
3215
3921
  ): Promise<FileSystemFileHandle>;
3216
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/getDirectoryHandle) */
3922
+ /**
3923
+ * The **`getDirectoryHandle()`** method of the within the directory handle on which the method is called.
3924
+ *
3925
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/getDirectoryHandle)
3926
+ */
3217
3927
  getDirectoryHandle(
3218
3928
  name: string,
3219
3929
  options?: FileSystemDirectoryHandleFileSystemGetDirectoryOptions,
3220
3930
  ): Promise<FileSystemDirectoryHandle>;
3221
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/removeEntry) */
3931
+ /**
3932
+ * The **`removeEntry()`** method of the directory handle contains a file or directory called the name specified.
3933
+ *
3934
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/removeEntry)
3935
+ */
3222
3936
  removeEntry(
3223
3937
  name: string,
3224
3938
  options?: FileSystemDirectoryHandleFileSystemRemoveOptions,
3225
3939
  ): Promise<void>;
3226
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/resolve) */
3940
+ /**
3941
+ * 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.
3942
+ *
3943
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/resolve)
3944
+ */
3227
3945
  resolve(possibleDescendant: FileSystemHandle): Promise<string[]>;
3228
3946
  entries(): AsyncIterableIterator<[string, FileSystemHandle]>;
3229
3947
  keys(): AsyncIterableIterator<string>;
@@ -3239,12 +3957,17 @@ export declare abstract class FileSystemDirectoryHandle extends FileSystemHandle
3239
3957
  [Symbol.asyncIterator](): AsyncIterableIterator<[string, FileSystemHandle]>;
3240
3958
  }
3241
3959
  /**
3960
+ * The **`FileSystemWritableFileStream`** interface of the File System API is a WritableStream object with additional convenience methods, which operates on a single file on disk.
3242
3961
  * Available only in secure contexts.
3243
3962
  *
3244
3963
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemWritableFileStream)
3245
3964
  */
3246
3965
  export declare abstract class FileSystemWritableFileStream extends WritableStream {
3247
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemWritableFileStream/write) */
3966
+ /**
3967
+ * The **`write()`** method of the FileSystemWritableFileStream interface writes content into the file the method is called on, at the current file cursor offset.
3968
+ *
3969
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemWritableFileStream/write)
3970
+ */
3248
3971
  write(
3249
3972
  data:
3250
3973
  | Blob
@@ -3252,18 +3975,31 @@ export declare abstract class FileSystemWritableFileStream extends WritableStrea
3252
3975
  | string
3253
3976
  | FileSystemFileWriteParams,
3254
3977
  ): Promise<void>;
3255
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemWritableFileStream/seek) */
3978
+ /**
3979
+ * The **`seek()`** method of the FileSystemWritableFileStream interface updates the current file cursor offset to the position (in bytes) specified when calling the method.
3980
+ *
3981
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemWritableFileStream/seek)
3982
+ */
3256
3983
  seek(position: number): Promise<void>;
3257
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemWritableFileStream/truncate) */
3984
+ /**
3985
+ * The **`truncate()`** method of the FileSystemWritableFileStream interface resizes the file associated with the stream to the specified size in bytes.
3986
+ *
3987
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemWritableFileStream/truncate)
3988
+ */
3258
3989
  truncate(size: number): Promise<void>;
3259
3990
  }
3260
3991
  /**
3992
+ * The **`StorageManager`** interface of the Storage API provides an interface for managing persistence permissions and estimating available storage.
3261
3993
  * Available only in secure contexts.
3262
3994
  *
3263
3995
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/StorageManager)
3264
3996
  */
3265
3997
  export declare abstract class StorageManager {
3266
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/StorageManager/getDirectory) */
3998
+ /**
3999
+ * The **`getDirectory()`** method of the StorageManager interface is used to obtain a reference to a FileSystemDirectoryHandle object allowing access to a directory and its contents, stored in the origin private file system (OPFS).
4000
+ *
4001
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/StorageManager/getDirectory)
4002
+ */
3267
4003
  getDirectory(): Promise<FileSystemDirectoryHandle>;
3268
4004
  }
3269
4005
  export interface FileSystemFileHandleFileSystemCreateWritableOptions {
@@ -3288,15 +4024,13 @@ export interface FileSystemHandleRemoveOptions {
3288
4024
  recursive?: boolean;
3289
4025
  }
3290
4026
  /**
3291
- * This Channel Messaging API interface represents one of the two ports of a MessageChannel, allowing messages to be sent from one port and listening out for them arriving at the other.
4027
+ * The **`MessagePort`** interface of the Channel Messaging API represents one of the two ports of a MessageChannel, allowing messages to be sent from one port and listening out for them arriving at the other.
3292
4028
  *
3293
4029
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort)
3294
4030
  */
3295
4031
  export declare abstract class MessagePort extends EventTarget {
3296
4032
  /**
3297
- * Posts a message through the channel. Objects listed in transfer are transferred, not just cloned, meaning that they are no longer usable on the sending side.
3298
- *
3299
- * Throws a "DataCloneError" DOMException if transfer contains duplicate objects or port, or if message could not be cloned.
4033
+ * The **`postMessage()`** method of the transfers ownership of objects to other browsing contexts.
3300
4034
  *
3301
4035
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/postMessage)
3302
4036
  */
@@ -3305,13 +4039,13 @@ export declare abstract class MessagePort extends EventTarget {
3305
4039
  options?: any[] | MessagePortPostMessageOptions,
3306
4040
  ): void;
3307
4041
  /**
3308
- * Disconnects the port, so that it is no longer active.
4042
+ * The **`close()`** method of the MessagePort interface disconnects the port, so it is no longer active.
3309
4043
  *
3310
4044
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/close)
3311
4045
  */
3312
4046
  close(): void;
3313
4047
  /**
3314
- * Begins dispatching messages received on the port.
4048
+ * The **`start()`** method of the MessagePort interface starts the sending of messages queued on the port.
3315
4049
  *
3316
4050
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/start)
3317
4051
  */
@@ -3320,20 +4054,20 @@ export declare abstract class MessagePort extends EventTarget {
3320
4054
  set onmessage(value: any | null);
3321
4055
  }
3322
4056
  /**
3323
- * This Channel Messaging API interface allows us to create a new message channel and send data through it via its two MessagePort properties.
4057
+ * The **`MessageChannel`** interface of the Channel Messaging API allows us to create a new message channel and send data through it via its two MessagePort properties.
3324
4058
  *
3325
4059
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageChannel)
3326
4060
  */
3327
4061
  export declare class MessageChannel {
3328
4062
  constructor();
3329
4063
  /**
3330
- * Returns the first MessagePort object.
4064
+ * The **`port1`** read-only property of the the port attached to the context that originated the channel.
3331
4065
  *
3332
4066
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageChannel/port1)
3333
4067
  */
3334
4068
  readonly port1: MessagePort;
3335
4069
  /**
3336
- * Returns the second MessagePort object.
4070
+ * 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.
3337
4071
  *
3338
4072
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageChannel/port2)
3339
4073
  */
@@ -3410,6 +4144,7 @@ export interface WorkerLoaderModule {
3410
4144
  data?: ArrayBuffer;
3411
4145
  json?: any;
3412
4146
  py?: string;
4147
+ wasm?: ArrayBuffer;
3413
4148
  }
3414
4149
  export interface WorkerLoaderWorkerCode {
3415
4150
  compatibilityDate: string;
@@ -3434,50 +4169,94 @@ export declare abstract class Performance extends EventTarget {
3434
4169
  /* [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/performance/#performancenow) */
3435
4170
  now(): number;
3436
4171
  get eventCounts(): EventCounts;
3437
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/clearMarks) */
4172
+ /**
4173
+ * The **`clearMarks()`** method removes all or specific PerformanceMark objects from the browser's performance timeline.
4174
+ *
4175
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/clearMarks)
4176
+ */
3438
4177
  clearMarks(name?: string): void;
3439
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/clearMeasures) */
4178
+ /**
4179
+ * The **`clearMeasures()`** method removes all or specific PerformanceMeasure objects from the browser's performance timeline.
4180
+ *
4181
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/clearMeasures)
4182
+ */
3440
4183
  clearMeasures(name?: string): void;
3441
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/clearResourceTimings) */
4184
+ /**
4185
+ * 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.
4186
+ *
4187
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/clearResourceTimings)
4188
+ */
3442
4189
  clearResourceTimings(): void;
3443
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/getEntries) */
4190
+ /**
4191
+ * The **`getEntries()`** method returns an array of all PerformanceEntry objects currently present in the performance timeline.
4192
+ *
4193
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/getEntries)
4194
+ */
3444
4195
  getEntries(): PerformanceEntry[];
3445
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/getEntriesByName) */
4196
+ /**
4197
+ * The **`getEntriesByName()`** method returns an array of PerformanceEntry objects currently present in the performance timeline with the given _name_ and _type_.
4198
+ *
4199
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/getEntriesByName)
4200
+ */
3446
4201
  getEntriesByName(name: string, type?: string): PerformanceEntry[];
3447
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/getEntriesByType) */
4202
+ /**
4203
+ * The **`getEntriesByType()`** method returns an array of PerformanceEntry objects currently present in the performance timeline for a given _type_.
4204
+ *
4205
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/getEntriesByType)
4206
+ */
3448
4207
  getEntriesByType(type: string): PerformanceEntry[];
3449
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/mark) */
4208
+ /**
4209
+ * The **`mark()`** method creates a named PerformanceMark object representing a high resolution timestamp marker in the browser's performance timeline.
4210
+ *
4211
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/mark)
4212
+ */
3450
4213
  mark(name: string, options?: PerformanceMarkOptions): PerformanceMark;
3451
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/measure) */
4214
+ /**
4215
+ * The **`measure()`** method creates a named PerformanceMeasure object representing a time measurement between two marks in the browser's performance timeline.
4216
+ *
4217
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/measure)
4218
+ */
3452
4219
  measure(
3453
4220
  measureName: string,
3454
4221
  measureOptionsOrStartMark: PerformanceMeasureOptions | string,
3455
4222
  maybeEndMark?: string,
3456
4223
  ): PerformanceMeasure;
3457
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/setResourceTimingBufferSize) */
4224
+ /**
4225
+ * The **`setResourceTimingBufferSize()`** method sets the desired size of the browser's resource timing buffer which stores the `'resource'` performance entries.
4226
+ *
4227
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/setResourceTimingBufferSize)
4228
+ */
3458
4229
  setResourceTimingBufferSize(size: number): void;
3459
4230
  eventLoopUtilization(): void;
3460
4231
  markResourceTiming(): void;
3461
4232
  timerify(fn: () => void): () => void;
3462
4233
  }
3463
4234
  /**
3464
- * PerformanceMark is an abstract interface for PerformanceEntry objects with an entryType of "mark". Entries of this type are created by calling performance.mark() to add a named DOMHighResTimeStamp (the mark) to the browser's performance timeline.
4235
+ * **`PerformanceMark`** is an interface for PerformanceEntry objects with an PerformanceEntry.entryType of `'mark'`.
3465
4236
  *
3466
4237
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMark)
3467
4238
  */
3468
4239
  export declare class PerformanceMark extends PerformanceEntry {
3469
4240
  constructor(name: string, maybeOptions?: PerformanceMarkOptions);
3470
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMark/detail) */
4241
+ /**
4242
+ * 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).
4243
+ *
4244
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMark/detail)
4245
+ */
3471
4246
  get detail(): any | undefined;
3472
4247
  toJSON(): any;
3473
4248
  }
3474
4249
  /**
3475
- * 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.
4250
+ * **`PerformanceMeasure`** is an _abstract_ interface for PerformanceEntry objects with an PerformanceEntry.entryType of `'measure'`.
3476
4251
  *
3477
4252
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMeasure)
3478
4253
  */
3479
4254
  export declare abstract class PerformanceMeasure extends PerformanceEntry {
3480
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMeasure/detail) */
4255
+ /**
4256
+ * The read-only **`detail`** property returns arbitrary metadata that was included in the mark upon construction (when using Performance.measure.
4257
+ *
4258
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMeasure/detail)
4259
+ */
3481
4260
  get detail(): any | undefined;
3482
4261
  toJSON(): any;
3483
4262
  }
@@ -3491,83 +4270,207 @@ export interface PerformanceMeasureOptions {
3491
4270
  duration?: number;
3492
4271
  end?: number;
3493
4272
  }
3494
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList) */
4273
+ /**
4274
+ * The **`PerformanceObserverEntryList`** interface is a list of PerformanceEntry that were explicitly observed via the PerformanceObserver.observe method.
4275
+ *
4276
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList)
4277
+ */
3495
4278
  export declare abstract class PerformanceObserverEntryList {
3496
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntries) */
4279
+ /**
4280
+ * The **`getEntries()`** method of the PerformanceObserverEntryList interface returns a list of explicitly observed PerformanceEntry objects.
4281
+ *
4282
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntries)
4283
+ */
3497
4284
  getEntries(): PerformanceEntry[];
3498
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntriesByType) */
4285
+ /**
4286
+ * The **`getEntriesByType()`** method of the PerformanceObserverEntryList returns a list of explicitly _observed_ PerformanceEntry objects for a given PerformanceEntry.entryType.
4287
+ *
4288
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntriesByType)
4289
+ */
3499
4290
  getEntriesByType(type: string): PerformanceEntry[];
3500
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntriesByName) */
4291
+ /**
4292
+ * The **`getEntriesByName()`** method of the PerformanceObserverEntryList interface returns a list of explicitly observed PerformanceEntry objects for a given PerformanceEntry.name and PerformanceEntry.entryType.
4293
+ *
4294
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntriesByName)
4295
+ */
3501
4296
  getEntriesByName(name: string, type?: string): PerformanceEntry[];
3502
4297
  }
3503
4298
  /**
3504
- * Encapsulates a single performance metric that is part of the performance timeline. A performance entry can be directly created by making a performance mark or measure (for example by calling the mark() method) at an explicit point in an application. Performance entries are also created in indirect ways such as loading a resource (such as an image).
4299
+ * The **`PerformanceEntry`** object encapsulates a single performance metric that is part of the browser's performance timeline.
3505
4300
  *
3506
4301
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry)
3507
4302
  */
3508
4303
  export declare abstract class PerformanceEntry {
3509
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/name) */
4304
+ /**
4305
+ * The read-only **`name`** property of the PerformanceEntry interface is a string representing the name for a performance entry.
4306
+ *
4307
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/name)
4308
+ */
3510
4309
  get name(): string;
3511
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/entryType) */
4310
+ /**
4311
+ * The read-only **`entryType`** property returns a string representing the type of performance metric that this entry represents.
4312
+ *
4313
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/entryType)
4314
+ */
3512
4315
  get entryType(): string;
3513
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/startTime) */
4316
+ /**
4317
+ * The read-only **`startTime`** property returns the first DOMHighResTimeStamp recorded for this PerformanceEntry.
4318
+ *
4319
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/startTime)
4320
+ */
3514
4321
  get startTime(): number;
3515
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/duration) */
4322
+ /**
4323
+ * The read-only **`duration`** property returns a DOMHighResTimeStamp that is the duration of the PerformanceEntry.
4324
+ *
4325
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/duration)
4326
+ */
3516
4327
  get duration(): number;
3517
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/toJSON) */
4328
+ /**
4329
+ * The **`toJSON()`** method is a Serialization; it returns a JSON representation of the PerformanceEntry object.
4330
+ *
4331
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/toJSON)
4332
+ */
3518
4333
  toJSON(): any;
3519
4334
  }
3520
4335
  /**
3521
- * 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.
4336
+ * The **`PerformanceResourceTiming`** interface enables retrieval and analysis of detailed network timing data regarding the loading of an application's resources.
3522
4337
  *
3523
4338
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming)
3524
4339
  */
3525
4340
  export declare abstract class PerformanceResourceTiming extends PerformanceEntry {
3526
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/connectEnd) */
4341
+ /**
4342
+ * The **`connectEnd`** read-only property returns the DOMHighResTimeStamp immediately after the browser finishes establishing the connection to the server to retrieve the resource.
4343
+ *
4344
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/connectEnd)
4345
+ */
3527
4346
  get connectEnd(): number;
3528
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/connectStart) */
4347
+ /**
4348
+ * The **`connectStart`** read-only property returns the DOMHighResTimeStamp immediately before the user agent starts establishing the connection to the server to retrieve the resource.
4349
+ *
4350
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/connectStart)
4351
+ */
3529
4352
  get connectStart(): number;
3530
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/decodedBodySize) */
4353
+ /**
4354
+ * 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).
4355
+ *
4356
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/decodedBodySize)
4357
+ */
3531
4358
  get decodedBodySize(): number;
3532
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/domainLookupEnd) */
4359
+ /**
4360
+ * The **`domainLookupEnd`** read-only property returns the DOMHighResTimeStamp immediately after the browser finishes the domain-name lookup for the resource.
4361
+ *
4362
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/domainLookupEnd)
4363
+ */
3533
4364
  get domainLookupEnd(): number;
3534
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/domainLookupStart) */
4365
+ /**
4366
+ * The **`domainLookupStart`** read-only property returns the DOMHighResTimeStamp immediately before the browser starts the domain name lookup for the resource.
4367
+ *
4368
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/domainLookupStart)
4369
+ */
3535
4370
  get domainLookupStart(): number;
3536
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/encodedBodySize) */
4371
+ /**
4372
+ * 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).
4373
+ *
4374
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/encodedBodySize)
4375
+ */
3537
4376
  get encodedBodySize(): number;
3538
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/fetchStart) */
4377
+ /**
4378
+ * The **`fetchStart`** read-only property represents a DOMHighResTimeStamp immediately before the browser starts to fetch the resource.
4379
+ *
4380
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/fetchStart)
4381
+ */
3539
4382
  get fetchStart(): number;
3540
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/initiatorType) */
4383
+ /**
4384
+ * The **`initiatorType`** read-only property is a string representing web platform feature that initiated the resource load.
4385
+ *
4386
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/initiatorType)
4387
+ */
3541
4388
  get initiatorType(): string;
3542
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/nextHopProtocol) */
4389
+ /**
4390
+ * The **`nextHopProtocol`** read-only property is a string representing the network protocol used to fetch the resource, as identified by the ALPN Protocol ID (RFC7301).
4391
+ *
4392
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/nextHopProtocol)
4393
+ */
3543
4394
  get nextHopProtocol(): string;
3544
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/redirectEnd) */
4395
+ /**
4396
+ * The **`redirectEnd`** read-only property returns a DOMHighResTimeStamp immediately after receiving the last byte of the response of the last redirect.
4397
+ *
4398
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/redirectEnd)
4399
+ */
3545
4400
  get redirectEnd(): number;
3546
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/redirectStart) */
4401
+ /**
4402
+ * The **`redirectStart`** read-only property returns a DOMHighResTimeStamp representing the start time of the fetch which that initiates the redirect.
4403
+ *
4404
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/redirectStart)
4405
+ */
3547
4406
  get redirectStart(): number;
3548
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/requestStart) */
4407
+ /**
4408
+ * 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.
4409
+ *
4410
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/requestStart)
4411
+ */
3549
4412
  get requestStart(): number;
3550
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/responseEnd) */
4413
+ /**
4414
+ * 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.
4415
+ *
4416
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/responseEnd)
4417
+ */
3551
4418
  get responseEnd(): number;
3552
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/responseStart) */
4419
+ /**
4420
+ * 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.
4421
+ *
4422
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/responseStart)
4423
+ */
3553
4424
  get responseStart(): number;
3554
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/responseStatus) */
4425
+ /**
4426
+ * The **`responseStatus`** read-only property represents the HTTP response status code returned when fetching the resource.
4427
+ *
4428
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/responseStatus)
4429
+ */
3555
4430
  get responseStatus(): number;
3556
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/secureConnectionStart) */
4431
+ /**
4432
+ * The **`secureConnectionStart`** read-only property returns a DOMHighResTimeStamp immediately before the browser starts the handshake process to secure the current connection.
4433
+ *
4434
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/secureConnectionStart)
4435
+ */
3557
4436
  get secureConnectionStart(): number | undefined;
3558
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/transferSize) */
4437
+ /**
4438
+ * The **`transferSize`** read-only property represents the size (in octets) of the fetched resource.
4439
+ *
4440
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/transferSize)
4441
+ */
3559
4442
  get transferSize(): number;
3560
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/workerStart) */
4443
+ /**
4444
+ * The **`workerStart`** read-only property of the PerformanceResourceTiming interface returns a The `workerStart` property can have the following values: - A DOMHighResTimeStamp.
4445
+ *
4446
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/workerStart)
4447
+ */
3561
4448
  get workerStart(): number;
3562
4449
  }
3563
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver) */
4450
+ /**
4451
+ * 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_.
4452
+ *
4453
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver)
4454
+ */
3564
4455
  export declare class PerformanceObserver {
3565
4456
  constructor(callback: any);
3566
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver/disconnect) */
4457
+ /**
4458
+ * The **`disconnect()`** method of the PerformanceObserver interface is used to stop the performance observer from receiving any PerformanceEntry events.
4459
+ *
4460
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver/disconnect)
4461
+ */
3567
4462
  disconnect(): void;
3568
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver/observe) */
4463
+ /**
4464
+ * The **`observe()`** method of the **PerformanceObserver** interface is used to specify the set of performance entry types to observe.
4465
+ *
4466
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver/observe)
4467
+ */
3569
4468
  observe(options?: PerformanceObserverObserveOptions): void;
3570
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver/takeRecords) */
4469
+ /**
4470
+ * The **`takeRecords()`** method of the PerformanceObserver interface returns the current list of PerformanceEntry objects stored in the performance observer, emptying it out.
4471
+ *
4472
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver/takeRecords)
4473
+ */
3571
4474
  takeRecords(): PerformanceEntry[];
3572
4475
  readonly supportedEntryTypes: string[];
3573
4476
  }
@@ -7358,6 +8261,10 @@ export type AutoRagSearchRequest = {
7358
8261
  ranker?: string;
7359
8262
  score_threshold?: number;
7360
8263
  };
8264
+ reranking?: {
8265
+ enabled?: boolean;
8266
+ model?: string;
8267
+ };
7361
8268
  rewrite_query?: boolean;
7362
8269
  };
7363
8270
  export type AutoRagAiSearchRequest = AutoRagSearchRequest & {
@@ -9258,6 +10165,11 @@ export declare namespace CloudflareWorkersModule {
9258
10165
  constructor(ctx: ExecutionContext, env: Env);
9259
10166
  fetch?(request: Request): Response | Promise<Response>;
9260
10167
  tail?(events: TraceItem[]): void | Promise<void>;
10168
+ tailStream?(
10169
+ event: TailStream.TailEvent<TailStream.Onset>,
10170
+ ):
10171
+ | TailStream.TailEventHandlerType
10172
+ | Promise<TailStream.TailEventHandlerType>;
9261
10173
  trace?(traces: TraceItem[]): void | Promise<void>;
9262
10174
  scheduled?(controller: ScheduledController): void | Promise<void>;
9263
10175
  queue?(batch: MessageBatch<unknown>): void | Promise<void>;
@@ -9636,7 +10548,14 @@ export interface VectorizeError {
9636
10548
  *
9637
10549
  * This list is expected to grow as support for more operations are released.
9638
10550
  */
9639
- export type VectorizeVectorMetadataFilterOp = "$eq" | "$ne";
10551
+ export type VectorizeVectorMetadataFilterOp =
10552
+ | "$eq"
10553
+ | "$ne"
10554
+ | "$lt"
10555
+ | "$lte"
10556
+ | "$gt"
10557
+ | "$gte";
10558
+ export type VectorizeVectorMetadataFilterCollectionOp = "$in" | "$nin";
9640
10559
  /**
9641
10560
  * Filter criteria for vector metadata used to limit the retrieved query result set.
9642
10561
  */
@@ -9649,6 +10568,12 @@ export type VectorizeVectorMetadataFilter = {
9649
10568
  VectorizeVectorMetadataValue,
9650
10569
  string[]
9651
10570
  > | null;
10571
+ }
10572
+ | {
10573
+ [Op in VectorizeVectorMetadataFilterCollectionOp]?: Exclude<
10574
+ VectorizeVectorMetadataValue,
10575
+ string[]
10576
+ >[];
9652
10577
  };
9653
10578
  };
9654
10579
  /**