diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index f31ed070e..78d2f611d 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -7,10 +7,6 @@ jobs: steps: - uses: actions/checkout@v4 - with: - submodules: true # Ensures submodules are cloned - - - uses: actions/setup-node@v5 with: node-version: "lts/*" diff --git a/.github/workflows/update-core-deps.yml b/.github/workflows/update-core-deps.yml index a2d79fe7b..e58e7d5b1 100644 --- a/.github/workflows/update-core-deps.yml +++ b/.github/workflows/update-core-deps.yml @@ -12,11 +12,7 @@ jobs: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - with: - submodules: true # Ensure submodules are checked out - - name: Update submodules - run: git submodule update --init --remote - uses: actions/setup-node@v5 with: node-version: "lts/*" @@ -31,6 +27,8 @@ jobs: # This prevents annoying change when contributors run `npm i` on their local machine. # Example: https://github.com/microsoft/TypeScript-DOM-lib-generator/pull/1463 - run: npm i + - name: Update MDN Data + run: node scripts/fetch-mdn.js - id: build run: npm run generate continue-on-error: true diff --git a/.gitmodules b/.gitmodules deleted file mode 100644 index d20ffa1da..000000000 --- a/.gitmodules +++ /dev/null @@ -1,3 +0,0 @@ -[submodule "inputfiles/mdn"] - path = inputfiles/mdn - url = https://github.com/mdn/content.git diff --git a/baselines/audioworklet.generated.d.ts b/baselines/audioworklet.generated.d.ts index 3f2caab45..9f5c74b44 100644 --- a/baselines/audioworklet.generated.d.ts +++ b/baselines/audioworklet.generated.d.ts @@ -194,7 +194,7 @@ interface AbortController { */ readonly signal: AbortSignal; /** - * The **`abort()`** method of the AbortController interface aborts an asynchronous operation before it has completed. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortController/abort) */ @@ -217,7 +217,7 @@ interface AbortSignalEventMap { */ interface AbortSignal extends EventTarget { /** - * 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`). + * 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). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/aborted) */ @@ -231,7 +231,7 @@ interface AbortSignal extends EventTarget { */ readonly reason: any; /** - * The **`throwIfAborted()`** method throws the signal's abort AbortSignal.reason if the signal has been aborted; otherwise it does nothing. + * The **`throwIfAborted()`** method throws the signal's abort reason if the signal has been aborted; otherwise it does nothing. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/throwIfAborted) */ @@ -246,13 +246,13 @@ declare var AbortSignal: { prototype: AbortSignal; new(): AbortSignal; /** - * The **`AbortSignal.abort()`** static method returns an AbortSignal that is already set as aborted (and which does not trigger an AbortSignal/abort_event event). + * The **`AbortSignal.abort()`** static method returns an AbortSignal that is already set as aborted (and which does not trigger an abort event). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/abort_static) */ abort(reason?: any): AbortSignal; /** - * The **`AbortSignal.any()`** static method takes an iterable of abort signals and returns an AbortSignal. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/any_static) */ @@ -266,13 +266,13 @@ declare var AbortSignal: { */ interface AudioWorkletGlobalScope extends WorkletGlobalScope { /** - * 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. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/currentFrame) */ readonly currentFrame: number; /** - * 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. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/currentTime) */ @@ -284,7 +284,7 @@ interface AudioWorkletGlobalScope extends WorkletGlobalScope { */ readonly sampleRate: number; /** - * The **`registerProcessor`** method of the AudioWorkletGlobalScope interface registers a class constructor derived from AudioWorkletProcessor interface under a specified _name_. + * The **`registerProcessor`** method of the AudioWorkletGlobalScope interface registers a class constructor derived from AudioWorkletProcessor interface under a specified name. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/registerProcessor) */ @@ -297,13 +297,13 @@ declare var AudioWorkletGlobalScope: { }; /** - * The **`AudioWorkletProcessor`** interface of the Web Audio API represents an audio processing code behind a custom AudioWorkletNode. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletProcessor) */ interface AudioWorkletProcessor { /** - * The read-only **`port`** property of the AudioWorkletProcessor interface returns the associated MessagePort. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletProcessor/port) */ @@ -389,7 +389,7 @@ interface CustomEvent extends Event { */ readonly detail: T; /** - * The **`CustomEvent.initCustomEvent()`** method initializes a CustomEvent object. + * The **`CustomEvent.initCustomEvent()`** method initializes a CustomEvent object. If the event has already been dispatched, this method does nothing. * @deprecated * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomEvent/initCustomEvent) @@ -403,13 +403,13 @@ declare var CustomEvent: { }; /** - * 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. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException) */ interface DOMException extends Error { /** - * The **`code`** read-only property of the DOMException interface returns one of the legacy error code constants, or `0` if none match. + * The **`code`** read-only property of the DOMException interface returns one of the legacy error code constants, or 0 if none match. * @deprecated * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/code) @@ -543,7 +543,7 @@ declare var ErrorEvent: { }; /** - * The **`Event`** interface represents an event which takes place on an `EventTarget`. + * The **`Event`** interface represents an event which takes place on an EventTarget. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event) */ @@ -555,7 +555,7 @@ interface Event { */ readonly bubbles: boolean; /** - * The **`cancelBubble`** property of the Event interface is deprecated. + * 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. * @deprecated * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/cancelBubble) @@ -592,7 +592,7 @@ interface Event { */ readonly eventPhase: number; /** - * 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 **`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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/isTrusted) */ @@ -605,14 +605,14 @@ interface Event { */ returnValue: boolean; /** - * The deprecated **`Event.srcElement`** is an alias for the Event.target property. + * The deprecated **`Event.srcElement`** is an alias for the Event.target property. Use Event.target instead. * @deprecated * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/srcElement) */ readonly srcElement: EventTarget | null; /** - * The read-only **`target`** property of the Event interface is a reference to the object onto which the event was dispatched. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/target) */ @@ -624,13 +624,13 @@ interface Event { */ readonly timeStamp: DOMHighResTimeStamp; /** - * The **`type`** read-only property of the Event interface returns a string containing the event's type. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/type) */ readonly type: string; /** - * 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. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/composedPath) */ @@ -655,7 +655,7 @@ interface Event { */ stopImmediatePropagation(): void; /** - * The **`stopPropagation()`** method of the Event interface prevents further propagation of the current event in the capturing and bubbling phases. + * 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(). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/stopPropagation) */ @@ -684,7 +684,7 @@ interface EventListenerObject { } /** - * The **`EventTarget`** interface is implemented by objects that can receive events and may have listeners for them. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget) */ @@ -696,13 +696,13 @@ interface EventTarget { */ addEventListener(type: string, callback: EventListenerOrEventListenerObject | null, options?: AddEventListenerOptions | boolean): void; /** - * The **`dispatchEvent()`** method of the EventTarget sends an Event to the object, (synchronously) invoking the affected event listeners in the appropriate order. + * 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(). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/dispatchEvent) */ dispatchEvent(event: Event): boolean; /** - * The **`removeEventListener()`** method of the EventTarget interface removes an event listener previously registered with EventTarget.addEventListener() from the target. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventTarget/removeEventListener) */ @@ -752,7 +752,7 @@ interface MessageEvent extends Event { */ readonly ports: ReadonlyArray; /** - * 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. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/source) */ @@ -794,7 +794,7 @@ interface MessagePortEventMap extends MessageEventTargetEventMap { */ interface MessagePort extends EventTarget, MessageEventTarget { /** - * The **`close()`** method of the MessagePort interface disconnects the port, so it is no longer active. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/close) */ @@ -807,7 +807,7 @@ interface MessagePort extends EventTarget, MessageEventTarget { postMessage(message: any, transfer: Transferable[]): void; postMessage(message: any, options?: StructuredSerializeOptions): void; /** - * The **`start()`** method of the MessagePort interface starts the sending of messages queued on the port. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/start) */ @@ -824,19 +824,19 @@ declare var MessagePort: { }; /** - * The **`PromiseRejectionEvent`** interface represents events which are sent to the global script context when JavaScript Promises are rejected. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent) */ interface PromiseRejectionEvent extends Event { /** - * The PromiseRejectionEvent interface's **`promise`** read-only property indicates the JavaScript Promise which was rejected. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/promise) */ readonly promise: Promise; /** - * The PromiseRejectionEvent **`reason`** read-only property is any JavaScript value or Object which provides the reason passed into Promise.reject(). + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/reason) */ @@ -849,13 +849,13 @@ declare var PromiseRejectionEvent: { }; /** - * The **`ReadableByteStreamController`** interface of the Streams API represents a controller for a readable byte stream. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController) */ interface ReadableByteStreamController { /** - * The **`byobRequest`** read-only property of the ReadableByteStreamController interface returns the current BYOB request, or `null` if there are no pending requests. + * The **`byobRequest`** read-only property of the ReadableByteStreamController interface returns the current BYOB request, or null if there are no pending requests. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableByteStreamController/byobRequest) */ @@ -892,7 +892,7 @@ declare var ReadableByteStreamController: { }; /** - * The `ReadableStream` interface of the Streams API represents a readable stream of byte data. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream) */ @@ -910,7 +910,7 @@ interface ReadableStream { */ cancel(reason?: any): Promise; /** - * The **`getReader()`** method of the ReadableStream interface creates a reader and locks the stream to it. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/getReader) */ @@ -924,7 +924,7 @@ interface ReadableStream { */ pipeThrough(transform: ReadableWritablePair, options?: StreamPipeOptions): ReadableStream; /** - * 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. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/pipeTo) */ @@ -945,19 +945,19 @@ declare var ReadableStream: { }; /** - * The `ReadableStreamBYOBReader` interface of the Streams API defines a reader for a ReadableStream that supports zero-copy reading from an underlying byte source. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader) */ interface ReadableStreamBYOBReader extends ReadableStreamGenericReader { /** - * 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. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/read) */ read(view: T): Promise>; /** - * The **`releaseLock()`** method of the ReadableStreamBYOBReader interface releases the reader's lock on the stream. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamBYOBReader/releaseLock) */ @@ -1001,7 +1001,7 @@ declare var ReadableStreamBYOBRequest: { }; /** - * The **`ReadableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a ReadableStream's state and internal queue. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController) */ @@ -1070,7 +1070,7 @@ interface ReadableStreamGenericReader { } /** - * The **`TextDecoder`** interface represents a decoder for a specific text encoding, such as `UTF-8`, `ISO-8859-2`, or `GBK`. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoder) */ @@ -1110,7 +1110,7 @@ interface TextDecoderCommon { } /** - * 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. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextDecoderStream) */ @@ -1125,19 +1125,19 @@ declare var TextDecoderStream: { }; /** - * The **`TextEncoder`** interface enables you to character encoding a JavaScript string using UTF-8. + * The **`TextEncoder`** interface enables you to encode a JavaScript string using UTF-8. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder) */ interface TextEncoder extends TextEncoderCommon { /** - * The **`TextEncoder.encode()`** method takes a string as input, and returns a Global_Objects/Uint8Array containing the string character encoding using UTF-8. + * The **`TextEncoder.encode()`** method takes a string as input, and returns a Uint8Array containing the string encoded using UTF-8. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encode) */ encode(input?: string): Uint8Array; /** - * 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. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoder/encodeInto) */ @@ -1159,7 +1159,7 @@ interface TextEncoderCommon { } /** - * The **`TextEncoderStream`** interface of the Encoding API converts a stream of strings into bytes in the UTF-8 encoding. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TextEncoderStream) */ @@ -1174,19 +1174,19 @@ declare var TextEncoderStream: { }; /** - * The **`TransformStream`** interface of the Streams API represents a concrete implementation of the pipe chain _transform stream_ concept. + * The **`TransformStream`** interface of the Streams API represents a concrete implementation of the pipe chain transform stream concept. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream) */ interface TransformStream { /** - * The **`readable`** read-only property of the TransformStream interface returns the ReadableStream instance controlled by this `TransformStream`. + * The **`readable`** read-only property of the TransformStream interface returns the ReadableStream instance controlled by this TransformStream. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/readable) */ readonly readable: ReadableStream; /** - * The **`writable`** read-only property of the TransformStream interface returns the WritableStream instance controlled by this `TransformStream`. + * The **`writable`** read-only property of the TransformStream interface returns the WritableStream instance controlled by this TransformStream. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStream/writable) */ @@ -1217,7 +1217,7 @@ interface TransformStreamDefaultController { */ enqueue(chunk?: O): void; /** - * The **`error()`** method of the TransformStreamDefaultController interface errors both sides of the stream. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/TransformStreamDefaultController/error) */ @@ -1236,25 +1236,25 @@ declare var TransformStreamDefaultController: { }; /** - * The **`URL`** interface is used to parse, construct, normalize, and encode URL. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL) */ interface URL { /** - * The **`hash`** property of the URL interface is a string containing a `'#'` followed by the fragment identifier of the URL. + * 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, ''. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hash) */ hash: string; /** - * 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. + * 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, ''. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/host) */ host: string; /** - * The **`hostname`** property of the URL interface is a string containing either the domain name or IP address of the URL. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/hostname) */ @@ -1273,31 +1273,31 @@ interface URL { */ readonly origin: string; /** - * The **`password`** property of the URL interface is a string containing the password component of the URL. + * 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, ''. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/password) */ password: string; /** - * The **`pathname`** property of the URL interface represents a location in a hierarchical structure. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/pathname) */ pathname: string; /** - * The **`port`** property of the URL interface is a string containing the port number of the URL. + * 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, ''. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/port) */ port: string; /** - * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final `':'`. + * The **`protocol`** property of the URL interface is a string containing the protocol or scheme of the URL, including the final ':'. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/protocol) */ protocol: string; /** - * 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. + * 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, ''. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/search) */ @@ -1309,7 +1309,7 @@ interface URL { */ readonly searchParams: URLSearchParams; /** - * The **`username`** property of the URL interface is a string containing the username component of the URL. + * 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, ''. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/username) */ @@ -1382,13 +1382,13 @@ interface URLSearchParams { */ has(name: string, value?: string): boolean; /** - * The **`set()`** method of the URLSearchParams interface sets the value associated with a given search parameter to the given value. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/set) */ set(name: string, value: string): void; /** - * The **`URLSearchParams.sort()`** method sorts all key/value pairs contained in this object in place and returns `undefined`. + * 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). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URLSearchParams/sort) */ @@ -1403,7 +1403,7 @@ declare var URLSearchParams: { }; /** - * The **`WorkletGlobalScope`** interface is an abstract class that specific worklet scope classes inherit from. + * The **`WorkletGlobalScope`** interface is an abstract class that specific worklet scope classes inherit from. Each WorkletGlobalScope defines a new global environment. * Available only in secure contexts. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WorkletGlobalScope) @@ -1417,13 +1417,13 @@ declare var WorkletGlobalScope: { }; /** - * The **`WritableStream`** interface of the Streams API provides a standard abstraction for writing streaming data to a destination, known as a sink. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream) */ interface WritableStream { /** - * The **`locked`** read-only property of the WritableStream interface returns a boolean indicating whether the `WritableStream` is locked to a writer. + * The **`locked`** read-only property of the WritableStream interface returns a boolean indicating whether the WritableStream is locked to a writer. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/locked) */ @@ -1435,13 +1435,13 @@ interface WritableStream { */ abort(reason?: any): Promise; /** - * The **`close()`** method of the WritableStream interface closes the associated stream. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/close) */ close(): Promise; /** - * The **`getWriter()`** method of the WritableStream interface returns a new instance of WritableStreamDefaultWriter and locks the stream to that instance. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStream/getWriter) */ @@ -1454,7 +1454,7 @@ declare var WritableStream: { }; /** - * The **`WritableStreamDefaultController`** interface of the Streams API represents a controller allowing control of a WritableStream's state. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController) */ @@ -1479,7 +1479,7 @@ declare var WritableStreamDefaultController: { }; /** - * 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. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter) */ @@ -1515,7 +1515,7 @@ interface WritableStreamDefaultWriter { */ close(): Promise; /** - * The **`releaseLock()`** method of the WritableStreamDefaultWriter interface releases the writer's lock on the corresponding stream. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/releaseLock) */ @@ -1550,19 +1550,19 @@ declare namespace WebAssembly { */ interface Exception { /** - * The read-only **`stack`** property of an object instance of type `WebAssembly.Exception` _may_ contain a stack trace. + * The read-only **`stack`** property of an object instance of type WebAssembly.Exception may contain a stack trace. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/stack) */ readonly stack: string | undefined; /** - * 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. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/getArg) */ getArg(index: number): any; /** - * The **`is()`** prototype method of the `Exception` object can be used to test if the `Exception` matches a given tag. + * The **`is()`** prototype method of the Exception object can be used to test if the Exception matches a given tag. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Exception/is) */ @@ -1575,7 +1575,7 @@ declare namespace WebAssembly { }; /** - * A **`WebAssembly.Global`** object represents a global variable instance, accessible from both JavaScript and importable/exportable across one or more `WebAssembly.Module` instances. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Global) */ @@ -1590,13 +1590,13 @@ declare namespace WebAssembly { }; /** - * A **`WebAssembly.Instance`** object is a stateful, executable instance of a `WebAssembly.Module`. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Instance) */ interface Instance { /** - * 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. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Instance/exports) */ @@ -1618,19 +1618,19 @@ declare namespace WebAssembly { }; /** - * The **`WebAssembly.Memory`** object is a resizable ArrayBuffer or SharedArrayBuffer that holds raw bytes of memory accessed by a `WebAssembly.Instance`. + * The **`WebAssembly.Memory`** object is a resizable ArrayBuffer or SharedArrayBuffer that holds raw bytes of memory accessed by a WebAssembly.Instance. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory) */ interface Memory { /** - * The read-only **`buffer`** prototype property of the `WebAssembly.Memory` object returns the buffer contained in the memory. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory/buffer) */ readonly buffer: ArrayBuffer; /** - * The **`grow()`** prototype method of the `WebAssembly.Memory` object increases the size of the memory instance by a specified number of WebAssembly pages. + * The **`grow()`** prototype method of the WebAssembly.Memory object increases the size of the memory instance by a specified number of WebAssembly pages. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Memory/grow) */ @@ -1654,19 +1654,19 @@ declare namespace WebAssembly { prototype: Module; new(bytes: BufferSource, options?: WebAssemblyCompileOptions): Module; /** - * 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. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Module/customSections_static) */ customSections(moduleObject: Module, sectionName: string): ArrayBuffer[]; /** - * The **`WebAssembly.Module.exports()`** static method returns an array containing descriptions of all the declared exports of the given `Module`. + * The WebAssembly.**`Module.exports()`** static method returns an array containing descriptions of all the declared exports of the given Module. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Module/exports_static) */ exports(moduleObject: Module): ModuleExportDescriptor[]; /** - * The **`WebAssembly.Module.imports()`** static method returns an array containing descriptions of all the declared imports of the given `Module`. + * The WebAssembly.**`Module.imports()`** static method returns an array containing descriptions of all the declared imports of the given Module. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Module/imports_static) */ @@ -1683,31 +1683,31 @@ declare namespace WebAssembly { }; /** - * The **`WebAssembly.Table`** object is a JavaScript wrapper object — an array-like structure representing a WebAssembly table, which stores homogeneous references. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table) */ interface Table { /** - * 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. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/length) */ readonly length: AddressValue; /** - * The **`get()`** prototype method of the `WebAssembly.Table()` object retrieves the element stored at a given index. + * The **`get()`** prototype method of the WebAssembly.Table() object retrieves the element stored at a given index. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/get) */ get(index: AddressValue): any; /** - * 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. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/grow) */ grow(delta: AddressValue, value?: any): AddressValue; /** - * The **`set()`** prototype method of the `WebAssembly.Table` object mutates a reference stored at a given index to a different value. + * The **`set()`** prototype method of the WebAssembly.Table object mutates a reference stored at a given index to a different value. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Table/set) */ @@ -1720,7 +1720,7 @@ declare namespace WebAssembly { }; /** - * The **`WebAssembly.Tag`** object defines a _type_ of a WebAssembly exception that can be thrown to/from WebAssembly code. + * The **`WebAssembly.Tag`** object defines a type of a WebAssembly exception that can be thrown to/from WebAssembly code. * * [MDN Reference](https://developer.mozilla.org/docs/WebAssembly/Reference/JavaScript_interface/Tag) */ @@ -1818,7 +1818,7 @@ declare namespace WebAssembly { */ interface Console { /** - * The **`console.assert()`** static method writes an error message to the console if the assertion is false. + * The **`console.assert()`** static method writes an error message to the console if the assertion is false. If the assertion is true, nothing happens. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/assert_static) */ @@ -1830,61 +1830,61 @@ interface Console { */ clear(): void; /** - * The **`console.count()`** static method logs the number of times that this particular call to `count()` has been called. + * The **`console.count()`** static method logs the number of times that this particular call to count() has been called. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/count_static) */ count(label?: string): void; /** - * The **`console.countReset()`** static method resets counter used with console/count_static. + * The **`console.countReset()`** static method resets counter used with console.count(). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/countReset_static) */ countReset(label?: string): void; /** - * The **`console.debug()`** static method outputs a message to the console at the 'debug' log level. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/debug_static) */ debug(...data: any[]): void; /** - * The **`console.dir()`** static method displays a list of the properties of the specified JavaScript object. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/dir_static) */ dir(item?: any, options?: any): void; /** - * The **`console.dirxml()`** static method displays an interactive tree of the descendant elements of the specified XML/HTML element. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/dirxml_static) */ dirxml(...data: any[]): void; /** - * The **`console.error()`** static method outputs a message to the console at the 'error' log level. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/error_static) */ error(...data: any[]): void; /** - * 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. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/group_static) */ group(...data: any[]): void; /** - * The **`console.groupCollapsed()`** static method creates a new inline group in the console. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/groupCollapsed_static) */ groupCollapsed(...data: any[]): void; /** - * The **`console.groupEnd()`** static method exits the current inline group in the console. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/groupEnd_static) */ groupEnd(): void; /** - * The **`console.info()`** static method outputs a message to the console at the 'info' log level. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/info_static) */ @@ -1902,19 +1902,19 @@ interface Console { */ table(tabularData?: any, properties?: string[]): void; /** - * The **`console.time()`** static method starts a timer you can use to track how long an operation takes. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/time_static) */ time(label?: string): void; /** - * The **`console.timeEnd()`** static method stops a timer that was previously started by calling console/time_static. + * The **`console.timeEnd()`** static method stops a timer that was previously started by calling console.time(). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/timeEnd_static) */ timeEnd(label?: string): void; /** - * The **`console.timeLog()`** static method logs the current value of a timer that was previously started by calling console/time_static. + * The **`console.timeLog()`** static method logs the current value of a timer that was previously started by calling console.time(). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/timeLog_static) */ @@ -1927,7 +1927,7 @@ interface Console { */ trace(...data: any[]): void; /** - * The **`console.warn()`** static method outputs a warning message to the console at the 'warning' log level. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/console/warn_static) */ @@ -1985,13 +1985,13 @@ interface UnderlyingSourceStartCallback { } /** - * 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. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/currentFrame) */ declare var currentFrame: number; /** - * 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. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/currentTime) */ @@ -2003,7 +2003,7 @@ declare var currentTime: number; */ declare var sampleRate: number; /** - * The **`registerProcessor`** method of the AudioWorkletGlobalScope interface registers a class constructor derived from AudioWorkletProcessor interface under a specified _name_. + * The **`registerProcessor`** method of the AudioWorkletGlobalScope interface registers a class constructor derived from AudioWorkletProcessor interface under a specified name. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletGlobalScope/registerProcessor) */ diff --git a/baselines/dom.generated.d.ts b/baselines/dom.generated.d.ts index 9b6c7a2bc..a236530fd 100644 --- a/baselines/dom.generated.d.ts +++ b/baselines/dom.generated.d.ts @@ -2681,19 +2681,19 @@ type XPathNSResolver = ((prefix: string | null) => string | null) | { lookupName */ interface ANGLE_instanced_arrays { /** - * The **`ANGLE_instanced_arrays.drawArraysInstancedANGLE()`** method of the WebGL API renders primitives from array data like the WebGLRenderingContext.drawArrays() method. + * The **`ANGLE_instanced_arrays.drawArraysInstancedANGLE()`** method of the WebGL API renders primitives from array data like the gl.drawArrays() method. In addition, it can execute multiple instances of the range of elements. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ANGLE_instanced_arrays/drawArraysInstancedANGLE) */ drawArraysInstancedANGLE(mode: GLenum, first: GLint, count: GLsizei, primcount: GLsizei): void; /** - * The **`ANGLE_instanced_arrays.drawElementsInstancedANGLE()`** method of the WebGL API renders primitives from array data like the WebGLRenderingContext.drawElements() method. + * The **`ANGLE_instanced_arrays.drawElementsInstancedANGLE()`** method of the WebGL API renders primitives from array data like the gl.drawElements() method. In addition, it can execute multiple instances of a set of elements. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ANGLE_instanced_arrays/drawElementsInstancedANGLE) */ drawElementsInstancedANGLE(mode: GLenum, count: GLsizei, type: GLenum, offset: GLintptr, primcount: GLsizei): void; /** - * The **ANGLE_instanced_arrays.vertexAttribDivisorANGLE()** method of the WebGL API modifies the rate at which generic vertex attributes advance when rendering multiple instances of primitives with ANGLE_instanced_arrays.drawArraysInstancedANGLE() and ANGLE_instanced_arrays.drawElementsInstancedANGLE(). + * The **`ANGLE_instanced_arrays.vertexAttribDivisorANGLE()`** method of the WebGL API modifies the rate at which generic vertex attributes advance when rendering multiple instances of primitives with ext.drawArraysInstancedANGLE() and ext.drawElementsInstancedANGLE(). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ANGLE_instanced_arrays/vertexAttribDivisorANGLE) */ @@ -2821,7 +2821,7 @@ interface AbortController { */ readonly signal: AbortSignal; /** - * The **`abort()`** method of the AbortController interface aborts an asynchronous operation before it has completed. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortController/abort) */ @@ -2844,7 +2844,7 @@ interface AbortSignalEventMap { */ interface AbortSignal extends EventTarget { /** - * 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`). + * 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). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/aborted) */ @@ -2858,7 +2858,7 @@ interface AbortSignal extends EventTarget { */ readonly reason: any; /** - * The **`throwIfAborted()`** method throws the signal's abort AbortSignal.reason if the signal has been aborted; otherwise it does nothing. + * The **`throwIfAborted()`** method throws the signal's abort reason if the signal has been aborted; otherwise it does nothing. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/throwIfAborted) */ @@ -2873,13 +2873,13 @@ declare var AbortSignal: { prototype: AbortSignal; new(): AbortSignal; /** - * The **`AbortSignal.abort()`** static method returns an AbortSignal that is already set as aborted (and which does not trigger an AbortSignal/abort_event event). + * The **`AbortSignal.abort()`** static method returns an AbortSignal that is already set as aborted (and which does not trigger an abort event). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/abort_static) */ abort(reason?: any): AbortSignal; /** - * The **`AbortSignal.any()`** static method takes an iterable of abort signals and returns an AbortSignal. + * 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. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbortSignal/any_static) */ @@ -2893,13 +2893,13 @@ declare var AbortSignal: { }; /** - * The **`AbstractRange`** abstract interface is the base class upon which all DOM range types are defined. + * The **`AbstractRange`** abstract interface is the base class upon which all DOM range types are defined. A range is an object that indicates the start and end points of a section of content within the document. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbstractRange) */ interface AbstractRange { /** - * The read-only **`collapsed`** property of the AbstractRange interface returns `true` if the range's start position and end position are the same. + * The read-only **`collapsed`** property of the AbstractRange interface returns true if the range's start position and end position are the same. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AbstractRange/collapsed) */ @@ -2949,7 +2949,7 @@ interface AbstractWorker { } /** - * The **`AnalyserNode`** interface represents a node able to provide real-time frequency and time-domain analysis information. + * The **`AnalyserNode`** interface represents a node able to provide real-time frequency and time-domain analysis information. It is an AudioNode that passes the audio stream unchanged from the input to the output, but allows you to take the generated data, process it, and create audio visualizations. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnalyserNode) */ @@ -2961,25 +2961,25 @@ interface AnalyserNode extends AudioNode { */ fftSize: number; /** - * The **`frequencyBinCount`** read-only property of the AnalyserNode interface contains the total number of data points available to AudioContext BaseAudioContext.sampleRate. + * The **`frequencyBinCount`** read-only property of the AnalyserNode interface contains the total number of data points available to AudioContext sampleRate. This is half of the value of the AnalyserNode.fftSize. The two methods' indices have a linear relationship with the frequencies they represent, between 0 and the Nyquist frequency. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnalyserNode/frequencyBinCount) */ readonly frequencyBinCount: number; /** - * The **`maxDecibels`** property of the AnalyserNode interface is a double value representing the maximum power value in the scaling range for the FFT analysis data, for conversion to unsigned byte values — basically, this specifies the maximum value for the range of results when using `getByteFrequencyData()`. + * The **`maxDecibels`** property of the AnalyserNode interface is a double value representing the maximum power value in the scaling range for the FFT analysis data, for conversion to unsigned byte values — basically, this specifies the maximum value for the range of results when using getByteFrequencyData(). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnalyserNode/maxDecibels) */ maxDecibels: number; /** - * The **`minDecibels`** property of the AnalyserNode interface is a double value representing the minimum power value in the scaling range for the FFT analysis data, for conversion to unsigned byte values — basically, this specifies the minimum value for the range of results when using `getByteFrequencyData()`. + * The **`minDecibels`** property of the AnalyserNode interface is a double value representing the minimum power value in the scaling range for the FFT analysis data, for conversion to unsigned byte values — basically, this specifies the minimum value for the range of results when using getByteFrequencyData(). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnalyserNode/minDecibels) */ minDecibels: number; /** - * The **`smoothingTimeConstant`** property of the AnalyserNode interface is a double value representing the averaging constant with the last analysis frame. + * The **`smoothingTimeConstant`** property of the AnalyserNode interface is a double value representing the averaging constant with the last analysis frame. It's basically an average between the current buffer and the last buffer the AnalyserNode processed, and results in a much smoother set of value changes over time. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnalyserNode/smoothingTimeConstant) */ @@ -3003,7 +3003,7 @@ interface AnalyserNode extends AudioNode { */ getFloatFrequencyData(array: Float32Array): void; /** - * The **`getFloatTimeDomainData()`** method of the AnalyserNode Interface copies the current waveform, or time-domain, data into a Float32Array array passed into it. + * The **`getFloatTimeDomainData()`** method of the AnalyserNode Interface copies the current waveform, or time-domain, data into a Float32Array array passed into it. Each array value is a sample, the magnitude of the signal at a particular time. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnalyserNode/getFloatTimeDomainData) */ @@ -3041,7 +3041,7 @@ interface Animation extends EventTarget { */ currentTime: CSSNumberish | null; /** - * The **`Animation.effect`** property of the Web Animations API gets and sets the target effect of an animation. + * The **`Animation.effect`** property of the Web Animations API gets and sets the target effect of an animation. The target effect may be either an effect object of a type based on AnimationEffect, such as KeyframeEffect, or null. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Animation/effect) */ @@ -3065,7 +3065,7 @@ interface Animation extends EventTarget { /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Animation/remove_event) */ onremove: ((this: Animation, ev: AnimationPlaybackEvent) => any) | null; /** - * The **`overallProgress`** read-only property of the Animation interface returns a number between `0` and `1` indicating the animation's overall progress towards its finished state. + * The **`overallProgress`** read-only property of the Animation interface returns a number between 0 and 1 indicating the animation's overall progress towards its finished state. This is the overall progress across all of the animation's iterations, not each individual iteration. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Animation/overallProgress) */ @@ -3089,7 +3089,7 @@ interface Animation extends EventTarget { */ playbackRate: number; /** - * The read-only **`Animation.ready`** property of the Web Animations API returns a Promise which resolves when the animation is ready to play. + * The read-only **`Animation.ready`** property of the Web Animations API returns a Promise which resolves when the animation is ready to play. A new promise is created every time the animation enters the 'pending' play state as well as when the animation is canceled, since in both of those scenarios, the animation is ready to be started again. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Animation/ready) */ @@ -3107,7 +3107,7 @@ interface Animation extends EventTarget { */ startTime: CSSNumberish | null; /** - * The **`Animation.timeline`** property of the Animation interface returns or sets the AnimationTimeline associated with this animation. + * The **`Animation.timeline`** property of the Animation interface returns or sets the timeline associated with this animation. A timeline is a source of time values for synchronization purposes, and is an AnimationTimeline-based object. By default, the animation's timeline and the Document's timeline are the same. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Animation/timeline) */ @@ -3119,7 +3119,7 @@ interface Animation extends EventTarget { */ cancel(): void; /** - * The `commitStyles()` method of the Web Animations API's Animation interface writes the computed values of the animation's current styles into its target element's `style` attribute. + * The **`commitStyles()`** method of the Web Animations API's Animation interface writes the computed values of the animation's current styles into its target element's style attribute. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Animation/commitStyles) */ @@ -3137,19 +3137,19 @@ interface Animation extends EventTarget { */ pause(): void; /** - * The `persist()` method of the Web Animations API's Animation interface explicitly persists an animation, preventing it from being automatically removed when it is replaced by another animation. + * The **`persist()`** method of the Web Animations API's Animation interface explicitly persists an animation, preventing it from being automatically removed when it is replaced by another animation. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Animation/persist) */ persist(): void; /** - * The **`play()`** method of the Web Animations API's Animation Interface starts or resumes playing of an animation. + * The **`play()`** method of the Web Animations API's Animation Interface starts or resumes playing of an animation. If the animation is finished, calling play() restarts the animation, playing it from the beginning. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Animation/play) */ play(): void; /** - * The **`Animation.reverse()`** method of the Animation Interface reverses the playback direction, meaning the animation ends at its beginning. + * The **`Animation.reverse()`** method of the Animation Interface reverses the playback direction, meaning the animation ends at its beginning. If called on an unplayed animation, the whole animation is played backwards. If called on a paused animation, the animation will continue in reverse. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Animation/reverse) */ @@ -3172,25 +3172,25 @@ declare var Animation: { }; /** - * The `AnimationEffect` interface of the Web Animations API is an interface representing animation effects. + * The **`AnimationEffect`** interface of the Web Animations API is an interface representing animation effects. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnimationEffect) */ interface AnimationEffect { /** - * The `getComputedTiming()` method of the AnimationEffect interface returns the calculated timing properties for this animation effect. + * The **`getComputedTiming()`** method of the AnimationEffect interface returns the calculated timing properties for this animation effect. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnimationEffect/getComputedTiming) */ getComputedTiming(): ComputedEffectTiming; /** - * The `AnimationEffect.getTiming()` method of the AnimationEffect interface returns an object containing the timing properties for the Animation Effect. + * The **`AnimationEffect.getTiming()`** method of the AnimationEffect interface returns an object containing the timing properties for the Animation Effect. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnimationEffect/getTiming) */ getTiming(): EffectTiming; /** - * The `updateTiming()` method of the AnimationEffect interface updates the specified timing properties for an animation effect. + * The **`updateTiming()`** method of the AnimationEffect interface updates the specified timing properties for an animation effect. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnimationEffect/updateTiming) */ @@ -3215,13 +3215,13 @@ interface AnimationEvent extends Event { */ readonly animationName: string; /** - * The **`AnimationEvent.elapsedTime`** read-only property is a `float` giving the amount of time the animation has been running, in seconds, when this event fired, excluding any time the animation was paused. + * The **`AnimationEvent.elapsedTime`** read-only property is a float giving the amount of time the animation has been running, in seconds, when this event fired, excluding any time the animation was paused. For an animationstart event, elapsedTime is 0.0 unless there was a negative value for animation-delay, in which case the event will be fired with elapsedTime containing (-1 * delay). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnimationEvent/elapsedTime) */ readonly elapsedTime: number; /** - * The **`AnimationEvent.pseudoElement`** read-only property is a string, starting with `'::'`, containing the name of the pseudo-element the animation runs on. + * The **`AnimationEvent.pseudoElement`** read-only property is a string, starting with '::', containing the name of the pseudo-element the animation runs on. If the animation doesn't run on a pseudo-element but on the element, an empty string: ''. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnimationEvent/pseudoElement) */ @@ -3241,19 +3241,19 @@ interface AnimationFrameProvider { } /** - * The AnimationPlaybackEvent interface of the Web Animations API represents animation events. + * The **`AnimationPlaybackEvent`** interface of the Web Animations API represents animation events. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnimationPlaybackEvent) */ interface AnimationPlaybackEvent extends Event { /** - * The **`currentTime`** read-only property of the AnimationPlaybackEvent interface represents the current time of the animation that generated the event at the moment the event is queued. + * The **`currentTime`** read-only property of the AnimationPlaybackEvent interface represents the current time of the animation that generated the event at the moment the event is queued. This will be unresolved if the animation was idle at the time the event was generated. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnimationPlaybackEvent/currentTime) */ readonly currentTime: CSSNumberish | null; /** - * The **`timelineTime`** read-only property of the AnimationPlaybackEvent interface represents the time value of the animation's AnimationTimeline at the moment the event is queued. + * The **`timelineTime`** read-only property of the AnimationPlaybackEvent interface represents the time value of the animation's timeline at the moment the event is queued. This will be unresolved if the animation was not associated with a timeline at the time the event was generated or if the associated timeline was inactive. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnimationPlaybackEvent/timelineTime) */ @@ -3266,18 +3266,22 @@ declare var AnimationPlaybackEvent: { }; /** - * The `AnimationTimeline` interface of the Web Animations API represents the timeline of an animation. + * The **`AnimationTimeline`** interface of the Web Animations API represents the timeline of an animation. This interface exists to define timeline features, inherited by other timeline types: * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnimationTimeline) */ interface AnimationTimeline { /** - * The **`currentTime`** read-only property of the Web Animations API's AnimationTimeline interface returns the timeline's current time in milliseconds, or `null` if the timeline is inactive. + * The **`currentTime`** read-only property of the Web Animations API's AnimationTimeline interface returns the timeline's current time in milliseconds, or null if the timeline is inactive. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnimationTimeline/currentTime) */ readonly currentTime: CSSNumberish | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnimationTimeline/duration) */ + /** + * The **`duration`** read-only property of the Web Animations API's AnimationTimeline interface returns the maximum value for this timeline or null. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnimationTimeline/duration) + */ readonly duration: CSSNumberish | null; } @@ -3287,25 +3291,25 @@ declare var AnimationTimeline: { }; /** - * The **`Attr`** interface represents one of an element's attributes as an object. + * The **`Attr`** interface represents one of an element's attributes as an object. In most situations, you will directly retrieve the attribute value as a string (e.g., Element.getAttribute()), but some cases may require interacting with Attr instances (e.g., Element.getAttributeNode()). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Attr) */ interface Attr extends Node { /** - * The read-only **`localName`** property of the Attr interface returns the _local part_ of the _qualified name_ of an attribute, that is the name of the attribute, stripped from any namespace in front of it. + * The read-only **`localName`** property of the Attr interface returns the local part of the qualified name of an attribute, that is the name of the attribute, stripped from any namespace in front of it. For example, if the qualified name is xml:lang, the returned local name is lang, if the element supports that namespace. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Attr/localName) */ readonly localName: string; /** - * The read-only **`name`** property of the Attr interface returns the _qualified name_ of an attribute, that is the name of the attribute, with the namespace prefix, if any, in front of it. + * The read-only **`name`** property of the Attr interface returns the qualified name of an attribute, that is the name of the attribute, with the namespace prefix, if any, in front of it. For example, if the local name is lang and the namespace prefix is xml, the returned qualified name is xml:lang. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Attr/name) */ readonly name: string; /** - * The read-only **`namespaceURI`** property of the Attr interface returns the namespace URI of the attribute, or `null` if the element is not in a namespace. + * The read-only **`namespaceURI`** property of the Attr interface returns the namespace URI of the attribute, or null if the element is not in a namespace. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Attr/namespaceURI) */ @@ -3318,13 +3322,13 @@ interface Attr extends Node { */ readonly ownerElement: Element | null; /** - * The read-only **`prefix`** property of the Attr returns the namespace prefix of the attribute, or `null` if no prefix is specified. + * The read-only **`prefix`** property of the Attr returns the namespace prefix of the attribute, or null if no prefix is specified. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Attr/prefix) */ readonly prefix: string | null; /** - * The read-only **`specified`** property of the Attr interface always returns `true`. + * The read-only **`specified`** property of the Attr interface always returns true. * @deprecated * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Attr/specified) @@ -3347,7 +3351,7 @@ declare var Attr: { }; /** - * The **`AudioBuffer`** interface represents a short audio asset residing in memory, created from an audio file using the BaseAudioContext/decodeAudioData method, or from raw data using BaseAudioContext/createBuffer. + * The **`AudioBuffer`** interface represents a short audio asset residing in memory, created from an audio file using the AudioContext.decodeAudioData() method, or from raw data using AudioContext.createBuffer(). Once put into an AudioBuffer, the audio can then be played by being passed into an AudioBufferSourceNode. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioBuffer) */ @@ -3365,7 +3369,7 @@ interface AudioBuffer { */ readonly length: number; /** - * The `numberOfChannels` property of the AudioBuffer interface returns an integer representing the number of discrete audio channels described by the PCM data stored in the buffer. + * The **`numberOfChannels`** property of the AudioBuffer interface returns an integer representing the number of discrete audio channels described by the PCM data stored in the buffer. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioBuffer/numberOfChannels) */ @@ -3377,13 +3381,13 @@ interface AudioBuffer { */ readonly sampleRate: number; /** - * The **`copyFromChannel()`** method of the AudioBuffer interface copies the audio sample data from the specified channel of the `AudioBuffer` to a specified Float32Array. + * The **`copyFromChannel()`** method of the AudioBuffer interface copies the audio sample data from the specified channel of the AudioBuffer to a specified Float32Array. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioBuffer/copyFromChannel) */ copyFromChannel(destination: Float32Array, channelNumber: number, bufferOffset?: number): void; /** - * The `copyToChannel()` method of the AudioBuffer interface copies the samples to the specified channel of the `AudioBuffer`, from the source array. + * The **`copyToChannel()`** method of the AudioBuffer interface copies the samples to the specified channel of the AudioBuffer, from the source array. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioBuffer/copyToChannel) */ @@ -3420,13 +3424,13 @@ interface AudioBufferSourceNode extends AudioScheduledSourceNode { */ readonly detune: AudioParam; /** - * The `loop` property of the AudioBufferSourceNode interface is a Boolean indicating if the audio asset must be replayed when the end of the AudioBuffer is reached. + * The **`loop`** property of the AudioBufferSourceNode interface is a Boolean indicating if the audio asset must be replayed when the end of the AudioBuffer is reached. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioBufferSourceNode/loop) */ loop: boolean; /** - * The `loopEnd` property of the AudioBufferSourceNode interface specifies is a floating point number specifying, in seconds, at what offset into playing the AudioBuffer playback should loop back to the time indicated by the AudioBufferSourceNode.loopStart property. + * The **`loopEnd`** property of the AudioBufferSourceNode interface specifies is a floating point number specifying, in seconds, at what offset into playing the AudioBuffer playback should loop back to the time indicated by the loopStart property. This is only used if the loop property is true. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioBufferSourceNode/loopEnd) */ @@ -3444,7 +3448,7 @@ interface AudioBufferSourceNode extends AudioScheduledSourceNode { */ readonly playbackRate: AudioParam; /** - * The `start()` method of the AudioBufferSourceNode Interface is used to schedule playback of the audio data contained in the buffer, or to begin playback immediately. + * The **`start()`** method of the AudioBufferSourceNode Interface is used to schedule playback of the audio data contained in the buffer, or to begin playback immediately. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioBufferSourceNode/start) */ @@ -3461,13 +3465,13 @@ declare var AudioBufferSourceNode: { }; /** - * The `AudioContext` interface represents an audio-processing graph built from audio modules linked together, each represented by an AudioNode. + * The **`AudioContext`** interface represents an audio-processing graph built from audio modules linked together, each represented by an AudioNode. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioContext) */ interface AudioContext extends BaseAudioContext { /** - * The **`baseLatency`** read-only property of the AudioContext interface returns a double that represents the number of seconds of processing latency incurred by the `AudioContext` passing an audio buffer from the AudioDestinationNode — i.e., the end of the audio graph — into the host system's audio subsystem ready for playing. + * The **`baseLatency`** read-only property of the AudioContext interface returns a double that represents the number of seconds of processing latency incurred by the AudioContext passing an audio buffer from the AudioDestinationNode — i.e., the end of the audio graph — into the host system's audio subsystem ready for playing. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioContext/baseLatency) */ @@ -3479,31 +3483,31 @@ interface AudioContext extends BaseAudioContext { */ readonly outputLatency: number; /** - * The `close()` method of the AudioContext Interface closes the audio context, releasing any system audio resources that it uses. + * The **`close()`** method of the AudioContext Interface closes the audio context, releasing any system audio resources that it uses. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioContext/close) */ close(): Promise; /** - * The `createMediaElementSource()` method of the AudioContext Interface is used to create a new MediaElementAudioSourceNode object, given an existing HTML audio or video element, the audio from which can then be played and manipulated. + * The **`createMediaElementSource()`** method of the AudioContext Interface is used to create a new MediaElementAudioSourceNode object, given an existing HTML