diff --git a/src/lib/dom.generated.d.ts b/src/lib/dom.generated.d.ts index 26f0aa1022e33..96f357d66820d 100644 --- a/src/lib/dom.generated.d.ts +++ b/src/lib/dom.generated.d.ts @@ -52,6 +52,12 @@ interface Algorithm { name: string; } +interface AllAcceptedCredentialsOptions { + allAcceptedCredentialIds: Base64URLString[]; + rpId: string; + userId: Base64URLString; +} + interface AnalyserOptions extends AudioNodeOptions { fftSize?: number; maxDecibels?: number; @@ -351,6 +357,11 @@ interface CloseEventInit extends EventInit { wasClean?: boolean; } +interface CommandEventInit extends EventInit { + command?: string; + source?: Element | null; +} + interface CompositionEventInit extends UIEventInit { data?: string; } @@ -376,6 +387,11 @@ interface ConstantSourceOptions { offset?: number; } +interface ConstrainBooleanOrDOMStringParameters { + exact?: boolean | string; + ideal?: boolean | string; +} + interface ConstrainBooleanParameters { exact?: boolean; ideal?: boolean; @@ -457,6 +473,13 @@ interface CryptoKeyPair { publicKey: CryptoKey; } +interface CurrentUserDetailsOptions { + displayName: string; + name: string; + rpId: string; + userId: Base64URLString; +} + interface CustomEventInit extends EventInit { detail?: T; } @@ -728,6 +751,10 @@ interface FullscreenOptions { navigationUI?: FullscreenNavigationUI; } +interface GPUPipelineErrorInit { + reason: GPUPipelineErrorReason; +} + interface GainOptions extends AudioNodeOptions { gain?: number; } @@ -883,6 +910,7 @@ interface InputEventInit extends UIEventInit { interface IntersectionObserverInit { root?: Element | Document | null; rootMargin?: string; + scrollMargin?: string; threshold?: number | number[]; } @@ -1113,7 +1141,7 @@ interface MediaTrackCapabilities { channelCount?: ULongRange; deviceId?: string; displaySurface?: string; - echoCancellation?: boolean[]; + echoCancellation?: (boolean | string)[]; facingMode?: string[]; frameRate?: DoubleRange; groupId?: string; @@ -1131,7 +1159,7 @@ interface MediaTrackConstraintSet { channelCount?: ConstrainULong; deviceId?: ConstrainDOMString; displaySurface?: ConstrainDOMString; - echoCancellation?: ConstrainBoolean; + echoCancellation?: ConstrainBooleanOrDOMString; facingMode?: ConstrainDOMString; frameRate?: ConstrainDouble; groupId?: ConstrainDOMString; @@ -1153,7 +1181,7 @@ interface MediaTrackSettings { channelCount?: number; deviceId?: string; displaySurface?: string; - echoCancellation?: boolean; + echoCancellation?: boolean | string; facingMode?: string; frameRate?: number; groupId?: string; @@ -2013,6 +2041,15 @@ interface RegistrationOptions { updateViaCache?: ServiceWorkerUpdateViaCache; } +interface Report { + body?: ReportBody | null; + type?: string; + url?: string; +} + +interface ReportBody { +} + interface ReportingObserverOptions { buffered?: boolean; types?: string[]; @@ -2101,6 +2138,12 @@ interface SVGBoundingBoxOptions { stroke?: boolean; } +interface SchedulerPostTaskOptions { + delay?: number; + priority?: TaskPriority; + signal?: AbortSignal; +} + interface ScrollIntoViewOptions extends ScrollOptions { block?: ScrollLogicalPosition; inline?: ScrollLogicalPosition; @@ -2110,6 +2153,11 @@ interface ScrollOptions { behavior?: ScrollBehavior; } +interface ScrollTimelineOptions { + axis?: ScrollAxis; + source?: Element | null; +} + interface ScrollToOptions extends ScrollOptions { left?: number; top?: number; @@ -2132,7 +2180,7 @@ interface SecurityPolicyViolationEventInit extends EventInit { interface ShadowRootInit { clonable?: boolean; - customElementRegistry?: CustomElementRegistry; + customElementRegistry?: CustomElementRegistry | null; delegatesFocus?: boolean; mode: ShadowRootMode; serializable?: boolean; @@ -2146,6 +2194,16 @@ interface ShareData { url?: string; } +interface SpeechRecognitionErrorEventInit extends EventInit { + error: SpeechRecognitionErrorCode; + message?: string; +} + +interface SpeechRecognitionEventInit extends EventInit { + resultIndex?: number; + results: SpeechRecognitionResultList; +} + interface SpeechSynthesisErrorEventInit extends SpeechSynthesisEventInit { error: SpeechSynthesisErrorCode; } @@ -2219,6 +2277,18 @@ interface SubmitEventInit extends EventInit { submitter?: HTMLElement | null; } +interface TaskControllerInit { + priority?: TaskPriority; +} + +interface TaskPriorityChangeEventInit extends EventInit { + previousPriority: TaskPriority; +} + +interface TaskSignalAnyInit { + priority?: TaskPriority | TaskSignal; +} + interface TextDecodeOptions { stream?: boolean; } @@ -2292,6 +2362,39 @@ interface ULongRange { min?: number; } +interface URLPatternComponentResult { + groups: Record; + input: string; +} + +interface URLPatternInit { + baseURL?: string; + hash?: string; + hostname?: string; + password?: string; + pathname?: string; + port?: string; + protocol?: string; + search?: string; + username?: string; +} + +interface URLPatternOptions { + ignoreCase?: boolean; +} + +interface URLPatternResult { + hash: URLPatternComponentResult; + hostname: URLPatternComponentResult; + inputs: URLPatternInput[]; + password: URLPatternComponentResult; + pathname: URLPatternComponentResult; + port: URLPatternComponentResult; + protocol: URLPatternComponentResult; + search: URLPatternComponentResult; + username: URLPatternComponentResult; +} + interface UnderlyingByteSource { autoAllocateChunkSize?: number; cancel?: UnderlyingSourceCancelCallback; @@ -2323,6 +2426,11 @@ interface UnderlyingSource { type?: ReadableStreamType; } +interface UnknownCredentialOptions { + credentialId: Base64URLString; + rpId: string; +} + interface ValidityStateFlags { badInput?: boolean; customError?: boolean; @@ -2456,6 +2564,12 @@ interface VideoFrameInit { visibleRect?: DOMRectInit; } +interface ViewTimelineOptions { + axis?: ScrollAxis; + inset?: string | (CSSNumericValue | CSSKeywordValue)[]; + subject?: Element; +} + interface WaveShaperOptions extends AudioNodeOptions { curve?: number[] | Float32Array; oversample?: OverSampleType; @@ -2947,6 +3061,12 @@ interface Animation extends EventTarget { onfinish: ((this: Animation, ev: AnimationPlaybackEvent) => any) | null; /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Animation/remove_event) */ onremove: ((this: Animation, ev: AnimationPlaybackEvent) => any) | null; + /** + * The **`overallProgress`** read-only property of the Animation interface returns a number between `0` and `1` indicating the animation's overall progress towards its finished state. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Animation/overallProgress) + */ + readonly overallProgress: number | null; /** * The read-only **`Animation.pending`** property of the Web Animations API indicates whether the animation is currently waiting for an asynchronous operation such as initiating playback or pausing a running animation. * @@ -3032,7 +3152,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) */ @@ -3154,6 +3274,8 @@ interface AnimationTimeline { * [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnimationTimeline/currentTime) */ readonly currentTime: CSSNumberish | null; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/AnimationTimeline/duration) */ + readonly duration: CSSNumberish | null; } declare var AnimationTimeline: { @@ -3211,7 +3333,7 @@ interface Attr extends Node { * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Attr/value) */ value: string; - /** [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent) */ + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Node/textContent) */ get textContent(): string; set textContent(value: string | null); } @@ -3252,7 +3374,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) */ @@ -3289,7 +3411,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) */ @@ -3342,7 +3464,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) */ @@ -3378,7 +3500,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) */ @@ -3748,7 +3870,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) */ @@ -3766,7 +3888,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) */ @@ -3823,7 +3945,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) */ @@ -3847,19 +3969,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) */ @@ -3984,13 +4106,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) */ @@ -4020,7 +4142,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) */ @@ -4046,7 +4168,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) */ @@ -4090,7 +4212,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) */ @@ -4132,7 +4254,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) @@ -4171,7 +4293,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) */ @@ -4207,7 +4329,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) */ @@ -4219,7 +4341,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) */ @@ -4280,7 +4402,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) */ @@ -4303,7 +4425,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) @@ -4408,7 +4530,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) */ @@ -4542,91 +4664,6 @@ declare var CDATASection: { new(): CDATASection; }; -/** - * The `CSPViolationReportBody` interface is an extension of the Reporting API that represents the body of a Content Security Policy (CSP) violation report. - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSPViolationReportBody) - */ -interface CSPViolationReportBody extends ReportBody { - /** - * The **`blockedURL`** read-only property of the CSPViolationReportBody interface is a string value that represents the resource that was blocked because it violates a Content Security Policy (CSP). - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSPViolationReportBody/blockedURL) - */ - readonly blockedURL: string | null; - /** - * The **`columnNumber`** read-only property of the CSPViolationReportBody interface indicates the column number in the source file that triggered the Content Security Policy (CSP) violation. - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSPViolationReportBody/columnNumber) - */ - readonly columnNumber: number | null; - /** - * The **`disposition`** read-only property of the CSPViolationReportBody interface indicates whether the user agent is configured to enforce Content Security Policy (CSP) violations or only report them. - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSPViolationReportBody/disposition) - */ - readonly disposition: SecurityPolicyViolationEventDisposition; - /** - * The **`documentURL`** read-only property of the CSPViolationReportBody interface is a string that represents the URL of the document or worker that violated the Content Security Policy (CSP). - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSPViolationReportBody/documentURL) - */ - readonly documentURL: string; - /** - * The **`effectiveDirective`** read-only property of the CSPViolationReportBody interface is a string that represents the effective Content Security Policy (CSP) directive that was violated. - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSPViolationReportBody/effectiveDirective) - */ - readonly effectiveDirective: string; - /** - * The **`lineNumber`** read-only property of the CSPViolationReportBody interface indicates the line number in the source file that triggered the Content Security Policy (CSP) violation. - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSPViolationReportBody/lineNumber) - */ - readonly lineNumber: number | null; - /** - * The **`originalPolicy`** read-only property of the CSPViolationReportBody interface is a string that represents the Content Security Policy (CSP) whose enforcement uncovered the violation. - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSPViolationReportBody/originalPolicy) - */ - readonly originalPolicy: string; - /** - * The **`referrer`** read-only property of the CSPViolationReportBody interface is a string that represents the URL of the referring page of the resource who's Content Security Policy (CSP) was violated. - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSPViolationReportBody/referrer) - */ - readonly referrer: string | null; - /** - * The **`sample`** read-only property of the CSPViolationReportBody interface is a string that contains a part of the resource that violated the Content Security Policy (CSP). - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSPViolationReportBody/sample) - */ - readonly sample: string | null; - /** - * The **`sourceFile`** read-only property of the CSPViolationReportBody interface indicates the URL of the source file that violated the Content Security Policy (CSP). - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSPViolationReportBody/sourceFile) - */ - readonly sourceFile: string | null; - /** - * The **`statusCode`** read-only property of the CSPViolationReportBody interface is a number representing the HTTP status code of the response to the request that triggered a Content Security Policy (CSP) violation (when loading a window or worker). - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSPViolationReportBody/statusCode) - */ - readonly statusCode: number; - /** - * The **`toJSON()`** method of the CSPViolationReportBody interface is a _serializer_, which returns a JSON representation of the `CSPViolationReportBody` object. - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSPViolationReportBody/toJSON) - */ - toJSON(): any; -} - -declare var CSPViolationReportBody: { - prototype: CSPViolationReportBody; - new(): CSPViolationReportBody; -}; - /** * The **`CSSAnimation`** interface of the Web Animations API represents an Animation object. * @@ -4634,7 +4671,7 @@ declare var CSPViolationReportBody: { */ 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) */ @@ -4856,19 +4893,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) */ @@ -4900,7 +4937,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) */ @@ -4912,14 +4949,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) */ @@ -5020,7 +5057,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) */ @@ -5088,7 +5125,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) */ @@ -5107,7 +5144,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) */ @@ -5126,7 +5163,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) */ @@ -5145,7 +5182,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) */ @@ -5164,7 +5201,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) */ @@ -5221,7 +5258,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) */ @@ -5240,7 +5277,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) */ @@ -5305,7 +5342,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) */ @@ -5326,61 +5363,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) */ @@ -5391,13 +5428,46 @@ 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) */ parse(cssText: string): CSSNumericValue; }; +/** + * The **`CSSPageDescriptors`** interface represents a CSS declaration block for an @page at-rule. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPageDescriptors) + */ +interface CSSPageDescriptors extends CSSStyleDeclarationBase { + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPageDescriptors#margin) */ + margin: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPageDescriptors#margin-bottom) */ + "margin-bottom": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPageDescriptors#margin-left) */ + "margin-left": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPageDescriptors#margin-right) */ + "margin-right": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPageDescriptors#margin-top) */ + "margin-top": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPageDescriptors#marginbottom) */ + marginBottom: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPageDescriptors#marginleft) */ + marginLeft: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPageDescriptors#marginright) */ + marginRight: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPageDescriptors#margintop) */ + marginTop: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPageDescriptors#size) */ + size: string; +} + +declare var CSSPageDescriptors: { + prototype: CSSPageDescriptors; + new(): CSSPageDescriptors; +}; + /** * **`CSSPageRule`** represents a single CSS @page rule. * @@ -5415,7 +5485,7 @@ interface CSSPageRule extends CSSGroupingRule { * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPageRule/style) */ - get style(): CSSStyleDeclaration; + get style(): CSSPageDescriptors; set style(cssText: string); } @@ -5431,7 +5501,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) */ @@ -5443,6 +5513,185 @@ declare var CSSPerspective: { new(length: CSSPerspectiveValue): CSSPerspective; }; +/** + * The **`CSSPositionTryDescriptors`** interface defines properties that represent the list of CSS descriptors that can be set in the body of a @position-try at-rule. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors) + */ +interface CSSPositionTryDescriptors extends CSSStyleDeclarationBase { + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "align-self": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + alignSelf: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "block-size": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + blockSize: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + bottom: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + height: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "inline-size": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + inlineSize: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + inset: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "inset-block": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "inset-block-end": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "inset-block-start": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "inset-inline": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "inset-inline-end": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "inset-inline-start": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + insetBlock: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + insetBlockEnd: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + insetBlockStart: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + insetInline: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + insetInlineEnd: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + insetInlineStart: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "justify-self": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + justifySelf: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + left: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + margin: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "margin-block": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "margin-block-end": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "margin-block-start": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "margin-bottom": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "margin-inline": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "margin-inline-end": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "margin-inline-start": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "margin-left": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "margin-right": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "margin-top": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + marginBlock: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + marginBlockEnd: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + marginBlockStart: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + marginBottom: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + marginInline: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + marginInlineEnd: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + marginInlineStart: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + marginLeft: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + marginRight: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + marginTop: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "max-block-size": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "max-height": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "max-inline-size": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "max-width": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + maxBlockSize: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + maxHeight: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + maxInlineSize: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + maxWidth: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "min-block-size": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "min-height": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "min-inline-size": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "min-width": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + minBlockSize: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + minHeight: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + minInlineSize: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + minWidth: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "place-self": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + placeSelf: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "position-anchor": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + "position-area": string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + positionAnchor: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + positionArea: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + right: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + top: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryDescriptors#instance_properties) */ + width: string; +} + +declare var CSSPositionTryDescriptors: { + prototype: CSSPositionTryDescriptors; + new(): CSSPositionTryDescriptors; +}; + +/** + * The **`CSSPositionTryRule`** interface describes an object representing a @position-try at-rule. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryRule) + */ +interface CSSPositionTryRule extends CSSRule { + /** + * The **`name`** read-only property of the CSSPositionTryRule interface represents the name of the position try fallback option specified by the `@position-try` at-rule's dashed-ident. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryRule/name) + */ + readonly name: string; + /** + * The **`style`** read-only property of the CSSPositionTryRule interface returns a CSSPositionTryDescriptors object representing the declarations set in the body of the `@position-try` at-rule. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSPositionTryRule/style) + */ + get style(): CSSPositionTryDescriptors; + set style(cssText: string); +} + +declare var CSSPositionTryRule: { + prototype: CSSPositionTryRule; + new(): CSSPositionTryRule; +}; + /** * The **`CSSPropertyRule`** interface of the CSS Properties and Values API represents a single CSS @property rule. * @@ -5487,25 +5736,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) */ @@ -5537,13 +5786,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) @@ -5613,19 +5862,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) */ @@ -5669,13 +5918,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) */ @@ -5694,7 +5943,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) */ @@ -5713,7 +5962,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) */ @@ -5743,7 +5992,67 @@ declare var CSSStartingStyleRule: { * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration) */ -interface CSSStyleDeclaration { +interface CSSStyleDeclarationBase { + /** + * The **`cssText`** property of the CSSStyleDeclaration interface returns or sets the text of the element's **inline** style declaration only. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/cssText) + */ + cssText: string; + /** + * The read-only property returns an integer that represents the number of style declarations in this CSS declaration block. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/length) + */ + readonly length: number; + /** + * The **CSSStyleDeclaration.parentRule** read-only property returns a CSSRule that is the parent of this style block, e.g., a CSSStyleRule representing the style for a CSS selector. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/parentRule) + */ + readonly parentRule: CSSRule | null; + /** + * The **CSSStyleDeclaration.getPropertyPriority()** method interface returns a string that provides all explicitly set priorities on the CSS property. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/getPropertyPriority) + */ + getPropertyPriority(property: string): string; + /** + * The **CSSStyleDeclaration.getPropertyValue()** method interface returns a string containing the value of a specified CSS property. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/getPropertyValue) + */ + getPropertyValue(property: string): string; + /** + * The `CSSStyleDeclaration.item()` method interface returns a CSS property name from a CSSStyleDeclaration by index. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/item) + */ + item(index: number): string; + /** + * The **`CSSStyleDeclaration.removeProperty()`** method interface removes a property from a CSS style declaration object. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/removeProperty) + */ + removeProperty(property: string): string; + /** + * The **`CSSStyleDeclaration.setProperty()`** method interface sets a new value for a property on a CSS style declaration object. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/setProperty) + */ + setProperty(property: string, value: string | null, priority?: string): void; + [index: number]: string; +} + +interface CSSStyleDeclaration extends CSSStyleProperties { +} + +declare var CSSStyleDeclaration: { + prototype: CSSStyleDeclaration; + new(): CSSStyleDeclaration; +}; + +interface CSSStyleProperties extends CSSStyleDeclarationBase { /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/accent-color) */ accentColor: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/align-content) */ @@ -5756,6 +6065,9 @@ interface CSSStyleDeclaration { alignmentBaseline: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/all) */ all: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/anchor-name) */ + anchorName: string; + anchorScope: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/animation) */ animation: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/animation-composition) */ @@ -5774,6 +6086,14 @@ interface CSSStyleDeclaration { animationName: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/animation-play-state) */ animationPlayState: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/animation-range) */ + animationRange: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/animation-range-end) */ + animationRangeEnd: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/animation-range-start) */ + animationRangeStart: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/animation-timeline) */ + animationTimeline: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/animation-timing-function) */ animationTimingFunction: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/appearance) */ @@ -6022,12 +6342,6 @@ interface CSSStyleDeclaration { counterSet: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/cssFloat) */ cssFloat: string; - /** - * The **`cssText`** property of the CSSStyleDeclaration interface returns or sets the text of the element's **inline** style declaration only. - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/cssText) - */ - cssText: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/cursor) */ cursor: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/cx) */ @@ -6042,6 +6356,7 @@ interface CSSStyleDeclaration { display: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/dominant-baseline) */ dominantBaseline: string; + dynamicRangeLimit: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/empty-cells) */ emptyCells: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/fill) */ @@ -6112,6 +6427,8 @@ interface CSSStyleDeclaration { fontVariantCaps: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/font-variant-east-asian) */ fontVariantEastAsian: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/font-variant-emoji) */ + fontVariantEmoji: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/font-variant-ligatures) */ fontVariantLigatures: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/font-variant-numeric) */ @@ -6204,12 +6521,6 @@ interface CSSStyleDeclaration { justifySelf: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/left) */ left: string; - /** - * The read-only property returns an integer that represents the number of style declarations in this CSS declaration block. - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/length) - */ - readonly length: number; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/letter-spacing) */ letterSpacing: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/lighting-color) */ @@ -6400,12 +6711,6 @@ interface CSSStyleDeclaration { pageBreakInside: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/paint-order) */ paintOrder: string; - /** - * The **CSSStyleDeclaration.parentRule** read-only property returns a CSSRule that is the parent of this style block, e.g., a CSSStyleRule representing the style for a CSS selector. - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/parentRule) - */ - readonly parentRule: CSSRule | null; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/perspective) */ perspective: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/perspective-origin) */ @@ -6420,6 +6725,16 @@ interface CSSStyleDeclaration { pointerEvents: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/position) */ position: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/position-anchor) */ + positionAnchor: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/position-area) */ + positionArea: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/position-try) */ + positionTry: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/position-try-fallbacks) */ + positionTryFallbacks: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/position-try-order) */ + positionTryOrder: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/print-color-adjust) */ printColorAdjust: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/quotes) */ @@ -6496,6 +6811,12 @@ interface CSSStyleDeclaration { scrollSnapStop: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/scroll-snap-type) */ scrollSnapType: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/scroll-timeline) */ + scrollTimeline: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/scroll-timeline-axis) */ + scrollTimelineAxis: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/scroll-timeline-name) */ + scrollTimelineName: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/scrollbar-color) */ scrollbarColor: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/scrollbar-gutter) */ @@ -6540,6 +6861,8 @@ interface CSSStyleDeclaration { textAlignLast: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/text-anchor) */ textAnchor: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/text-autospace) */ + textAutospace: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/text-box) */ textBox: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/text-box-edge) */ @@ -6590,6 +6913,8 @@ interface CSSStyleDeclaration { textWrapMode: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/text-wrap-style) */ textWrapStyle: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/timeline-scope) */ + timelineScope: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/top) */ top: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/touch-action) */ @@ -6624,6 +6949,14 @@ interface CSSStyleDeclaration { vectorEffect: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/vertical-align) */ verticalAlign: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/view-timeline) */ + viewTimeline: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/view-timeline-axis) */ + viewTimelineAxis: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/view-timeline-inset) */ + viewTimelineInset: string; + /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/view-timeline-name) */ + viewTimelineName: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/view-transition-class) */ viewTransitionClass: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/view-transition-name) */ @@ -7060,42 +7393,11 @@ interface CSSStyleDeclaration { zIndex: string; /** [MDN Reference](https://developer.mozilla.org/docs/Web/CSS/zoom) */ zoom: string; - /** - * The **CSSStyleDeclaration.getPropertyPriority()** method interface returns a string that provides all explicitly set priorities on the CSS property. - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/getPropertyPriority) - */ - getPropertyPriority(property: string): string; - /** - * The **CSSStyleDeclaration.getPropertyValue()** method interface returns a string containing the value of a specified CSS property. - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/getPropertyValue) - */ - getPropertyValue(property: string): string; - /** - * The `CSSStyleDeclaration.item()` method interface returns a CSS property name from a CSSStyleDeclaration by index. - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/item) - */ - item(index: number): string; - /** - * The **`CSSStyleDeclaration.removeProperty()`** method interface removes a property from a CSS style declaration object. - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/removeProperty) - */ - removeProperty(property: string): string; - /** - * The **`CSSStyleDeclaration.setProperty()`** method interface sets a new value for a property on a CSS style declaration object. - * - * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CSSStyleDeclaration/setProperty) - */ - setProperty(property: string, value: string | null, priority?: string): void; - [index: number]: string; } -declare var CSSStyleDeclaration: { - prototype: CSSStyleDeclaration; - new(): CSSStyleDeclaration; +declare var CSSStyleProperties: { + prototype: CSSStyleProperties; + new(): CSSStyleProperties; }; /** @@ -7118,7 +7420,7 @@ interface CSSStyleRule extends CSSGroupingRule { get style(): CSSStyleDeclaration; 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) */ @@ -7252,7 +7554,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) */ @@ -7272,19 +7574,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) */ @@ -7305,7 +7607,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) */ @@ -7328,19 +7630,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) */ @@ -7365,7 +7667,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) */ @@ -7384,7 +7686,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) */ @@ -7405,13 +7707,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) */ @@ -7459,7 +7761,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) */ @@ -7477,7 +7779,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) */ @@ -7503,7 +7805,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) */ @@ -7521,7 +7823,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) */ @@ -7728,7 +8030,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) */ @@ -7829,8 +8131,23 @@ interface CanvasUserInterface { * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CaretPosition) */ interface CaretPosition { + /** + * The **`offset`** property of the CaretPosition interface returns an integer representing the offset of the selection in the caret position node. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CaretPosition/offset) + */ readonly offset: number; + /** + * The **`offsetNode`** property of the CaretPosition interface returns a Node containing the found node at the caret's position. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CaretPosition/offsetNode) + */ readonly offsetNode: Node; + /** + * The `getClientRect()` method of the CaretPosition interface returns the client rectangle for the caret range. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CaretPosition/getClientRect) + */ getClientRect(): DOMRect | null; } @@ -7914,7 +8231,7 @@ interface CharacterData extends Node, ChildNode, NonDocumentTypeChildNode { * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CharacterData/substringData) */ substringData(offset: number, count: number): string; - /** [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent) */ + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Node/textContent) */ get textContent(): string; set textContent(value: string | null); } @@ -8006,7 +8323,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) */ @@ -8087,6 +8404,31 @@ declare var CloseEvent: { new(type: string, eventInitDict?: CloseEventInit): CloseEvent; }; +/** + * The **`CommandEvent`** interface represents an event notifying the user when a HTMLButtonElement element with valid HTMLButtonElement.commandForElement and HTMLButtonElement.command attributes is about to invoke an interactive element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CommandEvent) + */ +interface CommandEvent extends Event { + /** + * The **`command`** read-only property of the CommandEvent interface returns a string containing the value of the HTMLButtonElement.command property at the time the event was dispatched. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CommandEvent/command) + */ + readonly command: string; + /** + * The **`source`** read-only property of the CommandEvent interface returns an EventTarget representing the control that invoked the given command. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CommandEvent/source) + */ + readonly source: Element | null; +} + +declare var CommandEvent: { + prototype: CommandEvent; + new(type: string, eventInitDict?: CommandEventInit): CommandEvent; +}; + /** * The **`Comment`** interface represents textual notations within markup; although it is generally not visually shown, such comments are available to be read in the source view. * @@ -8107,7 +8449,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) */ @@ -8391,7 +8733,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) */ @@ -8410,7 +8752,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) @@ -8487,25 +8829,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) */ @@ -8518,7 +8860,7 @@ declare var CustomElementRegistry: { }; /** - * The **`CustomEvent`** interface represents events initialized by an application for any purpose. + * The **`CustomEvent`** interface can be used to attach custom data to an event generated by an application. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/CustomEvent) */ @@ -8571,13 +8913,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) */ @@ -8652,7 +8994,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(qualifiedNameStr, publicId, systemId) ``` - `qualifiedNameStr` - : A string containing the qualified name, like `svg:svg`. + * 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) */ @@ -8920,7 +9262,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) */ @@ -8964,7 +9306,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) */ @@ -9088,7 +9430,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) */ @@ -9143,7 +9485,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) */ @@ -9193,7 +9535,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) */ @@ -9295,7 +9637,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) */ @@ -9443,7 +9785,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) */ @@ -9535,13 +9877,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) */ @@ -9554,7 +9896,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) */ @@ -9731,6 +10073,19 @@ declare var DeviceOrientationEvent: { new(type: string, eventInitDict?: DeviceOrientationEventInit): DeviceOrientationEvent; }; +/** Available only in secure contexts. */ +interface DigitalCredential extends Credential { + readonly data: any; + readonly protocol: string; + toJSON(): any; +} + +declare var DigitalCredential: { + prototype: DigitalCredential; + new(): DigitalCredential; + userAgentAllowsProtocol(protocol: string): boolean; +}; + interface DocumentEventMap extends GlobalEventHandlersEventMap { "DOMContentLoaded": Event; "fullscreenchange": Event; @@ -9768,7 +10123,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) @@ -9789,7 +10144,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) */ @@ -9831,7 +10186,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) */ @@ -9855,13 +10210,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) */ @@ -9874,7 +10229,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) */ @@ -9930,7 +10285,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) */ @@ -9961,7 +10316,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) */ @@ -9981,13 +10336,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) */ @@ -10005,7 +10360,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) @@ -10018,7 +10373,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) */ @@ -10141,6 +10496,7 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve createEvent(eventInterface: "BlobEvent"): BlobEvent; createEvent(eventInterface: "ClipboardEvent"): ClipboardEvent; createEvent(eventInterface: "CloseEvent"): CloseEvent; + createEvent(eventInterface: "CommandEvent"): CommandEvent; createEvent(eventInterface: "CompositionEvent"): CompositionEvent; createEvent(eventInterface: "ContentVisibilityAutoStateChangeEvent"): ContentVisibilityAutoStateChangeEvent; createEvent(eventInterface: "CookieChangeEvent"): CookieChangeEvent; @@ -10186,10 +10542,13 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve createEvent(eventInterface: "RTCPeerConnectionIceEvent"): RTCPeerConnectionIceEvent; createEvent(eventInterface: "RTCTrackEvent"): RTCTrackEvent; createEvent(eventInterface: "SecurityPolicyViolationEvent"): SecurityPolicyViolationEvent; + createEvent(eventInterface: "SpeechRecognitionErrorEvent"): SpeechRecognitionErrorEvent; + createEvent(eventInterface: "SpeechRecognitionEvent"): SpeechRecognitionEvent; createEvent(eventInterface: "SpeechSynthesisErrorEvent"): SpeechSynthesisErrorEvent; createEvent(eventInterface: "SpeechSynthesisEvent"): SpeechSynthesisEvent; createEvent(eventInterface: "StorageEvent"): StorageEvent; createEvent(eventInterface: "SubmitEvent"): SubmitEvent; + createEvent(eventInterface: "TaskPriorityChangeEvent"): TaskPriorityChangeEvent; createEvent(eventInterface: "TextEvent"): TextEvent; createEvent(eventInterface: "ToggleEvent"): ToggleEvent; createEvent(eventInterface: "TouchEvent"): TouchEvent; @@ -10213,7 +10572,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) */ @@ -10257,7 +10616,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) */ @@ -10269,7 +10628,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) */ @@ -10307,13 +10666,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) */ @@ -10367,11 +10726,12 @@ interface Document extends Node, DocumentOrShadowRoot, FontFaceSource, GlobalEve write(...text: string[]): void; /** * The **`writeln()`** method of the Document interface writes text in one or more TrustedHTML or string parameters to a document stream opened by document.open(), followed by a newline character. + * @deprecated * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/writeln) */ writeln(...text: string[]): void; - /** [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent) */ + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Node/textContent) */ get textContent(): null; addEventListener(type: K, listener: (this: Document, ev: DocumentEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void; @@ -10383,7 +10743,7 @@ declare var Document: { prototype: Document; new(): Document; /** - * The **`parseHTMLUnsafe()`** static method of the Document object is used to parse an HTML input, optionally filtering unwanted HTML elements and attributes, in order to create a new Document instance. + * The **`parseHTMLUnsafe()`** static method of the Document object is used to parse HTML input, optionally filtering unwanted HTML elements and attributes, in order to create a new Document instance. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/parseHTMLUnsafe_static) */ @@ -10398,7 +10758,7 @@ declare var Document: { interface DocumentFragment extends Node, NonElementParentNode, ParentNode { readonly ownerDocument: Document; getElementById(elementId: string): HTMLElement | null; - /** [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent) */ + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Node/textContent) */ get textContent(): string; set textContent(value: string | null); } @@ -10477,7 +10837,7 @@ interface DocumentType extends Node, ChildNode { * [MDN Reference](https://developer.mozilla.org/docs/Web/API/DocumentType/systemId) */ readonly systemId: string; - /** [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent) */ + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Node/textContent) */ get textContent(): null; } @@ -10695,7 +11055,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) */ @@ -10737,7 +11097,7 @@ interface Element extends Node, ARIAMixin, Animatable, ChildNode, NonDocumentTyp */ id: string; /** - * The **`innerHTML`** property of the Element interface gets or sets the HTML or XML markup contained within the element. + * The **`innerHTML`** property of the Element interface gets or sets the HTML or XML markup contained within the element, omitting any shadow tree in both cases. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/innerHTML) */ @@ -10759,7 +11119,7 @@ interface Element extends Node, ARIAMixin, Animatable, ChildNode, NonDocumentTyp /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/fullscreenerror_event) */ onfullscreenerror: ((this: Element, ev: Event) => any) | null; /** - * The **`outerHTML`** attribute of the Element DOM interface gets the serialized HTML fragment describing the element including its descendants. + * The **`outerHTML`** attribute of the Element interface gets or sets the HTML or XML markup of the element and its descendants, omitting any shadow tree in both cases. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/outerHTML) */ @@ -10848,7 +11208,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) */ @@ -10860,7 +11220,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) */ @@ -10878,7 +11238,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) */ @@ -10890,13 +11250,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) */ @@ -10940,19 +11300,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 input 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) */ @@ -10968,9 +11328,12 @@ interface Element extends Node, ARIAMixin, Animatable, ChildNode, NonDocumentTyp * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/matches) */ + matches(selectors: K): this is HTMLElementTagNameMap[K]; + matches(selectors: K): this is SVGElementTagNameMap[K]; + matches(selectors: K): this is MathMLElementTagNameMap[K]; 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) */ @@ -10982,7 +11345,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) */ @@ -11057,19 +11420,19 @@ interface Element extends Node, ARIAMixin, Animatable, ChildNode, NonDocumentTyp */ setAttributeNodeNS(attr: Attr): Attr | null; /** - * The **`setHTMLUnsafe()`** method of the Element interface is used to parse a string of HTML into a DocumentFragment, optionally filtering out unwanted elements and attributes, and those that don't belong in the context, and then using it to replace the element's subtree in the DOM. + * The **`setHTMLUnsafe()`** method of the Element interface is used to parse HTML input into a DocumentFragment, optionally filtering out unwanted elements and attributes, and those that don't belong in the context, and then using it to replace the element's subtree in the DOM. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/setHTMLUnsafe) */ 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) */ @@ -11080,7 +11443,7 @@ interface Element extends Node, ARIAMixin, Animatable, ChildNode, NonDocumentTyp * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/matches) */ webkitMatchesSelector(selectors: string): boolean; - /** [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent) */ + /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Node/textContent) */ get textContent(): string; set textContent(value: string | null); addEventListener(type: K, listener: (this: Element, ev: ElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; @@ -11347,7 +11710,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) */ @@ -11365,13 +11728,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) */ @@ -11391,7 +11754,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) */ @@ -11422,13 +11785,13 @@ interface Event { */ initEvent(type: string, bubbles?: boolean, cancelable?: boolean): void; /** - * The **`preventDefault()`** method of the Event interface tells the user agent that if the event does not get explicitly handled, its default action should not be taken as it normally would be. + * The **`preventDefault()`** method of the Event interface tells the user agent that the event is being explicitly handled, so its default action, such as page scrolling, link navigation, or pasting text, should not be taken. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Event/preventDefault) */ 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) */ @@ -11495,25 +11858,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) */ @@ -11704,7 +12067,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) */ @@ -11739,13 +12102,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) */ @@ -11764,19 +12127,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) */ @@ -11797,25 +12160,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) */ @@ -11853,7 +12216,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) */ @@ -11883,7 +12246,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) */ @@ -11902,7 +12265,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) */ @@ -11929,7 +12292,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) */ @@ -11949,19 +12312,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) */ @@ -12012,7 +12375,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) */ @@ -12096,6 +12459,12 @@ interface FontFace { * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FontFace/unicodeRange) */ unicodeRange: string; + /** + * The **`variationSettings`** property of the FontFace interface retrieves or sets low-level OpenType or TrueType font variations. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/FontFace/variationSettings) + */ + variationSettings: string; /** * The **`weight`** property of the FontFace interface retrieves or sets the weight of the font. * @@ -12176,7 +12545,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) */ @@ -12287,13 +12656,38 @@ 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) */ readonly message: string; } +declare var GPUError: { + prototype: GPUError; + new(): GPUError; +}; + +/** + * The **`GPUPipelineError`** interface of the WebGPU API describes a pipeline failure. + * Available only in secure contexts. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUPipelineError) + */ +interface GPUPipelineError extends DOMException { + /** + * The **`reason`** read-only property of the GPUPipelineError interface defines the reason the pipeline creation failed in a machine-readable way. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/GPUPipelineError/reason) + */ + readonly reason: GPUPipelineErrorReason; +} + +declare var GPUPipelineError: { + prototype: GPUPipelineError; + new(message: string, options: GPUPipelineErrorInit): GPUPipelineError; +}; + /** * The `GainNode` interface represents a change in volume. * @@ -12332,7 +12726,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) */ @@ -12350,13 +12744,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) */ @@ -12381,19 +12775,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) */ @@ -12412,7 +12806,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) */ @@ -12655,7 +13049,7 @@ interface GlobalEventHandlersEventMap { "focusout": FocusEvent; "formdata": FormDataEvent; "gotpointercapture": PointerEvent; - "input": Event; + "input": InputEvent; "invalid": Event; "keydown": KeyboardEvent; "keypress": KeyboardEvent; @@ -12796,7 +13190,7 @@ interface GlobalEventHandlers { /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/gotpointercapture_event) */ ongotpointercapture: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null; /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/input_event) */ - oninput: ((this: GlobalEventHandlers, ev: Event) => any) | null; + oninput: ((this: GlobalEventHandlers, ev: InputEvent) => any) | null; /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLInputElement/invalid_event) */ oninvalid: ((this: GlobalEventHandlers, ev: Event) => any) | null; /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/keydown_event) */ @@ -13014,7 +13408,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) */ @@ -13098,7 +13492,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) */ @@ -13241,7 +13635,19 @@ declare var HTMLBodyElement: { * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement) */ -interface HTMLButtonElement extends HTMLElement, PopoverInvokerElement { +interface HTMLButtonElement extends HTMLElement, PopoverTargetAttributes { + /** + * The **`command`** property of the HTMLButtonElement interface gets and sets the action to be performed on an element being controlled by this button. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/command) + */ + command: string; + /** + * The **`commandForElement`** property of the HTMLButtonElement interface gets and sets the element to control via a button. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/commandForElement) + */ + commandForElement: Element | null; /** * The **`HTMLButtonElement.disabled`** property indicates whether the control is disabled, meaning that it does not accept any clicks. * @@ -13285,7 +13691,7 @@ interface HTMLButtonElement extends HTMLElement, PopoverInvokerElement { */ formTarget: string; /** - * The **`HTMLButtonElement.labels`** read-only property returns a A NodeList containing the `