@types/audioworklet 0.0.88 → 0.0.90

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
  */
@@ -396,7 +396,7 @@ interface CustomEvent<T = any> extends Event {
396
396
  */
397
397
  readonly detail: T;
398
398
  /**
399
- * The **`CustomEvent.initCustomEvent()`** method initializes a CustomEvent object.
399
+ * The **`CustomEvent.initCustomEvent()`** method initializes a CustomEvent object. If the event has already been dispatched, this method does nothing.
400
400
  * @deprecated
401
401
  *
402
402
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomEvent/initCustomEvent)
@@ -410,13 +410,13 @@ declare var CustomEvent: {
410
410
  };
411
411
 
412
412
  /**
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.
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. This is how error conditions are described in web APIs.
414
414
  *
415
415
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException)
416
416
  */
417
417
  interface DOMException extends Error {
418
418
  /**
419
- * The **`code`** read-only property of the DOMException interface returns one of the legacy error code constants, or `0` if none match.
419
+ * The **`code`** read-only property of the DOMException interface returns one of the legacy error code constants, or 0 if none match.
420
420
  * @deprecated
421
421
  *
422
422
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/code)
@@ -550,7 +550,7 @@ declare var ErrorEvent: {
550
550
  };
551
551
 
552
552
  /**
553
- * The **`Event`** interface represents an event which takes place on an `EventTarget`.
553
+ * The **`Event`** interface represents an event which takes place on an EventTarget.
554
554
  *
555
555
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event)
556
556
  */
@@ -562,7 +562,7 @@ interface Event {
562
562
  */
563
563
  readonly bubbles: boolean;
564
564
  /**
565
- * The **`cancelBubble`** property of the Event interface is deprecated.
565
+ * 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
566
  * @deprecated
567
567
  *
568
568
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/cancelBubble)
@@ -599,7 +599,7 @@ interface Event {
599
599
  */
600
600
  readonly eventPhase: number;
601
601
  /**
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().
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(). The only exception is the click event, which initializes the isTrusted property to false in user agents.
603
603
  *
604
604
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/isTrusted)
605
605
  */
@@ -612,14 +612,14 @@ interface Event {
612
612
  */
613
613
  returnValue: boolean;
614
614
  /**
615
- * The deprecated **`Event.srcElement`** is an alias for the Event.target property.
615
+ * The deprecated **`Event.srcElement`** is an alias for the Event.target property. Use Event.target instead.
616
616
  * @deprecated
617
617
  *
618
618
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/srcElement)
619
619
  */
620
620
  readonly srcElement: EventTarget | null;
621
621
  /**
622
- * The read-only **`target`** property of the Event interface is a reference to the object onto which the event was dispatched.
622
+ * 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
623
  *
624
624
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/target)
625
625
  */
@@ -631,13 +631,13 @@ interface Event {
631
631
  */
632
632
  readonly timeStamp: DOMHighResTimeStamp;
633
633
  /**
634
- * The **`type`** read-only property of the Event interface returns a string containing the event's type.
634
+ * 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
635
  *
636
636
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/type)
637
637
  */
638
638
  readonly type: string;
639
639
  /**
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.
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. This does not include nodes in shadow trees if the shadow root was created with its ShadowRoot.mode closed.
641
641
  *
642
642
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/composedPath)
643
643
  */
@@ -662,7 +662,7 @@ interface Event {
662
662
  */
663
663
  stopImmediatePropagation(): void;
664
664
  /**
665
- * The **`stopPropagation()`** method of the Event interface prevents further propagation of the current event in the capturing and bubbling phases.
665
+ * 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
666
  *
667
667
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/stopPropagation)
668
668
  */
@@ -691,7 +691,7 @@ interface EventListenerObject {
691
691
  }
692
692
 
693
693
  /**
694
- * The **`EventTarget`** interface is implemented by objects that can receive events and may have listeners for them.
694
+ * 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
695
  *
696
696
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget)
697
697
  */
@@ -703,13 +703,13 @@ interface EventTarget {
703
703
  */
704
704
  addEventListener(type: string, callback: EventListenerOrEventListenerObject | null, options?: AddEventListenerOptions | boolean): void;
705
705
  /**
706
- * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order.
706
+ * 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
707
  *
708
708
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/dispatchEvent)
709
709
  */
710
710
  dispatchEvent(event: Event): boolean;
711
711
  /**
712
- * The **`removeEventListener()`** method of the EventTarget interface removes an event listener previously registered with EventTarget.addEventListener() from the target.
712
+ * 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
713
  *
714
714
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/removeEventListener)
715
715
  */
@@ -759,7 +759,7 @@ interface MessageEvent<T = any> extends Event {
759
759
  */
760
760
  readonly ports: ReadonlyArray<MessagePort>;
761
761
  /**
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.
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.
763
763
  *
764
764
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/source)
765
765
  */
@@ -801,7 +801,7 @@ interface MessagePortEventMap extends MessageEventTargetEventMap {
801
801
  */
802
802
  interface MessagePort extends EventTarget, MessageEventTarget<MessagePort> {
803
803
  /**
804
- * The **`close()`** method of the MessagePort interface disconnects the port, so it is no longer active.
804
+ * 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
805
  *
806
806
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/close)
807
807
  */
@@ -814,7 +814,7 @@ interface MessagePort extends EventTarget, MessageEventTarget<MessagePort> {
814
814
  postMessage(message: any, transfer: Transferable[]): void;
815
815
  postMessage(message: any, options?: StructuredSerializeOptions): void;
816
816
  /**
817
- * The **`start()`** method of the MessagePort interface starts the sending of messages queued on the port.
817
+ * 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
818
  *
819
819
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/start)
820
820
  */
@@ -831,19 +831,19 @@ declare var MessagePort: {
831
831
  };
832
832
 
833
833
  /**
834
- * The **`PromiseRejectionEvent`** interface represents events which are sent to the global script context when JavaScript Promises are rejected.
834
+ * 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
835
  *
836
836
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent)
837
837
  */
838
838
  interface PromiseRejectionEvent extends Event {
839
839
  /**
840
- * The PromiseRejectionEvent interface's **`promise`** read-only property indicates the JavaScript Promise which was rejected.
840
+ * 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
841
  *
842
842
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/promise)
843
843
  */
844
844
  readonly promise: Promise<any>;
845
845
  /**
846
- * The PromiseRejectionEvent **`reason`** read-only property is any JavaScript value or Object which provides the reason passed into Promise.reject().
846
+ * 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
847
  *
848
848
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/reason)
849
849
  */
@@ -856,19 +856,19 @@ declare var PromiseRejectionEvent: {
856
856
  };
857
857
 
858
858
  /**
859
- * The **`ReadableByteStreamController`** interface of the Streams API represents a controller for a readable byte stream.
859
+ * 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
860
  *
861
861
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController)
862
862
  */
863
863
  interface ReadableByteStreamController {
864
864
  /**
865
- * The **`byobRequest`** read-only property of the ReadableByteStreamController interface returns the current BYOB request, or `null` if there are no pending requests.
865
+ * The **`byobRequest`** read-only property of the ReadableByteStreamController interface returns the current BYOB request, or null if there are no pending requests.
866
866
  *
867
867
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/byobRequest)
868
868
  */
869
869
  readonly byobRequest: ReadableStreamBYOBRequest | null;
870
870
  /**
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'.
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".
872
872
  *
873
873
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/desiredSize)
874
874
  */
@@ -899,7 +899,7 @@ declare var ReadableByteStreamController: {
899
899
  };
900
900
 
901
901
  /**
902
- * The `ReadableStream` interface of the Streams API represents a readable stream of byte data.
902
+ * 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
903
  *
904
904
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream)
905
905
  */
@@ -917,7 +917,7 @@ interface ReadableStream<R = any> {
917
917
  */
918
918
  cancel(reason?: any): Promise<void>;
919
919
  /**
920
- * The **`getReader()`** method of the ReadableStream interface creates a reader and locks the stream to it.
920
+ * 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
921
  *
922
922
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/getReader)
923
923
  */
@@ -931,7 +931,7 @@ interface ReadableStream<R = any> {
931
931
  */
932
932
  pipeThrough<T>(transform: ReadableWritablePair<T, R>, options?: StreamPipeOptions): ReadableStream<T>;
933
933
  /**
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.
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.
935
935
  *
936
936
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/pipeTo)
937
937
  */
@@ -952,19 +952,19 @@ declare var ReadableStream: {
952
952
  };
953
953
 
954
954
  /**
955
- * The `ReadableStreamBYOBReader` interface of the Streams API defines a reader for a ReadableStream that supports zero-copy reading from an underlying byte source.
955
+ * 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
956
  *
957
957
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader)
958
958
  */
959
959
  interface ReadableStreamBYOBReader extends ReadableStreamGenericReader {
960
960
  /**
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.
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. 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
962
  *
963
963
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/read)
964
964
  */
965
- read<T extends ArrayBufferView>(view: T, options?: ReadableStreamBYOBReaderReadOptions): Promise<ReadableStreamReadResult<T>>;
965
+ read<T extends Exclude<BufferSource, ArrayBuffer>>(view: T, options?: ReadableStreamBYOBReaderReadOptions): Promise<ReadableStreamReadResult<T>>;
966
966
  /**
967
- * The **`releaseLock()`** method of the ReadableStreamBYOBReader interface releases the reader's lock on the stream.
967
+ * 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
968
  *
969
969
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/releaseLock)
970
970
  */
@@ -977,7 +977,7 @@ declare var ReadableStreamBYOBReader: {
977
977
  };
978
978
 
979
979
  /**
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).
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).
981
981
  *
982
982
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest)
983
983
  */
@@ -1008,7 +1008,7 @@ declare var ReadableStreamBYOBRequest: {
1008
1008
  };
1009
1009
 
1010
1010
  /**
1011
- * The **`ReadableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a ReadableStream's state and internal queue.
1011
+ * 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
1012
  *
1013
1013
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController)
1014
1014
  */
@@ -1077,7 +1077,7 @@ interface ReadableStreamGenericReader {
1077
1077
  }
1078
1078
 
1079
1079
  /**
1080
- * The **`TextDecoder`** interface represents a decoder for a specific text encoding, such as `UTF-8`, `ISO-8859-2`, or `GBK`.
1080
+ * 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
1081
  *
1082
1082
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoder)
1083
1083
  */
@@ -1117,7 +1117,7 @@ interface TextDecoderCommon {
1117
1117
  }
1118
1118
 
1119
1119
  /**
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.
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. It is the streaming equivalent of TextDecoder.
1121
1121
  *
1122
1122
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoderStream)
1123
1123
  */
@@ -1132,19 +1132,19 @@ declare var TextDecoderStream: {
1132
1132
  };
1133
1133
 
1134
1134
  /**
1135
- * The **`TextEncoder`** interface enables you to character encoding a JavaScript string using UTF-8.
1135
+ * The **`TextEncoder`** interface enables you to encode a JavaScript string using UTF-8.
1136
1136
  *
1137
1137
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder)
1138
1138
  */
1139
1139
  interface TextEncoder extends TextEncoderCommon {
1140
1140
  /**
1141
- * The **`TextEncoder.encode()`** method takes a string as input, and returns a Global_Objects/Uint8Array containing the string character encoding using UTF-8.
1141
+ * The **`TextEncoder.encode()`** method takes a string as input, and returns a Uint8Array containing the string encoded using UTF-8.
1142
1142
  *
1143
1143
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encode)
1144
1144
  */
1145
1145
  encode(input?: string): Uint8Array<ArrayBuffer>;
1146
1146
  /**
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.
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. This is potentially more performant than the encode() method — especially when the target buffer is a view into a Wasm heap.
1148
1148
  *
1149
1149
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encodeInto)
1150
1150
  */
@@ -1166,7 +1166,7 @@ interface TextEncoderCommon {
1166
1166
  }
1167
1167
 
1168
1168
  /**
1169
- * The **`TextEncoderStream`** interface of the Encoding API converts a stream of strings into bytes in the UTF-8 encoding.
1169
+ * 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
1170
  *
1171
1171
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoderStream)
1172
1172
  */
@@ -1181,19 +1181,19 @@ declare var TextEncoderStream: {
1181
1181
  };
1182
1182
 
1183
1183
  /**
1184
- * The **`TransformStream`** interface of the Streams API represents a concrete implementation of the pipe chain _transform stream_ concept.
1184
+ * The **`TransformStream`** interface of the Streams API represents a concrete implementation of the pipe chain transform stream concept.
1185
1185
  *
1186
1186
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream)
1187
1187
  */
1188
1188
  interface TransformStream<I = any, O = any> {
1189
1189
  /**
1190
- * The **`readable`** read-only property of the TransformStream interface returns the ReadableStream instance controlled by this `TransformStream`.
1190
+ * The **`readable`** read-only property of the TransformStream interface returns the ReadableStream instance controlled by this TransformStream.
1191
1191
  *
1192
1192
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/readable)
1193
1193
  */
1194
1194
  readonly readable: ReadableStream<O>;
1195
1195
  /**
1196
- * The **`writable`** read-only property of the TransformStream interface returns the WritableStream instance controlled by this `TransformStream`.
1196
+ * The **`writable`** read-only property of the TransformStream interface returns the WritableStream instance controlled by this TransformStream.
1197
1197
  *
1198
1198
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/writable)
1199
1199
  */
@@ -1224,7 +1224,7 @@ interface TransformStreamDefaultController<O = any> {
1224
1224
  */
1225
1225
  enqueue(chunk?: O): void;
1226
1226
  /**
1227
- * The **`error()`** method of the TransformStreamDefaultController interface errors both sides of the stream.
1227
+ * 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
1228
  *
1229
1229
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/error)
1230
1230
  */
@@ -1243,25 +1243,25 @@ declare var TransformStreamDefaultController: {
1243
1243
  };
1244
1244
 
1245
1245
  /**
1246
- * The **`URL`** interface is used to parse, construct, normalize, and encode URL.
1246
+ * 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
1247
  *
1248
1248
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL)
1249
1249
  */
1250
1250
  interface URL {
1251
1251
  /**
1252
- * The **`hash`** property of the URL interface is a string containing a `'#'` followed by the fragment identifier of the URL.
1252
+ * 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
1253
  *
1254
1254
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hash)
1255
1255
  */
1256
1256
  hash: string;
1257
1257
  /**
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.
1258
+ * 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
1259
  *
1260
1260
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/host)
1261
1261
  */
1262
1262
  host: string;
1263
1263
  /**
1264
- * The **`hostname`** property of the URL interface is a string containing either the domain name or IP address of the URL.
1264
+ * 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
1265
  *
1266
1266
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hostname)
1267
1267
  */
@@ -1280,31 +1280,31 @@ interface URL {
1280
1280
  */
1281
1281
  readonly origin: string;
1282
1282
  /**
1283
- * The **`password`** property of the URL interface is a string containing the password component of the URL.
1283
+ * 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
1284
  *
1285
1285
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/password)
1286
1286
  */
1287
1287
  password: string;
1288
1288
  /**
1289
- * The **`pathname`** property of the URL interface represents a location in a hierarchical structure.
1289
+ * 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
1290
  *
1291
1291
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/pathname)
1292
1292
  */
1293
1293
  pathname: string;
1294
1294
  /**
1295
- * The **`port`** property of the URL interface is a string containing the port number of the URL.
1295
+ * 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
1296
  *
1297
1297
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/port)
1298
1298
  */
1299
1299
  port: string;
1300
1300
  /**
1301
- * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final `':'`.
1301
+ * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final ":".
1302
1302
  *
1303
1303
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/protocol)
1304
1304
  */
1305
1305
  protocol: string;
1306
1306
  /**
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.
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. If the URL does not have a search query, this property contains an empty string, "".
1308
1308
  *
1309
1309
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/search)
1310
1310
  */
@@ -1316,7 +1316,7 @@ interface URL {
1316
1316
  */
1317
1317
  readonly searchParams: URLSearchParams;
1318
1318
  /**
1319
- * The **`username`** property of the URL interface is a string containing the username component of the URL.
1319
+ * 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
1320
  *
1321
1321
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/username)
1322
1322
  */
@@ -1389,13 +1389,13 @@ interface URLSearchParams {
1389
1389
  */
1390
1390
  has(name: string, value?: string): boolean;
1391
1391
  /**
1392
- * The **`set()`** method of the URLSearchParams interface sets the value associated with a given search parameter to the given value.
1392
+ * 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
1393
  *
1394
1394
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/set)
1395
1395
  */
1396
1396
  set(name: string, value: string): void;
1397
1397
  /**
1398
- * The **`URLSearchParams.sort()`** method sorts all key/value pairs contained in this object in place and returns `undefined`.
1398
+ * 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
1399
  *
1400
1400
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/sort)
1401
1401
  */
@@ -1410,7 +1410,7 @@ declare var URLSearchParams: {
1410
1410
  };
1411
1411
 
1412
1412
  /**
1413
- * The **`WorkletGlobalScope`** interface is an abstract class that specific worklet scope classes inherit from.
1413
+ * The **`WorkletGlobalScope`** interface is an abstract class that specific worklet scope classes inherit from. Each WorkletGlobalScope defines a new global environment.
1414
1414
  * Available only in secure contexts.
1415
1415
  *
1416
1416
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkletGlobalScope)
@@ -1424,13 +1424,13 @@ declare var WorkletGlobalScope: {
1424
1424
  };
1425
1425
 
1426
1426
  /**
1427
- * The **`WritableStream`** interface of the Streams API provides a standard abstraction for writing streaming data to a destination, known as a sink.
1427
+ * 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
1428
  *
1429
1429
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream)
1430
1430
  */
1431
1431
  interface WritableStream<W = any> {
1432
1432
  /**
1433
- * The **`locked`** read-only property of the WritableStream interface returns a boolean indicating whether the `WritableStream` is locked to a writer.
1433
+ * The **`locked`** read-only property of the WritableStream interface returns a boolean indicating whether the WritableStream is locked to a writer.
1434
1434
  *
1435
1435
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/locked)
1436
1436
  */
@@ -1442,13 +1442,13 @@ interface WritableStream<W = any> {
1442
1442
  */
1443
1443
  abort(reason?: any): Promise<void>;
1444
1444
  /**
1445
- * The **`close()`** method of the WritableStream interface closes the associated stream.
1445
+ * 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
1446
  *
1447
1447
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/close)
1448
1448
  */
1449
1449
  close(): Promise<void>;
1450
1450
  /**
1451
- * The **`getWriter()`** method of the WritableStream interface returns a new instance of WritableStreamDefaultWriter and locks the stream to that instance.
1451
+ * 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
1452
  *
1453
1453
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/getWriter)
1454
1454
  */
@@ -1461,7 +1461,7 @@ declare var WritableStream: {
1461
1461
  };
1462
1462
 
1463
1463
  /**
1464
- * The **`WritableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a WritableStream's state.
1464
+ * 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
1465
  *
1466
1466
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController)
1467
1467
  */
@@ -1486,7 +1486,7 @@ declare var WritableStreamDefaultController: {
1486
1486
  };
1487
1487
 
1488
1488
  /**
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.
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.
1490
1490
  *
1491
1491
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter)
1492
1492
  */
@@ -1522,7 +1522,7 @@ interface WritableStreamDefaultWriter<W = any> {
1522
1522
  */
1523
1523
  close(): Promise<void>;
1524
1524
  /**
1525
- * The **`releaseLock()`** method of the WritableStreamDefaultWriter interface releases the writer's lock on the corresponding stream.
1525
+ * 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
1526
  *
1527
1527
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/releaseLock)
1528
1528
  */
@@ -1557,19 +1557,19 @@ declare namespace WebAssembly {
1557
1557
  */
1558
1558
  interface Exception {
1559
1559
  /**
1560
- * The read-only **`stack`** property of an object instance of type `WebAssembly.Exception` _may_ contain a stack trace.
1560
+ * The read-only **`stack`** property of an object instance of type WebAssembly.Exception may contain a stack trace.
1561
1561
  *
1562
1562
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/stack)
1563
1563
  */
1564
1564
  readonly stack: string | undefined;
1565
1565
  /**
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.
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.
1567
1567
  *
1568
1568
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/getArg)
1569
1569
  */
1570
1570
  getArg(index: number): any;
1571
1571
  /**
1572
- * The **`is()`** prototype method of the `Exception` object can be used to test if the `Exception` matches a given tag.
1572
+ * The **`is()`** prototype method of the Exception object can be used to test if the Exception matches a given tag.
1573
1573
  *
1574
1574
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/is)
1575
1575
  */
@@ -1582,7 +1582,7 @@ declare namespace WebAssembly {
1582
1582
  };
1583
1583
 
1584
1584
  /**
1585
- * A **`WebAssembly.Global`** object represents a global variable instance, accessible from both JavaScript and importable/exportable across one or more `WebAssembly.Module` instances.
1585
+ * 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
1586
  *
1587
1587
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Global)
1588
1588
  */
@@ -1597,13 +1597,13 @@ declare namespace WebAssembly {
1597
1597
  };
1598
1598
 
1599
1599
  /**
1600
- * A **`WebAssembly.Instance`** object is a stateful, executable instance of a `WebAssembly.Module`.
1600
+ * 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
1601
  *
1602
1602
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Instance)
1603
1603
  */
1604
1604
  interface Instance {
1605
1605
  /**
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.
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.
1607
1607
  *
1608
1608
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Instance/exports)
1609
1609
  */
@@ -1625,19 +1625,19 @@ declare namespace WebAssembly {
1625
1625
  };
1626
1626
 
1627
1627
  /**
1628
- * The **`WebAssembly.Memory`** object is a resizable ArrayBuffer or SharedArrayBuffer that holds raw bytes of memory accessed by a `WebAssembly.Instance`.
1628
+ * The **`WebAssembly.Memory`** object is a resizable ArrayBuffer or SharedArrayBuffer that holds raw bytes of memory accessed by a WebAssembly.Instance.
1629
1629
  *
1630
1630
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory)
1631
1631
  */
1632
1632
  interface Memory {
1633
1633
  /**
1634
- * The read-only **`buffer`** prototype property of the `WebAssembly.Memory` object returns the buffer contained in the memory.
1634
+ * 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
1635
  *
1636
1636
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory/buffer)
1637
1637
  */
1638
1638
  readonly buffer: ArrayBuffer;
1639
1639
  /**
1640
- * The **`grow()`** prototype method of the `WebAssembly.Memory` object increases the size of the memory instance by a specified number of WebAssembly pages.
1640
+ * The **`grow()`** prototype method of the WebAssembly.Memory object increases the size of the memory instance by a specified number of WebAssembly pages.
1641
1641
  *
1642
1642
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory/grow)
1643
1643
  */
@@ -1661,19 +1661,19 @@ declare namespace WebAssembly {
1661
1661
  prototype: Module;
1662
1662
  new(bytes: BufferSource, options?: WebAssemblyCompileOptions): Module;
1663
1663
  /**
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.
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.
1665
1665
  *
1666
1666
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Module/customSections_static)
1667
1667
  */
1668
1668
  customSections(moduleObject: Module, sectionName: string): ArrayBuffer[];
1669
1669
  /**
1670
- * The **`WebAssembly.Module.exports()`** static method returns an array containing descriptions of all the declared exports of the given `Module`.
1670
+ * The WebAssembly.**`Module.exports()`** static method returns an array containing descriptions of all the declared exports of the given Module.
1671
1671
  *
1672
1672
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Module/exports_static)
1673
1673
  */
1674
1674
  exports(moduleObject: Module): ModuleExportDescriptor[];
1675
1675
  /**
1676
- * The **`WebAssembly.Module.imports()`** static method returns an array containing descriptions of all the declared imports of the given `Module`.
1676
+ * The WebAssembly.**`Module.imports()`** static method returns an array containing descriptions of all the declared imports of the given Module.
1677
1677
  *
1678
1678
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Module/imports_static)
1679
1679
  */
@@ -1690,31 +1690,31 @@ declare namespace WebAssembly {
1690
1690
  };
1691
1691
 
1692
1692
  /**
1693
- * The **`WebAssembly.Table`** object is a JavaScript wrapper object — an array-like structure representing a WebAssembly table, which stores homogeneous references.
1693
+ * 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
1694
  *
1695
1695
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table)
1696
1696
  */
1697
1697
  interface Table {
1698
1698
  /**
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.
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.
1700
1700
  *
1701
1701
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/length)
1702
1702
  */
1703
1703
  readonly length: AddressValue;
1704
1704
  /**
1705
- * The **`get()`** prototype method of the `WebAssembly.Table()` object retrieves the element stored at a given index.
1705
+ * The **`get()`** prototype method of the WebAssembly.Table() object retrieves the element stored at a given index.
1706
1706
  *
1707
1707
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/get)
1708
1708
  */
1709
1709
  get(index: AddressValue): any;
1710
1710
  /**
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.
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.
1712
1712
  *
1713
1713
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/grow)
1714
1714
  */
1715
1715
  grow(delta: AddressValue, value?: any): AddressValue;
1716
1716
  /**
1717
- * The **`set()`** prototype method of the `WebAssembly.Table` object mutates a reference stored at a given index to a different value.
1717
+ * The **`set()`** prototype method of the WebAssembly.Table object mutates a reference stored at a given index to a different value.
1718
1718
  *
1719
1719
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/set)
1720
1720
  */
@@ -1727,7 +1727,7 @@ declare namespace WebAssembly {
1727
1727
  };
1728
1728
 
1729
1729
  /**
1730
- * The **`WebAssembly.Tag`** object defines a _type_ of a WebAssembly exception that can be thrown to/from WebAssembly code.
1730
+ * The **`WebAssembly.Tag`** object defines a type of a WebAssembly exception that can be thrown to/from WebAssembly code.
1731
1731
  *
1732
1732
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Tag)
1733
1733
  */
@@ -1825,7 +1825,7 @@ declare namespace WebAssembly {
1825
1825
  */
1826
1826
  interface Console {
1827
1827
  /**
1828
- * The **`console.assert()`** static method writes an error message to the console if the assertion is false.
1828
+ * 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
1829
  *
1830
1830
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/assert_static)
1831
1831
  */
@@ -1837,61 +1837,61 @@ interface Console {
1837
1837
  */
1838
1838
  clear(): void;
1839
1839
  /**
1840
- * The **`console.count()`** static method logs the number of times that this particular call to `count()` has been called.
1840
+ * The **`console.count()`** static method logs the number of times that this particular call to count() has been called.
1841
1841
  *
1842
1842
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/count_static)
1843
1843
  */
1844
1844
  count(label?: string): void;
1845
1845
  /**
1846
- * The **`console.countReset()`** static method resets counter used with console/count_static.
1846
+ * The **`console.countReset()`** static method resets counter used with console.count().
1847
1847
  *
1848
1848
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/countReset_static)
1849
1849
  */
1850
1850
  countReset(label?: string): void;
1851
1851
  /**
1852
- * The **`console.debug()`** static method outputs a message to the console at the 'debug' log level.
1852
+ * 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
1853
  *
1854
1854
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/debug_static)
1855
1855
  */
1856
1856
  debug(...data: any[]): void;
1857
1857
  /**
1858
- * The **`console.dir()`** static method displays a list of the properties of the specified JavaScript object.
1858
+ * 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
1859
  *
1860
1860
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/dir_static)
1861
1861
  */
1862
1862
  dir(item?: any, options?: any): void;
1863
1863
  /**
1864
- * The **`console.dirxml()`** static method displays an interactive tree of the descendant elements of the specified XML/HTML element.
1864
+ * 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
1865
  *
1866
1866
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/dirxml_static)
1867
1867
  */
1868
1868
  dirxml(...data: any[]): void;
1869
1869
  /**
1870
- * The **`console.error()`** static method outputs a message to the console at the 'error' log level.
1870
+ * 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
1871
  *
1872
1872
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/error_static)
1873
1873
  */
1874
1874
  error(...data: any[]): void;
1875
1875
  /**
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.
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() is called.
1877
1877
  *
1878
1878
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/group_static)
1879
1879
  */
1880
1880
  group(...data: any[]): void;
1881
1881
  /**
1882
- * The **`console.groupCollapsed()`** static method creates a new inline group in the console.
1882
+ * 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
1883
  *
1884
1884
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/groupCollapsed_static)
1885
1885
  */
1886
1886
  groupCollapsed(...data: any[]): void;
1887
1887
  /**
1888
- * The **`console.groupEnd()`** static method exits the current inline group in the console.
1888
+ * 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
1889
  *
1890
1890
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/groupEnd_static)
1891
1891
  */
1892
1892
  groupEnd(): void;
1893
1893
  /**
1894
- * The **`console.info()`** static method outputs a message to the console at the 'info' log level.
1894
+ * 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
1895
  *
1896
1896
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/info_static)
1897
1897
  */
@@ -1909,19 +1909,19 @@ interface Console {
1909
1909
  */
1910
1910
  table(tabularData?: any, properties?: string[]): void;
1911
1911
  /**
1912
- * The **`console.time()`** static method starts a timer you can use to track how long an operation takes.
1912
+ * 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
1913
  *
1914
1914
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/time_static)
1915
1915
  */
1916
1916
  time(label?: string): void;
1917
1917
  /**
1918
- * The **`console.timeEnd()`** static method stops a timer that was previously started by calling console/time_static.
1918
+ * The **`console.timeEnd()`** static method stops a timer that was previously started by calling console.time().
1919
1919
  *
1920
1920
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/timeEnd_static)
1921
1921
  */
1922
1922
  timeEnd(label?: string): void;
1923
1923
  /**
1924
- * The **`console.timeLog()`** static method logs the current value of a timer that was previously started by calling console/time_static.
1924
+ * The **`console.timeLog()`** static method logs the current value of a timer that was previously started by calling console.time().
1925
1925
  *
1926
1926
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/timeLog_static)
1927
1927
  */
@@ -1934,7 +1934,7 @@ interface Console {
1934
1934
  */
1935
1935
  trace(...data: any[]): void;
1936
1936
  /**
1937
- * The **`console.warn()`** static method outputs a warning message to the console at the 'warning' log level.
1937
+ * 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
1938
  *
1939
1939
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/warn_static)
1940
1940
  */
@@ -1992,13 +1992,13 @@ interface UnderlyingSourceStartCallback<R> {
1992
1992
  }
1993
1993
 
1994
1994
  /**
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.
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. It is incremented by 128 (the size of a render quantum) after the processing of each audio block.
1996
1996
  *
1997
1997
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/currentFrame)
1998
1998
  */
1999
1999
  declare var currentFrame: number;
2000
2000
  /**
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.
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. It is equal to the currentTime property of the BaseAudioContext the worklet belongs to.
2002
2002
  *
2003
2003
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/currentTime)
2004
2004
  */
@@ -2010,7 +2010,7 @@ declare var currentTime: number;
2010
2010
  */
2011
2011
  declare var sampleRate: number;
2012
2012
  /**
2013
- * The **`registerProcessor`** method of the AudioWorkletGlobalScope interface registers a class constructor derived from AudioWorkletProcessor interface under a specified _name_.
2013
+ * The **`registerProcessor`** method of the AudioWorkletGlobalScope interface registers a class constructor derived from AudioWorkletProcessor interface under a specified name.
2014
2014
  *
2015
2015
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/registerProcessor)
2016
2016
  */