From 9d7fe04e7350e2afeb2186d9fd9ecc622aa1584e Mon Sep 17 00:00:00 2001 From: Kagami Sascha Rosylight Date: Sun, 20 Jul 2025 20:41:39 +0200 Subject: [PATCH 1/2] Fix incorrect extract of comments --- baselines/audioworklet.generated.d.ts | 62 +- baselines/dom.generated.d.ts | 1076 ++++++++--------- baselines/dom.iterable.generated.d.ts | 4 +- baselines/serviceworker.generated.d.ts | 398 +++--- .../serviceworker.iterable.generated.d.ts | 2 +- baselines/sharedworker.generated.d.ts | 368 +++--- .../sharedworker.iterable.generated.d.ts | 2 +- baselines/ts5.5/audioworklet.generated.d.ts | 62 +- baselines/ts5.5/dom.generated.d.ts | 1076 ++++++++--------- baselines/ts5.5/dom.iterable.generated.d.ts | 4 +- baselines/ts5.5/serviceworker.generated.d.ts | 398 +++--- .../serviceworker.iterable.generated.d.ts | 2 +- baselines/ts5.5/sharedworker.generated.d.ts | 368 +++--- .../sharedworker.iterable.generated.d.ts | 2 +- baselines/ts5.5/webworker.generated.d.ts | 426 +++---- .../ts5.5/webworker.iterable.generated.d.ts | 2 +- baselines/ts5.6/audioworklet.generated.d.ts | 62 +- baselines/ts5.6/dom.generated.d.ts | 1076 ++++++++--------- baselines/ts5.6/dom.iterable.generated.d.ts | 4 +- baselines/ts5.6/serviceworker.generated.d.ts | 398 +++--- .../serviceworker.iterable.generated.d.ts | 2 +- baselines/ts5.6/sharedworker.generated.d.ts | 368 +++--- .../sharedworker.iterable.generated.d.ts | 2 +- baselines/ts5.6/webworker.generated.d.ts | 426 +++---- .../ts5.6/webworker.iterable.generated.d.ts | 2 +- baselines/webworker.generated.d.ts | 426 +++---- baselines/webworker.iterable.generated.d.ts | 2 +- src/build/mdn-comments.ts | 50 +- 28 files changed, 3530 insertions(+), 3540 deletions(-) diff --git a/baselines/audioworklet.generated.d.ts b/baselines/audioworklet.generated.d.ts index f72aed98b..1db6e88c2 100644 --- a/baselines/audioworklet.generated.d.ts +++ b/baselines/audioworklet.generated.d.ts @@ -281,7 +281,7 @@ interface AudioWorkletGlobalScope extends WorkletGlobalScope { */ readonly sampleRate: number; /** - * The **`registerProcessor`** method of the 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) */ @@ -300,7 +300,7 @@ declare var AudioWorkletGlobalScope: { */ interface AudioWorkletProcessor { /** - * The read-only **`port`** property of the The MessagePort object that is connecting the `AudioWorkletProcessor` and the associated `AudioWorkletNode`. + * The read-only **`port`** property of the AudioWorkletProcessor interface returns the associated MessagePort. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletProcessor/port) */ @@ -413,13 +413,13 @@ interface DOMException extends Error { */ readonly code: number; /** - * The **`message`** read-only property of the a message or description associated with the given error name. + * The **`message`** read-only property of the DOMException interface returns a string representing a message or description associated with the given error name. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/message) */ readonly message: string; /** - * The **`name`** read-only property of the one of the strings associated with an error name. + * The **`name`** read-only property of the DOMException interface returns a string that contains one of the strings associated with an error name. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/name) */ @@ -565,7 +565,7 @@ interface Event { */ readonly cancelable: boolean; /** - * The read-only **`composed`** property of the or not the event will propagate across the shadow DOM boundary into the standard DOM. + * The read-only **`composed`** property of the Event interface returns a boolean value which indicates whether or not the event will propagate across the shadow DOM boundary into the standard DOM. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/composed) */ @@ -583,13 +583,13 @@ interface Event { */ readonly defaultPrevented: boolean; /** - * The **`eventPhase`** read-only property of the being evaluated. + * The **`eventPhase`** read-only property of the Event interface indicates which phase of the event flow is currently being evaluated. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/eventPhase) */ readonly eventPhase: number; /** - * The **`isTrusted`** read-only property of the 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 The only exception is the `click` event, which initializes the `isTrusted` property to `false` in user agents. + * 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(). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/isTrusted) */ @@ -609,7 +609,7 @@ interface Event { */ readonly srcElement: EventTarget | null; /** - * The read-only **`target`** property of the dispatched. + * The read-only **`target`** property of the Event interface is a reference to the object onto which the event was dispatched. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/target) */ @@ -646,7 +646,7 @@ interface Event { */ preventDefault(): void; /** - * The **`stopImmediatePropagation()`** method of the If several listeners are attached to the same element for the same event type, they are called in the order in which they were added. + * The **`stopImmediatePropagation()`** method of the Event interface prevents other listeners of the same event from being called. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/stopImmediatePropagation) */ @@ -725,31 +725,31 @@ interface GenericTransformStream { */ interface MessageEvent extends Event { /** - * The **`data`** read-only property of the The data sent by the message emitter; this can be any data type, depending on what originated this event. + * The **`data`** read-only property of the MessageEvent interface represents the data sent by the message emitter. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/data) */ readonly data: T; /** - * The **`lastEventId`** read-only property of the unique ID for the event. + * The **`lastEventId`** read-only property of the MessageEvent interface is a string representing a unique ID for the event. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/lastEventId) */ readonly lastEventId: string; /** - * The **`origin`** read-only property of the origin of the message emitter. + * The **`origin`** read-only property of the MessageEvent interface is a string representing the origin of the message emitter. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/origin) */ readonly origin: string; /** - * The **`ports`** read-only property of the containing all MessagePort objects sent with the message, in order. + * The **`ports`** read-only property of the MessageEvent interface is an array of MessagePort objects containing all MessagePort objects sent with the message, in order. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessageEvent/ports) */ readonly ports: ReadonlyArray; /** - * The **`source`** read-only property of the a WindowProxy, MessagePort, or a `MessageEventSource` (which can be a WindowProxy, 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) */ @@ -797,7 +797,7 @@ interface MessagePort extends EventTarget, MessageEventTarget { */ close(): void; /** - * The **`postMessage()`** method of the transfers ownership of objects to other browsing contexts. + * The **`postMessage()`** method of the MessagePort interface sends a message from the port, and optionally, transfers ownership of objects to other browsing contexts. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/MessagePort/postMessage) */ @@ -827,7 +827,7 @@ declare var MessagePort: { */ interface PromiseRejectionEvent extends Event { /** - * The PromiseRejectionEvent interface's **`promise`** read-only property indicates the JavaScript rejected. + * The PromiseRejectionEvent interface's **`promise`** read-only property indicates the JavaScript Promise which was rejected. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/PromiseRejectionEvent/promise) */ @@ -927,7 +927,7 @@ interface ReadableStream { */ pipeTo(destination: WritableStream, options?: StreamPipeOptions): Promise; /** - * The **`tee()`** method of the two-element array containing the two resulting branches as new ReadableStream instances. + * The **`tee()`** method of the ReadableStream interface tees the current readable stream, returning a two-element array containing the two resulting branches as new ReadableStream instances. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStream/tee) */ @@ -1004,7 +1004,7 @@ declare var ReadableStreamBYOBRequest: { */ interface ReadableStreamDefaultController { /** - * The **`desiredSize`** read-only property of the required to fill the stream's internal queue. + * The **`desiredSize`** read-only property of the ReadableStreamDefaultController interface returns the desired size required to fill the stream's internal queue. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/desiredSize) */ @@ -1016,13 +1016,13 @@ interface ReadableStreamDefaultController { */ close(): void; /** - * The **`enqueue()`** method of the ```js-nolint enqueue(chunk) ``` - `chunk` - : The chunk to enqueue. + * The **`enqueue()`** method of the ReadableStreamDefaultController interface enqueues a given chunk in the associated stream. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/enqueue) */ enqueue(chunk?: R): void; /** - * The **`error()`** method of the with the associated stream to error. + * The **`error()`** method of the ReadableStreamDefaultController interface causes any future interactions with the associated stream to error. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ReadableStreamDefaultController/error) */ @@ -1300,7 +1300,7 @@ interface URL { */ search: string; /** - * The **`searchParams`** read-only property of the access to the [MISSING: httpmethod('GET')] decoded query arguments contained in the URL. + * The **`searchParams`** read-only property of the URL interface returns a URLSearchParams object allowing access to the GET decoded query arguments contained in the URL. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/searchParams) */ @@ -1312,7 +1312,7 @@ interface URL { */ username: string; /** - * The **`toJSON()`** method of the URL interface returns a string containing a serialized version of the URL, although in practice it seems to have the same effect as ```js-nolint toJSON() ``` None. + * The **`toJSON()`** method of the URL interface returns a string containing a serialized version of the URL, although in practice it seems to have the same effect as URL.toString(). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/URL/toJSON) */ @@ -1463,7 +1463,7 @@ interface WritableStreamDefaultController { */ readonly signal: AbortSignal; /** - * The **`error()`** method of the with the associated stream to error. + * The **`error()`** method of the WritableStreamDefaultController interface causes any future interactions with the associated stream to error. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultController/error) */ @@ -1482,43 +1482,43 @@ declare var WritableStreamDefaultController: { */ interface WritableStreamDefaultWriter { /** - * The **`closed`** read-only property of the the stream errors or the writer's lock is released. + * The **`closed`** read-only property of the WritableStreamDefaultWriter interface returns a Promise that fulfills if the stream becomes closed, or rejects if the stream errors or the writer's lock is released. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/closed) */ readonly closed: Promise; /** - * The **`desiredSize`** read-only property of the to fill the stream's internal queue. + * The **`desiredSize`** read-only property of the WritableStreamDefaultWriter interface returns the desired size required to fill the stream's internal queue. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/desiredSize) */ readonly desiredSize: number | null; /** - * The **`ready`** read-only property of the that resolves when the desired size of the stream's internal queue transitions from non-positive to positive, signaling that it is no longer applying backpressure. + * The **`ready`** read-only property of the WritableStreamDefaultWriter interface returns a Promise that resolves when the desired size of the stream's internal queue transitions from non-positive to positive, signaling that it is no longer applying backpressure. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/ready) */ readonly ready: Promise; /** - * The **`abort()`** method of the the producer can no longer successfully write to the stream and it is to be immediately moved to an error state, with any queued writes discarded. + * The **`abort()`** method of the WritableStreamDefaultWriter interface aborts the stream, signaling that the producer can no longer successfully write to the stream and it is to be immediately moved to an error state, with any queued writes discarded. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/abort) */ abort(reason?: any): Promise; /** - * The **`close()`** method of the stream. + * The **`close()`** method of the WritableStreamDefaultWriter interface closes the associated writable stream. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/close) */ close(): Promise; /** - * The **`releaseLock()`** method of the corresponding stream. + * The **`releaseLock()`** method of the WritableStreamDefaultWriter interface releases the writer's lock on the corresponding stream. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/releaseLock) */ releaseLock(): void; /** - * The **`write()`** method of the operation. + * The **`write()`** method of the WritableStreamDefaultWriter interface writes a passed chunk of data to a WritableStream and its underlying sink, then returns a Promise that resolves to indicate the success or failure of the write operation. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/WritableStreamDefaultWriter/write) */ @@ -1938,7 +1938,7 @@ declare var currentTime: number; */ declare var sampleRate: number; /** - * The **`registerProcessor`** method of the 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 ed0f93dfd..f70a201a6 100644 --- a/baselines/dom.generated.d.ts +++ b/baselines/dom.generated.d.ts @@ -3118,7 +3118,7 @@ interface Animation extends EventTarget { */ reverse(): void; /** - * The **`updatePlaybackRate()`** method of the Web Animations API's synchronizing its playback position. + * The **`updatePlaybackRate()`** method of the Web Animations API's Animation Interface sets the speed of an animation after first synchronizing its playback position. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Animation/updatePlaybackRate) */ @@ -3339,7 +3339,7 @@ interface AudioBuffer { */ readonly sampleRate: number; /** - * The **`copyFromChannel()`** method of the channel of the `AudioBuffer` to a specified ```js-nolint copyFromChannel(destination, channelNumber, startInChannel) ``` - `destination` - : A Float32Array to copy the channel's samples to. + * 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) */ @@ -3376,7 +3376,7 @@ interface AudioBufferSourceNode extends AudioScheduledSourceNode { */ buffer: AudioBuffer | null; /** - * The **`detune`** property of the representing detuning of oscillation in cents. + * The **`detune`** property of the AudioBufferSourceNode interface is a k-rate AudioParam representing detuning of oscillation in cents. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioBufferSourceNode/detune) */ @@ -3429,7 +3429,7 @@ declare var AudioBufferSourceNode: { */ interface AudioContext extends BaseAudioContext { /** - * The **`baseLatency`** read-only property of the 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) */ @@ -3465,7 +3465,7 @@ interface AudioContext extends BaseAudioContext { */ createMediaStreamSource(mediaStream: MediaStream): MediaStreamAudioSourceNode; /** - * The **`getOutputTimestamp()`** method of the containing two audio timestamp values relating to the current audio context. + * The **`getOutputTimestamp()`** method of the AudioContext interface returns a new `AudioTimestamp` object containing two audio timestamp values relating to the current audio context. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioContext/getOutputTimestamp) */ @@ -3835,7 +3835,7 @@ interface AudioNode extends EventTarget { */ channelInterpretation: ChannelInterpretation; /** - * The read-only `context` property of the the node is participating in. + * The read-only `context` property of the AudioNode interface returns the associated BaseAudioContext, that is the object representing the processing graph the node is participating in. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioNode/context) */ @@ -3853,7 +3853,7 @@ interface AudioNode extends EventTarget { */ readonly numberOfOutputs: number; /** - * The `connect()` method of the AudioNode interface lets you connect one of the node's outputs to a target, which may be either another `AudioNode` (thereby directing the sound data to the specified node) or an change the value of that parameter over time. + * The `connect()` method of the AudioNode interface lets you connect one of the node's outputs to a target, which may be either another `AudioNode` (thereby directing the sound data to the specified node) or an AudioParam, so that the node's output data is automatically used to change the value of that parameter over time. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioNode/connect) */ @@ -3910,7 +3910,7 @@ interface AudioParam { */ value: number; /** - * The **`cancelAndHoldAtTime()`** method of the `AudioParam` but holds its value at a given time until further changes are made using other methods. + * The **`cancelAndHoldAtTime()`** method of the AudioParam interface cancels all scheduled future changes to the `AudioParam` but holds its value at a given time until further changes are made using other methods. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioParam/cancelAndHoldAtTime) */ @@ -3934,19 +3934,19 @@ interface AudioParam { */ linearRampToValueAtTime(value: number, endTime: number): AudioParam; /** - * The `setTargetAtTime()` method of the `AudioParam` value. + * The `setTargetAtTime()` method of the AudioParam interface schedules the start of a gradual change to the `AudioParam` value. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioParam/setTargetAtTime) */ setTargetAtTime(target: number, startTime: number, timeConstant: number): AudioParam; /** - * The `setValueAtTime()` method of the `AudioParam` value at a precise time, as measured against ```js-nolint setValueAtTime(value, startTime) ``` - `value` - : A floating point number representing the value the AudioParam will change to at the given time. + * The `setValueAtTime()` method of the AudioParam interface schedules an instant change to the `AudioParam` value at a precise time, as measured against BaseAudioContext/currentTime. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioParam/setValueAtTime) */ setValueAtTime(value: number, startTime: number): AudioParam; /** - * The **`setValueCurveAtTime()`** method of the following a curve defined by a list of values. + * The **`setValueCurveAtTime()`** method of the AudioParam interface schedules the parameter's value to change following a curve defined by a list of values. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioParam/setValueCurveAtTime) */ @@ -4071,13 +4071,13 @@ interface AudioWorkletNode extends AudioNode { /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletNode/processorerror_event) */ onprocessorerror: ((this: AudioWorkletNode, ev: ErrorEvent) => any) | null; /** - * The read-only **`parameters`** property of the underlying AudioWorkletProcessor according to its getter. + * The read-only **`parameters`** property of the AudioWorkletNode interface returns the associated AudioParamMap — that is, a `Map`-like collection of AudioParam objects. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletNode/parameters) */ readonly parameters: AudioParamMap; /** - * The read-only **`port`** property of the associated AudioWorkletProcessor. + * The read-only **`port`** property of the AudioWorkletNode interface returns the associated MessagePort. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AudioWorkletNode/port) */ @@ -4107,7 +4107,7 @@ interface AuthenticatorAssertionResponse extends AuthenticatorResponse { */ readonly authenticatorData: ArrayBuffer; /** - * The **`signature`** read-only property of the object which is the signature of the authenticator for both the client data (AuthenticatorResponse.clientDataJSON). + * The **`signature`** read-only property of the AuthenticatorAssertionResponse interface is an ArrayBuffer object which is the signature of the authenticator for both AuthenticatorAssertionResponse.authenticatorData and a SHA-256 hash of the client data (AuthenticatorResponse.clientDataJSON). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AuthenticatorAssertionResponse/signature) */ @@ -4133,7 +4133,7 @@ declare var AuthenticatorAssertionResponse: { */ interface AuthenticatorAttestationResponse extends AuthenticatorResponse { /** - * The **`attestationObject`** property of the entire `attestationObject` with a private key that is stored in the authenticator when it is manufactured. + * The **`attestationObject`** property of the AuthenticatorAttestationResponse interface returns an ArrayBuffer containing the new public key, as well as signature over the entire `attestationObject` with a private key that is stored in the authenticator when it is manufactured. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AuthenticatorAttestationResponse/attestationObject) */ @@ -4177,7 +4177,7 @@ declare var AuthenticatorAttestationResponse: { */ interface AuthenticatorResponse { /** - * The **`clientDataJSON`** property of the AuthenticatorResponse interface stores a JSON string in an An ArrayBuffer. + * The **`clientDataJSON`** property of the AuthenticatorResponse interface stores a JSON string in an ArrayBuffer, representing the client data that was passed to CredentialsContainer.create() or CredentialsContainer.get(). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AuthenticatorResponse/clientDataJSON) */ @@ -4219,7 +4219,7 @@ interface BaseAudioContextEventMap { */ interface BaseAudioContext extends EventTarget { /** - * The `audioWorklet` read-only property of the processing. + * The `audioWorklet` read-only property of the BaseAudioContext interface returns an instance of AudioWorklet that can be used for adding AudioWorkletProcessor-derived classes which implement custom audio processing. * Available only in secure contexts. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/BaseAudioContext/audioWorklet) @@ -4258,7 +4258,7 @@ interface BaseAudioContext extends EventTarget { */ readonly state: AudioContextState; /** - * The `createAnalyser()` method of the can be used to expose audio time and frequency data and create data visualizations. + * The `createAnalyser()` method of the BaseAudioContext interface creates an AnalyserNode, which can be used to expose audio time and frequency data and create data visualizations. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/BaseAudioContext/createAnalyser) */ @@ -4294,7 +4294,7 @@ interface BaseAudioContext extends EventTarget { */ createChannelSplitter(numberOfOutputs?: number): ChannelSplitterNode; /** - * The **`createConstantSource()`** property of the BaseAudioContext interface creates a outputs a monaural (one-channel) sound signal whose samples all have the same value. + * The **`createConstantSource()`** property of the BaseAudioContext interface creates a ConstantSourceNode object, which is an audio source that continuously outputs a monaural (one-channel) sound signal whose samples all have the same value. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/BaseAudioContext/createConstantSource) */ @@ -4306,7 +4306,7 @@ interface BaseAudioContext extends EventTarget { */ createConvolver(): ConvolverNode; /** - * The `createDelay()` method of the which is used to delay the incoming audio signal by a certain amount of time. + * The `createDelay()` method of the BaseAudioContext Interface is used to create a DelayNode, which is used to delay the incoming audio signal by a certain amount of time. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/BaseAudioContext/createDelay) */ @@ -4367,7 +4367,7 @@ interface BaseAudioContext extends EventTarget { */ createWaveShaper(): WaveShaperNode; /** - * The `decodeAudioData()` method of the BaseAudioContext Interface is used to asynchronously decode audio file data contained in an rate, then passed to a callback or promise. + * The `decodeAudioData()` method of the BaseAudioContext Interface is used to asynchronously decode audio file data contained in an ArrayBuffer that is loaded from Window/fetch, XMLHttpRequest, or FileReader. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/BaseAudioContext/decodeAudioData) */ @@ -4390,7 +4390,7 @@ declare var BaseAudioContext: { */ interface BeforeUnloadEvent extends Event { /** - * The **`returnValue`** property of the `returnValue` is initialized to an empty string (`''`) value. + * The **`returnValue`** property of the BeforeUnloadEvent interface, when set to a truthy value, triggers a browser-generated confirmation dialog asking users to confirm if they _really_ want to leave the page when they try to close or reload it, or navigate somewhere else. * @deprecated * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/BeforeUnloadEvent/returnValue) @@ -4495,7 +4495,7 @@ interface Blob { */ stream(): ReadableStream>; /** - * The **`text()`** method of the string containing the contents of the blob, interpreted as UTF-8. + * The **`text()`** method of the Blob interface returns a Promise that resolves with a string containing the contents of the blob, interpreted as UTF-8. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Blob/text) */ @@ -4636,7 +4636,7 @@ declare var CDATASection: { */ interface CSSAnimation extends Animation { /** - * The **`animationName`** property of the specifies one or more keyframe at-rules which describe the animation applied to the element. + * The **`animationName`** property of the CSSAnimation interface returns the animation-name. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSAnimation/animationName) */ @@ -4858,19 +4858,19 @@ declare var CSSFontPaletteValuesRule: { */ interface CSSGroupingRule extends CSSRule { /** - * The **`cssRules`** property of the a collection of CSSRule objects. + * The **`cssRules`** property of the CSSGroupingRule interface returns a CSSRuleList containing a collection of CSSRule objects. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSGroupingRule/cssRules) */ readonly cssRules: CSSRuleList; /** - * The **`deleteRule()`** method of the rules. + * The **`deleteRule()`** method of the CSSGroupingRule interface removes a CSS rule from a list of child CSS rules. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSGroupingRule/deleteRule) */ deleteRule(index: number): void; /** - * The **`insertRule()`** method of the ```js-nolint insertRule(rule) insertRule(rule, index) ``` - `rule` - : A string - `index` MISSING: optional_inline] - : An optional index at which to insert the rule; defaults to 0. + * The **`insertRule()`** method of the CSSGroupingRule interface adds a new CSS rule to a list of CSS rules. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSGroupingRule/insertRule) */ @@ -4902,7 +4902,7 @@ declare var CSSImageValue: { */ interface CSSImportRule extends CSSRule { /** - * The read-only **`href`** property of the The resolved URL will be the `href` attribute of the associated stylesheet. + * The read-only **`href`** property of the CSSImportRule interface returns the URL specified by the @import at-rule. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSImportRule/href) */ @@ -4914,14 +4914,14 @@ interface CSSImportRule extends CSSRule { */ readonly layerName: string | null; /** - * The read-only **`media`** property of the containing the value of the `media` attribute of the associated stylesheet. + * The read-only **`media`** property of the CSSImportRule interface returns a MediaList object, containing the value of the `media` attribute of the associated stylesheet. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSImportRule/media) */ get media(): MediaList; set media(mediaText: string); /** - * The read-only **`styleSheet`** property of the in the form of a CSSStyleSheet object. + * The read-only **`styleSheet`** property of the CSSImportRule interface returns the CSS Stylesheet specified by the @import at-rule. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSImportRule/styleSheet) */ @@ -5022,7 +5022,7 @@ declare var CSSKeyframesRule: { */ interface CSSKeywordValue extends CSSStyleValue { /** - * The **`value`** property of the `CSSKeywordValue`. + * The **`value`** property of the CSSKeywordValue interface returns or sets the value of the `CSSKeywordValue`. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSKeywordValue/value) */ @@ -5090,7 +5090,7 @@ declare var CSSMathClamp: { */ interface CSSMathInvert extends CSSMathValue { /** - * The CSSMathInvert.value read-only property of the A CSSNumericValue. + * The CSSMathInvert.value read-only property of the CSSMathInvert interface returns a CSSNumericValue object. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathInvert/value) */ @@ -5109,7 +5109,7 @@ declare var CSSMathInvert: { */ interface CSSMathMax extends CSSMathValue { /** - * The CSSMathMax.values read-only property of the which contains one or more CSSNumericValue objects. + * The CSSMathMax.values read-only property of the CSSMathMax interface returns a CSSNumericArray object which contains one or more CSSNumericValue objects. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathMax/values) */ @@ -5128,7 +5128,7 @@ declare var CSSMathMax: { */ interface CSSMathMin extends CSSMathValue { /** - * The CSSMathMin.values read-only property of the which contains one or more CSSNumericValue objects. + * The CSSMathMin.values read-only property of the CSSMathMin interface returns a CSSNumericArray object which contains one or more CSSNumericValue objects. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathMin/values) */ @@ -5147,7 +5147,7 @@ declare var CSSMathMin: { */ interface CSSMathNegate extends CSSMathValue { /** - * The CSSMathNegate.value read-only property of the A CSSNumericValue. + * The CSSMathNegate.value read-only property of the CSSMathNegate interface returns a CSSNumericValue object. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathNegate/value) */ @@ -5166,7 +5166,7 @@ declare var CSSMathNegate: { */ interface CSSMathProduct extends CSSMathValue { /** - * The **`CSSMathProduct.values`** read-only property of the CSSMathProduct interface returns a A CSSNumericArray. + * The **`CSSMathProduct.values`** read-only property of the CSSMathProduct interface returns a CSSNumericArray object which contains one or more CSSNumericValue objects. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMathProduct/values) */ @@ -5223,7 +5223,7 @@ declare var CSSMathValue: { */ interface CSSMatrixComponent extends CSSTransformComponent { /** - * The **`matrix`** property of the See the matrix() and matrix3d() pages for examples. + * The **`matrix`** property of the CSSMatrixComponent interface gets and sets a 2d or 3d matrix. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMatrixComponent/matrix) */ @@ -5242,7 +5242,7 @@ declare var CSSMatrixComponent: { */ interface CSSMediaRule extends CSSConditionRule { /** - * The read-only **`media`** property of the destination medium for style information. + * The read-only **`media`** property of the CSSMediaRule interface returns a MediaList representing the intended destination medium for style information. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSMediaRule/media) */ @@ -5307,7 +5307,7 @@ declare var CSSNestedDeclarations: { */ interface CSSNumericArray { /** - * The read-only **`length`** property of the An integer representing the number of CSSNumericValue objects in the list. + * The read-only **`length`** property of the CSSNumericArray interface returns the number of CSSNumericValue objects in the list. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericArray/length) */ @@ -5328,61 +5328,61 @@ declare var CSSNumericArray: { */ interface CSSNumericValue extends CSSStyleValue { /** - * The **`add()`** method of the `CSSNumericValue`. + * The **`add()`** method of the CSSNumericValue interface adds a supplied number to the `CSSNumericValue`. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/add) */ add(...values: CSSNumberish[]): CSSNumericValue; /** - * The **`div()`** method of the supplied value. + * The **`div()`** method of the CSSNumericValue interface divides the `CSSNumericValue` by the supplied value. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/div) */ div(...values: CSSNumberish[]): CSSNumericValue; /** - * The **`equals()`** method of the value are strictly equal. + * The **`equals()`** method of the CSSNumericValue interface returns a boolean indicating whether the passed value are strictly equal. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/equals) */ equals(...value: CSSNumberish[]): boolean; /** - * The **`max()`** method of the passed. + * The **`max()`** method of the CSSNumericValue interface returns the highest value from among the values passed. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/max) */ max(...values: CSSNumberish[]): CSSNumericValue; /** - * The **`min()`** method of the values passed. + * The **`min()`** method of the CSSNumericValue interface returns the lowest value from among those values passed. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/min) */ min(...values: CSSNumberish[]): CSSNumericValue; /** - * The **`mul()`** method of the the supplied value. + * The **`mul()`** method of the CSSNumericValue interface multiplies the `CSSNumericValue` by the supplied value. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/mul) */ mul(...values: CSSNumberish[]): CSSNumericValue; /** - * The **`sub()`** method of the `CSSNumericValue`. + * The **`sub()`** method of the CSSNumericValue interface subtracts a supplied number from the `CSSNumericValue`. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/sub) */ sub(...values: CSSNumberish[]): CSSNumericValue; /** - * The **`to()`** method of the another. + * The **`to()`** method of the CSSNumericValue interface converts a numeric value from one unit to another. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/to) */ to(unit: string): CSSUnitValue; /** - * The **`toSum()`** method of the ```js-nolint toSum(units) ``` - `units` - : The units to convert to. + * The **`toSum()`** method of the CSSNumericValue interface converts the object's value to a CSSMathSum object to values of the specified unit. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/toSum) */ toSum(...units: string[]): CSSMathSum; /** - * The **`type()`** method of the `CSSNumericValue`, one of `angle`, `flex`, `frequency`, `length`, `resolution`, `percent`, `percentHint`, or `time`. + * The **`type()`** method of the CSSNumericValue interface returns the type of `CSSNumericValue`, one of `angle`, `flex`, `frequency`, `length`, `resolution`, `percent`, `percentHint`, or `time`. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/type) */ @@ -5393,7 +5393,7 @@ declare var CSSNumericValue: { prototype: CSSNumericValue; new(): CSSNumericValue; /** - * The **`parse()`** static method of the members are value and the units. + * The **`parse()`** static method of the CSSNumericValue interface converts a value string into an object whose members are value and the units. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSNumericValue/parse_static) */ @@ -5466,7 +5466,7 @@ declare var CSSPageRule: { */ interface CSSPerspective extends CSSTransformComponent { /** - * The **`length`** property of the It is used to apply a perspective transform to the element and its content. + * The **`length`** property of the CSSPerspective interface sets the distance from z=0. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPerspective/length) */ @@ -5701,25 +5701,25 @@ declare var CSSPropertyRule: { */ interface CSSRotate extends CSSTransformComponent { /** - * The **`angle`** property of the denotes a clockwise rotation, a negative angle a counter-clockwise one. + * The **`angle`** property of the CSSRotate interface gets and sets the angle of rotation. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSRotate/angle) */ angle: CSSNumericValue; /** - * The **`x`** property of the translating vector. + * The **`x`** property of the CSSRotate interface gets and sets the abscissa or x-axis of the translating vector. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSRotate/x) */ x: CSSNumberish; /** - * The **`y`** property of the translating vector. + * The **`y`** property of the CSSRotate interface gets and sets the ordinate or y-axis of the translating vector. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSRotate/y) */ y: CSSNumberish; /** - * The **`z`** property of the vector. + * The **`z`** property of the CSSRotate interface representing the z-component of the translating vector. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSRotate/z) */ @@ -5751,13 +5751,13 @@ interface CSSRule { */ readonly parentRule: CSSRule | null; /** - * The **`parentStyleSheet`** property of the the current rule is defined. + * The **`parentStyleSheet`** property of the CSSRule interface returns the StyleSheet object in which the current rule is defined. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSRule/parentStyleSheet) */ readonly parentStyleSheet: CSSStyleSheet | null; /** - * The read-only **`type`** property of the indicating which type of rule the CSSRule represents. + * The read-only **`type`** property of the CSSRule interface is a deprecated property that returns an integer indicating which type of rule the CSSRule represents. * @deprecated * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSRule/type) @@ -5827,19 +5827,19 @@ declare var CSSRuleList: { */ interface CSSScale extends CSSTransformComponent { /** - * The **`x`** property of the translating vector. + * The **`x`** property of the CSSScale interface gets and sets the abscissa or x-axis of the translating vector. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSScale/x) */ x: CSSNumberish; /** - * The **`y`** property of the translating vector. + * The **`y`** property of the CSSScale interface gets and sets the ordinate or y-axis of the translating vector. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSScale/y) */ y: CSSNumberish; /** - * The **`z`** property of the vector. + * The **`z`** property of the CSSScale interface representing the z-component of the translating vector. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSScale/z) */ @@ -5883,13 +5883,13 @@ declare var CSSScopeRule: { */ interface CSSSkew extends CSSTransformComponent { /** - * The **`ax`** property of the along the x-axis (or abscissa). + * The **`ax`** property of the CSSSkew interface gets and sets the angle used to distort the element along the x-axis (or abscissa). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSSkew/ax) */ ax: CSSNumericValue; /** - * The **`ay`** property of the along the y-axis (or ordinate). + * The **`ay`** property of the CSSSkew interface gets and sets the angle used to distort the element along the y-axis (or ordinate). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSSkew/ay) */ @@ -5908,7 +5908,7 @@ declare var CSSSkew: { */ interface CSSSkewX extends CSSTransformComponent { /** - * The **`ax`** property of the along the x-axis (or abscissa). + * The **`ax`** property of the CSSSkewX interface gets and sets the angle used to distort the element along the x-axis (or abscissa). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSSkewX/ax) */ @@ -5927,7 +5927,7 @@ declare var CSSSkewX: { */ interface CSSSkewY extends CSSTransformComponent { /** - * The **`ay`** property of the along the y-axis (or ordinate). + * The **`ay`** property of the CSSSkewY interface gets and sets the angle used to distort the element along the y-axis (or ordinate). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSSkewY/ay) */ @@ -7380,7 +7380,7 @@ interface CSSStyleRule extends CSSGroupingRule { get style(): CSSStyleProperties; set style(cssText: string); /** - * The **`styleMap`** read-only property of the which provides access to the rule's property-value pairs. + * The **`styleMap`** read-only property of the CSSStyleRule interface returns a StylePropertyMap object which provides access to the rule's property-value pairs. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleRule/styleMap) */ @@ -7514,7 +7514,7 @@ interface CSSTransformComponent { */ is2D: boolean; /** - * The **`toMatrix()`** method of the object. + * The **`toMatrix()`** method of the CSSTransformComponent interface returns a DOMMatrix object. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSTransformComponent/toMatrix) */ @@ -7534,19 +7534,19 @@ declare var CSSTransformComponent: { */ interface CSSTransformValue extends CSSStyleValue { /** - * The read-only **`is2D`** property of the In the case of the `CSSTransformValue` this property returns true unless any of the individual functions return false for `Is2D`, in which case it returns false. + * The read-only **`is2D`** property of the CSSTransformValue interface returns whether the transform is 2D or 3D. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSTransformValue/is2D) */ readonly is2D: boolean; /** - * The read-only **`length`** property of the the list. + * The read-only **`length`** property of the CSSTransformValue interface returns the number of transform components in the list. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSTransformValue/length) */ readonly length: number; /** - * The **`toMatrix()`** method of the ```js-nolint toMatrix() ``` None. + * The **`toMatrix()`** method of the CSSTransformValue interface returns a DOMMatrix object. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSTransformValue/toMatrix) */ @@ -7567,7 +7567,7 @@ declare var CSSTransformValue: { */ interface CSSTransition extends Animation { /** - * The **`transitionProperty`** property of the name** of the transition. + * The **`transitionProperty`** property of the CSSTransition interface returns the **expanded transition property name** of the transition. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSTransition/transitionProperty) */ @@ -7590,19 +7590,19 @@ declare var CSSTransition: { */ interface CSSTranslate extends CSSTransformComponent { /** - * The **`x`** property of the translating vector. + * The **`x`** property of the CSSTranslate interface gets and sets the abscissa or x-axis of the translating vector. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSTranslate/x) */ x: CSSNumericValue; /** - * The **`y`** property of the translating vector. + * The **`y`** property of the CSSTranslate interface gets and sets the ordinate or y-axis of the translating vector. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSTranslate/y) */ y: CSSNumericValue; /** - * The **`z`** property of the vector. + * The **`z`** property of the CSSTranslate interface representing the z-component of the translating vector. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSTranslate/z) */ @@ -7627,7 +7627,7 @@ interface CSSUnitValue extends CSSNumericValue { */ readonly unit: string; /** - * The **`CSSUnitValue.value`** property of the A double. + * The **`CSSUnitValue.value`** property of the CSSUnitValue interface returns a double indicating the number of units. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSUnitValue/value) */ @@ -7646,7 +7646,7 @@ declare var CSSUnitValue: { */ interface CSSUnparsedValue extends CSSStyleValue { /** - * The **`length`** read-only property of the An integer. + * The **`length`** read-only property of the CSSUnparsedValue interface returns the number of items in the object. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSUnparsedValue/length) */ @@ -7667,13 +7667,13 @@ declare var CSSUnparsedValue: { */ interface CSSVariableReferenceValue { /** - * The **`fallback`** read-only property of the A CSSUnparsedValue. + * The **`fallback`** read-only property of the CSSVariableReferenceValue interface returns the custom property fallback value of the CSSVariableReferenceValue. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSVariableReferenceValue/fallback) */ readonly fallback: CSSUnparsedValue | null; /** - * The **`variable`** property of the A string beginning with `--` (that is, a custom property name). + * The **`variable`** property of the CSSVariableReferenceValue interface returns the custom property name of the CSSVariableReferenceValue. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSVariableReferenceValue/variable) */ @@ -7721,7 +7721,7 @@ interface Cache { */ delete(request: RequestInfo | URL, options?: CacheQueryOptions): Promise; /** - * The **`keys()`** method of the Cache interface returns a representing the keys of the Cache. + * The **`keys()`** method of the Cache interface returns a Promise that resolves to an array of Request objects representing the keys of the Cache. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Cache/keys) */ @@ -7739,7 +7739,7 @@ interface Cache { */ matchAll(request?: RequestInfo | URL, options?: CacheQueryOptions): Promise>; /** - * The **`put()`** method of the Often, you will just want to Window/fetch one or more requests, then add the result straight to your cache. + * The **`put()`** method of the Cache interface allows key/value pairs to be added to the current Cache object. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Cache/put) */ @@ -7765,7 +7765,7 @@ interface CacheStorage { */ delete(cacheName: string): Promise; /** - * The **`has()`** method of the CacheStorage interface returns a Promise that resolves to `true` if a You can access `CacheStorage` through the Window.caches property in windows or through the WorkerGlobalScope.caches property in workers. + * The **`has()`** method of the CacheStorage interface returns a Promise that resolves to `true` if a Cache object matches the `cacheName`. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CacheStorage/has) */ @@ -7783,7 +7783,7 @@ interface CacheStorage { */ match(request: RequestInfo | URL, options?: MultiCacheQueryOptions): Promise; /** - * The **`open()`** method of the the Cache object matching the `cacheName`. + * The **`open()`** method of the CacheStorage interface returns a Promise that resolves to the Cache object matching the `cacheName`. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CacheStorage/open) */ @@ -7990,7 +7990,7 @@ interface CanvasRect { */ interface CanvasRenderingContext2D extends CanvasCompositing, CanvasDrawImage, CanvasDrawPath, CanvasFillStrokeStyles, CanvasFilters, CanvasImageData, CanvasImageSmoothing, CanvasPath, CanvasPathDrawingStyles, CanvasRect, CanvasSettings, CanvasShadowStyles, CanvasState, CanvasText, CanvasTextDrawingStyles, CanvasTransform, CanvasUserInterface { /** - * The **`CanvasRenderingContext2D.canvas`** property, part of the Canvas API, is a read-only reference to the might be `null` if there is no associated canvas element. + * The **`CanvasRenderingContext2D.canvas`** property, part of the Canvas API, is a read-only reference to the HTMLCanvasElement object that is associated with a given context. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CanvasRenderingContext2D/canvas) */ @@ -8268,7 +8268,7 @@ declare var Clipboard: { */ interface ClipboardEvent extends Event { /** - * The **`clipboardData`** property of the ClipboardEvent interface holds a DataTransfer object, which can be used to: - specify what data should be put into the clipboard from the Element/cut_event and Element/copy_event event handlers, typically with a DataTransfer.setData call; - obtain the data to be pasted from the Element/paste_event event handler, typically with a DataTransfer.getData call. + * The **`clipboardData`** property of the ClipboardEvent interface holds a DataTransfer object, which can be used to: * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/ClipboardEvent/clipboardData) */ @@ -8369,7 +8369,7 @@ declare var Comment: { */ interface CompositionEvent extends UIEvent { /** - * The **`data`** read-only property of the method that raised the event; its exact nature varies depending on the type of event that generated the `CompositionEvent` object. + * The **`data`** read-only property of the CompositionEvent interface returns the characters generated by the input method that raised the event; its exact nature varies depending on the type of event that generated the `CompositionEvent` object. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CompositionEvent/data) */ @@ -8653,7 +8653,7 @@ interface CredentialsContainer { */ preventSilentAccess(): Promise; /** - * The **`store()`** method of the ```js-nolint store(credentials) ``` - `credentials` - : A valid Credential instance. + * The **`store()`** method of the CredentialsContainer stores a set of credentials for the user inside a Credential instance, returning this in a Promise. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CredentialsContainer/store) */ @@ -8672,7 +8672,7 @@ declare var CredentialsContainer: { */ interface Crypto { /** - * The **`Crypto.subtle`** read-only property returns a cryptographic operations. + * The **`Crypto.subtle`** read-only property returns a SubtleCrypto which can then be used to perform low-level cryptographic operations. * Available only in secure contexts. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Crypto/subtle) @@ -8749,25 +8749,25 @@ interface CustomElementRegistry { */ define(name: string, constructor: CustomElementConstructor, options?: ElementDefinitionOptions): void; /** - * The **`get()`** method of the previously-defined custom element. + * The **`get()`** method of the CustomElementRegistry interface returns the constructor for a previously-defined custom element. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomElementRegistry/get) */ get(name: string): CustomElementConstructor | undefined; /** - * The **`getName()`** method of the previously-defined custom element. + * The **`getName()`** method of the CustomElementRegistry interface returns the name for a previously-defined custom element. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomElementRegistry/getName) */ getName(constructor: CustomElementConstructor): string | null; /** - * The **`upgrade()`** method of the elements in a Node subtree, even before they are connected to the main document. + * The **`upgrade()`** method of the CustomElementRegistry interface upgrades all shadow-containing custom elements in a Node subtree, even before they are connected to the main document. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomElementRegistry/upgrade) */ upgrade(root: Node): void; /** - * The **`whenDefined()`** method of the resolves when the named element is defined. + * The **`whenDefined()`** method of the CustomElementRegistry interface returns a Promise that resolves when the named element is defined. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomElementRegistry/whenDefined) */ @@ -8833,13 +8833,13 @@ interface DOMException extends Error { */ readonly code: number; /** - * The **`message`** read-only property of the a message or description associated with the given error name. + * The **`message`** read-only property of the DOMException interface returns a string representing a message or description associated with the given error name. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/message) */ readonly message: string; /** - * The **`name`** read-only property of the one of the strings associated with an error name. + * The **`name`** read-only property of the DOMException interface returns a string that contains one of the strings associated with an error name. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMException/name) */ @@ -8914,7 +8914,7 @@ interface DOMImplementation { */ createDocument(namespace: string | null, qualifiedName: string | null, doctype?: DocumentType | null): XMLDocument; /** - * The **`DOMImplementation.createDocumentType()`** method returns a DocumentType object which can either be used with into the document via methods like Node.insertBefore() or ```js-nolint createDocumentType(name, publicId, systemId) ``` - `name` - : A string containing the name of the doctype, like `html`. + * The **`DOMImplementation.createDocumentType()`** method returns a DocumentType object which can either be used with DOMImplementation.createDocument upon document creation or can be put into the document via methods like Node.insertBefore() or Node.replaceChild(). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMImplementation/createDocumentType) */ @@ -9182,7 +9182,7 @@ interface DOMMatrixReadOnly { */ rotateFromVector(x?: number, y?: number): DOMMatrix; /** - * The **`scale()`** method of the original matrix with a scale transform applied. + * The **`scale()`** method of the DOMMatrixReadOnly interface creates a new matrix being the result of the original matrix with a scale transform applied. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly/scale) */ @@ -9226,7 +9226,7 @@ interface DOMMatrixReadOnly { */ toJSON(): any; /** - * The **`transformPoint`** method of the You can also create a new `DOMPoint` by applying a matrix to a point with the DOMPointReadOnly.matrixTransform() method. + * The **`transformPoint`** method of the DOMMatrixReadOnly interface creates a new DOMPoint object, transforming a specified point by the matrix. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMMatrixReadOnly/transformPoint) */ @@ -9350,7 +9350,7 @@ interface DOMPointReadOnly { */ matrixTransform(matrix?: DOMMatrixInit): DOMPoint; /** - * The DOMPointReadOnly method `toJSON()` returns an object giving the ```js-nolint toJSON() ``` None. + * The DOMPointReadOnly method `toJSON()` returns an object giving the JSON form of the point object. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMPointReadOnly/toJSON) */ @@ -9405,7 +9405,7 @@ interface DOMQuad { */ getBounds(): DOMRect; /** - * The DOMQuad method `toJSON()` returns a ```js-nolint toJSON() ``` None. + * The DOMQuad method `toJSON()` returns a JSON representation of the `DOMQuad` object. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMQuad/toJSON) */ @@ -9455,7 +9455,7 @@ declare var DOMRect: { prototype: DOMRect; new(x?: number, y?: number, width?: number, height?: number): DOMRect; /** - * The **`fromRect()`** static method of the object with a given location and dimensions. + * The **`fromRect()`** static method of the DOMRect object creates a new `DOMRect` object with a given location and dimensions. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRect/fromRect_static) */ @@ -9557,7 +9557,7 @@ declare var DOMRectReadOnly: { prototype: DOMRectReadOnly; new(x?: number, y?: number, width?: number, height?: number): DOMRectReadOnly; /** - * The **`fromRect()`** static method of the object with a given location and dimensions. + * The **`fromRect()`** static method of the DOMRectReadOnly object creates a new `DOMRectReadOnly` object with a given location and dimensions. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DOMRectReadOnly/fromRect_static) */ @@ -9705,7 +9705,7 @@ interface DataTransfer { */ readonly files: FileList; /** - * The read-only `items` property of the DataTransfer interface is a A DataTransferItemList object containing DataTransferItem objects representing the items being dragged in a drag operation, one list item for each object being dragged. + * The read-only `items` property of the DataTransfer interface is a DataTransferItemList of the DataTransferItem in a drag operation. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransfer/items) */ @@ -9797,13 +9797,13 @@ declare var DataTransferItem: { */ interface DataTransferItemList { /** - * The read-only **`length`** property of the the drag item list. + * The read-only **`length`** property of the DataTransferItemList interface returns the number of items currently in the drag item list. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransferItemList/length) */ readonly length: number; /** - * The **`DataTransferItemList.add()`** method creates a new list. + * The **`DataTransferItemList.add()`** method creates a new DataTransferItem using the specified data and adds it to the drag data list. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransferItemList/add) */ @@ -9816,7 +9816,7 @@ interface DataTransferItemList { */ clear(): void; /** - * The **`DataTransferItemList.remove()`** method removes the less than zero or greater than one less than the length of the list, the list will not be changed. + * The **`DataTransferItemList.remove()`** method removes the DataTransferItem at the specified index from the list. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DataTransferItemList/remove) */ @@ -10030,7 +10030,7 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve */ readonly all: HTMLAllCollection; /** - * The **`anchors`** read-only property of the An HTMLCollection. + * The **`anchors`** read-only property of the Document interface returns a list of all of the anchors in the document. * @deprecated * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/anchors) @@ -10051,7 +10051,7 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve */ bgColor: string; /** - * The **`Document.body`** property represents the `null` if no such element exists. + * The **`Document.body`** property represents the body or frameset node of the current document, or `null` if no such element exists. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/body) */ @@ -10093,7 +10093,7 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve */ readonly currentScript: HTMLOrSVGScriptElement | null; /** - * In browsers, **`document.defaultView`** returns the This property is read-only. + * In browsers, **`document.defaultView`** returns the Window object associated with Browsing_context, or `null` if none is available. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/defaultView) */ @@ -10117,13 +10117,13 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve */ readonly doctype: DocumentType | null; /** - * The **`documentElement`** read-only property of the Document interface returns the example, the html element for HTML documents). + * The **`documentElement`** read-only property of the Document interface returns the Element that is the root element of the document (for example, the html element for HTML documents). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/documentElement) */ readonly documentElement: HTMLElement; /** - * The **`documentURI`** read-only property of the A string. + * The **`documentURI`** read-only property of the Document interface returns the document location as a string. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/documentURI) */ @@ -10136,7 +10136,7 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve */ domain: string; /** - * The **`embeds`** read-only property of the An HTMLCollection. + * The **`embeds`** read-only property of the Document interface returns a list of the embedded embed elements within the current document. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/embeds) */ @@ -10192,7 +10192,7 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve */ readonly images: HTMLCollectionOf; /** - * The **`Document.implementation`** property returns a A DOMImplementation object. + * The **`Document.implementation`** property returns a DOMImplementation object associated with the current document. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/implementation) */ @@ -10223,7 +10223,7 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve */ readonly links: HTMLCollectionOf; /** - * The **`Document.location`** read-only property returns a and provides methods for changing that URL and loading another URL. + * The **`Document.location`** read-only property returns a Location object, which contains information about the URL of the document and provides methods for changing that URL and loading another URL. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/location) */ @@ -10243,13 +10243,13 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve onvisibilitychange: ((this: Document, ev: Event) => any) | null; readonly ownerDocument: null; /** - * The read-only **`pictureInPictureEnabled`** property of the available. + * The read-only **`pictureInPictureEnabled`** property of the Document interface indicates whether or not picture-in-picture mode is available. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/pictureInPictureEnabled) */ readonly pictureInPictureEnabled: boolean; /** - * The **`plugins`** read-only property of the containing one or more HTMLEmbedElements representing the An HTMLCollection. + * The **`plugins`** read-only property of the Document interface returns an HTMLCollection object containing one or more HTMLEmbedElements representing the embed elements in the current document. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/plugins) */ @@ -10267,7 +10267,7 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve */ readonly referrer: string; /** - * **`Document.rootElement`** returns the Element that is the root element of the document if it is an documents. + * **`Document.rootElement`** returns the Element that is the root element of the document if it is an svg element, otherwise `null`. * @deprecated * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/rootElement) @@ -10280,7 +10280,7 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve */ readonly scripts: HTMLCollectionOf; /** - * The **`scrollingElement`** read-only property of the scrolls the document. + * The **`scrollingElement`** read-only property of the Document interface returns a reference to the Element that scrolls the document. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/scrollingElement) */ @@ -10477,7 +10477,7 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve */ createProcessingInstruction(target: string, data: string): ProcessingInstruction; /** - * The **`Document.createRange()`** method returns a new ```js-nolint createRange() ``` None. + * The **`Document.createRange()`** method returns a new Range object. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/createRange) */ @@ -10521,7 +10521,7 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve exitPointerLock(): void; getElementById(elementId: string): HTMLElement | null; /** - * The **`getElementsByClassName`** method of of all child elements which have all of the given class name(s). + * The **`getElementsByClassName`** method of Document interface returns an array-like object of all child elements which have all of the given class name(s). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/getElementsByClassName) */ @@ -10533,7 +10533,7 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve */ getElementsByName(elementName: string): NodeListOf; /** - * The **`getElementsByTagName`** method of The complete document is searched, including the root node. + * The **`getElementsByTagName`** method of Document interface returns an HTMLCollection of elements with the given tag name. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/getElementsByTagName) */ @@ -10571,13 +10571,13 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve */ hasStorageAccess(): Promise; /** - * The Document object's **`importNode()`** method creates a copy of a inserted into the current document later. + * The Document object's **`importNode()`** method creates a copy of a Node or DocumentFragment from another document, to be inserted into the current document later. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/importNode) */ importNode(node: T, options?: boolean | ImportNodeOptions): T; /** - * The **`Document.open()`** method opens a document for This does come with some side effects. + * The **`Document.open()`** method opens a document for Document.write. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/open) */ @@ -10960,7 +10960,7 @@ interface Element extends Node, ARIAMixin, Animatable, ChildNode, NonDocumentTyp get classList(): DOMTokenList; set classList(value: string); /** - * The **`className`** property of the of the specified element. + * The **`className`** property of the Element interface gets and sets the value of the `class` attribute of the specified element. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/className) */ @@ -11113,7 +11113,7 @@ interface Element extends Node, ARIAMixin, Animatable, ChildNode, NonDocumentTyp */ computedStyleMap(): StylePropertyMapReadOnly; /** - * The **`getAttribute()`** method of the element. + * The **`getAttribute()`** method of the Element interface returns the value of a specified attribute on the element. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/getAttribute) */ @@ -11125,7 +11125,7 @@ interface Element extends Node, ARIAMixin, Animatable, ChildNode, NonDocumentTyp */ getAttributeNS(namespace: string | null, localName: string): string | null; /** - * The **`getAttributeNames()`** method of the array. + * The **`getAttributeNames()`** method of the Element interface returns the attribute names of the element as an Array of strings. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/getAttributeNames) */ @@ -11143,7 +11143,7 @@ interface Element extends Node, ARIAMixin, Animatable, ChildNode, NonDocumentTyp */ getAttributeNodeNS(namespace: string | null, localName: string): Attr | null; /** - * The **`Element.getBoundingClientRect()`** method returns a position relative to the viewport. + * The **`Element.getBoundingClientRect()`** method returns a DOMRect object providing information about the size of an element and its position relative to the viewport. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/getBoundingClientRect) */ @@ -11155,13 +11155,13 @@ interface Element extends Node, ARIAMixin, Animatable, ChildNode, NonDocumentTyp */ getClientRects(): DOMRectList; /** - * The Element method **`getElementsByClassName()`** returns a live specified class name or names. + * The Element method **`getElementsByClassName()`** returns a live HTMLCollection which contains every descendant element which has the specified class name or names. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/getElementsByClassName) */ getElementsByClassName(classNames: string): HTMLCollectionOf; /** - * The **`Element.getElementsByTagName()`** method returns a live All descendants of the specified element are searched, but not the element itself. + * The **`Element.getElementsByTagName()`** method returns a live HTMLCollection of elements with the given tag name. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/getElementsByTagName) */ @@ -11205,19 +11205,19 @@ interface Element extends Node, ARIAMixin, Animatable, ChildNode, NonDocumentTyp */ hasAttributes(): boolean; /** - * The **`hasPointerCapture()`** method of the pointer capture for the pointer identified by the given pointer ID. + * The **`hasPointerCapture()`** method of the Element interface checks whether the element on which it is invoked has pointer capture for the pointer identified by the given pointer ID. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/hasPointerCapture) */ hasPointerCapture(pointerId: number): boolean; /** - * The **`insertAdjacentElement()`** method of the relative to the element it is invoked upon. + * The **`insertAdjacentElement()`** method of the Element interface inserts a given element node at a given position relative to the element it is invoked upon. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/insertAdjacentElement) */ insertAdjacentElement(where: InsertPosition, element: Element): Element | null; /** - * The **`insertAdjacentHTML()`** method of the the resulting nodes into the DOM tree at a specified position. + * The **`insertAdjacentHTML()`** method of the Element interface parses the specified text as HTML or XML and inserts the resulting nodes into the DOM tree at a specified position. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/insertAdjacentHTML) */ @@ -11235,7 +11235,7 @@ interface Element extends Node, ARIAMixin, Animatable, ChildNode, NonDocumentTyp */ matches(selectors: string): boolean; /** - * The **`releasePointerCapture()`** method of the previously set for a specific (PointerEvent) _pointer_. + * The **`releasePointerCapture()`** method of the Element interface releases (stops) _pointer capture_ that was previously set for a specific (PointerEvent) _pointer_. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/releasePointerCapture) */ @@ -11247,7 +11247,7 @@ interface Element extends Node, ARIAMixin, Animatable, ChildNode, NonDocumentTyp */ removeAttribute(qualifiedName: string): void; /** - * The **`removeAttributeNS()`** method of the If you are working with HTML and you don't need to specify the requested attribute as being part of a specific namespace, use the Element.removeAttribute() method instead. + * The **`removeAttributeNS()`** method of the Element interface removes the specified attribute with the specified namespace from an element. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/removeAttributeNS) */ @@ -11328,13 +11328,13 @@ interface Element extends Node, ARIAMixin, Animatable, ChildNode, NonDocumentTyp */ setHTMLUnsafe(html: string): void; /** - * The **`setPointerCapture()`** method of the _capture target_ of future pointer events. + * The **`setPointerCapture()`** method of the Element interface is used to designate a specific element as the _capture target_ of future pointer events. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/setPointerCapture) */ setPointerCapture(pointerId: number): void; /** - * The **`toggleAttribute()`** method of the present and adding it if it is not present) on the given element. + * The **`toggleAttribute()`** method of the Element interface toggles a Boolean attribute (removing it if it is present and adding it if it is not present) on the given element. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/toggleAttribute) */ @@ -11612,7 +11612,7 @@ interface Event { */ readonly cancelable: boolean; /** - * The read-only **`composed`** property of the or not the event will propagate across the shadow DOM boundary into the standard DOM. + * The read-only **`composed`** property of the Event interface returns a boolean value which indicates whether or not the event will propagate across the shadow DOM boundary into the standard DOM. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/composed) */ @@ -11630,13 +11630,13 @@ interface Event { */ readonly defaultPrevented: boolean; /** - * The **`eventPhase`** read-only property of the being evaluated. + * The **`eventPhase`** read-only property of the Event interface indicates which phase of the event flow is currently being evaluated. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/eventPhase) */ readonly eventPhase: number; /** - * The **`isTrusted`** read-only property of the 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 The only exception is the `click` event, which initializes the `isTrusted` property to `false` in user agents. + * 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(). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/isTrusted) */ @@ -11656,7 +11656,7 @@ interface Event { */ readonly srcElement: EventTarget | null; /** - * The read-only **`target`** property of the dispatched. + * The read-only **`target`** property of the Event interface is a reference to the object onto which the event was dispatched. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/target) */ @@ -11693,7 +11693,7 @@ interface Event { */ preventDefault(): void; /** - * The **`stopImmediatePropagation()`** method of the If several listeners are attached to the same element for the same event type, they are called in the order in which they were added. + * The **`stopImmediatePropagation()`** method of the Event interface prevents other listeners of the same event from being called. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/stopImmediatePropagation) */ @@ -11760,25 +11760,25 @@ interface EventSource extends EventTarget { /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/open_event) */ onopen: ((this: EventSource, ev: Event) => any) | null; /** - * The **`readyState`** read-only property of the connection. + * The **`readyState`** read-only property of the EventSource interface returns a number representing the state of the connection. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/readyState) */ readonly readyState: number; /** - * The **`url`** read-only property of the URL of the source. + * The **`url`** read-only property of the EventSource interface returns a string representing the URL of the source. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/url) */ readonly url: string; /** - * The **`withCredentials`** read-only property of the the `EventSource` object was instantiated with CORS credentials set. + * The **`withCredentials`** read-only property of the EventSource interface returns a boolean value indicating whether the `EventSource` object was instantiated with CORS credentials set. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/withCredentials) */ readonly withCredentials: boolean; /** - * The **`close()`** method of the EventSource interface closes the connection, if one is made, and sets the ```js-nolint close() ``` None. + * The **`close()`** method of the EventSource interface closes the connection, if one is made, and sets the EventSource.readyState attribute to `2` (closed). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/EventSource/close) */ @@ -11969,7 +11969,7 @@ interface FileReader extends EventTarget { */ readAsBinaryString(blob: Blob): void; /** - * The **`readAsDataURL()`** method of the FileReader interface is used to read the contents of the specified file's data as a base64 encoded string. + * The **`readAsDataURL()`** method of the FileReader interface is used to read the contents of the specified Blob or File. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileReader/readAsDataURL) */ @@ -12004,13 +12004,13 @@ declare var FileReader: { */ interface FileSystem { /** - * The read-only **`name`** property of the string is unique among all file systems currently exposed by the File and Directory Entries API. + * The read-only **`name`** property of the FileSystem interface indicates the file system's name. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystem/name) */ readonly name: string; /** - * The read-only **`root`** property of the object representing the root directory of the file system, for use with the File and Directory Entries API. + * The read-only **`root`** property of the FileSystem interface specifies a FileSystemDirectoryEntry object representing the root directory of the file system, for use with the File and Directory Entries API. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystem/root) */ @@ -12029,19 +12029,19 @@ declare var FileSystem: { */ interface FileSystemDirectoryEntry extends FileSystemEntry { /** - * The FileSystemDirectoryEntry interface's method **`createReader()`** returns a the directory. + * The FileSystemDirectoryEntry interface's method **`createReader()`** returns a FileSystemDirectoryReader object which can be used to read the entries in the directory. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryEntry/createReader) */ createReader(): FileSystemDirectoryReader; /** - * The FileSystemDirectoryEntry interface's method **`getDirectory()`** returns a somewhere within the directory subtree rooted at the directory on which it's called. + * The FileSystemDirectoryEntry interface's method **`getDirectory()`** returns a FileSystemDirectoryEntry object corresponding to a directory contained somewhere within the directory subtree rooted at the directory on which it's called. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryEntry/getDirectory) */ getDirectory(path?: string | null, options?: FileSystemFlags, successCallback?: FileSystemEntryCallback, errorCallback?: ErrorCallback): void; /** - * The FileSystemDirectoryEntry interface's method **`getFile()`** returns a within the directory subtree rooted at the directory on which it's called. + * The FileSystemDirectoryEntry interface's method **`getFile()`** returns a FileSystemFileEntry object corresponding to a file contained somewhere within the directory subtree rooted at the directory on which it's called. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryEntry/getFile) */ @@ -12062,25 +12062,25 @@ declare var FileSystemDirectoryEntry: { interface FileSystemDirectoryHandle extends FileSystemHandle { readonly kind: "directory"; /** - * The **`getDirectoryHandle()`** method of the within the directory handle on which the method is called. + * The **`getDirectoryHandle()`** method of the FileSystemDirectoryHandle interface returns a FileSystemDirectoryHandle for a subdirectory with the specified name within the directory handle on which the method is called. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/getDirectoryHandle) */ getDirectoryHandle(name: string, options?: FileSystemGetDirectoryOptions): Promise; /** - * The **`getFileHandle()`** method of the directory the method is called. + * The **`getFileHandle()`** method of the FileSystemDirectoryHandle interface returns a FileSystemFileHandle for a file with the specified name, within the directory the method is called. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/getFileHandle) */ getFileHandle(name: string, options?: FileSystemGetFileOptions): Promise; /** - * The **`removeEntry()`** method of the directory handle contains a file or directory called the name specified. + * The **`removeEntry()`** method of the FileSystemDirectoryHandle interface attempts to remove an entry if the directory handle contains a file or directory called the name specified. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/removeEntry) */ removeEntry(name: string, options?: FileSystemRemoveOptions): Promise; /** - * The **`resolve()`** method of the directory names from the parent handle to the specified child entry, with the name of the child entry as the last array item. + * The **`resolve()`** method of the FileSystemDirectoryHandle interface returns an Array of directory names from the parent handle to the specified child entry, with the name of the child entry as the last array item. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemDirectoryHandle/resolve) */ @@ -12118,7 +12118,7 @@ declare var FileSystemDirectoryReader: { */ interface FileSystemEntry { /** - * The read-only **`filesystem`** property of the FileSystemEntry interface contains a resides. + * The read-only **`filesystem`** property of the FileSystemEntry interface contains a FileSystem object that represents the file system on which the entry resides. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemEntry/filesystem) */ @@ -12148,7 +12148,7 @@ interface FileSystemEntry { */ readonly name: string; /** - * The FileSystemEntry interface's method **`getParent()`** obtains a ```js-nolint getParent(successCallback, errorCallback) getParent(successCallback) ``` - `successCallback` - : A function which is called when the parent directory entry has been retrieved. + * The FileSystemEntry interface's method **`getParent()`** obtains a FileSystemDirectoryEntry. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemEntry/getParent) */ @@ -12167,7 +12167,7 @@ declare var FileSystemEntry: { */ interface FileSystemFileEntry extends FileSystemEntry { /** - * The FileSystemFileEntry interface's method **`file()`** returns a the directory entry. + * The FileSystemFileEntry interface's method **`file()`** returns a File object which can be used to read data from the file represented by the directory entry. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemFileEntry/file) */ @@ -12194,7 +12194,7 @@ interface FileSystemFileHandle extends FileSystemHandle { */ createWritable(options?: FileSystemCreateWritableOptions): Promise; /** - * The **`getFile()`** method of the If the file on disk changes or is removed after this method is called, the returned ```js-nolint getFile() ``` None. + * The **`getFile()`** method of the FileSystemFileHandle interface returns a Promise which resolves to a File object representing the state on disk of the entry represented by the handle. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemFileHandle/getFile) */ @@ -12214,19 +12214,19 @@ declare var FileSystemFileHandle: { */ interface FileSystemHandle { /** - * The **`kind`** read-only property of the `'file'` if the associated entry is a file or `'directory'`. + * The **`kind`** read-only property of the FileSystemHandle interface returns the type of entry. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/kind) */ readonly kind: FileSystemHandleKind; /** - * The **`name`** read-only property of the handle. + * The **`name`** read-only property of the FileSystemHandle interface returns the name of the entry represented by handle. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/name) */ readonly name: string; /** - * The **`isSameEntry()`** method of the ```js-nolint isSameEntry(fileSystemHandle) ``` - FileSystemHandle - : The `FileSystemHandle` to match against the handle on which the method is invoked. + * The **`isSameEntry()`** method of the FileSystemHandle interface compares two FileSystemHandle to see if the associated entries (either a file or directory) match. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FileSystemHandle/isSameEntry) */ @@ -12277,7 +12277,7 @@ declare var FileSystemWritableFileStream: { */ interface FocusEvent extends UIEvent { /** - * The **`relatedTarget`** read-only property of the FocusEvent interface is the secondary target, depending on the type of event:
Event name target relatedTarget
Element/blur_event The EventTarget losing focus The EventTarget receiving focus (if any).
Element/focus_event The EventTarget receiving focus The EventTarget losing focus (if any)
Element/focusin_event The EventTarget receiving focus The EventTarget losing focus (if any)
Element/focusout_event The EventTarget losing focus The EventTarget receiving focus (if any)
Note that many elements can't have focus, which is a common reason for `relatedTarget` to be `null`. + * The **`relatedTarget`** read-only property of the FocusEvent interface is the secondary target, depending on the type of event: * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FocusEvent/relatedTarget) */ @@ -12441,7 +12441,7 @@ declare var FontFaceSet: { */ interface FontFaceSetLoadEvent extends Event { /** - * The **`fontfaces`** read-only property of the An array of FontFace instance. + * The **`fontfaces`** read-only property of the FontFaceSetLoadEvent interface returns an array of FontFace instances, each of which represents a single usable font. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FontFaceSetLoadEvent/fontfaces) */ @@ -12552,7 +12552,7 @@ declare var FragmentDirective: { */ interface GPUError { /** - * The **`message`** read-only property of the A string. + * The **`message`** read-only property of the GPUError interface provides a human-readable message that explains why the error occurred. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUError/message) */ @@ -12597,7 +12597,7 @@ interface Gamepad { */ readonly buttons: ReadonlyArray; /** - * The **`Gamepad.connected`** property of the still connected to the system. + * The **`Gamepad.connected`** property of the Gamepad interface returns a boolean indicating whether the gamepad is still connected to the system. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Gamepad/connected) */ @@ -12615,13 +12615,13 @@ interface Gamepad { */ readonly index: number; /** - * The **`Gamepad.mapping`** property of the remapped the controls on the device to a known layout. + * The **`Gamepad.mapping`** property of the Gamepad interface returns a string indicating whether the browser has remapped the controls on the device to a known layout. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Gamepad/mapping) */ readonly mapping: GamepadMappingType; /** - * The **`Gamepad.timestamp`** property of the representing the last time the data for this gamepad was updated. + * The **`Gamepad.timestamp`** property of the Gamepad interface returns a DOMHighResTimeStamp representing the last time the data for this gamepad was updated. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Gamepad/timestamp) */ @@ -12646,19 +12646,19 @@ declare var Gamepad: { */ interface GamepadButton { /** - * The **`GamepadButton.pressed`** property of the the button is currently pressed (`true`) or unpressed (`false`). + * The **`GamepadButton.pressed`** property of the GamepadButton interface returns a `boolean` indicating whether the button is currently pressed (`true`) or unpressed (`false`). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/GamepadButton/pressed) */ readonly pressed: boolean; /** - * The **`touched`** property of the a button capable of detecting touch is currently touched (`true`) or not touched (`false`). + * The **`touched`** property of the GamepadButton interface returns a `boolean` indicating whether a button capable of detecting touch is currently touched (`true`) or not touched (`false`). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/GamepadButton/touched) */ readonly touched: boolean; /** - * The **`GamepadButton.value`** property of the current state of analog buttons on many modern gamepads, such as the triggers. + * The **`GamepadButton.value`** property of the GamepadButton interface returns a double value used to represent the current state of analog buttons on many modern gamepads, such as the triggers. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/GamepadButton/value) */ @@ -12677,7 +12677,7 @@ declare var GamepadButton: { */ interface GamepadEvent extends Event { /** - * The **`GamepadEvent.gamepad`** property of the **GamepadEvent interface** returns a Gamepad object, providing access to the associated gamepad data for fired A Gamepad object. + * The **`GamepadEvent.gamepad`** property of the **GamepadEvent interface** returns a Gamepad object, providing access to the associated gamepad data for fired Window.gamepadconnected_event and Window.gamepaddisconnected_event events. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/GamepadEvent/gamepad) */ @@ -13279,7 +13279,7 @@ interface HTMLAnchorElement extends HTMLElement, HTMLHyperlinkElementUtils { */ ping: string; /** - * The **`HTMLAnchorElement.referrerPolicy`** property reflect the HTML `referrerpolicy` attribute of the A string; one of the following: - `no-referrer` - : The Referer header will be omitted entirely. + * The **`HTMLAnchorElement.referrerPolicy`** property reflect the HTML `referrerpolicy` attribute of the a element defining which referrer is sent when fetching the resource. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/referrerPolicy) */ @@ -13363,7 +13363,7 @@ interface HTMLAreaElement extends HTMLElement, HTMLHyperlinkElementUtils { */ ping: string; /** - * The **`HTMLAreaElement.referrerPolicy`** property reflect the HTML `referrerpolicy` attribute of the resource. + * The **`HTMLAreaElement.referrerPolicy`** property reflect the HTML `referrerpolicy` attribute of the area element defining which referrer is sent when fetching the resource. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAreaElement/referrerPolicy) */ @@ -13550,7 +13550,7 @@ interface HTMLButtonElement extends HTMLElement, PopoverInvokerElement { */ formTarget: string; /** - * The **`HTMLButtonElement.labels`** read-only property returns a A NodeList containing the `