@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/ts5.5/index.d.ts CHANGED
@@ -198,7 +198,7 @@ interface AbortController {
198
198
  */
199
199
  readonly signal: AbortSignal;
200
200
  /**
201
- * The **`abort()`** method of the AbortController interface aborts an asynchronous operation before it has completed.
201
+ * 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.
202
202
  *
203
203
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortController/abort)
204
204
  */
@@ -221,7 +221,7 @@ interface AbortSignalEventMap {
221
221
  */
222
222
  interface AbortSignal extends EventTarget {
223
223
  /**
224
- * 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`).
224
+ * 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).
225
225
  *
226
226
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/aborted)
227
227
  */
@@ -235,7 +235,7 @@ interface AbortSignal extends EventTarget {
235
235
  */
236
236
  readonly reason: any;
237
237
  /**
238
- * The **`throwIfAborted()`** method throws the signal's abort AbortSignal.reason if the signal has been aborted; otherwise it does nothing.
238
+ * The **`throwIfAborted()`** method throws the signal's abort reason if the signal has been aborted; otherwise it does nothing.
239
239
  *
240
240
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/throwIfAborted)
241
241
  */
@@ -250,13 +250,13 @@ declare var AbortSignal: {
250
250
  prototype: AbortSignal;
251
251
  new(): AbortSignal;
252
252
  /**
253
- * The **`AbortSignal.abort()`** static method returns an AbortSignal that is already set as aborted (and which does not trigger an AbortSignal/abort_event event).
253
+ * The **`AbortSignal.abort()`** static method returns an AbortSignal that is already set as aborted (and which does not trigger an abort event).
254
254
  *
255
255
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/abort_static)
256
256
  */
257
257
  abort(reason?: any): AbortSignal;
258
258
  /**
259
- * The **`AbortSignal.any()`** static method takes an iterable of abort signals and returns an AbortSignal.
259
+ * 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.
260
260
  *
261
261
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/any_static)
262
262
  */
@@ -270,13 +270,13 @@ declare var AbortSignal: {
270
270
  */
271
271
  interface AudioWorkletGlobalScope extends WorkletGlobalScope {
272
272
  /**
273
- * 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.
273
+ * 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.
274
274
  *
275
275
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/currentFrame)
276
276
  */
277
277
  readonly currentFrame: number;
278
278
  /**
279
- * 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.
279
+ * 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.
280
280
  *
281
281
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/currentTime)
282
282
  */
@@ -288,7 +288,7 @@ interface AudioWorkletGlobalScope extends WorkletGlobalScope {
288
288
  */
289
289
  readonly sampleRate: number;
290
290
  /**
291
- * The **`registerProcessor`** method of the AudioWorkletGlobalScope interface registers a class constructor derived from AudioWorkletProcessor interface under a specified _name_.
291
+ * The **`registerProcessor`** method of the AudioWorkletGlobalScope interface registers a class constructor derived from AudioWorkletProcessor interface under a specified name.
292
292
  *
293
293
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/registerProcessor)
294
294
  */
@@ -301,13 +301,13 @@ declare var AudioWorkletGlobalScope: {
301
301
  };
302
302
 
303
303
  /**
304
- * The **`AudioWorkletProcessor`** interface of the Web Audio API represents an audio processing code behind a custom AudioWorkletNode.
304
+ * 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.
305
305
  *
306
306
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletProcessor)
307
307
  */
308
308
  interface AudioWorkletProcessor {
309
309
  /**
310
- * The read-only **`port`** property of the AudioWorkletProcessor interface returns the associated MessagePort.
310
+ * 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.
311
311
  *
312
312
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletProcessor/port)
313
313
  */
@@ -350,7 +350,9 @@ declare var ByteLengthQueuingStrategy: {
350
350
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CompressionStream)
351
351
  */
352
352
  interface CompressionStream extends GenericTransformStream {
353
+ /** The **`readable`** read-only property of the CompressionStream interface returns a ReadableStream. */
353
354
  readonly readable: ReadableStream<Uint8Array>;
355
+ /** The **`writable`** read-only property of the CompressionStream interface returns a WritableStream. */
354
356
  readonly writable: WritableStream<BufferSource>;
355
357
  }
356
358
 
@@ -393,7 +395,7 @@ interface CustomEvent<T = any> extends Event {
393
395
  */
394
396
  readonly detail: T;
395
397
  /**
396
- * The **`CustomEvent.initCustomEvent()`** method initializes a CustomEvent object.
398
+ * The **`CustomEvent.initCustomEvent()`** method initializes a CustomEvent object. If the event has already been dispatched, this method does nothing.
397
399
  * @deprecated
398
400
  *
399
401
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomEvent/initCustomEvent)
@@ -407,13 +409,13 @@ declare var CustomEvent: {
407
409
  };
408
410
 
409
411
  /**
410
- * 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.
412
+ * 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.
411
413
  *
412
414
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException)
413
415
  */
414
416
  interface DOMException extends Error {
415
417
  /**
416
- * The **`code`** read-only property of the DOMException interface returns one of the legacy error code constants, or `0` if none match.
418
+ * The **`code`** read-only property of the DOMException interface returns one of the legacy error code constants, or 0 if none match.
417
419
  * @deprecated
418
420
  *
419
421
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/code)
@@ -494,7 +496,9 @@ declare var DOMException: {
494
496
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DecompressionStream)
495
497
  */
496
498
  interface DecompressionStream extends GenericTransformStream {
499
+ /** The **`readable`** read-only property of the DecompressionStream interface returns a ReadableStream. */
497
500
  readonly readable: ReadableStream<Uint8Array>;
501
+ /** The **`writable`** read-only property of the DecompressionStream interface returns a WritableStream. */
498
502
  readonly writable: WritableStream<BufferSource>;
499
503
  }
500
504
 
@@ -547,7 +551,7 @@ declare var ErrorEvent: {
547
551
  };
548
552
 
549
553
  /**
550
- * The **`Event`** interface represents an event which takes place on an `EventTarget`.
554
+ * The **`Event`** interface represents an event which takes place on an EventTarget.
551
555
  *
552
556
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event)
553
557
  */
@@ -559,7 +563,7 @@ interface Event {
559
563
  */
560
564
  readonly bubbles: boolean;
561
565
  /**
562
- * The **`cancelBubble`** property of the Event interface is deprecated.
566
+ * 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.
563
567
  * @deprecated
564
568
  *
565
569
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/cancelBubble)
@@ -596,7 +600,7 @@ interface Event {
596
600
  */
597
601
  readonly eventPhase: number;
598
602
  /**
599
- * 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().
603
+ * 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.
600
604
  *
601
605
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/isTrusted)
602
606
  */
@@ -609,14 +613,14 @@ interface Event {
609
613
  */
610
614
  returnValue: boolean;
611
615
  /**
612
- * The deprecated **`Event.srcElement`** is an alias for the Event.target property.
616
+ * The deprecated **`Event.srcElement`** is an alias for the Event.target property. Use Event.target instead.
613
617
  * @deprecated
614
618
  *
615
619
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/srcElement)
616
620
  */
617
621
  readonly srcElement: EventTarget | null;
618
622
  /**
619
- * The read-only **`target`** property of the Event interface is a reference to the object onto which the event was dispatched.
623
+ * 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.
620
624
  *
621
625
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/target)
622
626
  */
@@ -628,13 +632,13 @@ interface Event {
628
632
  */
629
633
  readonly timeStamp: DOMHighResTimeStamp;
630
634
  /**
631
- * The **`type`** read-only property of the Event interface returns a string containing the event's type.
635
+ * 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.
632
636
  *
633
637
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/type)
634
638
  */
635
639
  readonly type: string;
636
640
  /**
637
- * 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.
641
+ * 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.
638
642
  *
639
643
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/composedPath)
640
644
  */
@@ -659,7 +663,7 @@ interface Event {
659
663
  */
660
664
  stopImmediatePropagation(): void;
661
665
  /**
662
- * The **`stopPropagation()`** method of the Event interface prevents further propagation of the current event in the capturing and bubbling phases.
666
+ * 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().
663
667
  *
664
668
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/stopPropagation)
665
669
  */
@@ -688,7 +692,7 @@ interface EventListenerObject {
688
692
  }
689
693
 
690
694
  /**
691
- * The **`EventTarget`** interface is implemented by objects that can receive events and may have listeners for them.
695
+ * 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.
692
696
  *
693
697
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget)
694
698
  */
@@ -700,13 +704,13 @@ interface EventTarget {
700
704
  */
701
705
  addEventListener(type: string, callback: EventListenerOrEventListenerObject | null, options?: AddEventListenerOptions | boolean): void;
702
706
  /**
703
- * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order.
707
+ * 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().
704
708
  *
705
709
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/dispatchEvent)
706
710
  */
707
711
  dispatchEvent(event: Event): boolean;
708
712
  /**
709
- * The **`removeEventListener()`** method of the EventTarget interface removes an event listener previously registered with EventTarget.addEventListener() from the target.
713
+ * 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.
710
714
  *
711
715
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/removeEventListener)
712
716
  */
@@ -756,7 +760,7 @@ interface MessageEvent<T = any> extends Event {
756
760
  */
757
761
  readonly ports: ReadonlyArray<MessagePort>;
758
762
  /**
759
- * 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
+ * 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.
760
764
  *
761
765
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/source)
762
766
  */
@@ -798,7 +802,7 @@ interface MessagePortEventMap extends MessageEventTargetEventMap {
798
802
  */
799
803
  interface MessagePort extends EventTarget, MessageEventTarget<MessagePort> {
800
804
  /**
801
- * The **`close()`** method of the MessagePort interface disconnects the port, so it is no longer active.
805
+ * 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.
802
806
  *
803
807
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/close)
804
808
  */
@@ -811,7 +815,7 @@ interface MessagePort extends EventTarget, MessageEventTarget<MessagePort> {
811
815
  postMessage(message: any, transfer: Transferable[]): void;
812
816
  postMessage(message: any, options?: StructuredSerializeOptions): void;
813
817
  /**
814
- * The **`start()`** method of the MessagePort interface starts the sending of messages queued on the port.
818
+ * 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.
815
819
  *
816
820
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/start)
817
821
  */
@@ -828,19 +832,19 @@ declare var MessagePort: {
828
832
  };
829
833
 
830
834
  /**
831
- * The **`PromiseRejectionEvent`** interface represents events which are sent to the global script context when JavaScript Promises are rejected.
835
+ * 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.
832
836
  *
833
837
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent)
834
838
  */
835
839
  interface PromiseRejectionEvent extends Event {
836
840
  /**
837
- * The PromiseRejectionEvent interface's **`promise`** read-only property indicates the JavaScript Promise which was rejected.
841
+ * 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.
838
842
  *
839
843
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/promise)
840
844
  */
841
845
  readonly promise: Promise<any>;
842
846
  /**
843
- * The PromiseRejectionEvent **`reason`** read-only property is any JavaScript value or Object which provides the reason passed into Promise.reject().
847
+ * 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.
844
848
  *
845
849
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/reason)
846
850
  */
@@ -853,19 +857,19 @@ declare var PromiseRejectionEvent: {
853
857
  };
854
858
 
855
859
  /**
856
- * The **`ReadableByteStreamController`** interface of the Streams API represents a controller for a readable byte stream.
860
+ * 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.
857
861
  *
858
862
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController)
859
863
  */
860
864
  interface ReadableByteStreamController {
861
865
  /**
862
- * The **`byobRequest`** read-only property of the ReadableByteStreamController interface returns the current BYOB request, or `null` if there are no pending requests.
866
+ * The **`byobRequest`** read-only property of the ReadableByteStreamController interface returns the current BYOB request, or null if there are no pending requests.
863
867
  *
864
868
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/byobRequest)
865
869
  */
866
870
  readonly byobRequest: ReadableStreamBYOBRequest | null;
867
871
  /**
868
- * 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
+ * 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".
869
873
  *
870
874
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/desiredSize)
871
875
  */
@@ -896,7 +900,7 @@ declare var ReadableByteStreamController: {
896
900
  };
897
901
 
898
902
  /**
899
- * The `ReadableStream` interface of the Streams API represents a readable stream of byte data.
903
+ * 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.
900
904
  *
901
905
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream)
902
906
  */
@@ -914,7 +918,7 @@ interface ReadableStream<R = any> {
914
918
  */
915
919
  cancel(reason?: any): Promise<void>;
916
920
  /**
917
- * The **`getReader()`** method of the ReadableStream interface creates a reader and locks the stream to it.
921
+ * 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.
918
922
  *
919
923
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/getReader)
920
924
  */
@@ -928,7 +932,7 @@ interface ReadableStream<R = any> {
928
932
  */
929
933
  pipeThrough<T>(transform: ReadableWritablePair<T, R>, options?: StreamPipeOptions): ReadableStream<T>;
930
934
  /**
931
- * 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
+ * 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.
932
936
  *
933
937
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/pipeTo)
934
938
  */
@@ -949,19 +953,19 @@ declare var ReadableStream: {
949
953
  };
950
954
 
951
955
  /**
952
- * The `ReadableStreamBYOBReader` interface of the Streams API defines a reader for a ReadableStream that supports zero-copy reading from an underlying byte source.
956
+ * 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.
953
957
  *
954
958
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader)
955
959
  */
956
960
  interface ReadableStreamBYOBReader extends ReadableStreamGenericReader {
957
961
  /**
958
- * 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.
962
+ * 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.
959
963
  *
960
964
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/read)
961
965
  */
962
966
  read<T extends Exclude<BufferSource, ArrayBuffer>>(view: T, options?: ReadableStreamBYOBReaderReadOptions): Promise<ReadableStreamReadResult<T>>;
963
967
  /**
964
- * The **`releaseLock()`** method of the ReadableStreamBYOBReader interface releases the reader's lock on the stream.
968
+ * 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.
965
969
  *
966
970
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/releaseLock)
967
971
  */
@@ -974,7 +978,7 @@ declare var ReadableStreamBYOBReader: {
974
978
  };
975
979
 
976
980
  /**
977
- * 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
+ * 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).
978
982
  *
979
983
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest)
980
984
  */
@@ -1005,7 +1009,7 @@ declare var ReadableStreamBYOBRequest: {
1005
1009
  };
1006
1010
 
1007
1011
  /**
1008
- * The **`ReadableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a ReadableStream's state and internal queue.
1012
+ * 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.
1009
1013
  *
1010
1014
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController)
1011
1015
  */
@@ -1074,7 +1078,7 @@ interface ReadableStreamGenericReader {
1074
1078
  }
1075
1079
 
1076
1080
  /**
1077
- * The **`TextDecoder`** interface represents a decoder for a specific text encoding, such as `UTF-8`, `ISO-8859-2`, or `GBK`.
1081
+ * 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.
1078
1082
  *
1079
1083
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoder)
1080
1084
  */
@@ -1114,12 +1118,14 @@ interface TextDecoderCommon {
1114
1118
  }
1115
1119
 
1116
1120
  /**
1117
- * 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.
1121
+ * 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.
1118
1122
  *
1119
1123
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoderStream)
1120
1124
  */
1121
1125
  interface TextDecoderStream extends GenericTransformStream, TextDecoderCommon {
1126
+ /** The **`readable`** read-only property of the TextDecoderStream interface returns a ReadableStream. */
1122
1127
  readonly readable: ReadableStream<string>;
1128
+ /** The **`writable`** read-only property of the TextDecoderStream interface returns a WritableStream. */
1123
1129
  readonly writable: WritableStream<BufferSource>;
1124
1130
  }
1125
1131
 
@@ -1129,19 +1135,19 @@ declare var TextDecoderStream: {
1129
1135
  };
1130
1136
 
1131
1137
  /**
1132
- * The **`TextEncoder`** interface enables you to character encoding a JavaScript string using UTF-8.
1138
+ * The **`TextEncoder`** interface enables you to encode a JavaScript string using UTF-8.
1133
1139
  *
1134
1140
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder)
1135
1141
  */
1136
1142
  interface TextEncoder extends TextEncoderCommon {
1137
1143
  /**
1138
- * The **`TextEncoder.encode()`** method takes a string as input, and returns a Global_Objects/Uint8Array containing the string character encoding using UTF-8.
1144
+ * The **`TextEncoder.encode()`** method takes a string as input, and returns a Uint8Array containing the string encoded using UTF-8.
1139
1145
  *
1140
1146
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encode)
1141
1147
  */
1142
1148
  encode(input?: string): Uint8Array;
1143
1149
  /**
1144
- * 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.
1150
+ * 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.
1145
1151
  *
1146
1152
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encodeInto)
1147
1153
  */
@@ -1163,12 +1169,14 @@ interface TextEncoderCommon {
1163
1169
  }
1164
1170
 
1165
1171
  /**
1166
- * The **`TextEncoderStream`** interface of the Encoding API converts a stream of strings into bytes in the UTF-8 encoding.
1172
+ * 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.
1167
1173
  *
1168
1174
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoderStream)
1169
1175
  */
1170
1176
  interface TextEncoderStream extends GenericTransformStream, TextEncoderCommon {
1177
+ /** The **`readable`** read-only property of the TextEncoderStream interface returns a ReadableStream. */
1171
1178
  readonly readable: ReadableStream<Uint8Array>;
1179
+ /** The **`writable`** read-only property of the TextEncoderStream interface returns a WritableStream. */
1172
1180
  readonly writable: WritableStream<string>;
1173
1181
  }
1174
1182
 
@@ -1178,19 +1186,19 @@ declare var TextEncoderStream: {
1178
1186
  };
1179
1187
 
1180
1188
  /**
1181
- * The **`TransformStream`** interface of the Streams API represents a concrete implementation of the pipe chain _transform stream_ concept.
1189
+ * The **`TransformStream`** interface of the Streams API represents a concrete implementation of the pipe chain transform stream concept.
1182
1190
  *
1183
1191
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream)
1184
1192
  */
1185
1193
  interface TransformStream<I = any, O = any> {
1186
1194
  /**
1187
- * The **`readable`** read-only property of the TransformStream interface returns the ReadableStream instance controlled by this `TransformStream`.
1195
+ * The **`readable`** read-only property of the TransformStream interface returns the ReadableStream instance controlled by this TransformStream.
1188
1196
  *
1189
1197
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/readable)
1190
1198
  */
1191
1199
  readonly readable: ReadableStream<O>;
1192
1200
  /**
1193
- * The **`writable`** read-only property of the TransformStream interface returns the WritableStream instance controlled by this `TransformStream`.
1201
+ * The **`writable`** read-only property of the TransformStream interface returns the WritableStream instance controlled by this TransformStream.
1194
1202
  *
1195
1203
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/writable)
1196
1204
  */
@@ -1221,7 +1229,7 @@ interface TransformStreamDefaultController<O = any> {
1221
1229
  */
1222
1230
  enqueue(chunk?: O): void;
1223
1231
  /**
1224
- * The **`error()`** method of the TransformStreamDefaultController interface errors both sides of the stream.
1232
+ * 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.
1225
1233
  *
1226
1234
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/error)
1227
1235
  */
@@ -1240,25 +1248,25 @@ declare var TransformStreamDefaultController: {
1240
1248
  };
1241
1249
 
1242
1250
  /**
1243
- * The **`URL`** interface is used to parse, construct, normalize, and encode URL.
1251
+ * 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.
1244
1252
  *
1245
1253
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL)
1246
1254
  */
1247
1255
  interface URL {
1248
1256
  /**
1249
- * The **`hash`** property of the URL interface is a string containing a `'#'` followed by the fragment identifier of the URL.
1257
+ * 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, "".
1250
1258
  *
1251
1259
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hash)
1252
1260
  */
1253
1261
  hash: string;
1254
1262
  /**
1255
- * 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.
1263
+ * 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, "".
1256
1264
  *
1257
1265
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/host)
1258
1266
  */
1259
1267
  host: string;
1260
1268
  /**
1261
- * The **`hostname`** property of the URL interface is a string containing either the domain name or IP address of the URL.
1269
+ * 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.
1262
1270
  *
1263
1271
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hostname)
1264
1272
  */
@@ -1277,31 +1285,31 @@ interface URL {
1277
1285
  */
1278
1286
  readonly origin: string;
1279
1287
  /**
1280
- * The **`password`** property of the URL interface is a string containing the password component of the URL.
1288
+ * 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, "".
1281
1289
  *
1282
1290
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/password)
1283
1291
  */
1284
1292
  password: string;
1285
1293
  /**
1286
- * The **`pathname`** property of the URL interface represents a location in a hierarchical structure.
1294
+ * 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.
1287
1295
  *
1288
1296
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/pathname)
1289
1297
  */
1290
1298
  pathname: string;
1291
1299
  /**
1292
- * The **`port`** property of the URL interface is a string containing the port number of the URL.
1300
+ * 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, "".
1293
1301
  *
1294
1302
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/port)
1295
1303
  */
1296
1304
  port: string;
1297
1305
  /**
1298
- * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final `':'`.
1306
+ * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final ":".
1299
1307
  *
1300
1308
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/protocol)
1301
1309
  */
1302
1310
  protocol: string;
1303
1311
  /**
1304
- * 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.
1312
+ * 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, "".
1305
1313
  *
1306
1314
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/search)
1307
1315
  */
@@ -1313,7 +1321,7 @@ interface URL {
1313
1321
  */
1314
1322
  readonly searchParams: URLSearchParams;
1315
1323
  /**
1316
- * The **`username`** property of the URL interface is a string containing the username component of the URL.
1324
+ * 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, "".
1317
1325
  *
1318
1326
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/username)
1319
1327
  */
@@ -1386,13 +1394,13 @@ interface URLSearchParams {
1386
1394
  */
1387
1395
  has(name: string, value?: string): boolean;
1388
1396
  /**
1389
- * The **`set()`** method of the URLSearchParams interface sets the value associated with a given search parameter to the given value.
1397
+ * 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.
1390
1398
  *
1391
1399
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/set)
1392
1400
  */
1393
1401
  set(name: string, value: string): void;
1394
1402
  /**
1395
- * The **`URLSearchParams.sort()`** method sorts all key/value pairs contained in this object in place and returns `undefined`.
1403
+ * 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).
1396
1404
  *
1397
1405
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/sort)
1398
1406
  */
@@ -1407,7 +1415,7 @@ declare var URLSearchParams: {
1407
1415
  };
1408
1416
 
1409
1417
  /**
1410
- * The **`WorkletGlobalScope`** interface is an abstract class that specific worklet scope classes inherit from.
1418
+ * The **`WorkletGlobalScope`** interface is an abstract class that specific worklet scope classes inherit from. Each WorkletGlobalScope defines a new global environment.
1411
1419
  * Available only in secure contexts.
1412
1420
  *
1413
1421
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkletGlobalScope)
@@ -1421,13 +1429,13 @@ declare var WorkletGlobalScope: {
1421
1429
  };
1422
1430
 
1423
1431
  /**
1424
- * The **`WritableStream`** interface of the Streams API provides a standard abstraction for writing streaming data to a destination, known as a sink.
1432
+ * 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.
1425
1433
  *
1426
1434
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream)
1427
1435
  */
1428
1436
  interface WritableStream<W = any> {
1429
1437
  /**
1430
- * The **`locked`** read-only property of the WritableStream interface returns a boolean indicating whether the `WritableStream` is locked to a writer.
1438
+ * The **`locked`** read-only property of the WritableStream interface returns a boolean indicating whether the WritableStream is locked to a writer.
1431
1439
  *
1432
1440
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/locked)
1433
1441
  */
@@ -1439,13 +1447,13 @@ interface WritableStream<W = any> {
1439
1447
  */
1440
1448
  abort(reason?: any): Promise<void>;
1441
1449
  /**
1442
- * The **`close()`** method of the WritableStream interface closes the associated stream.
1450
+ * 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.
1443
1451
  *
1444
1452
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/close)
1445
1453
  */
1446
1454
  close(): Promise<void>;
1447
1455
  /**
1448
- * The **`getWriter()`** method of the WritableStream interface returns a new instance of WritableStreamDefaultWriter and locks the stream to that instance.
1456
+ * 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.
1449
1457
  *
1450
1458
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/getWriter)
1451
1459
  */
@@ -1458,7 +1466,7 @@ declare var WritableStream: {
1458
1466
  };
1459
1467
 
1460
1468
  /**
1461
- * The **`WritableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a WritableStream's state.
1469
+ * 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.
1462
1470
  *
1463
1471
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController)
1464
1472
  */
@@ -1483,7 +1491,7 @@ declare var WritableStreamDefaultController: {
1483
1491
  };
1484
1492
 
1485
1493
  /**
1486
- * 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.
1494
+ * 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.
1487
1495
  *
1488
1496
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter)
1489
1497
  */
@@ -1519,7 +1527,7 @@ interface WritableStreamDefaultWriter<W = any> {
1519
1527
  */
1520
1528
  close(): Promise<void>;
1521
1529
  /**
1522
- * The **`releaseLock()`** method of the WritableStreamDefaultWriter interface releases the writer's lock on the corresponding stream.
1530
+ * 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.
1523
1531
  *
1524
1532
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/releaseLock)
1525
1533
  */
@@ -1538,6 +1546,7 @@ declare var WritableStreamDefaultWriter: {
1538
1546
  };
1539
1547
 
1540
1548
  declare namespace WebAssembly {
1549
+ /** The **`WebAssembly.CompileError`** object indicates an error during WebAssembly decoding or validation. */
1541
1550
  interface CompileError extends Error {
1542
1551
  }
1543
1552
 
@@ -1554,19 +1563,19 @@ declare namespace WebAssembly {
1554
1563
  */
1555
1564
  interface Exception {
1556
1565
  /**
1557
- * The read-only **`stack`** property of an object instance of type `WebAssembly.Exception` _may_ contain a stack trace.
1566
+ * The read-only **`stack`** property of an object instance of type WebAssembly.Exception may contain a stack trace.
1558
1567
  *
1559
1568
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/stack)
1560
1569
  */
1561
1570
  readonly stack: string | undefined;
1562
1571
  /**
1563
- * 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.
1572
+ * 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.
1564
1573
  *
1565
1574
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/getArg)
1566
1575
  */
1567
1576
  getArg(index: number): any;
1568
1577
  /**
1569
- * The **`is()`** prototype method of the `Exception` object can be used to test if the `Exception` matches a given tag.
1578
+ * The **`is()`** prototype method of the Exception object can be used to test if the Exception matches a given tag.
1570
1579
  *
1571
1580
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/is)
1572
1581
  */
@@ -1579,7 +1588,7 @@ declare namespace WebAssembly {
1579
1588
  };
1580
1589
 
1581
1590
  /**
1582
- * A **`WebAssembly.Global`** object represents a global variable instance, accessible from both JavaScript and importable/exportable across one or more `WebAssembly.Module` instances.
1591
+ * 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.
1583
1592
  *
1584
1593
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Global)
1585
1594
  */
@@ -1594,13 +1603,13 @@ declare namespace WebAssembly {
1594
1603
  };
1595
1604
 
1596
1605
  /**
1597
- * A **`WebAssembly.Instance`** object is a stateful, executable instance of a `WebAssembly.Module`.
1606
+ * 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.
1598
1607
  *
1599
1608
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Instance)
1600
1609
  */
1601
1610
  interface Instance {
1602
1611
  /**
1603
- * 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.
1612
+ * 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.
1604
1613
  *
1605
1614
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Instance/exports)
1606
1615
  */
@@ -1612,6 +1621,7 @@ declare namespace WebAssembly {
1612
1621
  new(module: Module, importObject?: Imports): Instance;
1613
1622
  };
1614
1623
 
1624
+ /** The **`WebAssembly.LinkError`** object indicates an error during module instantiation (besides traps from the start function). */
1615
1625
  interface LinkError extends Error {
1616
1626
  }
1617
1627
 
@@ -1622,19 +1632,19 @@ declare namespace WebAssembly {
1622
1632
  };
1623
1633
 
1624
1634
  /**
1625
- * The **`WebAssembly.Memory`** object is a resizable ArrayBuffer or SharedArrayBuffer that holds raw bytes of memory accessed by a `WebAssembly.Instance`.
1635
+ * The **`WebAssembly.Memory`** object is a resizable ArrayBuffer or SharedArrayBuffer that holds raw bytes of memory accessed by a WebAssembly.Instance.
1626
1636
  *
1627
1637
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory)
1628
1638
  */
1629
1639
  interface Memory {
1630
1640
  /**
1631
- * The read-only **`buffer`** prototype property of the `WebAssembly.Memory` object returns the buffer contained in the memory.
1641
+ * 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.
1632
1642
  *
1633
1643
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory/buffer)
1634
1644
  */
1635
1645
  readonly buffer: ArrayBuffer;
1636
1646
  /**
1637
- * The **`grow()`** prototype method of the `WebAssembly.Memory` object increases the size of the memory instance by a specified number of WebAssembly pages.
1647
+ * The **`grow()`** prototype method of the WebAssembly.Memory object increases the size of the memory instance by a specified number of WebAssembly pages.
1638
1648
  *
1639
1649
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory/grow)
1640
1650
  */
@@ -1658,25 +1668,26 @@ declare namespace WebAssembly {
1658
1668
  prototype: Module;
1659
1669
  new(bytes: BufferSource, options?: WebAssemblyCompileOptions): Module;
1660
1670
  /**
1661
- * 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.
1671
+ * 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.
1662
1672
  *
1663
1673
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Module/customSections_static)
1664
1674
  */
1665
1675
  customSections(moduleObject: Module, sectionName: string): ArrayBuffer[];
1666
1676
  /**
1667
- * The **`WebAssembly.Module.exports()`** static method returns an array containing descriptions of all the declared exports of the given `Module`.
1677
+ * The WebAssembly.**`Module.exports()`** static method returns an array containing descriptions of all the declared exports of the given Module.
1668
1678
  *
1669
1679
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Module/exports_static)
1670
1680
  */
1671
1681
  exports(moduleObject: Module): ModuleExportDescriptor[];
1672
1682
  /**
1673
- * The **`WebAssembly.Module.imports()`** static method returns an array containing descriptions of all the declared imports of the given `Module`.
1683
+ * The WebAssembly.**`Module.imports()`** static method returns an array containing descriptions of all the declared imports of the given Module.
1674
1684
  *
1675
1685
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Module/imports_static)
1676
1686
  */
1677
1687
  imports(moduleObject: Module): ModuleImportDescriptor[];
1678
1688
  };
1679
1689
 
1690
+ /** The **`WebAssembly.RuntimeError`** object is the error type that is thrown whenever WebAssembly specifies a trap. */
1680
1691
  interface RuntimeError extends Error {
1681
1692
  }
1682
1693
 
@@ -1687,31 +1698,31 @@ declare namespace WebAssembly {
1687
1698
  };
1688
1699
 
1689
1700
  /**
1690
- * The **`WebAssembly.Table`** object is a JavaScript wrapper object — an array-like structure representing a WebAssembly table, which stores homogeneous references.
1701
+ * 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.
1691
1702
  *
1692
1703
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table)
1693
1704
  */
1694
1705
  interface Table {
1695
1706
  /**
1696
- * 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.
1707
+ * 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.
1697
1708
  *
1698
1709
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/length)
1699
1710
  */
1700
1711
  readonly length: AddressValue;
1701
1712
  /**
1702
- * The **`get()`** prototype method of the `WebAssembly.Table()` object retrieves the element stored at a given index.
1713
+ * The **`get()`** prototype method of the WebAssembly.Table() object retrieves the element stored at a given index.
1703
1714
  *
1704
1715
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/get)
1705
1716
  */
1706
1717
  get(index: AddressValue): any;
1707
1718
  /**
1708
- * 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.
1719
+ * 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.
1709
1720
  *
1710
1721
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/grow)
1711
1722
  */
1712
1723
  grow(delta: AddressValue, value?: any): AddressValue;
1713
1724
  /**
1714
- * The **`set()`** prototype method of the `WebAssembly.Table` object mutates a reference stored at a given index to a different value.
1725
+ * The **`set()`** prototype method of the WebAssembly.Table object mutates a reference stored at a given index to a different value.
1715
1726
  *
1716
1727
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/set)
1717
1728
  */
@@ -1724,7 +1735,7 @@ declare namespace WebAssembly {
1724
1735
  };
1725
1736
 
1726
1737
  /**
1727
- * The **`WebAssembly.Tag`** object defines a _type_ of a WebAssembly exception that can be thrown to/from WebAssembly code.
1738
+ * The **`WebAssembly.Tag`** object defines a type of a WebAssembly exception that can be thrown to/from WebAssembly code.
1728
1739
  *
1729
1740
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Tag)
1730
1741
  */
@@ -1822,7 +1833,7 @@ declare namespace WebAssembly {
1822
1833
  */
1823
1834
  interface Console {
1824
1835
  /**
1825
- * The **`console.assert()`** static method writes an error message to the console if the assertion is false.
1836
+ * The **`console.assert()`** static method writes an error message to the console if the assertion is false. If the assertion is true, nothing happens.
1826
1837
  *
1827
1838
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/assert_static)
1828
1839
  */
@@ -1834,61 +1845,61 @@ interface Console {
1834
1845
  */
1835
1846
  clear(): void;
1836
1847
  /**
1837
- * The **`console.count()`** static method logs the number of times that this particular call to `count()` has been called.
1848
+ * The **`console.count()`** static method logs the number of times that this particular call to count() has been called.
1838
1849
  *
1839
1850
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/count_static)
1840
1851
  */
1841
1852
  count(label?: string): void;
1842
1853
  /**
1843
- * The **`console.countReset()`** static method resets counter used with console/count_static.
1854
+ * The **`console.countReset()`** static method resets counter used with console.count().
1844
1855
  *
1845
1856
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/countReset_static)
1846
1857
  */
1847
1858
  countReset(label?: string): void;
1848
1859
  /**
1849
- * The **`console.debug()`** static method outputs a message to the console at the 'debug' log level.
1860
+ * 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.
1850
1861
  *
1851
1862
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/debug_static)
1852
1863
  */
1853
1864
  debug(...data: any[]): void;
1854
1865
  /**
1855
- * The **`console.dir()`** static method displays a list of the properties of the specified JavaScript object.
1866
+ * 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.
1856
1867
  *
1857
1868
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/dir_static)
1858
1869
  */
1859
1870
  dir(item?: any, options?: any): void;
1860
1871
  /**
1861
- * The **`console.dirxml()`** static method displays an interactive tree of the descendant elements of the specified XML/HTML element.
1872
+ * 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.
1862
1873
  *
1863
1874
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/dirxml_static)
1864
1875
  */
1865
1876
  dirxml(...data: any[]): void;
1866
1877
  /**
1867
- * The **`console.error()`** static method outputs a message to the console at the 'error' log level.
1878
+ * 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.
1868
1879
  *
1869
1880
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/error_static)
1870
1881
  */
1871
1882
  error(...data: any[]): void;
1872
1883
  /**
1873
- * 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.
1884
+ * 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.
1874
1885
  *
1875
1886
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/group_static)
1876
1887
  */
1877
1888
  group(...data: any[]): void;
1878
1889
  /**
1879
- * The **`console.groupCollapsed()`** static method creates a new inline group in the console.
1890
+ * 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.
1880
1891
  *
1881
1892
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/groupCollapsed_static)
1882
1893
  */
1883
1894
  groupCollapsed(...data: any[]): void;
1884
1895
  /**
1885
- * The **`console.groupEnd()`** static method exits the current inline group in the console.
1896
+ * 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.
1886
1897
  *
1887
1898
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/groupEnd_static)
1888
1899
  */
1889
1900
  groupEnd(): void;
1890
1901
  /**
1891
- * The **`console.info()`** static method outputs a message to the console at the 'info' log level.
1902
+ * 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.
1892
1903
  *
1893
1904
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/info_static)
1894
1905
  */
@@ -1906,23 +1917,24 @@ interface Console {
1906
1917
  */
1907
1918
  table(tabularData?: any, properties?: string[]): void;
1908
1919
  /**
1909
- * The **`console.time()`** static method starts a timer you can use to track how long an operation takes.
1920
+ * 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.
1910
1921
  *
1911
1922
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/time_static)
1912
1923
  */
1913
1924
  time(label?: string): void;
1914
1925
  /**
1915
- * The **`console.timeEnd()`** static method stops a timer that was previously started by calling console/time_static.
1926
+ * The **`console.timeEnd()`** static method stops a timer that was previously started by calling console.time().
1916
1927
  *
1917
1928
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/timeEnd_static)
1918
1929
  */
1919
1930
  timeEnd(label?: string): void;
1920
1931
  /**
1921
- * The **`console.timeLog()`** static method logs the current value of a timer that was previously started by calling console/time_static.
1932
+ * The **`console.timeLog()`** static method logs the current value of a timer that was previously started by calling console.time().
1922
1933
  *
1923
1934
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/timeLog_static)
1924
1935
  */
1925
1936
  timeLog(label?: string, ...data: any[]): void;
1937
+ /** 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. */
1926
1938
  timeStamp(label?: string): void;
1927
1939
  /**
1928
1940
  * The **`console.trace()`** static method outputs a stack trace to the console.
@@ -1931,7 +1943,7 @@ interface Console {
1931
1943
  */
1932
1944
  trace(...data: any[]): void;
1933
1945
  /**
1934
- * The **`console.warn()`** static method outputs a warning message to the console at the 'warning' log level.
1946
+ * 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.
1935
1947
  *
1936
1948
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/warn_static)
1937
1949
  */
@@ -1989,13 +2001,13 @@ interface UnderlyingSourceStartCallback<R> {
1989
2001
  }
1990
2002
 
1991
2003
  /**
1992
- * 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.
2004
+ * 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.
1993
2005
  *
1994
2006
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/currentFrame)
1995
2007
  */
1996
2008
  declare var currentFrame: number;
1997
2009
  /**
1998
- * 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.
2010
+ * 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.
1999
2011
  *
2000
2012
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/currentTime)
2001
2013
  */
@@ -2007,7 +2019,7 @@ declare var currentTime: number;
2007
2019
  */
2008
2020
  declare var sampleRate: number;
2009
2021
  /**
2010
- * The **`registerProcessor`** method of the AudioWorkletGlobalScope interface registers a class constructor derived from AudioWorkletProcessor interface under a specified _name_.
2022
+ * The **`registerProcessor`** method of the AudioWorkletGlobalScope interface registers a class constructor derived from AudioWorkletProcessor interface under a specified name.
2011
2023
  *
2012
2024
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/registerProcessor)
2013
2025
  */