@cloudflare/workers-types 4.20251014.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
  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
  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 @@ type WorkerGlobalScopeEventMap = {
70
79
  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
  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
  declare const console: Console;
@@ -200,7 +285,7 @@ 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)
@@ -322,7 +407,7 @@ declare function removeEventListener<
322
407
  options?: EventTargetEventListenerOptions | boolean,
323
408
  ): void;
324
409
  /**
325
- * 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.
410
+ * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order.
326
411
  *
327
412
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/dispatchEvent)
328
413
  */
@@ -460,13 +545,6 @@ interface ExportedHandler<
460
545
  interface StructuredSerializeOptions {
461
546
  transfer?: any[];
462
547
  }
463
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent) */
464
- declare abstract class PromiseRejectionEvent extends Event {
465
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/promise) */
466
- readonly promise: Promise<any>;
467
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/reason) */
468
- readonly reason: any;
469
- }
470
548
  declare abstract class Navigator {
471
549
  sendBeacon(
472
550
  url: string,
@@ -720,116 +798,120 @@ interface AnalyticsEngineDataPoint {
720
798
  blobs?: ((ArrayBuffer | string) | null)[];
721
799
  }
722
800
  /**
723
- * An event which takes place in the DOM.
801
+ * The **`Event`** interface represents an event which takes place on an `EventTarget`.
724
802
  *
725
803
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event)
726
804
  */
727
805
  declare class Event {
728
806
  constructor(type: string, init?: EventInit);
729
807
  /**
730
- * Returns the type of event, e.g. "click", "hashchange", or "submit".
808
+ * The **`type`** read-only property of the Event interface returns a string containing the event's type.
731
809
  *
732
810
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/type)
733
811
  */
734
812
  get type(): string;
735
813
  /**
736
- * Returns the event's phase, which is one of NONE, CAPTURING_PHASE, AT_TARGET, and BUBBLING_PHASE.
814
+ * The **`eventPhase`** read-only property of the being evaluated.
737
815
  *
738
816
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/eventPhase)
739
817
  */
740
818
  get eventPhase(): number;
741
819
  /**
742
- * 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.
820
+ * The read-only **`composed`** property of the or not the event will propagate across the shadow DOM boundary into the standard DOM.
743
821
  *
744
822
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/composed)
745
823
  */
746
824
  get composed(): boolean;
747
825
  /**
748
- * 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.
826
+ * The **`bubbles`** read-only property of the Event interface indicates whether the event bubbles up through the DOM tree or not.
749
827
  *
750
828
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/bubbles)
751
829
  */
752
830
  get bubbles(): boolean;
753
831
  /**
754
- * 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.
832
+ * 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.
755
833
  *
756
834
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/cancelable)
757
835
  */
758
836
  get cancelable(): boolean;
759
837
  /**
760
- * Returns true if preventDefault() was invoked successfully to indicate cancelation, and false otherwise.
838
+ * 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.
761
839
  *
762
840
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/defaultPrevented)
763
841
  */
764
842
  get defaultPrevented(): boolean;
765
843
  /**
844
+ * The Event property **`returnValue`** indicates whether the default action for this event has been prevented or not.
766
845
  * @deprecated
767
846
  *
768
847
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/returnValue)
769
848
  */
770
849
  get returnValue(): boolean;
771
850
  /**
772
- * Returns the object whose event listener's callback is currently being invoked.
851
+ * The **`currentTarget`** read-only property of the Event interface identifies the element to which the event handler has been attached.
773
852
  *
774
853
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/currentTarget)
775
854
  */
776
855
  get currentTarget(): EventTarget | null;
777
856
  /**
778
- * Returns the object to which event is dispatched (its target).
857
+ * The read-only **`target`** property of the dispatched.
779
858
  *
780
859
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/target)
781
860
  */
782
861
  get target(): EventTarget | undefined;
783
862
  /**
863
+ * The deprecated **`Event.srcElement`** is an alias for the Event.target property.
784
864
  * @deprecated
785
865
  *
786
866
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/srcElement)
787
867
  */
788
868
  get srcElement(): EventTarget | undefined;
789
869
  /**
790
- * Returns the event's timestamp as the number of milliseconds measured relative to the time origin.
870
+ * The **`timeStamp`** read-only property of the Event interface returns the time (in milliseconds) at which the event was created.
791
871
  *
792
872
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/timeStamp)
793
873
  */
794
874
  get timeStamp(): number;
795
875
  /**
796
- * Returns true if event was dispatched by the user agent, and false otherwise.
876
+ * 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.
797
877
  *
798
878
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/isTrusted)
799
879
  */
800
880
  readonly isTrusted: boolean;
801
881
  /**
882
+ * The **`cancelBubble`** property of the Event interface is deprecated.
802
883
  * @deprecated
803
884
  *
804
885
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/cancelBubble)
805
886
  */
806
887
  get cancelBubble(): boolean;
807
888
  /**
889
+ * The **`cancelBubble`** property of the Event interface is deprecated.
808
890
  * @deprecated
809
891
  *
810
892
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/cancelBubble)
811
893
  */
812
894
  set cancelBubble(value: boolean);
813
895
  /**
814
- * 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.
896
+ * 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.
815
897
  *
816
898
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/stopImmediatePropagation)
817
899
  */
818
900
  stopImmediatePropagation(): void;
819
901
  /**
820
- * 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.
902
+ * 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.
821
903
  *
822
904
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/preventDefault)
823
905
  */
824
906
  preventDefault(): void;
825
907
  /**
826
- * When dispatched in a tree, invoking this method prevents event from reaching any objects other than the current object.
908
+ * The **`stopPropagation()`** method of the Event interface prevents further propagation of the current event in the capturing and bubbling phases.
827
909
  *
828
910
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/stopPropagation)
829
911
  */
830
912
  stopPropagation(): void;
831
913
  /**
832
- * 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.
914
+ * 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.
833
915
  *
834
916
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/composedPath)
835
917
  */
@@ -854,7 +936,7 @@ type EventListenerOrEventListenerObject<EventType extends Event = Event> =
854
936
  | EventListener<EventType>
855
937
  | EventListenerObject<EventType>;
856
938
  /**
857
- * EventTarget is a DOM interface implemented by objects that can receive events and may have listeners for them.
939
+ * The **`EventTarget`** interface is implemented by objects that can receive events and may have listeners for them.
858
940
  *
859
941
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget)
860
942
  */
@@ -863,19 +945,7 @@ declare class EventTarget<
863
945
  > {
864
946
  constructor();
865
947
  /**
866
- * 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.
867
- *
868
- * 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.
869
- *
870
- * 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.
871
- *
872
- * 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.
873
- *
874
- * When set to true, options's once indicates that the callback will only be invoked once after which the event listener will be removed.
875
- *
876
- * If an AbortSignal is passed for options's signal, then the event listener will be removed when signal is aborted.
877
- *
878
- * The event listener is appended to target's event listener list and is not appended if it has the same type, callback, and capture.
948
+ * The **`addEventListener()`** method of the EventTarget interface sets up a function that will be called whenever the specified event is delivered to the target.
879
949
  *
880
950
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/addEventListener)
881
951
  */
@@ -885,7 +955,7 @@ declare class EventTarget<
885
955
  options?: EventTargetAddEventListenerOptions | boolean,
886
956
  ): void;
887
957
  /**
888
- * Removes the event listener in target's event listener list with the same type, callback, and options.
958
+ * The **`removeEventListener()`** method of the EventTarget interface removes an event listener previously registered with EventTarget.addEventListener() from the target.
889
959
  *
890
960
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/removeEventListener)
891
961
  */
@@ -895,7 +965,7 @@ declare class EventTarget<
895
965
  options?: EventTargetEventListenerOptions | boolean,
896
966
  ): void;
897
967
  /**
898
- * 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.
968
+ * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order.
899
969
  *
900
970
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/dispatchEvent)
901
971
  */
@@ -914,50 +984,70 @@ interface EventTargetHandlerObject {
914
984
  handleEvent: (event: Event) => any | undefined;
915
985
  }
916
986
  /**
917
- * A controller object that allows you to abort one or more DOM requests as and when desired.
987
+ * The **`AbortController`** interface represents a controller object that allows you to abort one or more Web requests as and when desired.
918
988
  *
919
989
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortController)
920
990
  */
921
991
  declare class AbortController {
922
992
  constructor();
923
993
  /**
924
- * Returns the AbortSignal object associated with this object.
994
+ * 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.
925
995
  *
926
996
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortController/signal)
927
997
  */
928
998
  get signal(): AbortSignal;
929
999
  /**
930
- * 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.
1000
+ * The **`abort()`** method of the AbortController interface aborts an asynchronous operation before it has completed.
931
1001
  *
932
1002
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortController/abort)
933
1003
  */
934
1004
  abort(reason?: any): void;
935
1005
  }
936
1006
  /**
937
- * 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.
1007
+ * 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.
938
1008
  *
939
1009
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal)
940
1010
  */
941
1011
  declare abstract class AbortSignal extends EventTarget {
942
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/abort_static) */
1012
+ /**
1013
+ * The **`AbortSignal.abort()`** static method returns an AbortSignal that is already set as aborted (and which does not trigger an AbortSignal/abort_event event).
1014
+ *
1015
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/abort_static)
1016
+ */
943
1017
  static abort(reason?: any): AbortSignal;
944
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/timeout_static) */
1018
+ /**
1019
+ * The **`AbortSignal.timeout()`** static method returns an AbortSignal that will automatically abort after a specified time.
1020
+ *
1021
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/timeout_static)
1022
+ */
945
1023
  static timeout(delay: number): AbortSignal;
946
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/any_static) */
1024
+ /**
1025
+ * The **`AbortSignal.any()`** static method takes an iterable of abort signals and returns an AbortSignal.
1026
+ *
1027
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/any_static)
1028
+ */
947
1029
  static any(signals: AbortSignal[]): AbortSignal;
948
1030
  /**
949
- * Returns true if this AbortSignal's AbortController has signaled to abort, and false otherwise.
1031
+ * 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`).
950
1032
  *
951
1033
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/aborted)
952
1034
  */
953
1035
  get aborted(): boolean;
954
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/reason) */
1036
+ /**
1037
+ * The **`reason`** read-only property returns a JavaScript value that indicates the abort reason.
1038
+ *
1039
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/reason)
1040
+ */
955
1041
  get reason(): any;
956
1042
  /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/abort_event) */
957
1043
  get onabort(): any | null;
958
1044
  /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/abort_event) */
959
1045
  set onabort(value: any | null);
960
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/throwIfAborted) */
1046
+ /**
1047
+ * The **`throwIfAborted()`** method throws the signal's abort AbortSignal.reason if the signal has been aborted; otherwise it does nothing.
1048
+ *
1049
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/throwIfAborted)
1050
+ */
961
1051
  throwIfAborted(): void;
962
1052
  }
963
1053
  interface Scheduler {
@@ -967,19 +1057,27 @@ interface SchedulerWaitOptions {
967
1057
  signal?: AbortSignal;
968
1058
  }
969
1059
  /**
970
- * 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.
1060
+ * The **`ExtendableEvent`** interface extends the lifetime of the `install` and `activate` events dispatched on the global scope as part of the service worker lifecycle.
971
1061
  *
972
1062
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ExtendableEvent)
973
1063
  */
974
1064
  declare abstract class ExtendableEvent extends Event {
975
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ExtendableEvent/waitUntil) */
1065
+ /**
1066
+ * The **`ExtendableEvent.waitUntil()`** method tells the event dispatcher that work is ongoing.
1067
+ *
1068
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ExtendableEvent/waitUntil)
1069
+ */
976
1070
  waitUntil(promise: Promise<any>): void;
977
1071
  }
978
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomEvent) */
1072
+ /**
1073
+ * The **`CustomEvent`** interface represents events initialized by an application for any purpose.
1074
+ *
1075
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomEvent)
1076
+ */
979
1077
  declare class CustomEvent<T = any> extends Event {
980
1078
  constructor(type: string, init?: CustomEventCustomEventInit);
981
1079
  /**
982
- * Returns any custom data event was created with. Typically used for synthetic events.
1080
+ * The read-only **`detail`** property of the CustomEvent interface returns any data passed when initializing the event.
983
1081
  *
984
1082
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomEvent/detail)
985
1083
  */
@@ -992,7 +1090,7 @@ interface CustomEventCustomEventInit {
992
1090
  detail?: any;
993
1091
  }
994
1092
  /**
995
- * 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.
1093
+ * 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.
996
1094
  *
997
1095
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob)
998
1096
  */
@@ -1001,26 +1099,54 @@ declare class Blob {
1001
1099
  type?: ((ArrayBuffer | ArrayBufferView) | string | Blob)[],
1002
1100
  options?: BlobOptions,
1003
1101
  );
1004
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/size) */
1102
+ /**
1103
+ * The **`size`** read-only property of the Blob interface returns the size of the Blob or File in bytes.
1104
+ *
1105
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/size)
1106
+ */
1005
1107
  get size(): number;
1006
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/type) */
1108
+ /**
1109
+ * The **`type`** read-only property of the Blob interface returns the MIME type of the file.
1110
+ *
1111
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/type)
1112
+ */
1007
1113
  get type(): string;
1008
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/slice) */
1114
+ /**
1115
+ * 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.
1116
+ *
1117
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/slice)
1118
+ */
1009
1119
  slice(start?: number, end?: number, type?: string): Blob;
1010
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/arrayBuffer) */
1120
+ /**
1121
+ * 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.
1122
+ *
1123
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/arrayBuffer)
1124
+ */
1011
1125
  arrayBuffer(): Promise<ArrayBuffer>;
1012
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/bytes) */
1126
+ /**
1127
+ * 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.
1128
+ *
1129
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/bytes)
1130
+ */
1013
1131
  bytes(): Promise<Uint8Array>;
1014
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/text) */
1132
+ /**
1133
+ * The **`text()`** method of the string containing the contents of the blob, interpreted as UTF-8.
1134
+ *
1135
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/text)
1136
+ */
1015
1137
  text(): Promise<string>;
1016
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/stream) */
1138
+ /**
1139
+ * The **`stream()`** method of the Blob interface returns a ReadableStream which upon reading returns the data contained within the `Blob`.
1140
+ *
1141
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/stream)
1142
+ */
1017
1143
  stream(): ReadableStream;
1018
1144
  }
1019
1145
  interface BlobOptions {
1020
1146
  type?: string;
1021
1147
  }
1022
1148
  /**
1023
- * Provides information about files and allows JavaScript in a web page to access their content.
1149
+ * The **`File`** interface provides information about files and allows JavaScript in a web page to access their content.
1024
1150
  *
1025
1151
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/File)
1026
1152
  */
@@ -1030,9 +1156,17 @@ declare class File extends Blob {
1030
1156
  name: string,
1031
1157
  options?: FileOptions,
1032
1158
  );
1033
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/name) */
1159
+ /**
1160
+ * The **`name`** read-only property of the File interface returns the name of the file represented by a File object.
1161
+ *
1162
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/name)
1163
+ */
1034
1164
  get name(): string;
1035
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/lastModified) */
1165
+ /**
1166
+ * 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).
1167
+ *
1168
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/File/lastModified)
1169
+ */
1036
1170
  get lastModified(): number;
1037
1171
  }
1038
1172
  interface FileOptions {
@@ -1045,7 +1179,11 @@ interface FileOptions {
1045
1179
  * [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/cache/)
1046
1180
  */
1047
1181
  declare abstract class CacheStorage {
1048
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CacheStorage/open) */
1182
+ /**
1183
+ * The **`open()`** method of the the Cache object matching the `cacheName`.
1184
+ *
1185
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CacheStorage/open)
1186
+ */
1049
1187
  open(cacheName: string): Promise<Cache>;
1050
1188
  readonly default: Cache;
1051
1189
  }
@@ -1081,12 +1219,17 @@ interface CacheQueryOptions {
1081
1219
  */
1082
1220
  declare abstract class Crypto {
1083
1221
  /**
1222
+ * The **`Crypto.subtle`** read-only property returns a cryptographic operations.
1084
1223
  * Available only in secure contexts.
1085
1224
  *
1086
1225
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Crypto/subtle)
1087
1226
  */
1088
1227
  get subtle(): SubtleCrypto;
1089
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Crypto/getRandomValues) */
1228
+ /**
1229
+ * The **`Crypto.getRandomValues()`** method lets you get cryptographically strong random values.
1230
+ *
1231
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Crypto/getRandomValues)
1232
+ */
1090
1233
  getRandomValues<
1091
1234
  T extends
1092
1235
  | Int8Array
@@ -1099,6 +1242,7 @@ declare abstract class Crypto {
1099
1242
  | BigUint64Array,
1100
1243
  >(buffer: T): T;
1101
1244
  /**
1245
+ * The **`randomUUID()`** method of the Crypto interface is used to generate a v4 UUID using a cryptographically secure random number generator.
1102
1246
  * Available only in secure contexts.
1103
1247
  *
1104
1248
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Crypto/randomUUID)
@@ -1107,49 +1251,77 @@ declare abstract class Crypto {
1107
1251
  DigestStream: typeof DigestStream;
1108
1252
  }
1109
1253
  /**
1110
- * 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).
1254
+ * The **`SubtleCrypto`** interface of the Web Crypto API provides a number of low-level cryptographic functions.
1111
1255
  * Available only in secure contexts.
1112
1256
  *
1113
1257
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto)
1114
1258
  */
1115
1259
  declare abstract class SubtleCrypto {
1116
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/encrypt) */
1260
+ /**
1261
+ * The **`encrypt()`** method of the SubtleCrypto interface encrypts data.
1262
+ *
1263
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/encrypt)
1264
+ */
1117
1265
  encrypt(
1118
1266
  algorithm: string | SubtleCryptoEncryptAlgorithm,
1119
1267
  key: CryptoKey,
1120
1268
  plainText: ArrayBuffer | ArrayBufferView,
1121
1269
  ): Promise<ArrayBuffer>;
1122
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/decrypt) */
1270
+ /**
1271
+ * The **`decrypt()`** method of the SubtleCrypto interface decrypts some encrypted data.
1272
+ *
1273
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/decrypt)
1274
+ */
1123
1275
  decrypt(
1124
1276
  algorithm: string | SubtleCryptoEncryptAlgorithm,
1125
1277
  key: CryptoKey,
1126
1278
  cipherText: ArrayBuffer | ArrayBufferView,
1127
1279
  ): Promise<ArrayBuffer>;
1128
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/sign) */
1280
+ /**
1281
+ * The **`sign()`** method of the SubtleCrypto interface generates a digital signature.
1282
+ *
1283
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/sign)
1284
+ */
1129
1285
  sign(
1130
1286
  algorithm: string | SubtleCryptoSignAlgorithm,
1131
1287
  key: CryptoKey,
1132
1288
  data: ArrayBuffer | ArrayBufferView,
1133
1289
  ): Promise<ArrayBuffer>;
1134
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/verify) */
1290
+ /**
1291
+ * The **`verify()`** method of the SubtleCrypto interface verifies a digital signature.
1292
+ *
1293
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/verify)
1294
+ */
1135
1295
  verify(
1136
1296
  algorithm: string | SubtleCryptoSignAlgorithm,
1137
1297
  key: CryptoKey,
1138
1298
  signature: ArrayBuffer | ArrayBufferView,
1139
1299
  data: ArrayBuffer | ArrayBufferView,
1140
1300
  ): Promise<boolean>;
1141
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/digest) */
1301
+ /**
1302
+ * The **`digest()`** method of the SubtleCrypto interface generates a _digest_ of the given data, using the specified hash function.
1303
+ *
1304
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/digest)
1305
+ */
1142
1306
  digest(
1143
1307
  algorithm: string | SubtleCryptoHashAlgorithm,
1144
1308
  data: ArrayBuffer | ArrayBufferView,
1145
1309
  ): Promise<ArrayBuffer>;
1146
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/generateKey) */
1310
+ /**
1311
+ * The **`generateKey()`** method of the SubtleCrypto interface is used to generate a new key (for symmetric algorithms) or key pair (for public-key algorithms).
1312
+ *
1313
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/generateKey)
1314
+ */
1147
1315
  generateKey(
1148
1316
  algorithm: string | SubtleCryptoGenerateKeyAlgorithm,
1149
1317
  extractable: boolean,
1150
1318
  keyUsages: string[],
1151
1319
  ): Promise<CryptoKey | CryptoKeyPair>;
1152
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/deriveKey) */
1320
+ /**
1321
+ * The **`deriveKey()`** method of the SubtleCrypto interface can be used to derive a secret key from a master key.
1322
+ *
1323
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/deriveKey)
1324
+ */
1153
1325
  deriveKey(
1154
1326
  algorithm: string | SubtleCryptoDeriveKeyAlgorithm,
1155
1327
  baseKey: CryptoKey,
@@ -1157,13 +1329,21 @@ declare abstract class SubtleCrypto {
1157
1329
  extractable: boolean,
1158
1330
  keyUsages: string[],
1159
1331
  ): Promise<CryptoKey>;
1160
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/deriveBits) */
1332
+ /**
1333
+ * The **`deriveBits()`** method of the key.
1334
+ *
1335
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/deriveBits)
1336
+ */
1161
1337
  deriveBits(
1162
1338
  algorithm: string | SubtleCryptoDeriveKeyAlgorithm,
1163
1339
  baseKey: CryptoKey,
1164
1340
  length?: number | null,
1165
1341
  ): Promise<ArrayBuffer>;
1166
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/importKey) */
1342
+ /**
1343
+ * 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.
1344
+ *
1345
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/importKey)
1346
+ */
1167
1347
  importKey(
1168
1348
  format: string,
1169
1349
  keyData: (ArrayBuffer | ArrayBufferView) | JsonWebKey,
@@ -1171,16 +1351,28 @@ declare abstract class SubtleCrypto {
1171
1351
  extractable: boolean,
1172
1352
  keyUsages: string[],
1173
1353
  ): Promise<CryptoKey>;
1174
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/exportKey) */
1354
+ /**
1355
+ * 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.
1356
+ *
1357
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/exportKey)
1358
+ */
1175
1359
  exportKey(format: string, key: CryptoKey): Promise<ArrayBuffer | JsonWebKey>;
1176
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/wrapKey) */
1360
+ /**
1361
+ * The **`wrapKey()`** method of the SubtleCrypto interface 'wraps' a key.
1362
+ *
1363
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/wrapKey)
1364
+ */
1177
1365
  wrapKey(
1178
1366
  format: string,
1179
1367
  key: CryptoKey,
1180
1368
  wrappingKey: CryptoKey,
1181
1369
  wrapAlgorithm: string | SubtleCryptoEncryptAlgorithm,
1182
1370
  ): Promise<ArrayBuffer>;
1183
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/unwrapKey) */
1371
+ /**
1372
+ * The **`unwrapKey()`** method of the SubtleCrypto interface 'unwraps' a key.
1373
+ *
1374
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/SubtleCrypto/unwrapKey)
1375
+ */
1184
1376
  unwrapKey(
1185
1377
  format: string,
1186
1378
  wrappedKey: ArrayBuffer | ArrayBufferView,
@@ -1196,17 +1388,29 @@ declare abstract class SubtleCrypto {
1196
1388
  ): boolean;
1197
1389
  }
1198
1390
  /**
1199
- * The CryptoKey dictionary of the Web Crypto API represents a cryptographic key.
1391
+ * 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.
1200
1392
  * Available only in secure contexts.
1201
1393
  *
1202
1394
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey)
1203
1395
  */
1204
1396
  declare abstract class CryptoKey {
1205
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/type) */
1397
+ /**
1398
+ * The read-only **`type`** property of the CryptoKey interface indicates which kind of key is represented by the object.
1399
+ *
1400
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/type)
1401
+ */
1206
1402
  readonly type: string;
1207
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/extractable) */
1403
+ /**
1404
+ * The read-only **`extractable`** property of the CryptoKey interface indicates whether or not the key may be extracted using `SubtleCrypto.exportKey()` or `SubtleCrypto.wrapKey()`.
1405
+ *
1406
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/extractable)
1407
+ */
1208
1408
  readonly extractable: boolean;
1209
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/algorithm) */
1409
+ /**
1410
+ * 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.
1411
+ *
1412
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/algorithm)
1413
+ */
1210
1414
  readonly algorithm:
1211
1415
  | CryptoKeyKeyAlgorithm
1212
1416
  | CryptoKeyAesKeyAlgorithm
@@ -1214,7 +1418,11 @@ declare abstract class CryptoKey {
1214
1418
  | CryptoKeyRsaKeyAlgorithm
1215
1419
  | CryptoKeyEllipticKeyAlgorithm
1216
1420
  | CryptoKeyArbitraryKeyAlgorithm;
1217
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/usages) */
1421
+ /**
1422
+ * The read-only **`usages`** property of the CryptoKey interface indicates what can be done with the key.
1423
+ *
1424
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CryptoKey/usages)
1425
+ */
1218
1426
  readonly usages: string[];
1219
1427
  }
1220
1428
  interface CryptoKeyPair {
@@ -1323,24 +1531,14 @@ declare class DigestStream extends WritableStream<
1323
1531
  get bytesWritten(): number | bigint;
1324
1532
  }
1325
1533
  /**
1326
- * 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.
1534
+ * The **`TextDecoder`** interface represents a decoder for a specific text encoding, such as `UTF-8`, `ISO-8859-2`, `KOI8-R`, `GBK`, etc.
1327
1535
  *
1328
1536
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoder)
1329
1537
  */
1330
1538
  declare class TextDecoder {
1331
1539
  constructor(label?: string, options?: TextDecoderConstructorOptions);
1332
1540
  /**
1333
- * 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.
1334
- *
1335
- * ```
1336
- * var string = "", decoder = new TextDecoder(encoding), buffer;
1337
- * while(buffer = next_chunk()) {
1338
- * string += decoder.decode(buffer, {stream:true});
1339
- * }
1340
- * string += decoder.decode(); // end-of-queue
1341
- * ```
1342
- *
1343
- * If the error mode is "fatal" and encoding's decoder returns error, throws a TypeError.
1541
+ * The **`TextDecoder.decode()`** method returns a string containing text decoded from the buffer passed as a parameter.
1344
1542
  *
1345
1543
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoder/decode)
1346
1544
  */
@@ -1353,27 +1551,24 @@ declare class TextDecoder {
1353
1551
  get ignoreBOM(): boolean;
1354
1552
  }
1355
1553
  /**
1356
- * 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.
1554
+ * The **`TextEncoder`** interface takes a stream of code points as input and emits a stream of UTF-8 bytes.
1357
1555
  *
1358
1556
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder)
1359
1557
  */
1360
1558
  declare class TextEncoder {
1361
1559
  constructor();
1362
1560
  /**
1363
- * Returns the result of running UTF-8's encoder.
1561
+ * 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.
1364
1562
  *
1365
1563
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encode)
1366
1564
  */
1367
1565
  encode(input?: string): Uint8Array;
1368
1566
  /**
1369
- * 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.
1567
+ * 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.
1370
1568
  *
1371
1569
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encodeInto)
1372
1570
  */
1373
- encodeInto(
1374
- input: string,
1375
- buffer: ArrayBuffer | ArrayBufferView,
1376
- ): TextEncoderEncodeIntoResult;
1571
+ encodeInto(input: string, buffer: Uint8Array): TextEncoderEncodeIntoResult;
1377
1572
  get encoding(): string;
1378
1573
  }
1379
1574
  interface TextDecoderConstructorOptions {
@@ -1388,21 +1583,41 @@ interface TextEncoderEncodeIntoResult {
1388
1583
  written: number;
1389
1584
  }
1390
1585
  /**
1391
- * Events providing information related to errors in scripts or in files.
1586
+ * The **`ErrorEvent`** interface represents events providing information related to errors in scripts or in files.
1392
1587
  *
1393
1588
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent)
1394
1589
  */
1395
1590
  declare class ErrorEvent extends Event {
1396
1591
  constructor(type: string, init?: ErrorEventErrorEventInit);
1397
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/filename) */
1592
+ /**
1593
+ * The **`filename`** read-only property of the ErrorEvent interface returns a string containing the name of the script file in which the error occurred.
1594
+ *
1595
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/filename)
1596
+ */
1398
1597
  get filename(): string;
1399
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/message) */
1598
+ /**
1599
+ * The **`message`** read-only property of the ErrorEvent interface returns a string containing a human-readable error message describing the problem.
1600
+ *
1601
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/message)
1602
+ */
1400
1603
  get message(): string;
1401
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/lineno) */
1604
+ /**
1605
+ * 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.
1606
+ *
1607
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/lineno)
1608
+ */
1402
1609
  get lineno(): number;
1403
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/colno) */
1610
+ /**
1611
+ * 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.
1612
+ *
1613
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/colno)
1614
+ */
1404
1615
  get colno(): number;
1405
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/error) */
1616
+ /**
1617
+ * 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.
1618
+ *
1619
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ErrorEvent/error)
1620
+ */
1406
1621
  get error(): any;
1407
1622
  }
1408
1623
  interface ErrorEventErrorEventInit {
@@ -1413,38 +1628,38 @@ interface ErrorEventErrorEventInit {
1413
1628
  error?: any;
1414
1629
  }
1415
1630
  /**
1416
- * A message received by a target object.
1631
+ * The **`MessageEvent`** interface represents a message received by a target object.
1417
1632
  *
1418
1633
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent)
1419
1634
  */
1420
1635
  declare class MessageEvent extends Event {
1421
1636
  constructor(type: string, initializer: MessageEventInit);
1422
1637
  /**
1423
- * Returns the data of the message.
1638
+ * 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.
1424
1639
  *
1425
1640
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/data)
1426
1641
  */
1427
1642
  readonly data: any;
1428
1643
  /**
1429
- * Returns the origin of the message, for server-sent events and cross-document messaging.
1644
+ * The **`origin`** read-only property of the origin of the message emitter.
1430
1645
  *
1431
1646
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/origin)
1432
1647
  */
1433
1648
  readonly origin: string | null;
1434
1649
  /**
1435
- * Returns the last event ID string, for server-sent events.
1650
+ * The **`lastEventId`** read-only property of the unique ID for the event.
1436
1651
  *
1437
1652
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/lastEventId)
1438
1653
  */
1439
1654
  readonly lastEventId: string;
1440
1655
  /**
1441
- * Returns the WindowProxy of the source window, for cross-document messaging, and the MessagePort being attached, in the connect event fired at SharedWorkerGlobalScope objects.
1656
+ * The **`source`** read-only property of the a WindowProxy, MessagePort, or a `MessageEventSource` (which can be a WindowProxy, message emitter.
1442
1657
  *
1443
1658
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/source)
1444
1659
  */
1445
1660
  readonly source: MessagePort | null;
1446
1661
  /**
1447
- * Returns the MessagePort array sent with the message, for cross-document messaging and channel messaging.
1662
+ * The **`ports`** read-only property of the containing all MessagePort objects sent with the message, in order.
1448
1663
  *
1449
1664
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/ports)
1450
1665
  */
@@ -1454,27 +1669,78 @@ interface MessageEventInit {
1454
1669
  data: ArrayBuffer | string;
1455
1670
  }
1456
1671
  /**
1457
- * 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".
1672
+ * The **`PromiseRejectionEvent`** interface represents events which are sent to the global script context when JavaScript Promises are rejected.
1673
+ *
1674
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent)
1675
+ */
1676
+ declare abstract class PromiseRejectionEvent extends Event {
1677
+ /**
1678
+ * The PromiseRejectionEvent interface's **`promise`** read-only property indicates the JavaScript rejected.
1679
+ *
1680
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/promise)
1681
+ */
1682
+ readonly promise: Promise<any>;
1683
+ /**
1684
+ * The PromiseRejectionEvent **`reason`** read-only property is any JavaScript value or Object which provides the reason passed into Promise.reject().
1685
+ *
1686
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/reason)
1687
+ */
1688
+ readonly reason: any;
1689
+ }
1690
+ /**
1691
+ * 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.
1458
1692
  *
1459
1693
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData)
1460
1694
  */
1461
1695
  declare class FormData {
1462
1696
  constructor();
1463
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/append) */
1697
+ /**
1698
+ * 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.
1699
+ *
1700
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/append)
1701
+ */
1464
1702
  append(name: string, value: string): void;
1465
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/append) */
1703
+ /**
1704
+ * 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.
1705
+ *
1706
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/append)
1707
+ */
1466
1708
  append(name: string, value: Blob, filename?: string): void;
1467
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/delete) */
1709
+ /**
1710
+ * The **`delete()`** method of the FormData interface deletes a key and its value(s) from a `FormData` object.
1711
+ *
1712
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/delete)
1713
+ */
1468
1714
  delete(name: string): void;
1469
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/get) */
1715
+ /**
1716
+ * The **`get()`** method of the FormData interface returns the first value associated with a given key from within a `FormData` object.
1717
+ *
1718
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/get)
1719
+ */
1470
1720
  get(name: string): (File | string) | null;
1471
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/getAll) */
1721
+ /**
1722
+ * The **`getAll()`** method of the FormData interface returns all the values associated with a given key from within a `FormData` object.
1723
+ *
1724
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/getAll)
1725
+ */
1472
1726
  getAll(name: string): (File | string)[];
1473
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/has) */
1727
+ /**
1728
+ * The **`has()`** method of the FormData interface returns whether a `FormData` object contains a certain key.
1729
+ *
1730
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/has)
1731
+ */
1474
1732
  has(name: string): boolean;
1475
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/set) */
1733
+ /**
1734
+ * 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.
1735
+ *
1736
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/set)
1737
+ */
1476
1738
  set(name: string, value: string): void;
1477
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/set) */
1739
+ /**
1740
+ * 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.
1741
+ *
1742
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FormData/set)
1743
+ */
1478
1744
  set(name: string, value: Blob, filename?: string): void;
1479
1745
  /* Returns an array of key, value pairs for every entry in the list. */
1480
1746
  entries(): IterableIterator<[key: string, value: File | string]>;
@@ -1600,14 +1866,22 @@ interface DocumentEnd {
1600
1866
  append(content: string, options?: ContentOptions): DocumentEnd;
1601
1867
  }
1602
1868
  /**
1603
- * 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.
1869
+ * This is the event type for `fetch` events dispatched on the ServiceWorkerGlobalScope.
1604
1870
  *
1605
1871
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent)
1606
1872
  */
1607
1873
  declare abstract class FetchEvent extends ExtendableEvent {
1608
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent/request) */
1874
+ /**
1875
+ * The **`request`** read-only property of the the event handler.
1876
+ *
1877
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent/request)
1878
+ */
1609
1879
  readonly request: Request;
1610
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent/respondWith) */
1880
+ /**
1881
+ * The **`respondWith()`** method of allows you to provide a promise for a Response yourself.
1882
+ *
1883
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FetchEvent/respondWith)
1884
+ */
1611
1885
  respondWith(promise: Response | Promise<Response>): void;
1612
1886
  passThroughOnException(): void;
1613
1887
  }
@@ -1616,24 +1890,48 @@ type HeadersInit =
1616
1890
  | Iterable<Iterable<string>>
1617
1891
  | Record<string, string>;
1618
1892
  /**
1619
- * 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.
1893
+ * The **`Headers`** interface of the Fetch API allows you to perform various actions on HTTP request and response headers.
1620
1894
  *
1621
1895
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers)
1622
1896
  */
1623
1897
  declare class Headers {
1624
1898
  constructor(init?: HeadersInit);
1625
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/get) */
1899
+ /**
1900
+ * 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.
1901
+ *
1902
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/get)
1903
+ */
1626
1904
  get(name: string): string | null;
1627
1905
  getAll(name: string): string[];
1628
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/getSetCookie) */
1906
+ /**
1907
+ * The **`getSetCookie()`** method of the Headers interface returns an array containing the values of all Set-Cookie headers associated with a response.
1908
+ *
1909
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/getSetCookie)
1910
+ */
1629
1911
  getSetCookie(): string[];
1630
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/has) */
1912
+ /**
1913
+ * The **`has()`** method of the Headers interface returns a boolean stating whether a `Headers` object contains a certain header.
1914
+ *
1915
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/has)
1916
+ */
1631
1917
  has(name: string): boolean;
1632
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/set) */
1918
+ /**
1919
+ * 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.
1920
+ *
1921
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/set)
1922
+ */
1633
1923
  set(name: string, value: string): void;
1634
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/append) */
1924
+ /**
1925
+ * 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.
1926
+ *
1927
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/append)
1928
+ */
1635
1929
  append(name: string, value: string): void;
1636
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/delete) */
1930
+ /**
1931
+ * The **`delete()`** method of the Headers interface deletes a header from the current `Headers` object.
1932
+ *
1933
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Headers/delete)
1934
+ */
1637
1935
  delete(name: string): void;
1638
1936
  forEach<This = unknown>(
1639
1937
  callback: (this: This, value: string, key: string, parent: Headers) => void,
@@ -1674,7 +1972,7 @@ declare abstract class Body {
1674
1972
  blob(): Promise<Blob>;
1675
1973
  }
1676
1974
  /**
1677
- * This Fetch API interface represents the response to a request.
1975
+ * The **`Response`** interface of the Fetch API represents the response to a request.
1678
1976
  *
1679
1977
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response)
1680
1978
  */
@@ -1686,28 +1984,60 @@ declare var Response: {
1686
1984
  json(any: any, maybeInit?: ResponseInit | Response): Response;
1687
1985
  };
1688
1986
  /**
1689
- * This Fetch API interface represents the response to a request.
1987
+ * The **`Response`** interface of the Fetch API represents the response to a request.
1690
1988
  *
1691
1989
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response)
1692
1990
  */
1693
1991
  interface Response extends Body {
1694
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/clone) */
1992
+ /**
1993
+ * The **`clone()`** method of the Response interface creates a clone of a response object, identical in every way, but stored in a different variable.
1994
+ *
1995
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/clone)
1996
+ */
1695
1997
  clone(): Response;
1696
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/status) */
1998
+ /**
1999
+ * The **`status`** read-only property of the Response interface contains the HTTP status codes of the response.
2000
+ *
2001
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/status)
2002
+ */
1697
2003
  status: number;
1698
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/statusText) */
2004
+ /**
2005
+ * The **`statusText`** read-only property of the Response interface contains the status message corresponding to the HTTP status code in Response.status.
2006
+ *
2007
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/statusText)
2008
+ */
1699
2009
  statusText: string;
1700
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/headers) */
2010
+ /**
2011
+ * The **`headers`** read-only property of the with the response.
2012
+ *
2013
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/headers)
2014
+ */
1701
2015
  headers: Headers;
1702
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/ok) */
2016
+ /**
2017
+ * 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.
2018
+ *
2019
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/ok)
2020
+ */
1703
2021
  ok: boolean;
1704
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/redirected) */
2022
+ /**
2023
+ * 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.
2024
+ *
2025
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/redirected)
2026
+ */
1705
2027
  redirected: boolean;
1706
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/url) */
2028
+ /**
2029
+ * The **`url`** read-only property of the Response interface contains the URL of the response.
2030
+ *
2031
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/url)
2032
+ */
1707
2033
  url: string;
1708
2034
  webSocket: WebSocket | null;
1709
2035
  cf: any | undefined;
1710
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/type) */
2036
+ /**
2037
+ * The **`type`** read-only property of the Response interface contains the type of the response.
2038
+ *
2039
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Response/type)
2040
+ */
1711
2041
  type: "default" | "error";
1712
2042
  }
1713
2043
  interface ResponseInit {
@@ -1722,7 +2052,7 @@ type RequestInfo<CfHostMetadata = unknown, Cf = CfProperties<CfHostMetadata>> =
1722
2052
  | Request<CfHostMetadata, Cf>
1723
2053
  | string;
1724
2054
  /**
1725
- * This Fetch API interface represents a resource request.
2055
+ * The **`Request`** interface of the Fetch API represents a resource request.
1726
2056
  *
1727
2057
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request)
1728
2058
  */
@@ -1734,64 +2064,68 @@ declare var Request: {
1734
2064
  ): Request<CfHostMetadata, Cf>;
1735
2065
  };
1736
2066
  /**
1737
- * This Fetch API interface represents a resource request.
2067
+ * The **`Request`** interface of the Fetch API represents a resource request.
1738
2068
  *
1739
2069
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request)
1740
2070
  */
1741
2071
  interface Request<CfHostMetadata = unknown, Cf = CfProperties<CfHostMetadata>>
1742
2072
  extends Body {
1743
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/clone) */
2073
+ /**
2074
+ * The **`clone()`** method of the Request interface creates a copy of the current `Request` object.
2075
+ *
2076
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/clone)
2077
+ */
1744
2078
  clone(): Request<CfHostMetadata, Cf>;
1745
2079
  /**
1746
- * Returns request's HTTP method, which is "GET" by default.
2080
+ * The **`method`** read-only property of the `POST`, etc.) A String indicating the method of the request.
1747
2081
  *
1748
2082
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/method)
1749
2083
  */
1750
2084
  method: string;
1751
2085
  /**
1752
- * Returns the URL of request as a string.
2086
+ * The **`url`** read-only property of the Request interface contains the URL of the request.
1753
2087
  *
1754
2088
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/url)
1755
2089
  */
1756
2090
  url: string;
1757
2091
  /**
1758
- * 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.
2092
+ * The **`headers`** read-only property of the with the request.
1759
2093
  *
1760
2094
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/headers)
1761
2095
  */
1762
2096
  headers: Headers;
1763
2097
  /**
1764
- * 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.
2098
+ * The **`redirect`** read-only property of the Request interface contains the mode for how redirects are handled.
1765
2099
  *
1766
2100
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/redirect)
1767
2101
  */
1768
2102
  redirect: string;
1769
2103
  fetcher: Fetcher | null;
1770
2104
  /**
1771
- * Returns the signal associated with request, which is an AbortSignal object indicating whether or not request has been aborted, and its abort event handler.
2105
+ * The read-only **`signal`** property of the Request interface returns the AbortSignal associated with the request.
1772
2106
  *
1773
2107
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/signal)
1774
2108
  */
1775
2109
  signal: AbortSignal;
1776
2110
  cf: Cf | undefined;
1777
2111
  /**
1778
- * 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]
2112
+ * The **`integrity`** read-only property of the Request interface contains the subresource integrity value of the request.
1779
2113
  *
1780
2114
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/integrity)
1781
2115
  */
1782
2116
  integrity: string;
1783
2117
  /**
1784
- * Returns a boolean indicating whether or not request can outlive the global in which it was created.
2118
+ * 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.
1785
2119
  *
1786
2120
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/keepalive)
1787
2121
  */
1788
2122
  keepalive: boolean;
1789
2123
  /**
1790
- * Returns the cache mode associated with request, which is a string indicating how the request will interact with the browser's cache when fetching.
2124
+ * The **`cache`** read-only property of the Request interface contains the cache mode of the request.
1791
2125
  *
1792
2126
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/cache)
1793
2127
  */
1794
- cache?: "no-store" | "no-cache";
2128
+ cache?: "no-store" | "no-cache" | "reload";
1795
2129
  }
1796
2130
  interface RequestInit<Cf = CfProperties> {
1797
2131
  /* A string to set request's method. */
@@ -1805,7 +2139,7 @@ interface RequestInit<Cf = CfProperties> {
1805
2139
  fetcher?: Fetcher | null;
1806
2140
  cf?: Cf;
1807
2141
  /* A string indicating how the request will interact with the browser's cache to set request's cache. */
1808
- cache?: "no-store" | "no-cache";
2142
+ cache?: "no-store" | "no-cache" | "reload";
1809
2143
  /* A cryptographic hash of the resource to be fetched by request. Sets request's integrity. */
1810
2144
  integrity?: string;
1811
2145
  /* An AbortSignal to set request's signal. */
@@ -2345,30 +2679,58 @@ type ReadableStreamReadResult<R = any> =
2345
2679
  value?: undefined;
2346
2680
  };
2347
2681
  /**
2348
- * 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.
2682
+ * The `ReadableStream` interface of the Streams API represents a readable stream of byte data.
2349
2683
  *
2350
2684
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream)
2351
2685
  */
2352
2686
  interface ReadableStream<R = any> {
2353
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/locked) */
2687
+ /**
2688
+ * The **`locked`** read-only property of the ReadableStream interface returns whether or not the readable stream is locked to a reader.
2689
+ *
2690
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/locked)
2691
+ */
2354
2692
  get locked(): boolean;
2355
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/cancel) */
2693
+ /**
2694
+ * The **`cancel()`** method of the ReadableStream interface returns a Promise that resolves when the stream is canceled.
2695
+ *
2696
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/cancel)
2697
+ */
2356
2698
  cancel(reason?: any): Promise<void>;
2357
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/getReader) */
2699
+ /**
2700
+ * The **`getReader()`** method of the ReadableStream interface creates a reader and locks the stream to it.
2701
+ *
2702
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/getReader)
2703
+ */
2358
2704
  getReader(): ReadableStreamDefaultReader<R>;
2359
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/getReader) */
2705
+ /**
2706
+ * The **`getReader()`** method of the ReadableStream interface creates a reader and locks the stream to it.
2707
+ *
2708
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/getReader)
2709
+ */
2360
2710
  getReader(options: ReadableStreamGetReaderOptions): ReadableStreamBYOBReader;
2361
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/pipeThrough) */
2711
+ /**
2712
+ * 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.
2713
+ *
2714
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/pipeThrough)
2715
+ */
2362
2716
  pipeThrough<T>(
2363
2717
  transform: ReadableWritablePair<T, R>,
2364
2718
  options?: StreamPipeOptions,
2365
2719
  ): ReadableStream<T>;
2366
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/pipeTo) */
2720
+ /**
2721
+ * 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.
2722
+ *
2723
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/pipeTo)
2724
+ */
2367
2725
  pipeTo(
2368
2726
  destination: WritableStream<R>,
2369
2727
  options?: StreamPipeOptions,
2370
2728
  ): Promise<void>;
2371
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/tee) */
2729
+ /**
2730
+ * The **`tee()`** method of the two-element array containing the two resulting branches as new ReadableStream instances.
2731
+ *
2732
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/tee)
2733
+ */
2372
2734
  tee(): [ReadableStream<R>, ReadableStream<R>];
2373
2735
  values(options?: ReadableStreamValuesOptions): AsyncIterableIterator<R>;
2374
2736
  [Symbol.asyncIterator](
@@ -2376,7 +2738,7 @@ interface ReadableStream<R = any> {
2376
2738
  ): AsyncIterableIterator<R>;
2377
2739
  }
2378
2740
  /**
2379
- * 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.
2741
+ * The `ReadableStream` interface of the Streams API represents a readable stream of byte data.
2380
2742
  *
2381
2743
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream)
2382
2744
  */
@@ -2391,26 +2753,50 @@ declare const ReadableStream: {
2391
2753
  strategy?: QueuingStrategy<R>,
2392
2754
  ): ReadableStream<R>;
2393
2755
  };
2394
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultReader) */
2756
+ /**
2757
+ * 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).
2758
+ *
2759
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultReader)
2760
+ */
2395
2761
  declare class ReadableStreamDefaultReader<R = any> {
2396
2762
  constructor(stream: ReadableStream);
2397
2763
  get closed(): Promise<void>;
2398
2764
  cancel(reason?: any): Promise<void>;
2399
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultReader/read) */
2765
+ /**
2766
+ * The **`read()`** method of the ReadableStreamDefaultReader interface returns a Promise providing access to the next chunk in the stream's internal queue.
2767
+ *
2768
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultReader/read)
2769
+ */
2400
2770
  read(): Promise<ReadableStreamReadResult<R>>;
2401
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultReader/releaseLock) */
2771
+ /**
2772
+ * The **`releaseLock()`** method of the ReadableStreamDefaultReader interface releases the reader's lock on the stream.
2773
+ *
2774
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultReader/releaseLock)
2775
+ */
2402
2776
  releaseLock(): void;
2403
2777
  }
2404
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader) */
2778
+ /**
2779
+ * The `ReadableStreamBYOBReader` interface of the Streams API defines a reader for a ReadableStream that supports zero-copy reading from an underlying byte source.
2780
+ *
2781
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader)
2782
+ */
2405
2783
  declare class ReadableStreamBYOBReader {
2406
2784
  constructor(stream: ReadableStream);
2407
2785
  get closed(): Promise<void>;
2408
2786
  cancel(reason?: any): Promise<void>;
2409
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/read) */
2787
+ /**
2788
+ * 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.
2789
+ *
2790
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/read)
2791
+ */
2410
2792
  read<T extends ArrayBufferView>(
2411
2793
  view: T,
2412
2794
  ): Promise<ReadableStreamReadResult<T>>;
2413
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/releaseLock) */
2795
+ /**
2796
+ * The **`releaseLock()`** method of the ReadableStreamBYOBReader interface releases the reader's lock on the stream.
2797
+ *
2798
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/releaseLock)
2799
+ */
2414
2800
  releaseLock(): void;
2415
2801
  readAtLeast<T extends ArrayBufferView>(
2416
2802
  minElements: number,
@@ -2428,60 +2814,148 @@ interface ReadableStreamGetReaderOptions {
2428
2814
  */
2429
2815
  mode: "byob";
2430
2816
  }
2431
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest) */
2817
+ /**
2818
+ * 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).
2819
+ *
2820
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest)
2821
+ */
2432
2822
  declare abstract class ReadableStreamBYOBRequest {
2433
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest/view) */
2823
+ /**
2824
+ * The **`view`** getter property of the ReadableStreamBYOBRequest interface returns the current view.
2825
+ *
2826
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest/view)
2827
+ */
2434
2828
  get view(): Uint8Array | null;
2435
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest/respond) */
2829
+ /**
2830
+ * 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.
2831
+ *
2832
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest/respond)
2833
+ */
2436
2834
  respond(bytesWritten: number): void;
2437
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest/respondWithNewView) */
2835
+ /**
2836
+ * 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.
2837
+ *
2838
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest/respondWithNewView)
2839
+ */
2438
2840
  respondWithNewView(view: ArrayBuffer | ArrayBufferView): void;
2439
2841
  get atLeast(): number | null;
2440
2842
  }
2441
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController) */
2843
+ /**
2844
+ * The **`ReadableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a ReadableStream's state and internal queue.
2845
+ *
2846
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController)
2847
+ */
2442
2848
  declare abstract class ReadableStreamDefaultController<R = any> {
2443
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/desiredSize) */
2849
+ /**
2850
+ * The **`desiredSize`** read-only property of the required to fill the stream's internal queue.
2851
+ *
2852
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/desiredSize)
2853
+ */
2444
2854
  get desiredSize(): number | null;
2445
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/close) */
2855
+ /**
2856
+ * The **`close()`** method of the ReadableStreamDefaultController interface closes the associated stream.
2857
+ *
2858
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/close)
2859
+ */
2446
2860
  close(): void;
2447
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/enqueue) */
2861
+ /**
2862
+ * The **`enqueue()`** method of the ```js-nolint enqueue(chunk) ``` - `chunk` - : The chunk to enqueue.
2863
+ *
2864
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/enqueue)
2865
+ */
2448
2866
  enqueue(chunk?: R): void;
2449
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/error) */
2867
+ /**
2868
+ * The **`error()`** method of the with the associated stream to error.
2869
+ *
2870
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/error)
2871
+ */
2450
2872
  error(reason: any): void;
2451
2873
  }
2452
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController) */
2874
+ /**
2875
+ * The **`ReadableByteStreamController`** interface of the Streams API represents a controller for a readable byte stream.
2876
+ *
2877
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController)
2878
+ */
2453
2879
  declare abstract class ReadableByteStreamController {
2454
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/byobRequest) */
2880
+ /**
2881
+ * The **`byobRequest`** read-only property of the ReadableByteStreamController interface returns the current BYOB request, or `null` if there are no pending requests.
2882
+ *
2883
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/byobRequest)
2884
+ */
2455
2885
  get byobRequest(): ReadableStreamBYOBRequest | null;
2456
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/desiredSize) */
2886
+ /**
2887
+ * 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'.
2888
+ *
2889
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/desiredSize)
2890
+ */
2457
2891
  get desiredSize(): number | null;
2458
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/close) */
2892
+ /**
2893
+ * The **`close()`** method of the ReadableByteStreamController interface closes the associated stream.
2894
+ *
2895
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/close)
2896
+ */
2459
2897
  close(): void;
2460
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/enqueue) */
2898
+ /**
2899
+ * 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).
2900
+ *
2901
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/enqueue)
2902
+ */
2461
2903
  enqueue(chunk: ArrayBuffer | ArrayBufferView): void;
2462
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/error) */
2904
+ /**
2905
+ * The **`error()`** method of the ReadableByteStreamController interface causes any future interactions with the associated stream to error with the specified reason.
2906
+ *
2907
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/error)
2908
+ */
2463
2909
  error(reason: any): void;
2464
2910
  }
2465
2911
  /**
2466
- * 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.
2912
+ * The **`WritableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a WritableStream's state.
2467
2913
  *
2468
2914
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController)
2469
2915
  */
2470
2916
  declare abstract class WritableStreamDefaultController {
2471
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController/signal) */
2917
+ /**
2918
+ * The read-only **`signal`** property of the WritableStreamDefaultController interface returns the AbortSignal associated with the controller.
2919
+ *
2920
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController/signal)
2921
+ */
2472
2922
  get signal(): AbortSignal;
2473
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController/error) */
2923
+ /**
2924
+ * The **`error()`** method of the with the associated stream to error.
2925
+ *
2926
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController/error)
2927
+ */
2474
2928
  error(reason?: any): void;
2475
2929
  }
2476
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController) */
2930
+ /**
2931
+ * The **`TransformStreamDefaultController`** interface of the Streams API provides methods to manipulate the associated ReadableStream and WritableStream.
2932
+ *
2933
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController)
2934
+ */
2477
2935
  declare abstract class TransformStreamDefaultController<O = any> {
2478
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/desiredSize) */
2936
+ /**
2937
+ * The **`desiredSize`** read-only property of the TransformStreamDefaultController interface returns the desired size to fill the queue of the associated ReadableStream.
2938
+ *
2939
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/desiredSize)
2940
+ */
2479
2941
  get desiredSize(): number | null;
2480
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/enqueue) */
2942
+ /**
2943
+ * The **`enqueue()`** method of the TransformStreamDefaultController interface enqueues the given chunk in the readable side of the stream.
2944
+ *
2945
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/enqueue)
2946
+ */
2481
2947
  enqueue(chunk?: O): void;
2482
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/error) */
2948
+ /**
2949
+ * The **`error()`** method of the TransformStreamDefaultController interface errors both sides of the stream.
2950
+ *
2951
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/error)
2952
+ */
2483
2953
  error(reason: any): void;
2484
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/terminate) */
2954
+ /**
2955
+ * The **`terminate()`** method of the TransformStreamDefaultController interface closes the readable side and errors the writable side of the stream.
2956
+ *
2957
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/terminate)
2958
+ */
2485
2959
  terminate(): void;
2486
2960
  }
2487
2961
  interface ReadableWritablePair<R = any, W = any> {
@@ -2494,7 +2968,7 @@ interface ReadableWritablePair<R = any, W = any> {
2494
2968
  readable: ReadableStream<R>;
2495
2969
  }
2496
2970
  /**
2497
- * 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.
2971
+ * The **`WritableStream`** interface of the Streams API provides a standard abstraction for writing streaming data to a destination, known as a sink.
2498
2972
  *
2499
2973
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream)
2500
2974
  */
@@ -2503,47 +2977,103 @@ declare class WritableStream<W = any> {
2503
2977
  underlyingSink?: UnderlyingSink,
2504
2978
  queuingStrategy?: QueuingStrategy,
2505
2979
  );
2506
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/locked) */
2980
+ /**
2981
+ * The **`locked`** read-only property of the WritableStream interface returns a boolean indicating whether the `WritableStream` is locked to a writer.
2982
+ *
2983
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/locked)
2984
+ */
2507
2985
  get locked(): boolean;
2508
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/abort) */
2986
+ /**
2987
+ * 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.
2988
+ *
2989
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/abort)
2990
+ */
2509
2991
  abort(reason?: any): Promise<void>;
2510
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/close) */
2992
+ /**
2993
+ * The **`close()`** method of the WritableStream interface closes the associated stream.
2994
+ *
2995
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/close)
2996
+ */
2511
2997
  close(): Promise<void>;
2512
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/getWriter) */
2998
+ /**
2999
+ * The **`getWriter()`** method of the WritableStream interface returns a new instance of WritableStreamDefaultWriter and locks the stream to that instance.
3000
+ *
3001
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/getWriter)
3002
+ */
2513
3003
  getWriter(): WritableStreamDefaultWriter<W>;
2514
3004
  }
2515
3005
  /**
2516
- * 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.
3006
+ * 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.
2517
3007
  *
2518
3008
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter)
2519
3009
  */
2520
3010
  declare class WritableStreamDefaultWriter<W = any> {
2521
3011
  constructor(stream: WritableStream);
2522
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/closed) */
3012
+ /**
3013
+ * The **`closed`** read-only property of the the stream errors or the writer's lock is released.
3014
+ *
3015
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/closed)
3016
+ */
2523
3017
  get closed(): Promise<void>;
2524
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/ready) */
3018
+ /**
3019
+ * 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.
3020
+ *
3021
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/ready)
3022
+ */
2525
3023
  get ready(): Promise<void>;
2526
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/desiredSize) */
3024
+ /**
3025
+ * The **`desiredSize`** read-only property of the to fill the stream's internal queue.
3026
+ *
3027
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/desiredSize)
3028
+ */
2527
3029
  get desiredSize(): number | null;
2528
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/abort) */
3030
+ /**
3031
+ * 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.
3032
+ *
3033
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/abort)
3034
+ */
2529
3035
  abort(reason?: any): Promise<void>;
2530
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/close) */
3036
+ /**
3037
+ * The **`close()`** method of the stream.
3038
+ *
3039
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/close)
3040
+ */
2531
3041
  close(): Promise<void>;
2532
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/write) */
3042
+ /**
3043
+ * The **`write()`** method of the operation.
3044
+ *
3045
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/write)
3046
+ */
2533
3047
  write(chunk?: W): Promise<void>;
2534
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/releaseLock) */
3048
+ /**
3049
+ * The **`releaseLock()`** method of the corresponding stream.
3050
+ *
3051
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/releaseLock)
3052
+ */
2535
3053
  releaseLock(): void;
2536
3054
  }
2537
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream) */
3055
+ /**
3056
+ * The **`TransformStream`** interface of the Streams API represents a concrete implementation of the pipe chain _transform stream_ concept.
3057
+ *
3058
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream)
3059
+ */
2538
3060
  declare class TransformStream<I = any, O = any> {
2539
3061
  constructor(
2540
3062
  transformer?: Transformer<I, O>,
2541
3063
  writableStrategy?: QueuingStrategy<I>,
2542
3064
  readableStrategy?: QueuingStrategy<O>,
2543
3065
  );
2544
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/readable) */
3066
+ /**
3067
+ * The **`readable`** read-only property of the TransformStream interface returns the ReadableStream instance controlled by this `TransformStream`.
3068
+ *
3069
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/readable)
3070
+ */
2545
3071
  get readable(): ReadableStream<O>;
2546
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/writable) */
3072
+ /**
3073
+ * The **`writable`** read-only property of the TransformStream interface returns the WritableStream instance controlled by this `TransformStream`.
3074
+ *
3075
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/writable)
3076
+ */
2547
3077
  get writable(): WritableStream<I>;
2548
3078
  }
2549
3079
  declare class FixedLengthStream extends IdentityTransformStream {
@@ -2564,26 +3094,42 @@ interface IdentityTransformStreamQueuingStrategy {
2564
3094
  interface ReadableStreamValuesOptions {
2565
3095
  preventCancel?: boolean;
2566
3096
  }
2567
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CompressionStream) */
3097
+ /**
3098
+ * The **`CompressionStream`** interface of the Compression Streams API is an API for compressing a stream of data.
3099
+ *
3100
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CompressionStream)
3101
+ */
2568
3102
  declare class CompressionStream extends TransformStream<
2569
3103
  ArrayBuffer | ArrayBufferView,
2570
3104
  Uint8Array
2571
3105
  > {
2572
3106
  constructor(format: "gzip" | "deflate" | "deflate-raw");
2573
3107
  }
2574
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/DecompressionStream) */
3108
+ /**
3109
+ * The **`DecompressionStream`** interface of the Compression Streams API is an API for decompressing a stream of data.
3110
+ *
3111
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DecompressionStream)
3112
+ */
2575
3113
  declare class DecompressionStream extends TransformStream<
2576
3114
  ArrayBuffer | ArrayBufferView,
2577
3115
  Uint8Array
2578
3116
  > {
2579
3117
  constructor(format: "gzip" | "deflate" | "deflate-raw");
2580
3118
  }
2581
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoderStream) */
3119
+ /**
3120
+ * The **`TextEncoderStream`** interface of the Encoding API converts a stream of strings into bytes in the UTF-8 encoding.
3121
+ *
3122
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoderStream)
3123
+ */
2582
3124
  declare class TextEncoderStream extends TransformStream<string, Uint8Array> {
2583
3125
  constructor();
2584
3126
  get encoding(): string;
2585
3127
  }
2586
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoderStream) */
3128
+ /**
3129
+ * 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.
3130
+ *
3131
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoderStream)
3132
+ */
2587
3133
  declare class TextDecoderStream extends TransformStream<
2588
3134
  ArrayBuffer | ArrayBufferView,
2589
3135
  string
@@ -2598,7 +3144,7 @@ interface TextDecoderStreamTextDecoderStreamInit {
2598
3144
  ignoreBOM?: boolean;
2599
3145
  }
2600
3146
  /**
2601
- * This Streams API interface provides a built-in byte length queuing strategy that can be used when constructing streams.
3147
+ * The **`ByteLengthQueuingStrategy`** interface of the Streams API provides a built-in byte length queuing strategy that can be used when constructing streams.
2602
3148
  *
2603
3149
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ByteLengthQueuingStrategy)
2604
3150
  */
@@ -2606,19 +3152,27 @@ declare class ByteLengthQueuingStrategy
2606
3152
  implements QueuingStrategy<ArrayBufferView>
2607
3153
  {
2608
3154
  constructor(init: QueuingStrategyInit);
2609
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ByteLengthQueuingStrategy/highWaterMark) */
3155
+ /**
3156
+ * The read-only **`ByteLengthQueuingStrategy.highWaterMark`** property returns the total number of bytes that can be contained in the internal queue before backpressure is applied.
3157
+ *
3158
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ByteLengthQueuingStrategy/highWaterMark)
3159
+ */
2610
3160
  get highWaterMark(): number;
2611
3161
  /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/ByteLengthQueuingStrategy/size) */
2612
3162
  get size(): (chunk?: any) => number;
2613
3163
  }
2614
3164
  /**
2615
- * This Streams API interface provides a built-in byte length queuing strategy that can be used when constructing streams.
3165
+ * The **`CountQueuingStrategy`** interface of the Streams API provides a built-in chunk counting queuing strategy that can be used when constructing streams.
2616
3166
  *
2617
3167
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CountQueuingStrategy)
2618
3168
  */
2619
3169
  declare class CountQueuingStrategy implements QueuingStrategy {
2620
3170
  constructor(init: QueuingStrategyInit);
2621
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CountQueuingStrategy/highWaterMark) */
3171
+ /**
3172
+ * The read-only **`CountQueuingStrategy.highWaterMark`** property returns the total number of chunks that can be contained in the internal queue before backpressure is applied.
3173
+ *
3174
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CountQueuingStrategy/highWaterMark)
3175
+ */
2622
3176
  get highWaterMark(): number;
2623
3177
  /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/CountQueuingStrategy/size) */
2624
3178
  get size(): (chunk?: any) => number;
@@ -2751,113 +3305,233 @@ interface UnsafeTraceMetrics {
2751
3305
  fromTrace(item: TraceItem): TraceMetrics;
2752
3306
  }
2753
3307
  /**
2754
- * The URL interface represents an object providing static methods used for creating object URLs.
3308
+ * The **`URL`** interface is used to parse, construct, normalize, and encode URL.
2755
3309
  *
2756
3310
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL)
2757
3311
  */
2758
3312
  declare class URL {
2759
3313
  constructor(url: string | URL, base?: string | URL);
2760
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/origin) */
3314
+ /**
3315
+ * The **`origin`** read-only property of the URL interface returns a string containing the Unicode serialization of the origin of the represented URL.
3316
+ *
3317
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/origin)
3318
+ */
2761
3319
  get origin(): string;
2762
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/href) */
3320
+ /**
3321
+ * The **`href`** property of the URL interface is a string containing the whole URL.
3322
+ *
3323
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/href)
3324
+ */
2763
3325
  get href(): string;
2764
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/href) */
3326
+ /**
3327
+ * The **`href`** property of the URL interface is a string containing the whole URL.
3328
+ *
3329
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/href)
3330
+ */
2765
3331
  set href(value: string);
2766
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/protocol) */
3332
+ /**
3333
+ * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final `':'`.
3334
+ *
3335
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/protocol)
3336
+ */
2767
3337
  get protocol(): string;
2768
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/protocol) */
3338
+ /**
3339
+ * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final `':'`.
3340
+ *
3341
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/protocol)
3342
+ */
2769
3343
  set protocol(value: string);
2770
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/username) */
3344
+ /**
3345
+ * The **`username`** property of the URL interface is a string containing the username component of the URL.
3346
+ *
3347
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/username)
3348
+ */
2771
3349
  get username(): string;
2772
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/username) */
3350
+ /**
3351
+ * The **`username`** property of the URL interface is a string containing the username component of the URL.
3352
+ *
3353
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/username)
3354
+ */
2773
3355
  set username(value: string);
2774
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/password) */
3356
+ /**
3357
+ * The **`password`** property of the URL interface is a string containing the password component of the URL.
3358
+ *
3359
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/password)
3360
+ */
2775
3361
  get password(): string;
2776
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/password) */
3362
+ /**
3363
+ * The **`password`** property of the URL interface is a string containing the password component of the URL.
3364
+ *
3365
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/password)
3366
+ */
2777
3367
  set password(value: string);
2778
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/host) */
3368
+ /**
3369
+ * 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.
3370
+ *
3371
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/host)
3372
+ */
2779
3373
  get host(): string;
2780
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/host) */
3374
+ /**
3375
+ * 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.
3376
+ *
3377
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/host)
3378
+ */
2781
3379
  set host(value: string);
2782
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hostname) */
3380
+ /**
3381
+ * The **`hostname`** property of the URL interface is a string containing either the domain name or IP address of the URL.
3382
+ *
3383
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hostname)
3384
+ */
2783
3385
  get hostname(): string;
2784
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hostname) */
3386
+ /**
3387
+ * The **`hostname`** property of the URL interface is a string containing either the domain name or IP address of the URL.
3388
+ *
3389
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hostname)
3390
+ */
2785
3391
  set hostname(value: string);
2786
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/port) */
3392
+ /**
3393
+ * The **`port`** property of the URL interface is a string containing the port number of the URL.
3394
+ *
3395
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/port)
3396
+ */
2787
3397
  get port(): string;
2788
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/port) */
3398
+ /**
3399
+ * The **`port`** property of the URL interface is a string containing the port number of the URL.
3400
+ *
3401
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/port)
3402
+ */
2789
3403
  set port(value: string);
2790
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/pathname) */
3404
+ /**
3405
+ * The **`pathname`** property of the URL interface represents a location in a hierarchical structure.
3406
+ *
3407
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/pathname)
3408
+ */
2791
3409
  get pathname(): string;
2792
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/pathname) */
3410
+ /**
3411
+ * The **`pathname`** property of the URL interface represents a location in a hierarchical structure.
3412
+ *
3413
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/pathname)
3414
+ */
2793
3415
  set pathname(value: string);
2794
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/search) */
3416
+ /**
3417
+ * 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.
3418
+ *
3419
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/search)
3420
+ */
2795
3421
  get search(): string;
2796
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/search) */
3422
+ /**
3423
+ * 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.
3424
+ *
3425
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/search)
3426
+ */
2797
3427
  set search(value: string);
2798
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hash) */
3428
+ /**
3429
+ * The **`hash`** property of the URL interface is a string containing a `'#'` followed by the fragment identifier of the URL.
3430
+ *
3431
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hash)
3432
+ */
2799
3433
  get hash(): string;
2800
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hash) */
3434
+ /**
3435
+ * The **`hash`** property of the URL interface is a string containing a `'#'` followed by the fragment identifier of the URL.
3436
+ *
3437
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hash)
3438
+ */
2801
3439
  set hash(value: string);
2802
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/searchParams) */
3440
+ /**
3441
+ * The **`searchParams`** read-only property of the access to the [MISSING: httpmethod('GET')] decoded query arguments contained in the URL.
3442
+ *
3443
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/searchParams)
3444
+ */
2803
3445
  get searchParams(): URLSearchParams;
2804
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/toJSON) */
3446
+ /**
3447
+ * 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.
3448
+ *
3449
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/toJSON)
3450
+ */
2805
3451
  toJSON(): string;
2806
3452
  /*function toString() { [native code] }*/
2807
3453
  toString(): string;
2808
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/canParse_static) */
3454
+ /**
3455
+ * 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.
3456
+ *
3457
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/canParse_static)
3458
+ */
2809
3459
  static canParse(url: string, base?: string): boolean;
2810
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/parse_static) */
3460
+ /**
3461
+ * The **`URL.parse()`** static method of the URL interface returns a newly created URL object representing the URL defined by the parameters.
3462
+ *
3463
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/parse_static)
3464
+ */
2811
3465
  static parse(url: string, base?: string): URL | null;
2812
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/createObjectURL_static) */
3466
+ /**
3467
+ * The **`createObjectURL()`** static method of the URL interface creates a string containing a URL representing the object given in the parameter.
3468
+ *
3469
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/createObjectURL_static)
3470
+ */
2813
3471
  static createObjectURL(object: File | Blob): string;
2814
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/revokeObjectURL_static) */
3472
+ /**
3473
+ * 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.
3474
+ *
3475
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/revokeObjectURL_static)
3476
+ */
2815
3477
  static revokeObjectURL(object_url: string): void;
2816
3478
  }
2817
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams) */
3479
+ /**
3480
+ * The **`URLSearchParams`** interface defines utility methods to work with the query string of a URL.
3481
+ *
3482
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams)
3483
+ */
2818
3484
  declare class URLSearchParams {
2819
3485
  constructor(
2820
3486
  init?: Iterable<Iterable<string>> | Record<string, string> | string,
2821
3487
  );
2822
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/size) */
3488
+ /**
3489
+ * The **`size`** read-only property of the URLSearchParams interface indicates the total number of search parameter entries.
3490
+ *
3491
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/size)
3492
+ */
2823
3493
  get size(): number;
2824
3494
  /**
2825
- * Appends a specified key/value pair as a new search parameter.
3495
+ * The **`append()`** method of the URLSearchParams interface appends a specified key/value pair as a new search parameter.
2826
3496
  *
2827
3497
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/append)
2828
3498
  */
2829
3499
  append(name: string, value: string): void;
2830
3500
  /**
2831
- * Deletes the given search parameter, and its associated value, from the list of all search parameters.
3501
+ * The **`delete()`** method of the URLSearchParams interface deletes specified parameters and their associated value(s) from the list of all search parameters.
2832
3502
  *
2833
3503
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/delete)
2834
3504
  */
2835
3505
  delete(name: string, value?: string): void;
2836
3506
  /**
2837
- * Returns the first value associated to the given search parameter.
3507
+ * The **`get()`** method of the URLSearchParams interface returns the first value associated to the given search parameter.
2838
3508
  *
2839
3509
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/get)
2840
3510
  */
2841
3511
  get(name: string): string | null;
2842
3512
  /**
2843
- * Returns all the values association with a given search parameter.
3513
+ * The **`getAll()`** method of the URLSearchParams interface returns all the values associated with a given search parameter as an array.
2844
3514
  *
2845
3515
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/getAll)
2846
3516
  */
2847
3517
  getAll(name: string): string[];
2848
3518
  /**
2849
- * Returns a Boolean indicating if such a search parameter exists.
3519
+ * The **`has()`** method of the URLSearchParams interface returns a boolean value that indicates whether the specified parameter is in the search parameters.
2850
3520
  *
2851
3521
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/has)
2852
3522
  */
2853
3523
  has(name: string, value?: string): boolean;
2854
3524
  /**
2855
- * Sets the value associated to a given search parameter to the given value. If there were several values, delete the others.
3525
+ * The **`set()`** method of the URLSearchParams interface sets the value associated with a given search parameter to the given value.
2856
3526
  *
2857
3527
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/set)
2858
3528
  */
2859
3529
  set(name: string, value: string): void;
2860
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/sort) */
3530
+ /**
3531
+ * The **`URLSearchParams.sort()`** method sorts all key/value pairs contained in this object in place and returns `undefined`.
3532
+ *
3533
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/sort)
3534
+ */
2861
3535
  sort(): void;
2862
3536
  /* Returns an array of key, value pairs for every entry in the search params. */
2863
3537
  entries(): IterableIterator<[key: string, value: string]>;
@@ -2874,7 +3548,7 @@ declare class URLSearchParams {
2874
3548
  ) => void,
2875
3549
  thisArg?: This,
2876
3550
  ): void;
2877
- /*function toString() { [native code] } Returns a string containing a query string suitable for use in a URL. Does not include the question mark. */
3551
+ /*function toString() { [native code] }*/
2878
3552
  toString(): string;
2879
3553
  [Symbol.iterator](): IterableIterator<[key: string, value: string]>;
2880
3554
  }
@@ -2929,26 +3603,26 @@ interface URLPatternOptions {
2929
3603
  ignoreCase?: boolean;
2930
3604
  }
2931
3605
  /**
2932
- * 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.
3606
+ * A `CloseEvent` is sent to clients using WebSockets when the connection is closed.
2933
3607
  *
2934
3608
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CloseEvent)
2935
3609
  */
2936
3610
  declare class CloseEvent extends Event {
2937
3611
  constructor(type: string, initializer?: CloseEventInit);
2938
3612
  /**
2939
- * Returns the WebSocket connection close code provided by the server.
3613
+ * The **`code`** read-only property of the CloseEvent interface returns a WebSocket connection close code indicating the reason the connection was closed.
2940
3614
  *
2941
3615
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CloseEvent/code)
2942
3616
  */
2943
3617
  readonly code: number;
2944
3618
  /**
2945
- * Returns the WebSocket connection close reason provided by the server.
3619
+ * 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.
2946
3620
  *
2947
3621
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CloseEvent/reason)
2948
3622
  */
2949
3623
  readonly reason: string;
2950
3624
  /**
2951
- * Returns true if the connection closed cleanly; false otherwise.
3625
+ * The **`wasClean`** read-only property of the CloseEvent interface returns `true` if the connection closed cleanly.
2952
3626
  *
2953
3627
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CloseEvent/wasClean)
2954
3628
  */
@@ -2966,7 +3640,7 @@ type WebSocketEventMap = {
2966
3640
  error: ErrorEvent;
2967
3641
  };
2968
3642
  /**
2969
- * Provides the API for creating and managing a WebSocket connection to a server, as well as for sending and receiving data on the connection.
3643
+ * 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.
2970
3644
  *
2971
3645
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket)
2972
3646
  */
@@ -2983,20 +3657,20 @@ declare var WebSocket: {
2983
3657
  readonly CLOSED: number;
2984
3658
  };
2985
3659
  /**
2986
- * Provides the API for creating and managing a WebSocket connection to a server, as well as for sending and receiving data on the connection.
3660
+ * 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.
2987
3661
  *
2988
3662
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket)
2989
3663
  */
2990
3664
  interface WebSocket extends EventTarget<WebSocketEventMap> {
2991
3665
  accept(): void;
2992
3666
  /**
2993
- * Transmits data using the WebSocket connection. data can be a string, a Blob, an ArrayBuffer, or an ArrayBufferView.
3667
+ * 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.
2994
3668
  *
2995
3669
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/send)
2996
3670
  */
2997
3671
  send(message: (ArrayBuffer | ArrayBufferView) | string): void;
2998
3672
  /**
2999
- * Closes the WebSocket connection, optionally using code as the the WebSocket connection close code and reason as the the WebSocket connection close reason.
3673
+ * The **`WebSocket.close()`** method closes the already `CLOSED`, this method does nothing.
3000
3674
  *
3001
3675
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/close)
3002
3676
  */
@@ -3004,25 +3678,25 @@ interface WebSocket extends EventTarget<WebSocketEventMap> {
3004
3678
  serializeAttachment(attachment: any): void;
3005
3679
  deserializeAttachment(): any | null;
3006
3680
  /**
3007
- * Returns the state of the WebSocket object's connection. It can have the values described below.
3681
+ * The **`WebSocket.readyState`** read-only property returns the current state of the WebSocket connection.
3008
3682
  *
3009
3683
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/readyState)
3010
3684
  */
3011
3685
  readyState: number;
3012
3686
  /**
3013
- * Returns the URL that was used to establish the WebSocket connection.
3687
+ * The **`WebSocket.url`** read-only property returns the absolute URL of the WebSocket as resolved by the constructor.
3014
3688
  *
3015
3689
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/url)
3016
3690
  */
3017
3691
  url: string | null;
3018
3692
  /**
3019
- * 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.
3693
+ * 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.
3020
3694
  *
3021
3695
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/protocol)
3022
3696
  */
3023
3697
  protocol: string | null;
3024
3698
  /**
3025
- * Returns the extensions selected by the server, if any.
3699
+ * The **`WebSocket.extensions`** read-only property returns the extensions selected by the server.
3026
3700
  *
3027
3701
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WebSocket/extensions)
3028
3702
  */
@@ -3101,29 +3775,33 @@ interface SocketInfo {
3101
3775
  remoteAddress?: string;
3102
3776
  localAddress?: string;
3103
3777
  }
3104
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource) */
3778
+ /**
3779
+ * The **`EventSource`** interface is web content's interface to server-sent events.
3780
+ *
3781
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource)
3782
+ */
3105
3783
  declare class EventSource extends EventTarget {
3106
3784
  constructor(url: string, init?: EventSourceEventSourceInit);
3107
3785
  /**
3108
- * Aborts any instances of the fetch algorithm started for this EventSource object, and sets the readyState attribute to CLOSED.
3786
+ * The **`close()`** method of the EventSource interface closes the connection, if one is made, and sets the ```js-nolint close() ``` None.
3109
3787
  *
3110
3788
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/close)
3111
3789
  */
3112
3790
  close(): void;
3113
3791
  /**
3114
- * Returns the URL providing the event stream.
3792
+ * The **`url`** read-only property of the URL of the source.
3115
3793
  *
3116
3794
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/url)
3117
3795
  */
3118
3796
  get url(): string;
3119
3797
  /**
3120
- * Returns true if the credentials mode for connection requests to the URL providing the event stream is set to "include", and false otherwise.
3798
+ * The **`withCredentials`** read-only property of the the `EventSource` object was instantiated with CORS credentials set.
3121
3799
  *
3122
3800
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/withCredentials)
3123
3801
  */
3124
3802
  get withCredentials(): boolean;
3125
3803
  /**
3126
- * Returns the state of this EventSource object's connection. It can have the values described below.
3804
+ * The **`readyState`** read-only property of the connection.
3127
3805
  *
3128
3806
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/readyState)
3129
3807
  */
@@ -3162,57 +3840,97 @@ interface ContainerStartupOptions {
3162
3840
  entrypoint?: string[];
3163
3841
  enableInternet: boolean;
3164
3842
  env?: Record<string, string>;
3843
+ hardTimeout?: number | bigint;
3165
3844
  }
3166
3845
  /**
3846
+ * The **`FileSystemHandle`** interface of the File System API is an object which represents a file or directory entry.
3167
3847
  * Available only in secure contexts.
3168
3848
  *
3169
3849
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle)
3170
3850
  */
3171
3851
  declare abstract class FileSystemHandle {
3172
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/kind) */
3852
+ /**
3853
+ * The **`kind`** read-only property of the `'file'` if the associated entry is a file or `'directory'`.
3854
+ *
3855
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/kind)
3856
+ */
3173
3857
  get kind(): string;
3174
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/name) */
3858
+ /**
3859
+ * The **`name`** read-only property of the handle.
3860
+ *
3861
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/name)
3862
+ */
3175
3863
  get name(): string;
3176
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/isSameEntry) */
3864
+ /**
3865
+ * The **`isSameEntry()`** method of the ```js-nolint isSameEntry(fileSystemHandle) ``` - FileSystemHandle - : The `FileSystemHandle` to match against the handle on which the method is invoked.
3866
+ *
3867
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/isSameEntry)
3868
+ */
3177
3869
  isSameEntry(other: FileSystemHandle): Promise<boolean>;
3178
3870
  getUniqueId(): Promise<string>;
3179
3871
  remove(options?: FileSystemHandleRemoveOptions): Promise<void>;
3180
3872
  }
3181
3873
  /**
3874
+ * The **`FileSystemFileHandle`** interface of the File System API represents a handle to a file system entry.
3182
3875
  * Available only in secure contexts.
3183
3876
  *
3184
3877
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemFileHandle)
3185
3878
  */
3186
3879
  declare abstract class FileSystemFileHandle extends FileSystemHandle {
3187
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemFileHandle/getFile) */
3880
+ /**
3881
+ * 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.
3882
+ *
3883
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemFileHandle/getFile)
3884
+ */
3188
3885
  getFile(): Promise<File>;
3189
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemFileHandle/createWritable) */
3886
+ /**
3887
+ * The **`createWritable()`** method of the FileSystemFileHandle interface creates a FileSystemWritableFileStream that can be used to write to a file.
3888
+ *
3889
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemFileHandle/createWritable)
3890
+ */
3190
3891
  createWritable(
3191
3892
  options?: FileSystemFileHandleFileSystemCreateWritableOptions,
3192
3893
  ): Promise<FileSystemWritableFileStream>;
3193
3894
  }
3194
3895
  /**
3896
+ * The **`FileSystemDirectoryHandle`** interface of the File System API provides a handle to a file system directory.
3195
3897
  * Available only in secure contexts.
3196
3898
  *
3197
3899
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle)
3198
3900
  */
3199
3901
  declare abstract class FileSystemDirectoryHandle extends FileSystemHandle {
3200
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/getFileHandle) */
3902
+ /**
3903
+ * The **`getFileHandle()`** method of the directory the method is called.
3904
+ *
3905
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/getFileHandle)
3906
+ */
3201
3907
  getFileHandle(
3202
3908
  name: string,
3203
3909
  options?: FileSystemDirectoryHandleFileSystemGetFileOptions,
3204
3910
  ): Promise<FileSystemFileHandle>;
3205
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/getDirectoryHandle) */
3911
+ /**
3912
+ * The **`getDirectoryHandle()`** method of the within the directory handle on which the method is called.
3913
+ *
3914
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/getDirectoryHandle)
3915
+ */
3206
3916
  getDirectoryHandle(
3207
3917
  name: string,
3208
3918
  options?: FileSystemDirectoryHandleFileSystemGetDirectoryOptions,
3209
3919
  ): Promise<FileSystemDirectoryHandle>;
3210
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/removeEntry) */
3920
+ /**
3921
+ * The **`removeEntry()`** method of the directory handle contains a file or directory called the name specified.
3922
+ *
3923
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/removeEntry)
3924
+ */
3211
3925
  removeEntry(
3212
3926
  name: string,
3213
3927
  options?: FileSystemDirectoryHandleFileSystemRemoveOptions,
3214
3928
  ): Promise<void>;
3215
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/resolve) */
3929
+ /**
3930
+ * 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.
3931
+ *
3932
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/resolve)
3933
+ */
3216
3934
  resolve(possibleDescendant: FileSystemHandle): Promise<string[]>;
3217
3935
  entries(): AsyncIterableIterator<[string, FileSystemHandle]>;
3218
3936
  keys(): AsyncIterableIterator<string>;
@@ -3228,12 +3946,17 @@ declare abstract class FileSystemDirectoryHandle extends FileSystemHandle {
3228
3946
  [Symbol.asyncIterator](): AsyncIterableIterator<[string, FileSystemHandle]>;
3229
3947
  }
3230
3948
  /**
3949
+ * The **`FileSystemWritableFileStream`** interface of the File System API is a WritableStream object with additional convenience methods, which operates on a single file on disk.
3231
3950
  * Available only in secure contexts.
3232
3951
  *
3233
3952
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemWritableFileStream)
3234
3953
  */
3235
3954
  declare abstract class FileSystemWritableFileStream extends WritableStream {
3236
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemWritableFileStream/write) */
3955
+ /**
3956
+ * The **`write()`** method of the FileSystemWritableFileStream interface writes content into the file the method is called on, at the current file cursor offset.
3957
+ *
3958
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemWritableFileStream/write)
3959
+ */
3237
3960
  write(
3238
3961
  data:
3239
3962
  | Blob
@@ -3241,18 +3964,31 @@ declare abstract class FileSystemWritableFileStream extends WritableStream {
3241
3964
  | string
3242
3965
  | FileSystemFileWriteParams,
3243
3966
  ): Promise<void>;
3244
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemWritableFileStream/seek) */
3967
+ /**
3968
+ * The **`seek()`** method of the FileSystemWritableFileStream interface updates the current file cursor offset to the position (in bytes) specified when calling the method.
3969
+ *
3970
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemWritableFileStream/seek)
3971
+ */
3245
3972
  seek(position: number): Promise<void>;
3246
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemWritableFileStream/truncate) */
3973
+ /**
3974
+ * The **`truncate()`** method of the FileSystemWritableFileStream interface resizes the file associated with the stream to the specified size in bytes.
3975
+ *
3976
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemWritableFileStream/truncate)
3977
+ */
3247
3978
  truncate(size: number): Promise<void>;
3248
3979
  }
3249
3980
  /**
3981
+ * The **`StorageManager`** interface of the Storage API provides an interface for managing persistence permissions and estimating available storage.
3250
3982
  * Available only in secure contexts.
3251
3983
  *
3252
3984
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/StorageManager)
3253
3985
  */
3254
3986
  declare abstract class StorageManager {
3255
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/StorageManager/getDirectory) */
3987
+ /**
3988
+ * 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).
3989
+ *
3990
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/StorageManager/getDirectory)
3991
+ */
3256
3992
  getDirectory(): Promise<FileSystemDirectoryHandle>;
3257
3993
  }
3258
3994
  interface FileSystemFileHandleFileSystemCreateWritableOptions {
@@ -3277,15 +4013,13 @@ interface FileSystemHandleRemoveOptions {
3277
4013
  recursive?: boolean;
3278
4014
  }
3279
4015
  /**
3280
- * 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.
4016
+ * 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.
3281
4017
  *
3282
4018
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort)
3283
4019
  */
3284
4020
  declare abstract class MessagePort extends EventTarget {
3285
4021
  /**
3286
- * 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.
3287
- *
3288
- * Throws a "DataCloneError" DOMException if transfer contains duplicate objects or port, or if message could not be cloned.
4022
+ * The **`postMessage()`** method of the transfers ownership of objects to other browsing contexts.
3289
4023
  *
3290
4024
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/postMessage)
3291
4025
  */
@@ -3294,13 +4028,13 @@ declare abstract class MessagePort extends EventTarget {
3294
4028
  options?: any[] | MessagePortPostMessageOptions,
3295
4029
  ): void;
3296
4030
  /**
3297
- * Disconnects the port, so that it is no longer active.
4031
+ * The **`close()`** method of the MessagePort interface disconnects the port, so it is no longer active.
3298
4032
  *
3299
4033
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/close)
3300
4034
  */
3301
4035
  close(): void;
3302
4036
  /**
3303
- * Begins dispatching messages received on the port.
4037
+ * The **`start()`** method of the MessagePort interface starts the sending of messages queued on the port.
3304
4038
  *
3305
4039
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/start)
3306
4040
  */
@@ -3309,20 +4043,20 @@ declare abstract class MessagePort extends EventTarget {
3309
4043
  set onmessage(value: any | null);
3310
4044
  }
3311
4045
  /**
3312
- * This Channel Messaging API interface allows us to create a new message channel and send data through it via its two MessagePort properties.
4046
+ * 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.
3313
4047
  *
3314
4048
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageChannel)
3315
4049
  */
3316
4050
  declare class MessageChannel {
3317
4051
  constructor();
3318
4052
  /**
3319
- * Returns the first MessagePort object.
4053
+ * The **`port1`** read-only property of the the port attached to the context that originated the channel.
3320
4054
  *
3321
4055
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageChannel/port1)
3322
4056
  */
3323
4057
  readonly port1: MessagePort;
3324
4058
  /**
3325
- * Returns the second MessagePort object.
4059
+ * 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.
3326
4060
  *
3327
4061
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageChannel/port2)
3328
4062
  */
@@ -3397,6 +4131,7 @@ interface WorkerLoaderModule {
3397
4131
  data?: ArrayBuffer;
3398
4132
  json?: any;
3399
4133
  py?: string;
4134
+ wasm?: ArrayBuffer;
3400
4135
  }
3401
4136
  interface WorkerLoaderWorkerCode {
3402
4137
  compatibilityDate: string;
@@ -3421,50 +4156,94 @@ declare abstract class Performance extends EventTarget {
3421
4156
  /* [Cloudflare Docs Reference](https://developers.cloudflare.com/workers/runtime-apis/performance/#performancenow) */
3422
4157
  now(): number;
3423
4158
  get eventCounts(): EventCounts;
3424
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/clearMarks) */
4159
+ /**
4160
+ * The **`clearMarks()`** method removes all or specific PerformanceMark objects from the browser's performance timeline.
4161
+ *
4162
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/clearMarks)
4163
+ */
3425
4164
  clearMarks(name?: string): void;
3426
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/clearMeasures) */
4165
+ /**
4166
+ * The **`clearMeasures()`** method removes all or specific PerformanceMeasure objects from the browser's performance timeline.
4167
+ *
4168
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/clearMeasures)
4169
+ */
3427
4170
  clearMeasures(name?: string): void;
3428
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/clearResourceTimings) */
4171
+ /**
4172
+ * 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.
4173
+ *
4174
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/clearResourceTimings)
4175
+ */
3429
4176
  clearResourceTimings(): void;
3430
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/getEntries) */
4177
+ /**
4178
+ * The **`getEntries()`** method returns an array of all PerformanceEntry objects currently present in the performance timeline.
4179
+ *
4180
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/getEntries)
4181
+ */
3431
4182
  getEntries(): PerformanceEntry[];
3432
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/getEntriesByName) */
4183
+ /**
4184
+ * The **`getEntriesByName()`** method returns an array of PerformanceEntry objects currently present in the performance timeline with the given _name_ and _type_.
4185
+ *
4186
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/getEntriesByName)
4187
+ */
3433
4188
  getEntriesByName(name: string, type?: string): PerformanceEntry[];
3434
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/getEntriesByType) */
4189
+ /**
4190
+ * The **`getEntriesByType()`** method returns an array of PerformanceEntry objects currently present in the performance timeline for a given _type_.
4191
+ *
4192
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/getEntriesByType)
4193
+ */
3435
4194
  getEntriesByType(type: string): PerformanceEntry[];
3436
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/mark) */
4195
+ /**
4196
+ * The **`mark()`** method creates a named PerformanceMark object representing a high resolution timestamp marker in the browser's performance timeline.
4197
+ *
4198
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/mark)
4199
+ */
3437
4200
  mark(name: string, options?: PerformanceMarkOptions): PerformanceMark;
3438
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/measure) */
4201
+ /**
4202
+ * The **`measure()`** method creates a named PerformanceMeasure object representing a time measurement between two marks in the browser's performance timeline.
4203
+ *
4204
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/measure)
4205
+ */
3439
4206
  measure(
3440
4207
  measureName: string,
3441
4208
  measureOptionsOrStartMark: PerformanceMeasureOptions | string,
3442
4209
  maybeEndMark?: string,
3443
4210
  ): PerformanceMeasure;
3444
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/setResourceTimingBufferSize) */
4211
+ /**
4212
+ * The **`setResourceTimingBufferSize()`** method sets the desired size of the browser's resource timing buffer which stores the `'resource'` performance entries.
4213
+ *
4214
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Performance/setResourceTimingBufferSize)
4215
+ */
3445
4216
  setResourceTimingBufferSize(size: number): void;
3446
4217
  eventLoopUtilization(): void;
3447
4218
  markResourceTiming(): void;
3448
4219
  timerify(fn: () => void): () => void;
3449
4220
  }
3450
4221
  /**
3451
- * 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.
4222
+ * **`PerformanceMark`** is an interface for PerformanceEntry objects with an PerformanceEntry.entryType of `'mark'`.
3452
4223
  *
3453
4224
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMark)
3454
4225
  */
3455
4226
  declare class PerformanceMark extends PerformanceEntry {
3456
4227
  constructor(name: string, maybeOptions?: PerformanceMarkOptions);
3457
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMark/detail) */
4228
+ /**
4229
+ * 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).
4230
+ *
4231
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMark/detail)
4232
+ */
3458
4233
  get detail(): any | undefined;
3459
4234
  toJSON(): any;
3460
4235
  }
3461
4236
  /**
3462
- * 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.
4237
+ * **`PerformanceMeasure`** is an _abstract_ interface for PerformanceEntry objects with an PerformanceEntry.entryType of `'measure'`.
3463
4238
  *
3464
4239
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMeasure)
3465
4240
  */
3466
4241
  declare abstract class PerformanceMeasure extends PerformanceEntry {
3467
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMeasure/detail) */
4242
+ /**
4243
+ * The read-only **`detail`** property returns arbitrary metadata that was included in the mark upon construction (when using Performance.measure.
4244
+ *
4245
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceMeasure/detail)
4246
+ */
3468
4247
  get detail(): any | undefined;
3469
4248
  toJSON(): any;
3470
4249
  }
@@ -3478,83 +4257,207 @@ interface PerformanceMeasureOptions {
3478
4257
  duration?: number;
3479
4258
  end?: number;
3480
4259
  }
3481
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList) */
4260
+ /**
4261
+ * The **`PerformanceObserverEntryList`** interface is a list of PerformanceEntry that were explicitly observed via the PerformanceObserver.observe method.
4262
+ *
4263
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList)
4264
+ */
3482
4265
  declare abstract class PerformanceObserverEntryList {
3483
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntries) */
4266
+ /**
4267
+ * The **`getEntries()`** method of the PerformanceObserverEntryList interface returns a list of explicitly observed PerformanceEntry objects.
4268
+ *
4269
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntries)
4270
+ */
3484
4271
  getEntries(): PerformanceEntry[];
3485
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntriesByType) */
4272
+ /**
4273
+ * The **`getEntriesByType()`** method of the PerformanceObserverEntryList returns a list of explicitly _observed_ PerformanceEntry objects for a given PerformanceEntry.entryType.
4274
+ *
4275
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntriesByType)
4276
+ */
3486
4277
  getEntriesByType(type: string): PerformanceEntry[];
3487
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntriesByName) */
4278
+ /**
4279
+ * The **`getEntriesByName()`** method of the PerformanceObserverEntryList interface returns a list of explicitly observed PerformanceEntry objects for a given PerformanceEntry.name and PerformanceEntry.entryType.
4280
+ *
4281
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserverEntryList/getEntriesByName)
4282
+ */
3488
4283
  getEntriesByName(name: string, type?: string): PerformanceEntry[];
3489
4284
  }
3490
4285
  /**
3491
- * 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).
4286
+ * The **`PerformanceEntry`** object encapsulates a single performance metric that is part of the browser's performance timeline.
3492
4287
  *
3493
4288
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry)
3494
4289
  */
3495
4290
  declare abstract class PerformanceEntry {
3496
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/name) */
4291
+ /**
4292
+ * The read-only **`name`** property of the PerformanceEntry interface is a string representing the name for a performance entry.
4293
+ *
4294
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/name)
4295
+ */
3497
4296
  get name(): string;
3498
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/entryType) */
4297
+ /**
4298
+ * The read-only **`entryType`** property returns a string representing the type of performance metric that this entry represents.
4299
+ *
4300
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/entryType)
4301
+ */
3499
4302
  get entryType(): string;
3500
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/startTime) */
4303
+ /**
4304
+ * The read-only **`startTime`** property returns the first DOMHighResTimeStamp recorded for this PerformanceEntry.
4305
+ *
4306
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/startTime)
4307
+ */
3501
4308
  get startTime(): number;
3502
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/duration) */
4309
+ /**
4310
+ * The read-only **`duration`** property returns a DOMHighResTimeStamp that is the duration of the PerformanceEntry.
4311
+ *
4312
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/duration)
4313
+ */
3503
4314
  get duration(): number;
3504
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/toJSON) */
4315
+ /**
4316
+ * The **`toJSON()`** method is a Serialization; it returns a JSON representation of the PerformanceEntry object.
4317
+ *
4318
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceEntry/toJSON)
4319
+ */
3505
4320
  toJSON(): any;
3506
4321
  }
3507
4322
  /**
3508
- * 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.
4323
+ * The **`PerformanceResourceTiming`** interface enables retrieval and analysis of detailed network timing data regarding the loading of an application's resources.
3509
4324
  *
3510
4325
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming)
3511
4326
  */
3512
4327
  declare abstract class PerformanceResourceTiming extends PerformanceEntry {
3513
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/connectEnd) */
4328
+ /**
4329
+ * The **`connectEnd`** read-only property returns the DOMHighResTimeStamp immediately after the browser finishes establishing the connection to the server to retrieve the resource.
4330
+ *
4331
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/connectEnd)
4332
+ */
3514
4333
  get connectEnd(): number;
3515
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/connectStart) */
4334
+ /**
4335
+ * The **`connectStart`** read-only property returns the DOMHighResTimeStamp immediately before the user agent starts establishing the connection to the server to retrieve the resource.
4336
+ *
4337
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/connectStart)
4338
+ */
3516
4339
  get connectStart(): number;
3517
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/decodedBodySize) */
4340
+ /**
4341
+ * 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).
4342
+ *
4343
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/decodedBodySize)
4344
+ */
3518
4345
  get decodedBodySize(): number;
3519
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/domainLookupEnd) */
4346
+ /**
4347
+ * The **`domainLookupEnd`** read-only property returns the DOMHighResTimeStamp immediately after the browser finishes the domain-name lookup for the resource.
4348
+ *
4349
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/domainLookupEnd)
4350
+ */
3520
4351
  get domainLookupEnd(): number;
3521
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/domainLookupStart) */
4352
+ /**
4353
+ * The **`domainLookupStart`** read-only property returns the DOMHighResTimeStamp immediately before the browser starts the domain name lookup for the resource.
4354
+ *
4355
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/domainLookupStart)
4356
+ */
3522
4357
  get domainLookupStart(): number;
3523
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/encodedBodySize) */
4358
+ /**
4359
+ * 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).
4360
+ *
4361
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/encodedBodySize)
4362
+ */
3524
4363
  get encodedBodySize(): number;
3525
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/fetchStart) */
4364
+ /**
4365
+ * The **`fetchStart`** read-only property represents a DOMHighResTimeStamp immediately before the browser starts to fetch the resource.
4366
+ *
4367
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/fetchStart)
4368
+ */
3526
4369
  get fetchStart(): number;
3527
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/initiatorType) */
4370
+ /**
4371
+ * The **`initiatorType`** read-only property is a string representing web platform feature that initiated the resource load.
4372
+ *
4373
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/initiatorType)
4374
+ */
3528
4375
  get initiatorType(): string;
3529
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/nextHopProtocol) */
4376
+ /**
4377
+ * 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).
4378
+ *
4379
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/nextHopProtocol)
4380
+ */
3530
4381
  get nextHopProtocol(): string;
3531
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/redirectEnd) */
4382
+ /**
4383
+ * The **`redirectEnd`** read-only property returns a DOMHighResTimeStamp immediately after receiving the last byte of the response of the last redirect.
4384
+ *
4385
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/redirectEnd)
4386
+ */
3532
4387
  get redirectEnd(): number;
3533
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/redirectStart) */
4388
+ /**
4389
+ * The **`redirectStart`** read-only property returns a DOMHighResTimeStamp representing the start time of the fetch which that initiates the redirect.
4390
+ *
4391
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/redirectStart)
4392
+ */
3534
4393
  get redirectStart(): number;
3535
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/requestStart) */
4394
+ /**
4395
+ * 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.
4396
+ *
4397
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/requestStart)
4398
+ */
3536
4399
  get requestStart(): number;
3537
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/responseEnd) */
4400
+ /**
4401
+ * 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.
4402
+ *
4403
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/responseEnd)
4404
+ */
3538
4405
  get responseEnd(): number;
3539
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/responseStart) */
4406
+ /**
4407
+ * 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.
4408
+ *
4409
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/responseStart)
4410
+ */
3540
4411
  get responseStart(): number;
3541
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/responseStatus) */
4412
+ /**
4413
+ * The **`responseStatus`** read-only property represents the HTTP response status code returned when fetching the resource.
4414
+ *
4415
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/responseStatus)
4416
+ */
3542
4417
  get responseStatus(): number;
3543
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/secureConnectionStart) */
4418
+ /**
4419
+ * The **`secureConnectionStart`** read-only property returns a DOMHighResTimeStamp immediately before the browser starts the handshake process to secure the current connection.
4420
+ *
4421
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/secureConnectionStart)
4422
+ */
3544
4423
  get secureConnectionStart(): number | undefined;
3545
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/transferSize) */
4424
+ /**
4425
+ * The **`transferSize`** read-only property represents the size (in octets) of the fetched resource.
4426
+ *
4427
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/transferSize)
4428
+ */
3546
4429
  get transferSize(): number;
3547
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/workerStart) */
4430
+ /**
4431
+ * The **`workerStart`** read-only property of the PerformanceResourceTiming interface returns a The `workerStart` property can have the following values: - A DOMHighResTimeStamp.
4432
+ *
4433
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceResourceTiming/workerStart)
4434
+ */
3548
4435
  get workerStart(): number;
3549
4436
  }
3550
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver) */
4437
+ /**
4438
+ * 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_.
4439
+ *
4440
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver)
4441
+ */
3551
4442
  declare class PerformanceObserver {
3552
4443
  constructor(callback: any);
3553
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver/disconnect) */
4444
+ /**
4445
+ * The **`disconnect()`** method of the PerformanceObserver interface is used to stop the performance observer from receiving any PerformanceEntry events.
4446
+ *
4447
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver/disconnect)
4448
+ */
3554
4449
  disconnect(): void;
3555
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver/observe) */
4450
+ /**
4451
+ * The **`observe()`** method of the **PerformanceObserver** interface is used to specify the set of performance entry types to observe.
4452
+ *
4453
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver/observe)
4454
+ */
3556
4455
  observe(options?: PerformanceObserverObserveOptions): void;
3557
- /* [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver/takeRecords) */
4456
+ /**
4457
+ * The **`takeRecords()`** method of the PerformanceObserver interface returns the current list of PerformanceEntry objects stored in the performance observer, emptying it out.
4458
+ *
4459
+ * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PerformanceObserver/takeRecords)
4460
+ */
3558
4461
  takeRecords(): PerformanceEntry[];
3559
4462
  readonly supportedEntryTypes: string[];
3560
4463
  }
@@ -7337,6 +8240,10 @@ type AutoRagSearchRequest = {
7337
8240
  ranker?: string;
7338
8241
  score_threshold?: number;
7339
8242
  };
8243
+ reranking?: {
8244
+ enabled?: boolean;
8245
+ model?: string;
8246
+ };
7340
8247
  rewrite_query?: boolean;
7341
8248
  };
7342
8249
  type AutoRagAiSearchRequest = AutoRagSearchRequest & {
@@ -9281,6 +10188,11 @@ declare namespace CloudflareWorkersModule {
9281
10188
  constructor(ctx: ExecutionContext, env: Env);
9282
10189
  fetch?(request: Request): Response | Promise<Response>;
9283
10190
  tail?(events: TraceItem[]): void | Promise<void>;
10191
+ tailStream?(
10192
+ event: TailStream.TailEvent<TailStream.Onset>,
10193
+ ):
10194
+ | TailStream.TailEventHandlerType
10195
+ | Promise<TailStream.TailEventHandlerType>;
9284
10196
  trace?(traces: TraceItem[]): void | Promise<void>;
9285
10197
  scheduled?(controller: ScheduledController): void | Promise<void>;
9286
10198
  queue?(batch: MessageBatch<unknown>): void | Promise<void>;
@@ -9669,7 +10581,14 @@ interface VectorizeError {
9669
10581
  *
9670
10582
  * This list is expected to grow as support for more operations are released.
9671
10583
  */
9672
- type VectorizeVectorMetadataFilterOp = "$eq" | "$ne";
10584
+ type VectorizeVectorMetadataFilterOp =
10585
+ | "$eq"
10586
+ | "$ne"
10587
+ | "$lt"
10588
+ | "$lte"
10589
+ | "$gt"
10590
+ | "$gte";
10591
+ type VectorizeVectorMetadataFilterCollectionOp = "$in" | "$nin";
9673
10592
  /**
9674
10593
  * Filter criteria for vector metadata used to limit the retrieved query result set.
9675
10594
  */
@@ -9682,6 +10601,12 @@ type VectorizeVectorMetadataFilter = {
9682
10601
  VectorizeVectorMetadataValue,
9683
10602
  string[]
9684
10603
  > | null;
10604
+ }
10605
+ | {
10606
+ [Op in VectorizeVectorMetadataFilterCollectionOp]?: Exclude<
10607
+ VectorizeVectorMetadataValue,
10608
+ string[]
10609
+ >[];
9685
10610
  };
9686
10611
  };
9687
10612
  /**