@types/audioworklet 0.0.89 → 0.0.91

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.
package/index.d.ts CHANGED
@@ -201,7 +201,7 @@ interface AbortController {
201
201
  */
202
202
  readonly signal: AbortSignal;
203
203
  /**
204
- * The **`abort()`** method of the AbortController interface aborts an asynchronous operation before it has completed.
204
+ * The **`abort()`** method of the AbortController interface aborts an asynchronous operation before it has completed. This is able to abort fetch requests, the consumption of any response bodies, or streams.
205
205
  *
206
206
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortController/abort)
207
207
  */
@@ -224,7 +224,7 @@ interface AbortSignalEventMap {
224
224
  */
225
225
  interface AbortSignal extends EventTarget {
226
226
  /**
227
- * 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`).
227
+ * 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).
228
228
  *
229
229
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/aborted)
230
230
  */
@@ -238,7 +238,7 @@ interface AbortSignal extends EventTarget {
238
238
  */
239
239
  readonly reason: any;
240
240
  /**
241
- * The **`throwIfAborted()`** method throws the signal's abort AbortSignal.reason if the signal has been aborted; otherwise it does nothing.
241
+ * The **`throwIfAborted()`** method throws the signal's abort reason if the signal has been aborted; otherwise it does nothing.
242
242
  *
243
243
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/throwIfAborted)
244
244
  */
@@ -253,13 +253,13 @@ declare var AbortSignal: {
253
253
  prototype: AbortSignal;
254
254
  new(): AbortSignal;
255
255
  /**
256
- * The **`AbortSignal.abort()`** static method returns an AbortSignal that is already set as aborted (and which does not trigger an AbortSignal/abort_event event).
256
+ * The **`AbortSignal.abort()`** static method returns an AbortSignal that is already set as aborted (and which does not trigger an abort event).
257
257
  *
258
258
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/abort_static)
259
259
  */
260
260
  abort(reason?: any): AbortSignal;
261
261
  /**
262
- * The **`AbortSignal.any()`** static method takes an iterable of abort signals and returns an AbortSignal.
262
+ * The **`AbortSignal.any()`** static method takes an iterable of abort signals and returns an AbortSignal. The returned abort signal is aborted when any of the input iterable abort signals are aborted. The abort reason will be set to the reason of the first signal that is aborted. If any of the given abort signals are already aborted then so will be the returned AbortSignal.
263
263
  *
264
264
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/any_static)
265
265
  */
@@ -273,13 +273,13 @@ declare var AbortSignal: {
273
273
  */
274
274
  interface AudioWorkletGlobalScope extends WorkletGlobalScope {
275
275
  /**
276
- * The read-only **`currentFrame`** property of the AudioWorkletGlobalScope interface returns an integer that represents the ever-increasing current sample-frame of the audio block being processed.
276
+ * The read-only **`currentFrame`** property of the AudioWorkletGlobalScope interface returns an integer that represents the ever-increasing current sample-frame of the audio block being processed. It is incremented by 128 (the size of a render quantum) after the processing of each audio block.
277
277
  *
278
278
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/currentFrame)
279
279
  */
280
280
  readonly currentFrame: number;
281
281
  /**
282
- * The read-only **`currentTime`** property of the AudioWorkletGlobalScope interface returns a double that represents the ever-increasing context time of the audio block being processed.
282
+ * The read-only **`currentTime`** property of the AudioWorkletGlobalScope interface returns a double that represents the ever-increasing context time of the audio block being processed. It is equal to the currentTime property of the BaseAudioContext the worklet belongs to.
283
283
  *
284
284
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/currentTime)
285
285
  */
@@ -291,7 +291,7 @@ interface AudioWorkletGlobalScope extends WorkletGlobalScope {
291
291
  */
292
292
  readonly sampleRate: number;
293
293
  /**
294
- * The **`registerProcessor`** method of the AudioWorkletGlobalScope interface registers a class constructor derived from AudioWorkletProcessor interface under a specified _name_.
294
+ * The **`registerProcessor`** method of the AudioWorkletGlobalScope interface registers a class constructor derived from AudioWorkletProcessor interface under a specified name.
295
295
  *
296
296
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/registerProcessor)
297
297
  */
@@ -304,13 +304,13 @@ declare var AudioWorkletGlobalScope: {
304
304
  };
305
305
 
306
306
  /**
307
- * The **`AudioWorkletProcessor`** interface of the Web Audio API represents an audio processing code behind a custom AudioWorkletNode.
307
+ * The **`AudioWorkletProcessor`** interface of the Web Audio API represents an audio processing code behind a custom AudioWorkletNode. It lives in the AudioWorkletGlobalScope and runs on the Web Audio rendering thread. In turn, an AudioWorkletNode based on it runs on the main thread.
308
308
  *
309
309
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletProcessor)
310
310
  */
311
311
  interface AudioWorkletProcessor {
312
312
  /**
313
- * The read-only **`port`** property of the AudioWorkletProcessor interface returns the associated MessagePort.
313
+ * The read-only **`port`** property of the AudioWorkletProcessor interface returns the associated MessagePort. It can be used to communicate between the processor and the AudioWorkletNode to which it belongs.
314
314
  *
315
315
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletProcessor/port)
316
316
  */
@@ -353,7 +353,9 @@ declare var ByteLengthQueuingStrategy: {
353
353
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CompressionStream)
354
354
  */
355
355
  interface CompressionStream extends GenericTransformStream {
356
+ /** The **`readable`** read-only property of the CompressionStream interface returns a ReadableStream. */
356
357
  readonly readable: ReadableStream<Uint8Array<ArrayBuffer>>;
358
+ /** The **`writable`** read-only property of the CompressionStream interface returns a WritableStream. */
357
359
  readonly writable: WritableStream<BufferSource>;
358
360
  }
359
361
 
@@ -396,7 +398,7 @@ interface CustomEvent<T = any> extends Event {
396
398
  */
397
399
  readonly detail: T;
398
400
  /**
399
- * The **`CustomEvent.initCustomEvent()`** method initializes a CustomEvent object.
401
+ * The **`CustomEvent.initCustomEvent()`** method initializes a CustomEvent object. If the event has already been dispatched, this method does nothing.
400
402
  * @deprecated
401
403
  *
402
404
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomEvent/initCustomEvent)
@@ -410,13 +412,13 @@ declare var CustomEvent: {
410
412
  };
411
413
 
412
414
  /**
413
- * 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.
415
+ * The **`DOMException`** interface represents an abnormal event (called an exception) that occurs as a result of calling a method or accessing a property of a web API. This is how error conditions are described in web APIs.
414
416
  *
415
417
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException)
416
418
  */
417
419
  interface DOMException extends Error {
418
420
  /**
419
- * The **`code`** read-only property of the DOMException interface returns one of the legacy error code constants, or `0` if none match.
421
+ * The **`code`** read-only property of the DOMException interface returns one of the legacy error code constants, or 0 if none match.
420
422
  * @deprecated
421
423
  *
422
424
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/code)
@@ -497,7 +499,9 @@ declare var DOMException: {
497
499
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DecompressionStream)
498
500
  */
499
501
  interface DecompressionStream extends GenericTransformStream {
502
+ /** The **`readable`** read-only property of the DecompressionStream interface returns a ReadableStream. */
500
503
  readonly readable: ReadableStream<Uint8Array<ArrayBuffer>>;
504
+ /** The **`writable`** read-only property of the DecompressionStream interface returns a WritableStream. */
501
505
  readonly writable: WritableStream<BufferSource>;
502
506
  }
503
507
 
@@ -550,7 +554,7 @@ declare var ErrorEvent: {
550
554
  };
551
555
 
552
556
  /**
553
- * The **`Event`** interface represents an event which takes place on an `EventTarget`.
557
+ * The **`Event`** interface represents an event which takes place on an EventTarget.
554
558
  *
555
559
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event)
556
560
  */
@@ -562,7 +566,7 @@ interface Event {
562
566
  */
563
567
  readonly bubbles: boolean;
564
568
  /**
565
- * The **`cancelBubble`** property of the Event interface is deprecated.
569
+ * The **`cancelBubble`** property of the Event interface is deprecated. Use Event.stopPropagation() instead. Setting its value to true before returning from an event handler prevents propagation of the event. In later implementations, setting this to false does nothing. See Browser compatibility for details.
566
570
  * @deprecated
567
571
  *
568
572
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/cancelBubble)
@@ -599,7 +603,7 @@ interface Event {
599
603
  */
600
604
  readonly eventPhase: number;
601
605
  /**
602
- * The **`isTrusted`** read-only property of the Event interface is a boolean value that is `true` when the event was generated by the user agent (including via user actions and programmatic methods such as HTMLElement.focus()), and `false` when the event was dispatched via EventTarget.dispatchEvent().
606
+ * The **`isTrusted`** read-only property of the Event interface is a boolean value that is true when the event was generated by the user agent (including via user actions and programmatic methods such as HTMLElement.focus()), and false when the event was dispatched via EventTarget.dispatchEvent(). The only exception is the click event, which initializes the isTrusted property to false in user agents.
603
607
  *
604
608
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/isTrusted)
605
609
  */
@@ -612,14 +616,14 @@ interface Event {
612
616
  */
613
617
  returnValue: boolean;
614
618
  /**
615
- * The deprecated **`Event.srcElement`** is an alias for the Event.target property.
619
+ * The deprecated **`Event.srcElement`** is an alias for the Event.target property. Use Event.target instead.
616
620
  * @deprecated
617
621
  *
618
622
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/srcElement)
619
623
  */
620
624
  readonly srcElement: EventTarget | null;
621
625
  /**
622
- * The read-only **`target`** property of the Event interface is a reference to the object onto which the event was dispatched.
626
+ * The read-only **`target`** property of the Event interface is a reference to the object onto which the event was dispatched. It is different from Event.currentTarget when the event handler is called during the bubbling or capturing phase of the event.
623
627
  *
624
628
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/target)
625
629
  */
@@ -631,13 +635,13 @@ interface Event {
631
635
  */
632
636
  readonly timeStamp: DOMHighResTimeStamp;
633
637
  /**
634
- * The **`type`** read-only property of the Event interface returns a string containing the event's type.
638
+ * The **`type`** read-only property of the Event interface returns a string containing the event's type. It is set when the event is constructed and is the name commonly used to refer to the specific event, such as click, load, or error.
635
639
  *
636
640
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/type)
637
641
  */
638
642
  readonly type: string;
639
643
  /**
640
- * 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.
644
+ * The **`composedPath()`** method of the Event interface returns the event's path which is an array of the objects on which listeners will be invoked. This does not include nodes in shadow trees if the shadow root was created with its ShadowRoot.mode closed.
641
645
  *
642
646
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/composedPath)
643
647
  */
@@ -662,7 +666,7 @@ interface Event {
662
666
  */
663
667
  stopImmediatePropagation(): void;
664
668
  /**
665
- * The **`stopPropagation()`** method of the Event interface prevents further propagation of the current event in the capturing and bubbling phases.
669
+ * The **`stopPropagation()`** method of the Event interface prevents further propagation of the current event in the capturing and bubbling phases. It does not, however, prevent any default behaviors from occurring; for instance, clicks on links are still processed. If you want to stop those behaviors, see the preventDefault() method. It also does not prevent propagation to other event-handlers of the current element. If you want to stop those, see stopImmediatePropagation().
666
670
  *
667
671
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/stopPropagation)
668
672
  */
@@ -691,7 +695,7 @@ interface EventListenerObject {
691
695
  }
692
696
 
693
697
  /**
694
- * The **`EventTarget`** interface is implemented by objects that can receive events and may have listeners for them.
698
+ * The **`EventTarget`** interface is implemented by objects that can receive events and may have listeners for them. In other words, any target of events implements the three methods associated with this interface.
695
699
  *
696
700
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget)
697
701
  */
@@ -703,13 +707,13 @@ interface EventTarget {
703
707
  */
704
708
  addEventListener(type: string, callback: EventListenerOrEventListenerObject | null, options?: AddEventListenerOptions | boolean): void;
705
709
  /**
706
- * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order.
710
+ * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order. The normal event processing rules (including the capturing and optional bubbling phase) also apply to events dispatched manually with dispatchEvent().
707
711
  *
708
712
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/dispatchEvent)
709
713
  */
710
714
  dispatchEvent(event: Event): boolean;
711
715
  /**
712
- * The **`removeEventListener()`** method of the EventTarget interface removes an event listener previously registered with EventTarget.addEventListener() from the target.
716
+ * The **`removeEventListener()`** method of the EventTarget interface removes an event listener previously registered with EventTarget.addEventListener() from the target. The event listener to be removed is identified using a combination of the event type, the event listener function itself, and various optional options that may affect the matching process; see Matching event listeners for removal.
713
717
  *
714
718
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/removeEventListener)
715
719
  */
@@ -759,7 +763,7 @@ interface MessageEvent<T = any> extends Event {
759
763
  */
760
764
  readonly ports: ReadonlyArray<MessagePort>;
761
765
  /**
762
- * The **`source`** read-only property of the MessageEvent interface is a `MessageEventSource` (which can be a WindowProxy, MessagePort, or ServiceWorker object) representing the message emitter.
766
+ * The **`source`** read-only property of the MessageEvent interface is a MessageEventSource (which can be a WindowProxy, MessagePort, or ServiceWorker object) representing the message emitter.
763
767
  *
764
768
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/source)
765
769
  */
@@ -801,7 +805,7 @@ interface MessagePortEventMap extends MessageEventTargetEventMap {
801
805
  */
802
806
  interface MessagePort extends EventTarget, MessageEventTarget<MessagePort> {
803
807
  /**
804
- * The **`close()`** method of the MessagePort interface disconnects the port, so it is no longer active.
808
+ * The **`close()`** method of the MessagePort interface disconnects the port, so it is no longer active. This stops the flow of messages to that port.
805
809
  *
806
810
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/close)
807
811
  */
@@ -814,7 +818,7 @@ interface MessagePort extends EventTarget, MessageEventTarget<MessagePort> {
814
818
  postMessage(message: any, transfer: Transferable[]): void;
815
819
  postMessage(message: any, options?: StructuredSerializeOptions): void;
816
820
  /**
817
- * The **`start()`** method of the MessagePort interface starts the sending of messages queued on the port.
821
+ * The **`start()`** method of the MessagePort interface starts the sending of messages queued on the port. This method is only needed when using EventTarget.addEventListener; it is implied when using onmessage.
818
822
  *
819
823
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/start)
820
824
  */
@@ -831,19 +835,19 @@ declare var MessagePort: {
831
835
  };
832
836
 
833
837
  /**
834
- * The **`PromiseRejectionEvent`** interface represents events which are sent to the global script context when JavaScript Promises are rejected.
838
+ * The **`PromiseRejectionEvent`** interface represents events which are sent to the global script context when JavaScript Promises are rejected. These events are particularly useful for telemetry and debugging purposes.
835
839
  *
836
840
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent)
837
841
  */
838
842
  interface PromiseRejectionEvent extends Event {
839
843
  /**
840
- * The PromiseRejectionEvent interface's **`promise`** read-only property indicates the JavaScript Promise which was rejected.
844
+ * The PromiseRejectionEvent interface's **`promise`** read-only property indicates the JavaScript Promise which was rejected. You can examine the event's PromiseRejectionEvent.reason property to learn why the promise was rejected.
841
845
  *
842
846
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/promise)
843
847
  */
844
848
  readonly promise: Promise<any>;
845
849
  /**
846
- * The PromiseRejectionEvent **`reason`** read-only property is any JavaScript value or Object which provides the reason passed into Promise.reject().
850
+ * The PromiseRejectionEvent **`reason`** read-only property is any JavaScript value or Object which provides the reason passed into Promise.reject(). This in theory provides information about why the promise was rejected.
847
851
  *
848
852
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/reason)
849
853
  */
@@ -856,19 +860,19 @@ declare var PromiseRejectionEvent: {
856
860
  };
857
861
 
858
862
  /**
859
- * The **`ReadableByteStreamController`** interface of the Streams API represents a controller for a readable byte stream.
863
+ * The **`ReadableByteStreamController`** interface of the Streams API represents a controller for a readable byte stream. It allows control of the state and internal queue of a ReadableStream with an underlying byte source, and enables efficient zero-copy transfer of data from the underlying source to a consumer when the stream's internal queue is empty.
860
864
  *
861
865
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController)
862
866
  */
863
867
  interface ReadableByteStreamController {
864
868
  /**
865
- * The **`byobRequest`** read-only property of the ReadableByteStreamController interface returns the current BYOB request, or `null` if there are no pending requests.
869
+ * The **`byobRequest`** read-only property of the ReadableByteStreamController interface returns the current BYOB request, or null if there are no pending requests.
866
870
  *
867
871
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/byobRequest)
868
872
  */
869
873
  readonly byobRequest: ReadableStreamBYOBRequest | null;
870
874
  /**
871
- * 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'.
875
+ * 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".
872
876
  *
873
877
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/desiredSize)
874
878
  */
@@ -899,7 +903,7 @@ declare var ReadableByteStreamController: {
899
903
  };
900
904
 
901
905
  /**
902
- * The `ReadableStream` interface of the Streams API represents a readable stream of byte data.
906
+ * The **`ReadableStream`** interface of the Streams API represents a readable stream of byte data. The Fetch API offers a concrete instance of a ReadableStream through the body property of a Response object.
903
907
  *
904
908
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream)
905
909
  */
@@ -917,7 +921,7 @@ interface ReadableStream<R = any> {
917
921
  */
918
922
  cancel(reason?: any): Promise<void>;
919
923
  /**
920
- * The **`getReader()`** method of the ReadableStream interface creates a reader and locks the stream to it.
924
+ * The **`getReader()`** method of the ReadableStream interface creates a reader and locks the stream to it. While the stream is locked, no other reader can be acquired until this one is released.
921
925
  *
922
926
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/getReader)
923
927
  */
@@ -931,7 +935,7 @@ interface ReadableStream<R = any> {
931
935
  */
932
936
  pipeThrough<T>(transform: ReadableWritablePair<T, R>, options?: StreamPipeOptions): ReadableStream<T>;
933
937
  /**
934
- * 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.
938
+ * 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.
935
939
  *
936
940
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/pipeTo)
937
941
  */
@@ -952,19 +956,19 @@ declare var ReadableStream: {
952
956
  };
953
957
 
954
958
  /**
955
- * The `ReadableStreamBYOBReader` interface of the Streams API defines a reader for a ReadableStream that supports zero-copy reading from an underlying byte source.
959
+ * The **`ReadableStreamBYOBReader`** interface of the Streams API defines a reader for a ReadableStream that supports zero-copy reading from an underlying byte source. It is used for efficient copying from underlying sources where the data is delivered as an "anonymous" sequence of bytes, such as files.
956
960
  *
957
961
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader)
958
962
  */
959
963
  interface ReadableStreamBYOBReader extends ReadableStreamGenericReader {
960
964
  /**
961
- * 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.
965
+ * The **`read()`** method of the ReadableStreamBYOBReader interface is used to read data into a view on a user-supplied buffer from an associated readable byte stream. A request for data will be satisfied from the stream's internal queues if there is any data present. If the stream queues are empty, the request may be supplied as a zero-copy transfer from the underlying byte source.
962
966
  *
963
967
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/read)
964
968
  */
965
969
  read<T extends Exclude<BufferSource, ArrayBuffer>>(view: T, options?: ReadableStreamBYOBReaderReadOptions): Promise<ReadableStreamReadResult<T>>;
966
970
  /**
967
- * The **`releaseLock()`** method of the ReadableStreamBYOBReader interface releases the reader's lock on the stream.
971
+ * The **`releaseLock()`** method of the ReadableStreamBYOBReader interface releases the reader's lock on the stream. After the lock is released, the reader is no longer active.
968
972
  *
969
973
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/releaseLock)
970
974
  */
@@ -977,7 +981,7 @@ declare var ReadableStreamBYOBReader: {
977
981
  };
978
982
 
979
983
  /**
980
- * 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).
984
+ * 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).
981
985
  *
982
986
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest)
983
987
  */
@@ -1008,7 +1012,7 @@ declare var ReadableStreamBYOBRequest: {
1008
1012
  };
1009
1013
 
1010
1014
  /**
1011
- * The **`ReadableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a ReadableStream's state and internal queue.
1015
+ * The **`ReadableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a ReadableStream's state and internal queue. Default controllers are for streams that are not byte streams.
1012
1016
  *
1013
1017
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController)
1014
1018
  */
@@ -1077,7 +1081,7 @@ interface ReadableStreamGenericReader {
1077
1081
  }
1078
1082
 
1079
1083
  /**
1080
- * The **`TextDecoder`** interface represents a decoder for a specific text encoding, such as `UTF-8`, `ISO-8859-2`, or `GBK`.
1084
+ * The **`TextDecoder`** interface represents a decoder for a specific text encoding, such as UTF-8, ISO-8859-2, or GBK. A decoder takes an array of bytes as input and returns a JavaScript string.
1081
1085
  *
1082
1086
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoder)
1083
1087
  */
@@ -1117,12 +1121,14 @@ interface TextDecoderCommon {
1117
1121
  }
1118
1122
 
1119
1123
  /**
1120
- * 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.
1124
+ * The **`TextDecoderStream`** interface of the Encoding API converts a stream of text in a binary encoding, such as UTF-8 etc., to a stream of strings. It is the streaming equivalent of TextDecoder.
1121
1125
  *
1122
1126
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoderStream)
1123
1127
  */
1124
1128
  interface TextDecoderStream extends GenericTransformStream, TextDecoderCommon {
1129
+ /** The **`readable`** read-only property of the TextDecoderStream interface returns a ReadableStream. */
1125
1130
  readonly readable: ReadableStream<string>;
1131
+ /** The **`writable`** read-only property of the TextDecoderStream interface returns a WritableStream. */
1126
1132
  readonly writable: WritableStream<BufferSource>;
1127
1133
  }
1128
1134
 
@@ -1132,19 +1138,19 @@ declare var TextDecoderStream: {
1132
1138
  };
1133
1139
 
1134
1140
  /**
1135
- * The **`TextEncoder`** interface enables you to character encoding a JavaScript string using UTF-8.
1141
+ * The **`TextEncoder`** interface enables you to encode a JavaScript string using UTF-8.
1136
1142
  *
1137
1143
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder)
1138
1144
  */
1139
1145
  interface TextEncoder extends TextEncoderCommon {
1140
1146
  /**
1141
- * The **`TextEncoder.encode()`** method takes a string as input, and returns a Global_Objects/Uint8Array containing the string character encoding using UTF-8.
1147
+ * The **`TextEncoder.encode()`** method takes a string as input, and returns a Uint8Array containing the string encoded using UTF-8.
1142
1148
  *
1143
1149
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encode)
1144
1150
  */
1145
1151
  encode(input?: string): Uint8Array<ArrayBuffer>;
1146
1152
  /**
1147
- * The **`TextEncoder.encodeInto()`** method takes a string to encode and a destination Uint8Array to put resulting UTF-8 encoded text into, and returns an object indicating the progress of the encoding.
1153
+ * The **`TextEncoder.encodeInto()`** method takes a string to encode and a destination Uint8Array to put resulting UTF-8 encoded text into, and returns an object indicating the progress of the encoding. This is potentially more performant than the encode() method — especially when the target buffer is a view into a Wasm heap.
1148
1154
  *
1149
1155
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encodeInto)
1150
1156
  */
@@ -1166,12 +1172,14 @@ interface TextEncoderCommon {
1166
1172
  }
1167
1173
 
1168
1174
  /**
1169
- * The **`TextEncoderStream`** interface of the Encoding API converts a stream of strings into bytes in the UTF-8 encoding.
1175
+ * The **`TextEncoderStream`** interface of the Encoding API converts a stream of strings into bytes in the UTF-8 encoding. It is the streaming equivalent of TextEncoder.
1170
1176
  *
1171
1177
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoderStream)
1172
1178
  */
1173
1179
  interface TextEncoderStream extends GenericTransformStream, TextEncoderCommon {
1180
+ /** The **`readable`** read-only property of the TextEncoderStream interface returns a ReadableStream. */
1174
1181
  readonly readable: ReadableStream<Uint8Array<ArrayBuffer>>;
1182
+ /** The **`writable`** read-only property of the TextEncoderStream interface returns a WritableStream. */
1175
1183
  readonly writable: WritableStream<string>;
1176
1184
  }
1177
1185
 
@@ -1181,19 +1189,19 @@ declare var TextEncoderStream: {
1181
1189
  };
1182
1190
 
1183
1191
  /**
1184
- * The **`TransformStream`** interface of the Streams API represents a concrete implementation of the pipe chain _transform stream_ concept.
1192
+ * The **`TransformStream`** interface of the Streams API represents a concrete implementation of the pipe chain transform stream concept.
1185
1193
  *
1186
1194
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream)
1187
1195
  */
1188
1196
  interface TransformStream<I = any, O = any> {
1189
1197
  /**
1190
- * The **`readable`** read-only property of the TransformStream interface returns the ReadableStream instance controlled by this `TransformStream`.
1198
+ * The **`readable`** read-only property of the TransformStream interface returns the ReadableStream instance controlled by this TransformStream.
1191
1199
  *
1192
1200
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/readable)
1193
1201
  */
1194
1202
  readonly readable: ReadableStream<O>;
1195
1203
  /**
1196
- * The **`writable`** read-only property of the TransformStream interface returns the WritableStream instance controlled by this `TransformStream`.
1204
+ * The **`writable`** read-only property of the TransformStream interface returns the WritableStream instance controlled by this TransformStream.
1197
1205
  *
1198
1206
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/writable)
1199
1207
  */
@@ -1224,7 +1232,7 @@ interface TransformStreamDefaultController<O = any> {
1224
1232
  */
1225
1233
  enqueue(chunk?: O): void;
1226
1234
  /**
1227
- * The **`error()`** method of the TransformStreamDefaultController interface errors both sides of the stream.
1235
+ * The **`error()`** method of the TransformStreamDefaultController interface errors both sides of the stream. Any further interactions with it will fail with the given error message, and any chunks in the queue will be discarded.
1228
1236
  *
1229
1237
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/error)
1230
1238
  */
@@ -1243,25 +1251,25 @@ declare var TransformStreamDefaultController: {
1243
1251
  };
1244
1252
 
1245
1253
  /**
1246
- * The **`URL`** interface is used to parse, construct, normalize, and encode URL.
1254
+ * The **`URL`** interface is used to parse, construct, normalize, and encode URLs. It works by providing properties which allow you to easily read and modify the components of a URL.
1247
1255
  *
1248
1256
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL)
1249
1257
  */
1250
1258
  interface URL {
1251
1259
  /**
1252
- * The **`hash`** property of the URL interface is a string containing a `'#'` followed by the fragment identifier of the URL.
1260
+ * The **`hash`** property of the URL interface is a string containing a "#" followed by the fragment identifier of the URL. If the URL does not have a fragment identifier, this property contains an empty string, "".
1253
1261
  *
1254
1262
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hash)
1255
1263
  */
1256
1264
  hash: string;
1257
1265
  /**
1258
- * 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.
1266
+ * The **`host`** property of the URL interface is a string containing the host, which is the hostname, and then, if the port of the URL is nonempty, a ":", followed by the port of the URL. If the URL does not have a hostname, this property contains an empty string, "".
1259
1267
  *
1260
1268
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/host)
1261
1269
  */
1262
1270
  host: string;
1263
1271
  /**
1264
- * The **`hostname`** property of the URL interface is a string containing either the domain name or IP address of the URL.
1272
+ * The **`hostname`** property of the URL interface is a string containing either the domain name or IP address of the URL. If the URL does not have a hostname, this property contains an empty string, "". IPv4 and IPv6 addresses are normalized, such as stripping leading zeros, and domain names are converted to IDN.
1265
1273
  *
1266
1274
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hostname)
1267
1275
  */
@@ -1280,31 +1288,31 @@ interface URL {
1280
1288
  */
1281
1289
  readonly origin: string;
1282
1290
  /**
1283
- * The **`password`** property of the URL interface is a string containing the password component of the URL.
1291
+ * The **`password`** property of the URL interface is a string containing the password component of the URL. If the URL does not have a password, this property contains an empty string, "".
1284
1292
  *
1285
1293
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/password)
1286
1294
  */
1287
1295
  password: string;
1288
1296
  /**
1289
- * The **`pathname`** property of the URL interface represents a location in a hierarchical structure.
1297
+ * The **`pathname`** property of the URL interface represents a location in a hierarchical structure. It is a string constructed from a list of path segments, each of which is prefixed by a / character.
1290
1298
  *
1291
1299
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/pathname)
1292
1300
  */
1293
1301
  pathname: string;
1294
1302
  /**
1295
- * The **`port`** property of the URL interface is a string containing the port number of the URL.
1303
+ * The **`port`** property of the URL interface is a string containing the port number of the URL. If the port is the default for the protocol (80 for ws: and http:, 443 for wss: and https:, and 21 for ftp:), this property contains an empty string, "".
1296
1304
  *
1297
1305
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/port)
1298
1306
  */
1299
1307
  port: string;
1300
1308
  /**
1301
- * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final `':'`.
1309
+ * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final ":".
1302
1310
  *
1303
1311
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/protocol)
1304
1312
  */
1305
1313
  protocol: string;
1306
1314
  /**
1307
- * 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.
1315
+ * The **`search`** property of the URL interface is a search string, also called a query string, that is a string containing a "?" followed by the parameters of the URL. If the URL does not have a search query, this property contains an empty string, "".
1308
1316
  *
1309
1317
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/search)
1310
1318
  */
@@ -1316,7 +1324,7 @@ interface URL {
1316
1324
  */
1317
1325
  readonly searchParams: URLSearchParams;
1318
1326
  /**
1319
- * The **`username`** property of the URL interface is a string containing the username component of the URL.
1327
+ * The **`username`** property of the URL interface is a string containing the username component of the URL. If the URL does not have a username, this property contains an empty string, "".
1320
1328
  *
1321
1329
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/username)
1322
1330
  */
@@ -1389,13 +1397,13 @@ interface URLSearchParams {
1389
1397
  */
1390
1398
  has(name: string, value?: string): boolean;
1391
1399
  /**
1392
- * The **`set()`** method of the URLSearchParams interface sets the value associated with a given search parameter to the given value.
1400
+ * The **`set()`** method of the URLSearchParams interface sets the value associated with a given search parameter to the given value. If there were several matching values, this method deletes the others. If the search parameter doesn't exist, this method creates it.
1393
1401
  *
1394
1402
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/set)
1395
1403
  */
1396
1404
  set(name: string, value: string): void;
1397
1405
  /**
1398
- * The **`URLSearchParams.sort()`** method sorts all key/value pairs contained in this object in place and returns `undefined`.
1406
+ * The **`URLSearchParams.sort()`** method sorts all key/value pairs contained in this object in place and returns undefined. Key/value pairs are sorted by the values of the UTF-16 code units of the keys. This method uses a stable sorting algorithm (i.e., the relative order between key/value pairs with equal keys will be preserved).
1399
1407
  *
1400
1408
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/sort)
1401
1409
  */
@@ -1410,7 +1418,7 @@ declare var URLSearchParams: {
1410
1418
  };
1411
1419
 
1412
1420
  /**
1413
- * The **`WorkletGlobalScope`** interface is an abstract class that specific worklet scope classes inherit from.
1421
+ * The **`WorkletGlobalScope`** interface is an abstract class that specific worklet scope classes inherit from. Each WorkletGlobalScope defines a new global environment.
1414
1422
  * Available only in secure contexts.
1415
1423
  *
1416
1424
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkletGlobalScope)
@@ -1424,13 +1432,13 @@ declare var WorkletGlobalScope: {
1424
1432
  };
1425
1433
 
1426
1434
  /**
1427
- * The **`WritableStream`** interface of the Streams API provides a standard abstraction for writing streaming data to a destination, known as a sink.
1435
+ * The **`WritableStream`** interface of the Streams API provides a standard abstraction for writing streaming data to a destination, known as a sink. This object comes with built-in backpressure and queuing.
1428
1436
  *
1429
1437
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream)
1430
1438
  */
1431
1439
  interface WritableStream<W = any> {
1432
1440
  /**
1433
- * The **`locked`** read-only property of the WritableStream interface returns a boolean indicating whether the `WritableStream` is locked to a writer.
1441
+ * The **`locked`** read-only property of the WritableStream interface returns a boolean indicating whether the WritableStream is locked to a writer.
1434
1442
  *
1435
1443
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/locked)
1436
1444
  */
@@ -1442,13 +1450,13 @@ interface WritableStream<W = any> {
1442
1450
  */
1443
1451
  abort(reason?: any): Promise<void>;
1444
1452
  /**
1445
- * The **`close()`** method of the WritableStream interface closes the associated stream.
1453
+ * The **`close()`** method of the WritableStream interface closes the associated stream. All chunks written before this method is called are sent before the returned promise is fulfilled.
1446
1454
  *
1447
1455
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/close)
1448
1456
  */
1449
1457
  close(): Promise<void>;
1450
1458
  /**
1451
- * The **`getWriter()`** method of the WritableStream interface returns a new instance of WritableStreamDefaultWriter and locks the stream to that instance.
1459
+ * The **`getWriter()`** method of the WritableStream interface returns a new instance of WritableStreamDefaultWriter and locks the stream to that instance. While the stream is locked, no other writer can be acquired until this one is released.
1452
1460
  *
1453
1461
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/getWriter)
1454
1462
  */
@@ -1461,7 +1469,7 @@ declare var WritableStream: {
1461
1469
  };
1462
1470
 
1463
1471
  /**
1464
- * The **`WritableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a WritableStream's state.
1472
+ * The **`WritableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a WritableStream's state. When constructing a WritableStream, the underlying sink is given a corresponding WritableStreamDefaultController instance to manipulate.
1465
1473
  *
1466
1474
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController)
1467
1475
  */
@@ -1486,7 +1494,7 @@ declare var WritableStreamDefaultController: {
1486
1494
  };
1487
1495
 
1488
1496
  /**
1489
- * 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.
1497
+ * 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.
1490
1498
  *
1491
1499
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter)
1492
1500
  */
@@ -1522,7 +1530,7 @@ interface WritableStreamDefaultWriter<W = any> {
1522
1530
  */
1523
1531
  close(): Promise<void>;
1524
1532
  /**
1525
- * The **`releaseLock()`** method of the WritableStreamDefaultWriter interface releases the writer's lock on the corresponding stream.
1533
+ * The **`releaseLock()`** method of the WritableStreamDefaultWriter interface releases the writer's lock on the corresponding stream. After the lock is released, the writer is no longer active. If the associated stream is errored when the lock is released, the writer will appear errored in the same way from now on; otherwise, the writer will appear closed.
1526
1534
  *
1527
1535
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/releaseLock)
1528
1536
  */
@@ -1541,6 +1549,7 @@ declare var WritableStreamDefaultWriter: {
1541
1549
  };
1542
1550
 
1543
1551
  declare namespace WebAssembly {
1552
+ /** The **`WebAssembly.CompileError`** object indicates an error during WebAssembly decoding or validation. */
1544
1553
  interface CompileError extends Error {
1545
1554
  }
1546
1555
 
@@ -1557,19 +1566,19 @@ declare namespace WebAssembly {
1557
1566
  */
1558
1567
  interface Exception {
1559
1568
  /**
1560
- * The read-only **`stack`** property of an object instance of type `WebAssembly.Exception` _may_ contain a stack trace.
1569
+ * The read-only **`stack`** property of an object instance of type WebAssembly.Exception may contain a stack trace.
1561
1570
  *
1562
1571
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/stack)
1563
1572
  */
1564
1573
  readonly stack: string | undefined;
1565
1574
  /**
1566
- * The **`getArg()`** prototype method of the `Exception` object can be used to get the value of a specified item in the exception's data arguments.
1575
+ * The **`getArg()`** prototype method of the Exception object can be used to get the value of a specified item in the exception's data arguments.
1567
1576
  *
1568
1577
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/getArg)
1569
1578
  */
1570
1579
  getArg(index: number): any;
1571
1580
  /**
1572
- * The **`is()`** prototype method of the `Exception` object can be used to test if the `Exception` matches a given tag.
1581
+ * The **`is()`** prototype method of the Exception object can be used to test if the Exception matches a given tag.
1573
1582
  *
1574
1583
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/is)
1575
1584
  */
@@ -1582,7 +1591,7 @@ declare namespace WebAssembly {
1582
1591
  };
1583
1592
 
1584
1593
  /**
1585
- * A **`WebAssembly.Global`** object represents a global variable instance, accessible from both JavaScript and importable/exportable across one or more `WebAssembly.Module` instances.
1594
+ * A **`WebAssembly.Global`** object represents a global variable instance, accessible from both JavaScript and importable/exportable across one or more WebAssembly.Module instances. This allows dynamic linking of multiple modules.
1586
1595
  *
1587
1596
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Global)
1588
1597
  */
@@ -1597,13 +1606,13 @@ declare namespace WebAssembly {
1597
1606
  };
1598
1607
 
1599
1608
  /**
1600
- * A **`WebAssembly.Instance`** object is a stateful, executable instance of a `WebAssembly.Module`.
1609
+ * A **`WebAssembly.Instance`** object is a stateful, executable instance of a WebAssembly.Module. Instance objects contain all the Exported WebAssembly functions that allow calling into WebAssembly code from JavaScript.
1601
1610
  *
1602
1611
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Instance)
1603
1612
  */
1604
1613
  interface Instance {
1605
1614
  /**
1606
- * The **`exports`** read-only property of the `WebAssembly.Instance` object prototype returns an object containing as its members all the functions exported from the WebAssembly module instance, to allow them to be accessed and used by JavaScript.
1615
+ * The **`exports`** read-only property of the WebAssembly.Instance object prototype returns an object containing as its members all the functions exported from the WebAssembly module instance, to allow them to be accessed and used by JavaScript.
1607
1616
  *
1608
1617
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Instance/exports)
1609
1618
  */
@@ -1615,6 +1624,7 @@ declare namespace WebAssembly {
1615
1624
  new(module: Module, importObject?: Imports): Instance;
1616
1625
  };
1617
1626
 
1627
+ /** The **`WebAssembly.LinkError`** object indicates an error during module instantiation (besides traps from the start function). */
1618
1628
  interface LinkError extends Error {
1619
1629
  }
1620
1630
 
@@ -1625,19 +1635,19 @@ declare namespace WebAssembly {
1625
1635
  };
1626
1636
 
1627
1637
  /**
1628
- * The **`WebAssembly.Memory`** object is a resizable ArrayBuffer or SharedArrayBuffer that holds raw bytes of memory accessed by a `WebAssembly.Instance`.
1638
+ * The **`WebAssembly.Memory`** object is a resizable ArrayBuffer or SharedArrayBuffer that holds raw bytes of memory accessed by a WebAssembly.Instance.
1629
1639
  *
1630
1640
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory)
1631
1641
  */
1632
1642
  interface Memory {
1633
1643
  /**
1634
- * The read-only **`buffer`** prototype property of the `WebAssembly.Memory` object returns the buffer contained in the memory.
1644
+ * The read-only **`buffer`** prototype property of the WebAssembly.Memory object returns the buffer contained in the memory. Depending on whether or not the memory was constructed with shared: true, the buffer is either an ArrayBuffer or a SharedArrayBuffer.
1635
1645
  *
1636
1646
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory/buffer)
1637
1647
  */
1638
1648
  readonly buffer: ArrayBuffer;
1639
1649
  /**
1640
- * The **`grow()`** prototype method of the `WebAssembly.Memory` object increases the size of the memory instance by a specified number of WebAssembly pages.
1650
+ * The **`grow()`** prototype method of the WebAssembly.Memory object increases the size of the memory instance by a specified number of WebAssembly pages.
1641
1651
  *
1642
1652
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory/grow)
1643
1653
  */
@@ -1661,25 +1671,26 @@ declare namespace WebAssembly {
1661
1671
  prototype: Module;
1662
1672
  new(bytes: BufferSource, options?: WebAssemblyCompileOptions): Module;
1663
1673
  /**
1664
- * The **`WebAssembly.Module.customSections()`** static method returns a copy of the contents of all custom sections in the given module with the given string name.
1674
+ * The WebAssembly.**`Module.customSections()`** static method returns a copy of the contents of all custom sections in the given module with the given string name.
1665
1675
  *
1666
1676
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Module/customSections_static)
1667
1677
  */
1668
1678
  customSections(moduleObject: Module, sectionName: string): ArrayBuffer[];
1669
1679
  /**
1670
- * The **`WebAssembly.Module.exports()`** static method returns an array containing descriptions of all the declared exports of the given `Module`.
1680
+ * The WebAssembly.**`Module.exports()`** static method returns an array containing descriptions of all the declared exports of the given Module.
1671
1681
  *
1672
1682
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Module/exports_static)
1673
1683
  */
1674
1684
  exports(moduleObject: Module): ModuleExportDescriptor[];
1675
1685
  /**
1676
- * The **`WebAssembly.Module.imports()`** static method returns an array containing descriptions of all the declared imports of the given `Module`.
1686
+ * The WebAssembly.**`Module.imports()`** static method returns an array containing descriptions of all the declared imports of the given Module.
1677
1687
  *
1678
1688
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Module/imports_static)
1679
1689
  */
1680
1690
  imports(moduleObject: Module): ModuleImportDescriptor[];
1681
1691
  };
1682
1692
 
1693
+ /** The **`WebAssembly.RuntimeError`** object is the error type that is thrown whenever WebAssembly specifies a trap. */
1683
1694
  interface RuntimeError extends Error {
1684
1695
  }
1685
1696
 
@@ -1690,31 +1701,31 @@ declare namespace WebAssembly {
1690
1701
  };
1691
1702
 
1692
1703
  /**
1693
- * The **`WebAssembly.Table`** object is a JavaScript wrapper object — an array-like structure representing a WebAssembly table, which stores homogeneous references.
1704
+ * The **`WebAssembly.Table`** object is a JavaScript wrapper object — an array-like structure representing a WebAssembly table, which stores homogeneous references. A table created by JavaScript or in WebAssembly code will be accessible and mutable from both JavaScript and WebAssembly.
1694
1705
  *
1695
1706
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table)
1696
1707
  */
1697
1708
  interface Table {
1698
1709
  /**
1699
- * The read-only **`length`** prototype property of the `WebAssembly.Table` object returns the length of the table, i.e., the number of elements in the table.
1710
+ * The read-only **`length`** prototype property of the WebAssembly.Table object returns the length of the table, i.e., the number of elements in the table.
1700
1711
  *
1701
1712
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/length)
1702
1713
  */
1703
1714
  readonly length: AddressValue;
1704
1715
  /**
1705
- * The **`get()`** prototype method of the `WebAssembly.Table()` object retrieves the element stored at a given index.
1716
+ * The **`get()`** prototype method of the WebAssembly.Table() object retrieves the element stored at a given index.
1706
1717
  *
1707
1718
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/get)
1708
1719
  */
1709
1720
  get(index: AddressValue): any;
1710
1721
  /**
1711
- * The **`grow()`** prototype method of the `WebAssembly.Table` object increases the size of the `Table` instance by a specified number of elements, filled with the provided value.
1722
+ * The **`grow()`** prototype method of the WebAssembly.Table object increases the size of the Table instance by a specified number of elements, filled with the provided value.
1712
1723
  *
1713
1724
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/grow)
1714
1725
  */
1715
1726
  grow(delta: AddressValue, value?: any): AddressValue;
1716
1727
  /**
1717
- * The **`set()`** prototype method of the `WebAssembly.Table` object mutates a reference stored at a given index to a different value.
1728
+ * The **`set()`** prototype method of the WebAssembly.Table object mutates a reference stored at a given index to a different value.
1718
1729
  *
1719
1730
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/set)
1720
1731
  */
@@ -1727,7 +1738,7 @@ declare namespace WebAssembly {
1727
1738
  };
1728
1739
 
1729
1740
  /**
1730
- * The **`WebAssembly.Tag`** object defines a _type_ of a WebAssembly exception that can be thrown to/from WebAssembly code.
1741
+ * The **`WebAssembly.Tag`** object defines a type of a WebAssembly exception that can be thrown to/from WebAssembly code.
1731
1742
  *
1732
1743
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Tag)
1733
1744
  */
@@ -1825,7 +1836,7 @@ declare namespace WebAssembly {
1825
1836
  */
1826
1837
  interface Console {
1827
1838
  /**
1828
- * The **`console.assert()`** static method writes an error message to the console if the assertion is false.
1839
+ * The **`console.assert()`** static method writes an error message to the console if the assertion is false. If the assertion is true, nothing happens.
1829
1840
  *
1830
1841
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/assert_static)
1831
1842
  */
@@ -1837,61 +1848,61 @@ interface Console {
1837
1848
  */
1838
1849
  clear(): void;
1839
1850
  /**
1840
- * The **`console.count()`** static method logs the number of times that this particular call to `count()` has been called.
1851
+ * The **`console.count()`** static method logs the number of times that this particular call to count() has been called.
1841
1852
  *
1842
1853
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/count_static)
1843
1854
  */
1844
1855
  count(label?: string): void;
1845
1856
  /**
1846
- * The **`console.countReset()`** static method resets counter used with console/count_static.
1857
+ * The **`console.countReset()`** static method resets counter used with console.count().
1847
1858
  *
1848
1859
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/countReset_static)
1849
1860
  */
1850
1861
  countReset(label?: string): void;
1851
1862
  /**
1852
- * The **`console.debug()`** static method outputs a message to the console at the 'debug' log level.
1863
+ * The **`console.debug()`** static method outputs a message to the console at the "debug" log level. The message is only displayed to the user if the console is configured to display debug output. In most cases, the log level is configured within the console UI. This log level might correspond to the Debug or Verbose log level.
1853
1864
  *
1854
1865
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/debug_static)
1855
1866
  */
1856
1867
  debug(...data: any[]): void;
1857
1868
  /**
1858
- * The **`console.dir()`** static method displays a list of the properties of the specified JavaScript object.
1869
+ * The **`console.dir()`** static method displays a list of the properties of the specified JavaScript object. In browser consoles, the output is presented as a hierarchical listing with disclosure triangles that let you see the contents of child objects.
1859
1870
  *
1860
1871
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/dir_static)
1861
1872
  */
1862
1873
  dir(item?: any, options?: any): void;
1863
1874
  /**
1864
- * The **`console.dirxml()`** static method displays an interactive tree of the descendant elements of the specified XML/HTML element.
1875
+ * The **`console.dirxml()`** static method displays an interactive tree of the descendant elements of the specified XML/HTML element. If it is not possible to display as an element the JavaScript Object view is shown instead. The output is presented as a hierarchical listing of expandable nodes that let you see the contents of child nodes.
1865
1876
  *
1866
1877
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/dirxml_static)
1867
1878
  */
1868
1879
  dirxml(...data: any[]): void;
1869
1880
  /**
1870
- * The **`console.error()`** static method outputs a message to the console at the 'error' log level.
1881
+ * The **`console.error()`** static method outputs a message to the console at the "error" log level. The message is only displayed to the user if the console is configured to display error output. In most cases, the log level is configured within the console UI. The message may be formatted as an error, with red colors and call stack information.
1871
1882
  *
1872
1883
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/error_static)
1873
1884
  */
1874
1885
  error(...data: any[]): void;
1875
1886
  /**
1876
- * 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.
1887
+ * The **`console.group()`** static method creates a new inline group in the Web console log, causing any subsequent console messages to be indented by an additional level, until console.groupEnd() is called.
1877
1888
  *
1878
1889
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/group_static)
1879
1890
  */
1880
1891
  group(...data: any[]): void;
1881
1892
  /**
1882
- * The **`console.groupCollapsed()`** static method creates a new inline group in the console.
1893
+ * The **`console.groupCollapsed()`** static method creates a new inline group in the console. Unlike console.group(), however, the new group is created collapsed. The user will need to use the disclosure button next to it to expand it, revealing the entries created in the group.
1883
1894
  *
1884
1895
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/groupCollapsed_static)
1885
1896
  */
1886
1897
  groupCollapsed(...data: any[]): void;
1887
1898
  /**
1888
- * The **`console.groupEnd()`** static method exits the current inline group in the console.
1899
+ * The **`console.groupEnd()`** static method exits the current inline group in the console. See Using groups in the console in the console documentation for details and examples.
1889
1900
  *
1890
1901
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/groupEnd_static)
1891
1902
  */
1892
1903
  groupEnd(): void;
1893
1904
  /**
1894
- * The **`console.info()`** static method outputs a message to the console at the 'info' log level.
1905
+ * The **`console.info()`** static method outputs a message to the console at the "info" log level. The message is only displayed to the user if the console is configured to display info output. In most cases, the log level is configured within the console UI. The message may receive special formatting, such as a small "i" icon next to it.
1895
1906
  *
1896
1907
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/info_static)
1897
1908
  */
@@ -1909,23 +1920,24 @@ interface Console {
1909
1920
  */
1910
1921
  table(tabularData?: any, properties?: string[]): void;
1911
1922
  /**
1912
- * The **`console.time()`** static method starts a timer you can use to track how long an operation takes.
1923
+ * The **`console.time()`** static method starts a timer you can use to track how long an operation takes. You give each timer a unique name, and may have up to 10,000 timers running on a given page. When you call console.timeEnd() with the same name, the browser will output the time, in milliseconds, that elapsed since the timer was started.
1913
1924
  *
1914
1925
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/time_static)
1915
1926
  */
1916
1927
  time(label?: string): void;
1917
1928
  /**
1918
- * The **`console.timeEnd()`** static method stops a timer that was previously started by calling console/time_static.
1929
+ * The **`console.timeEnd()`** static method stops a timer that was previously started by calling console.time().
1919
1930
  *
1920
1931
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/timeEnd_static)
1921
1932
  */
1922
1933
  timeEnd(label?: string): void;
1923
1934
  /**
1924
- * The **`console.timeLog()`** static method logs the current value of a timer that was previously started by calling console/time_static.
1935
+ * The **`console.timeLog()`** static method logs the current value of a timer that was previously started by calling console.time().
1925
1936
  *
1926
1937
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/timeLog_static)
1927
1938
  */
1928
1939
  timeLog(label?: string, ...data: any[]): void;
1940
+ /** The **`console.timeStamp()`** static method adds a single marker to the browser's Performance tool (Firefox bug 1387528, Chrome). This lets you correlate a point in your code with the other events recorded in the timeline, such as layout and paint events. */
1929
1941
  timeStamp(label?: string): void;
1930
1942
  /**
1931
1943
  * The **`console.trace()`** static method outputs a stack trace to the console.
@@ -1934,7 +1946,7 @@ interface Console {
1934
1946
  */
1935
1947
  trace(...data: any[]): void;
1936
1948
  /**
1937
- * The **`console.warn()`** static method outputs a warning message to the console at the 'warning' log level.
1949
+ * The **`console.warn()`** static method outputs a warning message to the console at the "warning" log level. The message is only displayed to the user if the console is configured to display warning output. In most cases, the log level is configured within the console UI. The message may receive special formatting, such as yellow colors and a warning icon.
1938
1950
  *
1939
1951
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/warn_static)
1940
1952
  */
@@ -1992,13 +2004,13 @@ interface UnderlyingSourceStartCallback<R> {
1992
2004
  }
1993
2005
 
1994
2006
  /**
1995
- * The read-only **`currentFrame`** property of the AudioWorkletGlobalScope interface returns an integer that represents the ever-increasing current sample-frame of the audio block being processed.
2007
+ * The read-only **`currentFrame`** property of the AudioWorkletGlobalScope interface returns an integer that represents the ever-increasing current sample-frame of the audio block being processed. It is incremented by 128 (the size of a render quantum) after the processing of each audio block.
1996
2008
  *
1997
2009
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/currentFrame)
1998
2010
  */
1999
2011
  declare var currentFrame: number;
2000
2012
  /**
2001
- * The read-only **`currentTime`** property of the AudioWorkletGlobalScope interface returns a double that represents the ever-increasing context time of the audio block being processed.
2013
+ * The read-only **`currentTime`** property of the AudioWorkletGlobalScope interface returns a double that represents the ever-increasing context time of the audio block being processed. It is equal to the currentTime property of the BaseAudioContext the worklet belongs to.
2002
2014
  *
2003
2015
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/currentTime)
2004
2016
  */
@@ -2010,7 +2022,7 @@ declare var currentTime: number;
2010
2022
  */
2011
2023
  declare var sampleRate: number;
2012
2024
  /**
2013
- * The **`registerProcessor`** method of the AudioWorkletGlobalScope interface registers a class constructor derived from AudioWorkletProcessor interface under a specified _name_.
2025
+ * The **`registerProcessor`** method of the AudioWorkletGlobalScope interface registers a class constructor derived from AudioWorkletProcessor interface under a specified name.
2014
2026
  *
2015
2027
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/registerProcessor)
2016
2028
  */