@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/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
  */
@@ -393,7 +393,7 @@ interface CustomEvent<T = any> extends Event {
393
393
  */
394
394
  readonly detail: T;
395
395
  /**
396
- * The **`CustomEvent.initCustomEvent()`** method initializes a CustomEvent object.
396
+ * The **`CustomEvent.initCustomEvent()`** method initializes a CustomEvent object. If the event has already been dispatched, this method does nothing.
397
397
  * @deprecated
398
398
  *
399
399
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomEvent/initCustomEvent)
@@ -407,13 +407,13 @@ declare var CustomEvent: {
407
407
  };
408
408
 
409
409
  /**
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.
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. This is how error conditions are described in web APIs.
411
411
  *
412
412
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException)
413
413
  */
414
414
  interface DOMException extends Error {
415
415
  /**
416
- * The **`code`** read-only property of the DOMException interface returns one of the legacy error code constants, or `0` if none match.
416
+ * The **`code`** read-only property of the DOMException interface returns one of the legacy error code constants, or 0 if none match.
417
417
  * @deprecated
418
418
  *
419
419
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/code)
@@ -547,7 +547,7 @@ declare var ErrorEvent: {
547
547
  };
548
548
 
549
549
  /**
550
- * The **`Event`** interface represents an event which takes place on an `EventTarget`.
550
+ * The **`Event`** interface represents an event which takes place on an EventTarget.
551
551
  *
552
552
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event)
553
553
  */
@@ -559,7 +559,7 @@ interface Event {
559
559
  */
560
560
  readonly bubbles: boolean;
561
561
  /**
562
- * The **`cancelBubble`** property of the Event interface is deprecated.
562
+ * 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
563
  * @deprecated
564
564
  *
565
565
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/cancelBubble)
@@ -596,7 +596,7 @@ interface Event {
596
596
  */
597
597
  readonly eventPhase: number;
598
598
  /**
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().
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(). The only exception is the click event, which initializes the isTrusted property to false in user agents.
600
600
  *
601
601
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/isTrusted)
602
602
  */
@@ -609,14 +609,14 @@ interface Event {
609
609
  */
610
610
  returnValue: boolean;
611
611
  /**
612
- * The deprecated **`Event.srcElement`** is an alias for the Event.target property.
612
+ * The deprecated **`Event.srcElement`** is an alias for the Event.target property. Use Event.target instead.
613
613
  * @deprecated
614
614
  *
615
615
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/srcElement)
616
616
  */
617
617
  readonly srcElement: EventTarget | null;
618
618
  /**
619
- * The read-only **`target`** property of the Event interface is a reference to the object onto which the event was dispatched.
619
+ * 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
620
  *
621
621
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/target)
622
622
  */
@@ -628,13 +628,13 @@ interface Event {
628
628
  */
629
629
  readonly timeStamp: DOMHighResTimeStamp;
630
630
  /**
631
- * The **`type`** read-only property of the Event interface returns a string containing the event's type.
631
+ * 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
632
  *
633
633
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/type)
634
634
  */
635
635
  readonly type: string;
636
636
  /**
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.
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. This does not include nodes in shadow trees if the shadow root was created with its ShadowRoot.mode closed.
638
638
  *
639
639
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/composedPath)
640
640
  */
@@ -659,7 +659,7 @@ interface Event {
659
659
  */
660
660
  stopImmediatePropagation(): void;
661
661
  /**
662
- * The **`stopPropagation()`** method of the Event interface prevents further propagation of the current event in the capturing and bubbling phases.
662
+ * 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
663
  *
664
664
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/stopPropagation)
665
665
  */
@@ -688,7 +688,7 @@ interface EventListenerObject {
688
688
  }
689
689
 
690
690
  /**
691
- * The **`EventTarget`** interface is implemented by objects that can receive events and may have listeners for them.
691
+ * 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
692
  *
693
693
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget)
694
694
  */
@@ -700,13 +700,13 @@ interface EventTarget {
700
700
  */
701
701
  addEventListener(type: string, callback: EventListenerOrEventListenerObject | null, options?: AddEventListenerOptions | boolean): void;
702
702
  /**
703
- * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order.
703
+ * 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
704
  *
705
705
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/dispatchEvent)
706
706
  */
707
707
  dispatchEvent(event: Event): boolean;
708
708
  /**
709
- * The **`removeEventListener()`** method of the EventTarget interface removes an event listener previously registered with EventTarget.addEventListener() from the target.
709
+ * 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
710
  *
711
711
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/removeEventListener)
712
712
  */
@@ -756,7 +756,7 @@ interface MessageEvent<T = any> extends Event {
756
756
  */
757
757
  readonly ports: ReadonlyArray<MessagePort>;
758
758
  /**
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.
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.
760
760
  *
761
761
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/source)
762
762
  */
@@ -798,7 +798,7 @@ interface MessagePortEventMap extends MessageEventTargetEventMap {
798
798
  */
799
799
  interface MessagePort extends EventTarget, MessageEventTarget<MessagePort> {
800
800
  /**
801
- * The **`close()`** method of the MessagePort interface disconnects the port, so it is no longer active.
801
+ * 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
802
  *
803
803
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/close)
804
804
  */
@@ -811,7 +811,7 @@ interface MessagePort extends EventTarget, MessageEventTarget<MessagePort> {
811
811
  postMessage(message: any, transfer: Transferable[]): void;
812
812
  postMessage(message: any, options?: StructuredSerializeOptions): void;
813
813
  /**
814
- * The **`start()`** method of the MessagePort interface starts the sending of messages queued on the port.
814
+ * 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
815
  *
816
816
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/start)
817
817
  */
@@ -828,19 +828,19 @@ declare var MessagePort: {
828
828
  };
829
829
 
830
830
  /**
831
- * The **`PromiseRejectionEvent`** interface represents events which are sent to the global script context when JavaScript Promises are rejected.
831
+ * 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
832
  *
833
833
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent)
834
834
  */
835
835
  interface PromiseRejectionEvent extends Event {
836
836
  /**
837
- * The PromiseRejectionEvent interface's **`promise`** read-only property indicates the JavaScript Promise which was rejected.
837
+ * 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
838
  *
839
839
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/promise)
840
840
  */
841
841
  readonly promise: Promise<any>;
842
842
  /**
843
- * The PromiseRejectionEvent **`reason`** read-only property is any JavaScript value or Object which provides the reason passed into Promise.reject().
843
+ * 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
844
  *
845
845
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/reason)
846
846
  */
@@ -853,19 +853,19 @@ declare var PromiseRejectionEvent: {
853
853
  };
854
854
 
855
855
  /**
856
- * The **`ReadableByteStreamController`** interface of the Streams API represents a controller for a readable byte stream.
856
+ * 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
857
  *
858
858
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController)
859
859
  */
860
860
  interface ReadableByteStreamController {
861
861
  /**
862
- * The **`byobRequest`** read-only property of the ReadableByteStreamController interface returns the current BYOB request, or `null` if there are no pending requests.
862
+ * The **`byobRequest`** read-only property of the ReadableByteStreamController interface returns the current BYOB request, or null if there are no pending requests.
863
863
  *
864
864
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/byobRequest)
865
865
  */
866
866
  readonly byobRequest: ReadableStreamBYOBRequest | null;
867
867
  /**
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'.
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".
869
869
  *
870
870
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/desiredSize)
871
871
  */
@@ -896,7 +896,7 @@ declare var ReadableByteStreamController: {
896
896
  };
897
897
 
898
898
  /**
899
- * The `ReadableStream` interface of the Streams API represents a readable stream of byte data.
899
+ * 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
900
  *
901
901
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream)
902
902
  */
@@ -914,7 +914,7 @@ interface ReadableStream<R = any> {
914
914
  */
915
915
  cancel(reason?: any): Promise<void>;
916
916
  /**
917
- * The **`getReader()`** method of the ReadableStream interface creates a reader and locks the stream to it.
917
+ * 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
918
  *
919
919
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/getReader)
920
920
  */
@@ -928,7 +928,7 @@ interface ReadableStream<R = any> {
928
928
  */
929
929
  pipeThrough<T>(transform: ReadableWritablePair<T, R>, options?: StreamPipeOptions): ReadableStream<T>;
930
930
  /**
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.
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.
932
932
  *
933
933
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/pipeTo)
934
934
  */
@@ -949,19 +949,19 @@ declare var ReadableStream: {
949
949
  };
950
950
 
951
951
  /**
952
- * The `ReadableStreamBYOBReader` interface of the Streams API defines a reader for a ReadableStream that supports zero-copy reading from an underlying byte source.
952
+ * 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
953
  *
954
954
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader)
955
955
  */
956
956
  interface ReadableStreamBYOBReader extends ReadableStreamGenericReader {
957
957
  /**
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.
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. 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
959
  *
960
960
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/read)
961
961
  */
962
- read<T extends ArrayBufferView>(view: T, options?: ReadableStreamBYOBReaderReadOptions): Promise<ReadableStreamReadResult<T>>;
962
+ read<T extends Exclude<BufferSource, ArrayBuffer>>(view: T, options?: ReadableStreamBYOBReaderReadOptions): Promise<ReadableStreamReadResult<T>>;
963
963
  /**
964
- * The **`releaseLock()`** method of the ReadableStreamBYOBReader interface releases the reader's lock on the stream.
964
+ * 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
965
  *
966
966
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/releaseLock)
967
967
  */
@@ -974,7 +974,7 @@ declare var ReadableStreamBYOBReader: {
974
974
  };
975
975
 
976
976
  /**
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).
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).
978
978
  *
979
979
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBRequest)
980
980
  */
@@ -1005,7 +1005,7 @@ declare var ReadableStreamBYOBRequest: {
1005
1005
  };
1006
1006
 
1007
1007
  /**
1008
- * The **`ReadableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a ReadableStream's state and internal queue.
1008
+ * 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
1009
  *
1010
1010
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController)
1011
1011
  */
@@ -1074,7 +1074,7 @@ interface ReadableStreamGenericReader {
1074
1074
  }
1075
1075
 
1076
1076
  /**
1077
- * The **`TextDecoder`** interface represents a decoder for a specific text encoding, such as `UTF-8`, `ISO-8859-2`, or `GBK`.
1077
+ * 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
1078
  *
1079
1079
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoder)
1080
1080
  */
@@ -1114,7 +1114,7 @@ interface TextDecoderCommon {
1114
1114
  }
1115
1115
 
1116
1116
  /**
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.
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. It is the streaming equivalent of TextDecoder.
1118
1118
  *
1119
1119
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoderStream)
1120
1120
  */
@@ -1129,19 +1129,19 @@ declare var TextDecoderStream: {
1129
1129
  };
1130
1130
 
1131
1131
  /**
1132
- * The **`TextEncoder`** interface enables you to character encoding a JavaScript string using UTF-8.
1132
+ * The **`TextEncoder`** interface enables you to encode a JavaScript string using UTF-8.
1133
1133
  *
1134
1134
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder)
1135
1135
  */
1136
1136
  interface TextEncoder extends TextEncoderCommon {
1137
1137
  /**
1138
- * The **`TextEncoder.encode()`** method takes a string as input, and returns a Global_Objects/Uint8Array containing the string character encoding using UTF-8.
1138
+ * The **`TextEncoder.encode()`** method takes a string as input, and returns a Uint8Array containing the string encoded using UTF-8.
1139
1139
  *
1140
1140
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encode)
1141
1141
  */
1142
1142
  encode(input?: string): Uint8Array;
1143
1143
  /**
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.
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. This is potentially more performant than the encode() method — especially when the target buffer is a view into a Wasm heap.
1145
1145
  *
1146
1146
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encodeInto)
1147
1147
  */
@@ -1163,7 +1163,7 @@ interface TextEncoderCommon {
1163
1163
  }
1164
1164
 
1165
1165
  /**
1166
- * The **`TextEncoderStream`** interface of the Encoding API converts a stream of strings into bytes in the UTF-8 encoding.
1166
+ * 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
1167
  *
1168
1168
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoderStream)
1169
1169
  */
@@ -1178,19 +1178,19 @@ declare var TextEncoderStream: {
1178
1178
  };
1179
1179
 
1180
1180
  /**
1181
- * The **`TransformStream`** interface of the Streams API represents a concrete implementation of the pipe chain _transform stream_ concept.
1181
+ * The **`TransformStream`** interface of the Streams API represents a concrete implementation of the pipe chain transform stream concept.
1182
1182
  *
1183
1183
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream)
1184
1184
  */
1185
1185
  interface TransformStream<I = any, O = any> {
1186
1186
  /**
1187
- * The **`readable`** read-only property of the TransformStream interface returns the ReadableStream instance controlled by this `TransformStream`.
1187
+ * The **`readable`** read-only property of the TransformStream interface returns the ReadableStream instance controlled by this TransformStream.
1188
1188
  *
1189
1189
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/readable)
1190
1190
  */
1191
1191
  readonly readable: ReadableStream<O>;
1192
1192
  /**
1193
- * The **`writable`** read-only property of the TransformStream interface returns the WritableStream instance controlled by this `TransformStream`.
1193
+ * The **`writable`** read-only property of the TransformStream interface returns the WritableStream instance controlled by this TransformStream.
1194
1194
  *
1195
1195
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/writable)
1196
1196
  */
@@ -1221,7 +1221,7 @@ interface TransformStreamDefaultController<O = any> {
1221
1221
  */
1222
1222
  enqueue(chunk?: O): void;
1223
1223
  /**
1224
- * The **`error()`** method of the TransformStreamDefaultController interface errors both sides of the stream.
1224
+ * 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
1225
  *
1226
1226
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/error)
1227
1227
  */
@@ -1240,25 +1240,25 @@ declare var TransformStreamDefaultController: {
1240
1240
  };
1241
1241
 
1242
1242
  /**
1243
- * The **`URL`** interface is used to parse, construct, normalize, and encode URL.
1243
+ * 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
1244
  *
1245
1245
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL)
1246
1246
  */
1247
1247
  interface URL {
1248
1248
  /**
1249
- * The **`hash`** property of the URL interface is a string containing a `'#'` followed by the fragment identifier of the URL.
1249
+ * 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
1250
  *
1251
1251
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hash)
1252
1252
  */
1253
1253
  hash: string;
1254
1254
  /**
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.
1255
+ * 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
1256
  *
1257
1257
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/host)
1258
1258
  */
1259
1259
  host: string;
1260
1260
  /**
1261
- * The **`hostname`** property of the URL interface is a string containing either the domain name or IP address of the URL.
1261
+ * 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
1262
  *
1263
1263
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hostname)
1264
1264
  */
@@ -1277,31 +1277,31 @@ interface URL {
1277
1277
  */
1278
1278
  readonly origin: string;
1279
1279
  /**
1280
- * The **`password`** property of the URL interface is a string containing the password component of the URL.
1280
+ * 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
1281
  *
1282
1282
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/password)
1283
1283
  */
1284
1284
  password: string;
1285
1285
  /**
1286
- * The **`pathname`** property of the URL interface represents a location in a hierarchical structure.
1286
+ * 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
1287
  *
1288
1288
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/pathname)
1289
1289
  */
1290
1290
  pathname: string;
1291
1291
  /**
1292
- * The **`port`** property of the URL interface is a string containing the port number of the URL.
1292
+ * 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
1293
  *
1294
1294
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/port)
1295
1295
  */
1296
1296
  port: string;
1297
1297
  /**
1298
- * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final `':'`.
1298
+ * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final ":".
1299
1299
  *
1300
1300
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/protocol)
1301
1301
  */
1302
1302
  protocol: string;
1303
1303
  /**
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.
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. If the URL does not have a search query, this property contains an empty string, "".
1305
1305
  *
1306
1306
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/search)
1307
1307
  */
@@ -1313,7 +1313,7 @@ interface URL {
1313
1313
  */
1314
1314
  readonly searchParams: URLSearchParams;
1315
1315
  /**
1316
- * The **`username`** property of the URL interface is a string containing the username component of the URL.
1316
+ * 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
1317
  *
1318
1318
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/username)
1319
1319
  */
@@ -1386,13 +1386,13 @@ interface URLSearchParams {
1386
1386
  */
1387
1387
  has(name: string, value?: string): boolean;
1388
1388
  /**
1389
- * The **`set()`** method of the URLSearchParams interface sets the value associated with a given search parameter to the given value.
1389
+ * 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
1390
  *
1391
1391
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/set)
1392
1392
  */
1393
1393
  set(name: string, value: string): void;
1394
1394
  /**
1395
- * The **`URLSearchParams.sort()`** method sorts all key/value pairs contained in this object in place and returns `undefined`.
1395
+ * 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
1396
  *
1397
1397
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/sort)
1398
1398
  */
@@ -1407,7 +1407,7 @@ declare var URLSearchParams: {
1407
1407
  };
1408
1408
 
1409
1409
  /**
1410
- * The **`WorkletGlobalScope`** interface is an abstract class that specific worklet scope classes inherit from.
1410
+ * The **`WorkletGlobalScope`** interface is an abstract class that specific worklet scope classes inherit from. Each WorkletGlobalScope defines a new global environment.
1411
1411
  * Available only in secure contexts.
1412
1412
  *
1413
1413
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkletGlobalScope)
@@ -1421,13 +1421,13 @@ declare var WorkletGlobalScope: {
1421
1421
  };
1422
1422
 
1423
1423
  /**
1424
- * The **`WritableStream`** interface of the Streams API provides a standard abstraction for writing streaming data to a destination, known as a sink.
1424
+ * 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
1425
  *
1426
1426
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream)
1427
1427
  */
1428
1428
  interface WritableStream<W = any> {
1429
1429
  /**
1430
- * The **`locked`** read-only property of the WritableStream interface returns a boolean indicating whether the `WritableStream` is locked to a writer.
1430
+ * The **`locked`** read-only property of the WritableStream interface returns a boolean indicating whether the WritableStream is locked to a writer.
1431
1431
  *
1432
1432
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/locked)
1433
1433
  */
@@ -1439,13 +1439,13 @@ interface WritableStream<W = any> {
1439
1439
  */
1440
1440
  abort(reason?: any): Promise<void>;
1441
1441
  /**
1442
- * The **`close()`** method of the WritableStream interface closes the associated stream.
1442
+ * 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
1443
  *
1444
1444
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/close)
1445
1445
  */
1446
1446
  close(): Promise<void>;
1447
1447
  /**
1448
- * The **`getWriter()`** method of the WritableStream interface returns a new instance of WritableStreamDefaultWriter and locks the stream to that instance.
1448
+ * 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
1449
  *
1450
1450
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/getWriter)
1451
1451
  */
@@ -1458,7 +1458,7 @@ declare var WritableStream: {
1458
1458
  };
1459
1459
 
1460
1460
  /**
1461
- * The **`WritableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a WritableStream's state.
1461
+ * 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
1462
  *
1463
1463
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController)
1464
1464
  */
@@ -1483,7 +1483,7 @@ declare var WritableStreamDefaultController: {
1483
1483
  };
1484
1484
 
1485
1485
  /**
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.
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.
1487
1487
  *
1488
1488
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter)
1489
1489
  */
@@ -1519,7 +1519,7 @@ interface WritableStreamDefaultWriter<W = any> {
1519
1519
  */
1520
1520
  close(): Promise<void>;
1521
1521
  /**
1522
- * The **`releaseLock()`** method of the WritableStreamDefaultWriter interface releases the writer's lock on the corresponding stream.
1522
+ * 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
1523
  *
1524
1524
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/releaseLock)
1525
1525
  */
@@ -1554,19 +1554,19 @@ declare namespace WebAssembly {
1554
1554
  */
1555
1555
  interface Exception {
1556
1556
  /**
1557
- * The read-only **`stack`** property of an object instance of type `WebAssembly.Exception` _may_ contain a stack trace.
1557
+ * The read-only **`stack`** property of an object instance of type WebAssembly.Exception may contain a stack trace.
1558
1558
  *
1559
1559
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/stack)
1560
1560
  */
1561
1561
  readonly stack: string | undefined;
1562
1562
  /**
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.
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.
1564
1564
  *
1565
1565
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/getArg)
1566
1566
  */
1567
1567
  getArg(index: number): any;
1568
1568
  /**
1569
- * The **`is()`** prototype method of the `Exception` object can be used to test if the `Exception` matches a given tag.
1569
+ * The **`is()`** prototype method of the Exception object can be used to test if the Exception matches a given tag.
1570
1570
  *
1571
1571
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/is)
1572
1572
  */
@@ -1579,7 +1579,7 @@ declare namespace WebAssembly {
1579
1579
  };
1580
1580
 
1581
1581
  /**
1582
- * A **`WebAssembly.Global`** object represents a global variable instance, accessible from both JavaScript and importable/exportable across one or more `WebAssembly.Module` instances.
1582
+ * 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
1583
  *
1584
1584
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Global)
1585
1585
  */
@@ -1594,13 +1594,13 @@ declare namespace WebAssembly {
1594
1594
  };
1595
1595
 
1596
1596
  /**
1597
- * A **`WebAssembly.Instance`** object is a stateful, executable instance of a `WebAssembly.Module`.
1597
+ * 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
1598
  *
1599
1599
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Instance)
1600
1600
  */
1601
1601
  interface Instance {
1602
1602
  /**
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.
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.
1604
1604
  *
1605
1605
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Instance/exports)
1606
1606
  */
@@ -1622,19 +1622,19 @@ declare namespace WebAssembly {
1622
1622
  };
1623
1623
 
1624
1624
  /**
1625
- * The **`WebAssembly.Memory`** object is a resizable ArrayBuffer or SharedArrayBuffer that holds raw bytes of memory accessed by a `WebAssembly.Instance`.
1625
+ * The **`WebAssembly.Memory`** object is a resizable ArrayBuffer or SharedArrayBuffer that holds raw bytes of memory accessed by a WebAssembly.Instance.
1626
1626
  *
1627
1627
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory)
1628
1628
  */
1629
1629
  interface Memory {
1630
1630
  /**
1631
- * The read-only **`buffer`** prototype property of the `WebAssembly.Memory` object returns the buffer contained in the memory.
1631
+ * 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
1632
  *
1633
1633
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory/buffer)
1634
1634
  */
1635
1635
  readonly buffer: ArrayBuffer;
1636
1636
  /**
1637
- * The **`grow()`** prototype method of the `WebAssembly.Memory` object increases the size of the memory instance by a specified number of WebAssembly pages.
1637
+ * The **`grow()`** prototype method of the WebAssembly.Memory object increases the size of the memory instance by a specified number of WebAssembly pages.
1638
1638
  *
1639
1639
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory/grow)
1640
1640
  */
@@ -1658,19 +1658,19 @@ declare namespace WebAssembly {
1658
1658
  prototype: Module;
1659
1659
  new(bytes: BufferSource, options?: WebAssemblyCompileOptions): Module;
1660
1660
  /**
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.
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.
1662
1662
  *
1663
1663
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Module/customSections_static)
1664
1664
  */
1665
1665
  customSections(moduleObject: Module, sectionName: string): ArrayBuffer[];
1666
1666
  /**
1667
- * The **`WebAssembly.Module.exports()`** static method returns an array containing descriptions of all the declared exports of the given `Module`.
1667
+ * The WebAssembly.**`Module.exports()`** static method returns an array containing descriptions of all the declared exports of the given Module.
1668
1668
  *
1669
1669
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Module/exports_static)
1670
1670
  */
1671
1671
  exports(moduleObject: Module): ModuleExportDescriptor[];
1672
1672
  /**
1673
- * The **`WebAssembly.Module.imports()`** static method returns an array containing descriptions of all the declared imports of the given `Module`.
1673
+ * The WebAssembly.**`Module.imports()`** static method returns an array containing descriptions of all the declared imports of the given Module.
1674
1674
  *
1675
1675
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Module/imports_static)
1676
1676
  */
@@ -1687,31 +1687,31 @@ declare namespace WebAssembly {
1687
1687
  };
1688
1688
 
1689
1689
  /**
1690
- * The **`WebAssembly.Table`** object is a JavaScript wrapper object — an array-like structure representing a WebAssembly table, which stores homogeneous references.
1690
+ * 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
1691
  *
1692
1692
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table)
1693
1693
  */
1694
1694
  interface Table {
1695
1695
  /**
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.
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.
1697
1697
  *
1698
1698
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/length)
1699
1699
  */
1700
1700
  readonly length: AddressValue;
1701
1701
  /**
1702
- * The **`get()`** prototype method of the `WebAssembly.Table()` object retrieves the element stored at a given index.
1702
+ * The **`get()`** prototype method of the WebAssembly.Table() object retrieves the element stored at a given index.
1703
1703
  *
1704
1704
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/get)
1705
1705
  */
1706
1706
  get(index: AddressValue): any;
1707
1707
  /**
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.
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.
1709
1709
  *
1710
1710
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/grow)
1711
1711
  */
1712
1712
  grow(delta: AddressValue, value?: any): AddressValue;
1713
1713
  /**
1714
- * The **`set()`** prototype method of the `WebAssembly.Table` object mutates a reference stored at a given index to a different value.
1714
+ * The **`set()`** prototype method of the WebAssembly.Table object mutates a reference stored at a given index to a different value.
1715
1715
  *
1716
1716
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/set)
1717
1717
  */
@@ -1724,7 +1724,7 @@ declare namespace WebAssembly {
1724
1724
  };
1725
1725
 
1726
1726
  /**
1727
- * The **`WebAssembly.Tag`** object defines a _type_ of a WebAssembly exception that can be thrown to/from WebAssembly code.
1727
+ * The **`WebAssembly.Tag`** object defines a type of a WebAssembly exception that can be thrown to/from WebAssembly code.
1728
1728
  *
1729
1729
  * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Tag)
1730
1730
  */
@@ -1822,7 +1822,7 @@ declare namespace WebAssembly {
1822
1822
  */
1823
1823
  interface Console {
1824
1824
  /**
1825
- * The **`console.assert()`** static method writes an error message to the console if the assertion is false.
1825
+ * 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
1826
  *
1827
1827
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/assert_static)
1828
1828
  */
@@ -1834,61 +1834,61 @@ interface Console {
1834
1834
  */
1835
1835
  clear(): void;
1836
1836
  /**
1837
- * The **`console.count()`** static method logs the number of times that this particular call to `count()` has been called.
1837
+ * The **`console.count()`** static method logs the number of times that this particular call to count() has been called.
1838
1838
  *
1839
1839
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/count_static)
1840
1840
  */
1841
1841
  count(label?: string): void;
1842
1842
  /**
1843
- * The **`console.countReset()`** static method resets counter used with console/count_static.
1843
+ * The **`console.countReset()`** static method resets counter used with console.count().
1844
1844
  *
1845
1845
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/countReset_static)
1846
1846
  */
1847
1847
  countReset(label?: string): void;
1848
1848
  /**
1849
- * The **`console.debug()`** static method outputs a message to the console at the 'debug' log level.
1849
+ * 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
1850
  *
1851
1851
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/debug_static)
1852
1852
  */
1853
1853
  debug(...data: any[]): void;
1854
1854
  /**
1855
- * The **`console.dir()`** static method displays a list of the properties of the specified JavaScript object.
1855
+ * 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
1856
  *
1857
1857
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/dir_static)
1858
1858
  */
1859
1859
  dir(item?: any, options?: any): void;
1860
1860
  /**
1861
- * The **`console.dirxml()`** static method displays an interactive tree of the descendant elements of the specified XML/HTML element.
1861
+ * 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
1862
  *
1863
1863
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/dirxml_static)
1864
1864
  */
1865
1865
  dirxml(...data: any[]): void;
1866
1866
  /**
1867
- * The **`console.error()`** static method outputs a message to the console at the 'error' log level.
1867
+ * 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
1868
  *
1869
1869
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/error_static)
1870
1870
  */
1871
1871
  error(...data: any[]): void;
1872
1872
  /**
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.
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() is called.
1874
1874
  *
1875
1875
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/group_static)
1876
1876
  */
1877
1877
  group(...data: any[]): void;
1878
1878
  /**
1879
- * The **`console.groupCollapsed()`** static method creates a new inline group in the console.
1879
+ * 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
1880
  *
1881
1881
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/groupCollapsed_static)
1882
1882
  */
1883
1883
  groupCollapsed(...data: any[]): void;
1884
1884
  /**
1885
- * The **`console.groupEnd()`** static method exits the current inline group in the console.
1885
+ * 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
1886
  *
1887
1887
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/groupEnd_static)
1888
1888
  */
1889
1889
  groupEnd(): void;
1890
1890
  /**
1891
- * The **`console.info()`** static method outputs a message to the console at the 'info' log level.
1891
+ * 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
1892
  *
1893
1893
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/info_static)
1894
1894
  */
@@ -1906,19 +1906,19 @@ interface Console {
1906
1906
  */
1907
1907
  table(tabularData?: any, properties?: string[]): void;
1908
1908
  /**
1909
- * The **`console.time()`** static method starts a timer you can use to track how long an operation takes.
1909
+ * 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
1910
  *
1911
1911
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/time_static)
1912
1912
  */
1913
1913
  time(label?: string): void;
1914
1914
  /**
1915
- * The **`console.timeEnd()`** static method stops a timer that was previously started by calling console/time_static.
1915
+ * The **`console.timeEnd()`** static method stops a timer that was previously started by calling console.time().
1916
1916
  *
1917
1917
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/timeEnd_static)
1918
1918
  */
1919
1919
  timeEnd(label?: string): void;
1920
1920
  /**
1921
- * The **`console.timeLog()`** static method logs the current value of a timer that was previously started by calling console/time_static.
1921
+ * The **`console.timeLog()`** static method logs the current value of a timer that was previously started by calling console.time().
1922
1922
  *
1923
1923
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/timeLog_static)
1924
1924
  */
@@ -1931,7 +1931,7 @@ interface Console {
1931
1931
  */
1932
1932
  trace(...data: any[]): void;
1933
1933
  /**
1934
- * The **`console.warn()`** static method outputs a warning message to the console at the 'warning' log level.
1934
+ * 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
1935
  *
1936
1936
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/warn_static)
1937
1937
  */
@@ -1989,13 +1989,13 @@ interface UnderlyingSourceStartCallback<R> {
1989
1989
  }
1990
1990
 
1991
1991
  /**
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.
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. It is incremented by 128 (the size of a render quantum) after the processing of each audio block.
1993
1993
  *
1994
1994
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/currentFrame)
1995
1995
  */
1996
1996
  declare var currentFrame: number;
1997
1997
  /**
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.
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. It is equal to the currentTime property of the BaseAudioContext the worklet belongs to.
1999
1999
  *
2000
2000
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/currentTime)
2001
2001
  */
@@ -2007,7 +2007,7 @@ declare var currentTime: number;
2007
2007
  */
2008
2008
  declare var sampleRate: number;
2009
2009
  /**
2010
- * The **`registerProcessor`** method of the AudioWorkletGlobalScope interface registers a class constructor derived from AudioWorkletProcessor interface under a specified _name_.
2010
+ * The **`registerProcessor`** method of the AudioWorkletGlobalScope interface registers a class constructor derived from AudioWorkletProcessor interface under a specified name.
2011
2011
  *
2012
2012
  * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/registerProcessor)
2013
2013
  */