diff --git a/lib/enu/diagnosticMessages.generated.json.lcg b/lib/enu/diagnosticMessages.generated.json.lcg index 0b66fd7760cc0..de808d1e48ad5 100644 --- a/lib/enu/diagnosticMessages.generated.json.lcg +++ b/lib/enu/diagnosticMessages.generated.json.lcg @@ -141,9 +141,9 @@ - + - + @@ -189,12 +189,6 @@ - - - - - - @@ -867,6 +861,12 @@ + + + + + + @@ -1209,6 +1209,12 @@ + + + + + + @@ -1863,6 +1869,12 @@ + + + + + + @@ -2037,6 +2049,12 @@ + + + + + + @@ -2061,12 +2079,6 @@ - - - - - - @@ -2151,6 +2163,12 @@ + + + + + + @@ -2199,6 +2217,12 @@ + + + + + + @@ -2433,6 +2457,12 @@ + + + + + + @@ -2663,7 +2693,7 @@ - + @@ -2811,6 +2841,24 @@ + + + + + + + + + + + + + + + + + + @@ -3033,18 +3081,6 @@ - - - - - - - - - - - - @@ -3795,6 +3831,12 @@ + + + + + + @@ -3963,6 +4005,12 @@ + + + + + + @@ -4173,6 +4221,12 @@ + + + + + + @@ -4887,6 +4941,12 @@ + + + + + + @@ -5679,6 +5739,12 @@ + + + + + + @@ -5889,6 +5955,12 @@ + + + + + + @@ -5967,6 +6039,12 @@ + + + + + + @@ -5991,6 +6069,12 @@ + + + + + + @@ -6717,6 +6801,12 @@ + + + + + + @@ -7227,6 +7317,12 @@ + + + + + + diff --git a/lib/lib.dom.d.ts b/lib/lib.dom.d.ts index 7817a0e426704..26664f7d070e0 100644 --- a/lib/lib.dom.d.ts +++ b/lib/lib.dom.d.ts @@ -171,7 +171,6 @@ interface ByteLengthChunk { } interface CacheQueryOptions { - cacheName?: string; ignoreMethod?: boolean; ignoreSearch?: boolean; ignoreVary?: boolean; @@ -256,7 +255,7 @@ interface ConstrainDoubleRange extends DoubleRange { ideal?: number; } -interface ConstrainLongRange extends LongRange { +interface ConstrainULongRange extends ULongRange { exact?: number; ideal?: number; } @@ -330,36 +329,41 @@ interface DelayOptions extends AudioNodeOptions { maxDelayTime?: number; } -interface DeviceAccelerationDict { +interface DeviceLightEventInit extends EventInit { + value?: number; +} + +interface DeviceMotionEventAccelerationInit { x?: number | null; y?: number | null; z?: number | null; } -interface DeviceLightEventInit extends EventInit { - value?: number; -} - interface DeviceMotionEventInit extends EventInit { - acceleration?: DeviceAccelerationDict | null; - accelerationIncludingGravity?: DeviceAccelerationDict | null; - interval?: number | null; - rotationRate?: DeviceRotationRateDict | null; + acceleration?: DeviceMotionEventAccelerationInit; + accelerationIncludingGravity?: DeviceMotionEventAccelerationInit; + interval?: number; + rotationRate?: DeviceMotionEventRotationRateInit; } -interface DeviceOrientationEventInit extends EventInit { - absolute?: boolean; +interface DeviceMotionEventRotationRateInit { alpha?: number | null; beta?: number | null; gamma?: number | null; } -interface DeviceRotationRateDict { +interface DeviceOrientationEventInit extends EventInit { + absolute?: boolean; alpha?: number | null; beta?: number | null; gamma?: number | null; } +interface DevicePermissionDescriptor extends PermissionDescriptor { + deviceId?: string; + name: "camera" | "microphone" | "speaker"; +} + interface DocumentTimelineOptions { originTime?: number; } @@ -412,6 +416,10 @@ interface EffectTiming { iterations?: number; } +interface ElementCreationOptions { + is?: string; +} + interface ElementDefinitionOptions { extends?: string; } @@ -553,11 +561,17 @@ interface IIRFilterOptions extends AudioNodeOptions { feedforward: number[]; } +interface ImageEncodeOptions { + quality?: number; + type?: string; +} + interface IntersectionObserverEntryInit { boundingClientRect: DOMRectInit; + intersectionRatio: number; intersectionRect: DOMRectInit; isIntersecting: boolean; - rootBounds: DOMRectInit; + rootBounds: DOMRectInit | null; target: Element; time: number; } @@ -616,11 +630,6 @@ interface KeyframeEffectOptions extends EffectTiming { iterationComposite?: IterationCompositeOperation; } -interface LongRange { - max?: number; - min?: number; -} - interface MediaElementAudioSourceOptions { mediaElement: HTMLMediaElement; } @@ -678,39 +687,45 @@ interface MediaStreamTrackAudioSourceOptions { } interface MediaStreamTrackEventInit extends EventInit { - track?: MediaStreamTrack | null; + track: MediaStreamTrack; } interface MediaTrackCapabilities { - aspectRatio?: number | DoubleRange; + aspectRatio?: DoubleRange; + autoGainControl?: boolean[]; + channelCount?: ULongRange; deviceId?: string; echoCancellation?: boolean[]; - facingMode?: string; - frameRate?: number | DoubleRange; + facingMode?: string[]; + frameRate?: DoubleRange; groupId?: string; - height?: number | LongRange; - sampleRate?: number | LongRange; - sampleSize?: number | LongRange; - volume?: number | DoubleRange; - width?: number | LongRange; + height?: ULongRange; + latency?: DoubleRange; + noiseSuppression?: boolean[]; + resizeMode?: string[]; + sampleRate?: ULongRange; + sampleSize?: ULongRange; + volume?: DoubleRange; + width?: ULongRange; } interface MediaTrackConstraintSet { - aspectRatio?: number | ConstrainDoubleRange; - channelCount?: number | ConstrainLongRange; - deviceId?: string | string[] | ConstrainDOMStringParameters; - displaySurface?: string | string[] | ConstrainDOMStringParameters; - echoCancellation?: boolean | ConstrainBooleanParameters; - facingMode?: string | string[] | ConstrainDOMStringParameters; - frameRate?: number | ConstrainDoubleRange; - groupId?: string | string[] | ConstrainDOMStringParameters; - height?: number | ConstrainLongRange; - latency?: number | ConstrainDoubleRange; - logicalSurface?: boolean | ConstrainBooleanParameters; - sampleRate?: number | ConstrainLongRange; - sampleSize?: number | ConstrainLongRange; - volume?: number | ConstrainDoubleRange; - width?: number | ConstrainLongRange; + aspectRatio?: ConstrainDouble; + autoGainControl?: ConstrainBoolean; + channelCount?: ConstrainULong; + deviceId?: ConstrainDOMString; + echoCancellation?: ConstrainBoolean; + facingMode?: ConstrainDOMString; + frameRate?: ConstrainDouble; + groupId?: ConstrainDOMString; + height?: ConstrainULong; + latency?: ConstrainDouble; + noiseSuppression?: ConstrainBoolean; + resizeMode?: ConstrainDOMString; + sampleRate?: ConstrainULong; + sampleSize?: ConstrainULong; + volume?: ConstrainDouble; + width?: ConstrainULong; } interface MediaTrackConstraints extends MediaTrackConstraintSet { @@ -719,12 +734,17 @@ interface MediaTrackConstraints extends MediaTrackConstraintSet { interface MediaTrackSettings { aspectRatio?: number; + autoGainControl?: boolean; + channelCount?: number; deviceId?: string; echoCancellation?: boolean; facingMode?: string; frameRate?: number; groupId?: string; height?: number; + latency?: number; + noiseSuppression?: boolean; + resizeMode?: string; sampleRate?: number; sampleSize?: number; volume?: number; @@ -733,12 +753,17 @@ interface MediaTrackSettings { interface MediaTrackSupportedConstraints { aspectRatio?: boolean; + autoGainControl?: boolean; + channelCount?: boolean; deviceId?: boolean; echoCancellation?: boolean; facingMode?: boolean; frameRate?: boolean; groupId?: boolean; height?: boolean; + latency?: boolean; + noiseSuppression?: boolean; + resizeMode?: boolean; sampleRate?: boolean; sampleSize?: boolean; volume?: boolean; @@ -753,6 +778,11 @@ interface MessageEventInit extends EventInit { source?: MessageEventSource | null; } +interface MidiPermissionDescriptor extends PermissionDescriptor { + name: "midi"; + sysex?: boolean; +} + interface MouseEventInit extends EventModifierInit { button?: number; buttons?: number; @@ -765,6 +795,10 @@ interface MouseEventInit extends EventModifierInit { screenY?: number; } +interface MultiCacheQueryOptions extends CacheQueryOptions { + cacheName?: string; +} + interface MutationObserverInit { attributeFilter?: string[]; attributeOldValue?: boolean; @@ -914,7 +948,8 @@ interface Pbkdf2Params extends Algorithm { interface PerformanceObserverInit { buffered?: boolean; - entryTypes: string[]; + entryTypes?: string[]; + type?: string; } interface PeriodicWaveConstraints { @@ -926,10 +961,15 @@ interface PeriodicWaveOptions extends PeriodicWaveConstraints { real?: number[] | Float32Array; } +interface PermissionDescriptor { + name: PermissionName; +} + interface PipeOptions { preventAbort?: boolean; preventCancel?: boolean; preventClose?: boolean; + signal?: AbortSignal; } interface PointerEventInit extends MouseEventInit { @@ -955,6 +995,10 @@ interface PositionOptions { timeout?: number; } +interface PostMessageOptions { + transfer?: any[]; +} + interface ProgressEventInit extends EventInit { lengthComputable?: boolean; loaded?: number; @@ -973,6 +1017,11 @@ interface PropertyIndexedKeyframes { [property: string]: string | string[] | number | null | (number | null)[] | undefined; } +interface PushPermissionDescriptor extends PermissionDescriptor { + name: "push"; + userVisibleOnly?: boolean; +} + interface PushSubscriptionJSON { endpoint?: string; expirationTime?: number | null; @@ -1519,6 +1568,11 @@ interface TextDecoderOptions { ignoreBOM?: boolean; } +interface TextEncoderEncodeIntoResult { + read?: number; + written?: number; +} + interface TouchEventInit extends EventModifierInit { changedTouches?: Touch[]; targetTouches?: Touch[]; @@ -1566,6 +1620,11 @@ interface UIEventInit extends EventInit { view?: Window | null; } +interface ULongRange { + max?: number; + min?: number; +} + interface UnderlyingByteSource { autoAllocateChunkSize?: number; cancel?: ReadableStreamErrorCallback; @@ -1650,6 +1709,8 @@ interface EventListener { (evt: Event): void; } +type XPathNSResolver = ((prefix: string | null) => string | null) | { lookupNamespaceURI(prefix: string | null): string | null; }; + /** The ANGLE_instanced_arrays extension is part of the WebGL API and allows to draw the same object, or groups of similar objects multiple times, if they share the same vertex data, primitive count and type. */ interface ANGLE_instanced_arrays { drawArraysInstancedANGLE(mode: GLenum, first: GLint, count: GLsizei, primcount: GLsizei): void; @@ -1658,7 +1719,7 @@ interface ANGLE_instanced_arrays { readonly VERTEX_ATTRIB_ARRAY_DIVISOR_ANGLE: GLenum; } -/** The AbortController interface represents a controller object that allows you to abort one or more DOM requests as and when desired. */ +/** A controller object that allows you to abort one or more DOM requests as and when desired. */ interface AbortController { /** * Returns the AbortSignal object associated with this object. @@ -1680,7 +1741,7 @@ interface AbortSignalEventMap { "abort": Event; } -/** The AbortSignal interface represents a signal object that allows you to communicate with a DOM request (such as a Fetch) and abort it if required via an AbortController object. */ +/** A signal object that allows you to communicate with a DOM request (such as a Fetch) and abort it if required via an AbortController object. */ interface AbortSignal extends EventTarget { /** * Returns true if this AbortSignal's AbortController has signaled to abort, and false @@ -1732,7 +1793,7 @@ interface AesCmacParams extends Algorithm { length: number; } -/** The AnalyserNode interface represents a node able to provide real-time frequency and time-domain analysis information. It is an AudioNode that passes the audio stream unchanged from the input to the output, but allows you to take the generated data, process it, and create audio visualizations. */ +/** A node able to provide real-time frequency and time-domain analysis information. It is an AudioNode that passes the audio stream unchanged from the input to the output, but allows you to take the generated data, process it, and create audio visualizations. */ interface AnalyserNode extends AudioNode { fftSize: number; readonly frequencyBinCount: number; @@ -1801,7 +1862,7 @@ declare var AnimationEffect: { new(): AnimationEffect; }; -/** The AnimationEvent interface represents events providing information related to animations. */ +/** Events providing information related to animations. */ interface AnimationEvent extends Event { readonly animationName: string; readonly elapsedTime: number; @@ -1891,7 +1952,7 @@ declare var ApplicationCache: { readonly UPDATEREADY: number; }; -/** This type represents a DOM element's attribute as an object. In most DOM methods, you will probably directly retrieve the attribute as a string (e.g., Element.getAttribute(), but certain functions (e.g., Element.getAttributeNode()) or means of iterating give Attr types. */ +/** A DOM element's attribute as an object. In most DOM methods, you will probably directly retrieve the attribute as a string (e.g., Element.getAttribute(), but certain functions (e.g., Element.getAttributeNode()) or means of iterating give Attr types. */ interface Attr extends Node { readonly localName: string; readonly name: string; @@ -1907,7 +1968,7 @@ declare var Attr: { new(): Attr; }; -/** Objects of these types are designed to hold small audio snippets, typically less than 45 s. For longer sounds, objects implementing the MediaElementAudioSourceNode are more suitable. The buffer contains data in the following format: non-interleaved IEEE754 32-bit linear PCM with a nominal range between -1 and +1, that is, 32bits floating point buffer, with each samples between -1.0 and 1.0. If the AudioBuffer has multiple channels, they are stored in separate buffer. */ +/** A short audio asset residing in memory, created from an audio file using the AudioContext.decodeAudioData() method, or from raw data using AudioContext.createBuffer(). Once put into an AudioBuffer, the audio can then be played by being passed into an AudioBufferSourceNode. */ interface AudioBuffer { readonly duration: number; readonly length: number; @@ -1923,7 +1984,7 @@ declare var AudioBuffer: { new(options: AudioBufferOptions): AudioBuffer; }; -/** The AudioBufferSourceNode interface is an AudioScheduledSourceNode which represents an audio source consisting of in-memory audio data, stored in an AudioBuffer. It's especially useful for playing back audio which has particularly stringent timing accuracy requirements, such as for sounds that must match a specific rhythm and can be kept in memory rather than being played from disk or the network. */ +/** An AudioScheduledSourceNode which represents an audio source consisting of in-memory audio data, stored in an AudioBuffer. It's especially useful for playing back audio which has particularly stringent timing accuracy requirements, such as for sounds that must match a specific rhythm and can be kept in memory rather than being played from disk or the network. */ interface AudioBufferSourceNode extends AudioScheduledSourceNode { buffer: AudioBuffer | null; readonly detune: AudioParam; @@ -1943,7 +2004,7 @@ declare var AudioBufferSourceNode: { new(context: BaseAudioContext, options?: AudioBufferSourceOptions): AudioBufferSourceNode; }; -/** The AudioContext interface represents an audio-processing graph built from audio modules linked together, each represented by an AudioNode. */ +/** An audio-processing graph built from audio modules linked together, each represented by an AudioNode. */ interface AudioContext extends BaseAudioContext { readonly baseLatency: number; readonly outputLatency: number; @@ -1953,6 +2014,7 @@ interface AudioContext extends BaseAudioContext { createMediaStreamSource(mediaStream: MediaStream): MediaStreamAudioSourceNode; createMediaStreamTrackSource(mediaStreamTrack: MediaStreamTrack): MediaStreamTrackAudioSourceNode; getOutputTimestamp(): AudioTimestamp; + resume(): Promise; suspend(): Promise; addEventListener(type: K, listener: (this: AudioContext, ev: BaseAudioContextEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void; @@ -1975,7 +2037,7 @@ declare var AudioDestinationNode: { new(): AudioDestinationNode; }; -/** The AudioListener interface represents the position and orientation of the unique person listening to the audio scene, and is used in audio spatialization. All PannerNodes spatialize in relation to the AudioListener stored in the BaseAudioContext.listener attribute. */ +/** The position and orientation of the unique person listening to the audio scene, and is used in audio spatialization. All PannerNodes spatialize in relation to the AudioListener stored in the BaseAudioContext.listener attribute. */ interface AudioListener { readonly forwardX: AudioParam; readonly forwardY: AudioParam; @@ -1997,7 +2059,7 @@ declare var AudioListener: { new(): AudioListener; }; -/** The AudioNode interface is a generic interface for representing an audio processing module. Examples include: */ +/** A generic interface for representing an audio processing module. Examples include: */ interface AudioNode extends EventTarget { channelCount: number; channelCountMode: ChannelCountMode; @@ -2051,7 +2113,7 @@ declare var AudioParamMap: { new(): AudioParamMap; }; -/** The Web Audio API AudioProcessingEvent represents events that occur when a ScriptProcessorNode input buffer is ready to be processed. */ +/** The Web Audio API events that occur when a ScriptProcessorNode input buffer is ready to be processed. */ interface AudioProcessingEvent extends Event { readonly inputBuffer: AudioBuffer; readonly outputBuffer: AudioBuffer; @@ -2082,7 +2144,7 @@ declare var AudioScheduledSourceNode: { new(): AudioScheduledSourceNode; }; -/** The AudioTrack interface represents a single audio track from one of the HTML media elements, or . */ +/** A single audio track from one of the HTML media elements, or . */ interface AudioTrack { enabled: boolean; readonly id: string; @@ -2103,7 +2165,7 @@ interface AudioTrackListEventMap { "removetrack": TrackEvent; } -/** The AudioTrackList interface is used to represent a list of the audio tracks contained within a given HTML media element, with each track represented by a separate AudioTrack object in the list. */ +/** Used to represent a list of the audio tracks contained within a given HTML media element, with each track represented by a separate AudioTrack object in the list. */ interface AudioTrackList extends EventTarget { readonly length: number; onaddtrack: ((this: AudioTrackList, ev: TrackEvent) => any) | null; @@ -2190,7 +2252,6 @@ interface BaseAudioContext extends EventTarget { createStereoPanner(): StereoPannerNode; createWaveShaper(): WaveShaperNode; decodeAudioData(audioData: ArrayBuffer, successCallback?: DecodeSuccessCallback | null, errorCallback?: DecodeErrorCallback | null): Promise; - resume(): Promise; addEventListener(type: K, listener: (this: BaseAudioContext, ev: BaseAudioContextEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void; removeEventListener(type: K, listener: (this: BaseAudioContext, ev: BaseAudioContextEventMap[K]) => any, options?: boolean | EventListenerOptions): void; @@ -2234,7 +2295,7 @@ declare var BhxBrowser: { new(): BhxBrowser; }; -/** The BiquadFilterNode interface represents a simple low-order filter, and is created using the AudioContext.createBiquadFilter() method. It is an AudioNode that can represent different kinds of filters, tone control devices, and graphic equalizers. */ +/** A simple low-order filter, and is created using the AudioContext.createBiquadFilter() method. It is an AudioNode that can represent different kinds of filters, tone control devices, and graphic equalizers. */ interface BiquadFilterNode extends AudioNode { readonly Q: AudioParam; readonly detune: AudioParam; @@ -2249,7 +2310,7 @@ declare var BiquadFilterNode: { new(context: BaseAudioContext, options?: BiquadFilterOptions): BiquadFilterNode; }; -/** A Blob object represents a file-like object of immutable, raw data. Blobs represent data that isn't necessarily in a JavaScript-native format. The File interface is based on Blob, inheriting blob functionality and expanding it to support files on the user's system. */ +/** A file-like object of immutable, raw data. Blobs represent data that isn't necessarily in a JavaScript-native format. The File interface is based on Blob, inheriting blob functionality and expanding it to support files on the user's system. */ interface Blob { readonly size: number; readonly type: string; @@ -2302,12 +2363,7 @@ declare var BroadcastChannel: { new(name: string): BroadcastChannel; }; -interface BroadcastChannelEventMap { - message: MessageEvent; - messageerror: MessageEvent; -} - -/** The ByteLengthQueuingStrategy interface of the the Streams API provides a built-in byte length queuing strategy that can be used when constructing streams. */ +/** An interface of the Streams API provides a built-in byte length queuing strategy that can be used when constructing streams. */ interface ByteLengthQueuingStrategy extends QueuingStrategy { highWaterMark: number; size(chunk: ArrayBufferView): number; @@ -2318,7 +2374,7 @@ declare var ByteLengthQueuingStrategy: { new(options: { highWaterMark: number }): ByteLengthQueuingStrategy; }; -/** The CDATASection interface represents a CDATA section that can be used within XML to include extended portions of unescaped text. The symbols < and & don’t need escaping as they normally do when inside a CDATA section. */ +/** A CDATA section that can be used within XML to include extended portions of unescaped text. The symbols < and & don’t need escaping as they normally do when inside a CDATA section. */ interface CDATASection extends Text { } @@ -2327,14 +2383,14 @@ declare var CDATASection: { new(): CDATASection; }; -/** The CSS interface holds useful CSS-related methods. No object with this interface are implemented: it contains only static methods and therefore is a utilitarian interface. */ +/** Holds useful CSS-related methods. No object with this interface are implemented: it contains only static methods and therefore is a utilitarian interface. */ interface CSS { escape(value: string): string; supports(property: string, value?: string): boolean; } declare var CSS: CSS; -/** An object implementing the CSSConditionRule interface represents a single condition CSS at-rule, which consists of a condition and a statement block. It is a child of CSSGroupingRule. */ +/** A single condition CSS at-rule, which consists of a condition and a statement block. It is a child of CSSGroupingRule. */ interface CSSConditionRule extends CSSGroupingRule { conditionText: string; } @@ -2353,7 +2409,7 @@ declare var CSSFontFaceRule: { new(): CSSFontFaceRule; }; -/** An object implementing the CSSGroupingRule interface represents any CSS at-rule that contains other rules nested within it. */ +/** Any CSS at-rule that contains other rules nested within it. */ interface CSSGroupingRule extends CSSRule { readonly cssRules: CSSRuleList; deleteRule(index: number): void; @@ -2376,7 +2432,7 @@ declare var CSSImportRule: { new(): CSSImportRule; }; -/** The CSSKeyframeRule interface describes an object representing a set of style for a given keyframe. It corresponds to the contains of a single keyframe of a @keyframes at-rule. It implements the CSSRule interface with a type value of 8 (CSSRule.KEYFRAME_RULE). */ +/** An object representing a set of style for a given keyframe. It corresponds to the contains of a single keyframe of a @keyframes at-rule. It implements the CSSRule interface with a type value of 8 (CSSRule.KEYFRAME_RULE). */ interface CSSKeyframeRule extends CSSRule { keyText: string; readonly style: CSSStyleDeclaration; @@ -2387,7 +2443,7 @@ declare var CSSKeyframeRule: { new(): CSSKeyframeRule; }; -/** The CSSKeyframesRule interface describes an object representing a complete set of keyframes for a CSS animation. It corresponds to the contains of a whole @keyframes at-rule. It implements the CSSRule interface with a type value of 7 (CSSRule.KEYFRAMES_RULE). */ +/** An object representing a complete set of keyframes for a CSS animation. It corresponds to the contains of a whole @keyframes at-rule. It implements the CSSRule interface with a type value of 7 (CSSRule.KEYFRAMES_RULE). */ interface CSSKeyframesRule extends CSSRule { readonly cssRules: CSSRuleList; name: string; @@ -2401,7 +2457,7 @@ declare var CSSKeyframesRule: { new(): CSSKeyframesRule; }; -/** The CSSMediaRule is an interface representing a single CSS @media rule. It implements the CSSConditionRule interface, and therefore the CSSGroupingRule and the CSSRule interface with a type value of 4 (CSSRule.MEDIA_RULE). */ +/** A single CSS @media rule. It implements the CSSConditionRule interface, and therefore the CSSGroupingRule and the CSSRule interface with a type value of 4 (CSSRule.MEDIA_RULE). */ interface CSSMediaRule extends CSSConditionRule { readonly media: MediaList; } @@ -2411,7 +2467,7 @@ declare var CSSMediaRule: { new(): CSSMediaRule; }; -/** The CSSNamespaceRule interface describes an object representing a single CSS @namespace at-rule. It implements the CSSRule interface, with a type value of 10 (CSSRule.NAMESPACE_RULE). */ +/** An object representing a single CSS @namespace at-rule. It implements the CSSRule interface, with a type value of 10 (CSSRule.NAMESPACE_RULE). */ interface CSSNamespaceRule extends CSSRule { readonly namespaceURI: string; readonly prefix: string; @@ -2435,7 +2491,7 @@ declare var CSSPageRule: { new(): CSSPageRule; }; -/** The CSSRule interface represents a single CSS rule. There are several types of rules, listed in the Type constants section below. */ +/** A single CSS rule. There are several types of rules, listed in the Type constants section below. */ interface CSSRule { cssText: string; readonly parentRule: CSSRule | null; @@ -2484,7 +2540,7 @@ declare var CSSRuleList: { new(): CSSRuleList; }; -/** The CSSStyleDeclaration API represents an object that is a CSS declaration block, that exposes style information and various style-related methods and properties. */ +/** An object that is a CSS declaration block, and exposes style information and various style-related methods and properties. */ interface CSSStyleDeclaration { alignContent: string | null; alignItems: string | null; @@ -2547,33 +2603,34 @@ interface CSSStyleDeclaration { borderWidth: string | null; bottom: string | null; boxShadow: string | null; - boxSizing: string | null; + boxSizing: string; breakAfter: string | null; breakBefore: string | null; breakInside: string | null; captionSide: string | null; + caretColor: string; clear: string | null; clip: string | null; clipPath: string | null; clipRule: string | null; color: string | null; colorInterpolationFilters: string | null; - columnCount: any; - columnFill: string | null; - columnGap: any; - columnRule: string | null; - columnRuleColor: any; - columnRuleStyle: string | null; - columnRuleWidth: any; - columnSpan: string | null; - columnWidth: any; - columns: string | null; + columnCount: string; + columnFill: string; + columnGap: string; + columnRule: string; + columnRuleColor: string; + columnRuleStyle: string; + columnRuleWidth: string; + columnSpan: string; + columnWidth: string; + columns: string; content: string | null; counterIncrement: string | null; counterReset: string | null; cssFloat: string | null; cssText: string; - cursor: string | null; + cursor: string; direction: string | null; display: string | null; dominantBaseline: string | null; @@ -2623,6 +2680,8 @@ interface CSSStyleDeclaration { gridTemplateColumns: string | null; gridTemplateRows: string | null; height: string | null; + imageOrientation: string; + imageRendering: string; imeMode: string | null; justifyContent: string | null; justifyItems: string | null; @@ -2705,16 +2764,16 @@ interface CSSStyleDeclaration { msWrapFlow: string; msWrapMargin: any; msWrapThrough: string; - objectFit: string | null; - objectPosition: string | null; + objectFit: string; + objectPosition: string; opacity: string | null; order: string | null; orphans: string | null; - outline: string | null; - outlineColor: string | null; - outlineOffset: string | null; - outlineStyle: string | null; - outlineWidth: string | null; + outline: string; + outlineColor: string; + outlineOffset: string; + outlineStyle: string; + outlineWidth: string; overflow: string | null; overflowX: string | null; overflowY: string | null; @@ -2762,7 +2821,7 @@ interface CSSStyleDeclaration { textJustify: string | null; textKashida: string | null; textKashidaSpace: string | null; - textOverflow: string | null; + textOverflow: string; textShadow: string | null; textTransform: string | null; textUnderlinePosition: string | null; @@ -2937,6 +2996,7 @@ interface CSSStyleDeclaration { whiteSpace: string | null; widows: string | null; width: string | null; + willChange: string; wordBreak: string | null; wordSpacing: string | null; wordWrap: string | null; @@ -2967,7 +3027,7 @@ declare var CSSStyleRule: { new(): CSSStyleRule; }; -/** The CSSStyleSheet interface represents a single CSS style sheet. It inherits properties and methods from its parent, StyleSheet. */ +/** A single CSS style sheet. It inherits properties and methods from its parent, StyleSheet. */ interface CSSStyleSheet extends StyleSheet { readonly cssRules: CSSRuleList; /** @deprecated */ @@ -3005,7 +3065,7 @@ declare var CSSStyleSheet: { new(): CSSStyleSheet; }; -/** The CSSSupportsRule interface describes an object representing a single CSS @supports at-rule. It implements the CSSConditionRule interface, and therefore the CSSRule and CSSGroupingRule interfaces with a type value of 12 (CSSRule.SUPPORTS_RULE). */ +/** An object representing a single CSS @supports at-rule. It implements the CSSConditionRule interface, and therefore the CSSRule and CSSGroupingRule interfaces with a type value of 12 (CSSRule.SUPPORTS_RULE). */ interface CSSSupportsRule extends CSSConditionRule { } @@ -3014,7 +3074,7 @@ declare var CSSSupportsRule: { new(): CSSSupportsRule; }; -/** The Cache interface provides a storage mechanism for Request / Response object pairs that are cached, for example as part of the ServiceWorker life cycle. Note that the Cache interface is exposed to windowed scopes as well as workers. You don't have to use it in conjunction with service workers, even though it is defined in the service worker spec. */ +/** Provides a storage mechanism for Request / Response object pairs that are cached, for example as part of the ServiceWorker life cycle. Note that the Cache interface is exposed to windowed scopes as well as workers. You don't have to use it in conjunction with service workers, even though it is defined in the service worker spec. */ interface Cache { add(request: RequestInfo): Promise; addAll(requests: RequestInfo[]): Promise; @@ -3030,7 +3090,7 @@ declare var Cache: { new(): Cache; }; -/** The CacheStorage interface represents the storage for Cache objects. */ +/** The storage for Cache objects. */ interface CacheStorage { delete(cacheName: string): Promise; has(cacheName: string): Promise; @@ -3081,7 +3141,7 @@ interface CanvasFilters { filter: string; } -/** The CanvasGradient interface represents an opaque object describing a gradient. It is returned by the methods CanvasRenderingContext2D.createLinearGradient() or CanvasRenderingContext2D.createRadialGradient(). */ +/** An opaque object describing a gradient. It is returned by the methods CanvasRenderingContext2D.createLinearGradient() or CanvasRenderingContext2D.createRadialGradient(). */ interface CanvasGradient { /** * Adds a color stop with the given color to the gradient at the given offset. 0.0 is the offset @@ -3133,7 +3193,7 @@ interface CanvasPathDrawingStyles { setLineDash(segments: number[]): void; } -/** The CanvasPattern interface represents an opaque object describing a pattern, based on an image, a canvas, or a video, created by the CanvasRenderingContext2D.createPattern() method. */ +/** An opaque object describing a pattern, based on an image, a canvas, or a video, created by the CanvasRenderingContext2D.createPattern() method. */ interface CanvasPattern { /** * Sets the transformation matrix that will be used when rendering the pattern during a fill or @@ -3311,7 +3371,7 @@ declare var Clipboard: { new(): Clipboard; }; -/** The ClipboardEvent interface represents events providing information related to modification of the clipboard, that is cut, copy, and paste events. */ +/** Events providing information related to modification of the clipboard, that is cut, copy, and paste events. */ interface ClipboardEvent extends Event { readonly clipboardData: DataTransfer | null; } @@ -3335,7 +3395,7 @@ declare var CloseEvent: { new(type: string, eventInitDict?: CloseEventInit): CloseEvent; }; -/** 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. Comments are represented in HTML and XML as content between ''. In XML, the character sequence '--' cannot be used within a comment. */ +/** Textual notations within markup; although it is generally not visually shown, such comments are available to be read in the source view. */ interface Comment extends CharacterData { } @@ -3365,7 +3425,7 @@ interface ConcatParams extends Algorithm { publicInfo?: Uint8Array; } -/** The Console object provides access to the browser's debugging console (e.g. the Web Console in Firefox). The specifics of how it works varies from browser to browser, but there is a de facto set of features that are typically provided. */ +/** Provides access to the browser's debugging console (e.g. the Web Console in Firefox). The specifics of how it works varies from browser to browser, but there is a de facto set of features that are typically provided. */ interface Console { memory: any; assert(condition?: boolean, message?: string, ...data: any[]): void; @@ -3412,7 +3472,7 @@ declare var ConstantSourceNode: { new(context: BaseAudioContext, options?: ConstantSourceOptions): ConstantSourceNode; }; -/** The ConvolverNode interface is an AudioNode that performs a Linear Convolution on a given AudioBuffer, often used to achieve a reverb effect. A ConvolverNode always has exactly one input and one output. */ +/** An AudioNode that performs a Linear Convolution on a given AudioBuffer, often used to achieve a reverb effect. A ConvolverNode always has exactly one input and one output. */ interface ConvolverNode extends AudioNode { buffer: AudioBuffer | null; normalize: boolean; @@ -3423,7 +3483,7 @@ declare var ConvolverNode: { new(context: BaseAudioContext, options?: ConvolverOptions): ConvolverNode; }; -/** The Coordinates interface represents the position and altitude of the device on Earth, as well as the accuracy with which these properties are calculated. */ +/** The position and altitude of the device on Earth, as well as the accuracy with which these properties are calculated. */ interface Coordinates { readonly accuracy: number; readonly altitude: number | null; @@ -3434,7 +3494,7 @@ interface Coordinates { readonly speed: number | null; } -/** The CountQueuingStrategy interface of the the Streams API provides a built-in byte length queuing strategy that can be used when constructing streams. */ +/** An interface of the Streams API provides a built-in byte length queuing strategy that can be used when constructing streams. */ interface CountQueuingStrategy extends QueuingStrategy { highWaterMark: number; size(chunk: any): 1; @@ -3445,7 +3505,7 @@ declare var CountQueuingStrategy: { new(options: { highWaterMark: number }): CountQueuingStrategy; }; -/** The Crypto interface represents basic cryptography features available in the current context. It allows access to a cryptographically strong random number generator and to cryptographic primitives. */ +/** Basic cryptography features available in the current context. It allows access to a cryptographically strong random number generator and to cryptographic primitives. */ interface Crypto { readonly subtle: SubtleCrypto; getRandomValues(array: T): T; @@ -3456,7 +3516,7 @@ declare var Crypto: { new(): Crypto; }; -/** The CryptoKey interface represents a cryptographic key derived from a specific key algorithm. */ +/** The CryptoKey dictionary of the Web Crypto API represents a cryptographic key. */ interface CryptoKey { readonly algorithm: KeyAlgorithm; readonly extractable: boolean; @@ -3469,6 +3529,7 @@ declare var CryptoKey: { new(): CryptoKey; }; +/** The CryptoKeyPair dictionary of the Web Crypto API represents a key pair for an asymmetric cryptography algorithm, also known as a public-key algorithm. */ interface CryptoKeyPair { privateKey: CryptoKey; publicKey: CryptoKey; @@ -3505,7 +3566,7 @@ declare var CustomEvent: { new(typeArg: string, eventInitDict?: CustomEventInit): CustomEvent; }; -/** The DOMError interface describes an error object that contains an error name. */ +/** An error object that contains an error name. */ interface DOMError { readonly name: string; toString(): string; @@ -3516,7 +3577,7 @@ declare var DOMError: { new(): DOMError; }; -/** The DOMException interface represents an abnormal event (called an exception) which occurs as a result of calling a method or accessing a property of a web API. */ +/** An abnormal event (called an exception) which occurs as a result of calling a method or accessing a property of a web API. */ interface DOMException { readonly code: number; readonly message: string; @@ -3578,7 +3639,7 @@ declare var DOMException: { readonly WRONG_DOCUMENT_ERR: number; }; -/** The DOMImplementation interface represent an object providing methods which are not dependent on any particular document. Such an object is returned by the Document.implementation property. */ +/** An object providing methods which are not dependent on any particular document. Such an object is returned by the Document.implementation property. */ interface DOMImplementation { createDocument(namespaceURI: string | null, qualifiedName: string | null, doctype: DocumentType | null): Document; createDocumentType(qualifiedName: string, publicId: string, systemId: string): DocumentType; @@ -3700,7 +3761,7 @@ declare var DOMMatrixReadOnly: { fromMatrix(other?: DOMMatrixInit): DOMMatrixReadOnly; }; -/** The DOMParser interface provides the ability to parse XML or HTML source code from a string into a DOM Document. */ +/** Provides the ability to parse XML or HTML source code from a string into a DOM Document. */ interface DOMParser { parseFromString(str: string, type: SupportedType): Document; } @@ -3844,7 +3905,7 @@ declare var DOMStringMap: { new(): DOMStringMap; }; -/** The DOMTokenList interface represents a set of space-separated tokens. Such a set is returned by Element.classList, HTMLLinkElement.relList, HTMLAnchorElement.relList, HTMLAreaElement.relList, HTMLIframeElement.sandbox, or HTMLOutputElement.htmlFor. It is indexed beginning with 0 as with JavaScript Array objects. DOMTokenList is always case-sensitive. */ +/** A set of space-separated tokens. Such a set is returned by Element.classList, HTMLLinkElement.relList, HTMLAnchorElement.relList, HTMLAreaElement.relList, HTMLIframeElement.sandbox, or HTMLOutputElement.htmlFor. It is indexed beginning with 0 as with JavaScript Array objects. DOMTokenList is always case-sensitive. */ interface DOMTokenList { /** * Returns the number of tokens. @@ -3917,7 +3978,7 @@ declare var DataCue: { new(): DataCue; }; -/** The DataTransfer object is used to hold the data that is being dragged during a drag and drop operation. It may hold one or more data items, each of one or more data types. For more information about drag and drop, see HTML Drag and Drop API. */ +/** Used to hold the data that is being dragged during a drag and drop operation. It may hold one or more data items, each of one or more data types. For more information about drag and drop, see HTML Drag and Drop API. */ interface DataTransfer { dropEffect: string; effectAllowed: string; @@ -3958,7 +4019,7 @@ declare var DataTransfer: { new(): DataTransfer; }; -/** The DataTransferItem object represents one drag data item. During a drag operation, each drag event has a dataTransfer property which contains a list of drag data items. Each item in the list is a DataTransferItem object. */ +/** One drag data item. During a drag operation, each drag event has a dataTransfer property which contains a list of drag data items. Each item in the list is a DataTransferItem object. */ interface DataTransferItem { /** * Returns the drag data item kind, one of: "string", @@ -3986,7 +4047,7 @@ declare var DataTransferItem: { new(): DataTransferItem; }; -/** The DataTransferItemList object is a list of DataTransferItem objects representing items being dragged. During a drag operation, each DragEvent has a dataTransfer property and that property is a DataTransferItemList. */ +/** A list of DataTransferItem objects representing items being dragged. During a drag operation, each DragEvent has a dataTransfer property and that property is a DataTransferItemList. */ interface DataTransferItemList { /** * Returns the number of items in the drag data store. @@ -4029,7 +4090,7 @@ declare var DeferredPermissionRequest: { new(): DeferredPermissionRequest; }; -/** The DelayNode interface represents a delay-line; an AudioNode audio-processing module that causes a delay between the arrival of an input data and its propagation to the output. */ +/** A delay-line; an AudioNode audio-processing module that causes a delay between the arrival of an input data and its propagation to the output. */ interface DelayNode extends AudioNode { readonly delayTime: AudioParam; } @@ -4039,7 +4100,7 @@ declare var DelayNode: { new(context: BaseAudioContext, options?: DelayOptions): DelayNode; }; -/** A DeviceAcceleration object provides information about the amount of acceleration the device is experiencing along all three axes. */ +/** Provides information about the amount of acceleration the device is experiencing along all three axes. */ interface DeviceAcceleration { readonly x: number | null; readonly y: number | null; @@ -4063,33 +4124,43 @@ declare var DeviceLightEvent: { /** The DeviceMotionEvent provides web developers with information about the speed of changes for the device's position and orientation. */ interface DeviceMotionEvent extends Event { - readonly acceleration: DeviceAcceleration | null; - readonly accelerationIncludingGravity: DeviceAcceleration | null; - readonly interval: number | null; - readonly rotationRate: DeviceRotationRate | null; - initDeviceMotionEvent(type: string, bubbles: boolean, cancelable: boolean, acceleration: DeviceAccelerationDict | null, accelerationIncludingGravity: DeviceAccelerationDict | null, rotationRate: DeviceRotationRateDict | null, interval: number | null): void; + readonly acceleration: DeviceMotionEventAcceleration | null; + readonly accelerationIncludingGravity: DeviceMotionEventAcceleration | null; + readonly interval: number; + readonly rotationRate: DeviceMotionEventRotationRate | null; } declare var DeviceMotionEvent: { prototype: DeviceMotionEvent; - new(typeArg: string, eventInitDict?: DeviceMotionEventInit): DeviceMotionEvent; + new(type: string, eventInitDict?: DeviceMotionEventInit): DeviceMotionEvent; }; +interface DeviceMotionEventAcceleration { + readonly x: number | null; + readonly y: number | null; + readonly z: number | null; +} + +interface DeviceMotionEventRotationRate { + readonly alpha: number | null; + readonly beta: number | null; + readonly gamma: number | null; +} + /** The DeviceOrientationEvent provides web developers with information from the physical orientation of the device running the web page. */ interface DeviceOrientationEvent extends Event { readonly absolute: boolean; readonly alpha: number | null; readonly beta: number | null; readonly gamma: number | null; - initDeviceOrientationEvent(type: string, bubbles: boolean, cancelable: boolean, alpha: number | null, beta: number | null, gamma: number | null, absolute: boolean): void; } declare var DeviceOrientationEvent: { prototype: DeviceOrientationEvent; - new(typeArg: string, eventInitDict?: DeviceOrientationEventInit): DeviceOrientationEvent; + new(type: string, eventInitDict?: DeviceOrientationEventInit): DeviceOrientationEvent; }; -/** A DeviceRotationRate object provides information about the rate at which the device is rotating around all three axes. */ +/** Provides information about the rate at which the device is rotating around all three axes. */ interface DeviceRotationRate { readonly alpha: number | null; readonly beta: number | null; @@ -4129,8 +4200,8 @@ interface DocumentEventMap extends GlobalEventHandlersEventMap, DocumentAndEleme "visibilitychange": Event; } -/** The Document interface represents any web page loaded in the browser and serves as an entry point into the web page's content, which is the DOM tree. */ -interface Document extends Node, NonElementParentNode, DocumentOrShadowRoot, ParentNode, GlobalEventHandlers, DocumentAndElementEventHandlers { +/** Any web page loaded in the browser and serves as an entry point into the web page's content, which is the DOM tree. */ +interface Document extends Node, NonElementParentNode, DocumentOrShadowRoot, ParentNode, XPathEvaluatorBase, GlobalEventHandlers, DocumentAndElementEventHandlers { /** * Sets or gets the URL for the current document. */ @@ -4386,10 +4457,6 @@ interface Document extends Node, NonElementParentNode, DocumentOrShadowRoot, Par */ createElementNS(namespaceURI: "http://www.w3.org/1999/xhtml", qualifiedName: string): HTMLElement; createElementNS(namespaceURI: "http://www.w3.org/2000/svg", qualifiedName: K): SVGElementTagNameMap[K]; - createElementNS(namespaceURI: "http://www.w3.org/2000/svg", qualifiedName: "a"): SVGAElement; - createElementNS(namespaceURI: "http://www.w3.org/2000/svg", qualifiedName: "script"): SVGScriptElement; - createElementNS(namespaceURI: "http://www.w3.org/2000/svg", qualifiedName: "style"): SVGStyleElement; - createElementNS(namespaceURI: "http://www.w3.org/2000/svg", qualifiedName: "title"): SVGTitleElement; createElementNS(namespaceURI: "http://www.w3.org/2000/svg", qualifiedName: string): SVGElement; createElementNS(namespaceURI: string | null, qualifiedName: string, options?: ElementCreationOptions): Element; createElementNS(namespace: string | null, qualifiedName: string, options?: string | ElementCreationOptions): Element; @@ -4515,7 +4582,6 @@ interface Document extends Node, NonElementParentNode, DocumentOrShadowRoot, Par */ elementFromPoint(x: number, y: number): Element | null; elementsFromPoint(x: number, y: number): Element[]; - evaluate(expression: string, contextNode: Node, resolver: XPathNSResolver | ((prefix: string) => string | null) | null, type: number, result: XPathResult | null): XPathResult; /** * Executes a command on the current document, current selection, or the given range. * @param commandId String that specifies the command to execute. This command can be any of the command identifiers that can be executed in script. @@ -4728,7 +4794,7 @@ interface DocumentEvent { createEvent(eventInterface: string): Event; } -/** The DocumentFragment interface represents a minimal document object that has no parent. It is used as a lightweight version of Document that stores a segment of a document structure comprised of nodes just like a standard document. The key difference is that because the document fragment isn't part of the active document tree structure, changes made to the fragment don't affect the document, cause reflow, or incur any performance impact that can occur when changes are made. */ +/** A minimal document object that has no parent. It is used as a lightweight version of Document that stores a segment of a document structure comprised of nodes just like a standard document. The key difference is that because the document fragment isn't part of the active document tree structure, changes made to the fragment don't affect the document, cause reflow, or incur any performance impact that can occur when changes are made. */ interface DocumentFragment extends Node, NonElementParentNode, ParentNode { getElementById(elementId: string): HTMLElement | null; } @@ -4762,7 +4828,7 @@ declare var DocumentTimeline: { new(options?: DocumentTimelineOptions): DocumentTimeline; }; -/** The DocumentType interface represents a Node containing a doctype. */ +/** A Node containing a doctype. */ interface DocumentType extends Node, ChildNode { readonly name: string; readonly publicId: string; @@ -4774,7 +4840,7 @@ declare var DocumentType: { new(): DocumentType; }; -/** The DragEvent interface is a DOM event that represents a drag and drop interaction. The user initiates a drag by placing a pointer device (such as a mouse) on the touch surface and then dragging the pointer to a new location (such as another DOM element). Applications are free to interpret a drag and drop interaction in an application-specific way. */ +/** A DOM event that represents a drag and drop interaction. The user initiates a drag by placing a pointer device (such as a mouse) on the touch surface and then dragging the pointer to a new location (such as another DOM element). Applications are free to interpret a drag and drop interaction in an application-specific way. */ interface DragEvent extends MouseEvent { /** * Returns the DataTransfer object for the event. @@ -4833,7 +4899,7 @@ interface ElementEventMap { } /** Element is the most general base class from which all objects in a Document inherit. It only has methods and properties common to all kinds of elements. More specific classes inherit from Element. */ -interface Element extends Node, ParentNode, NonDocumentTypeChildNode, ChildNode, Slotable, Animatable { +interface Element extends Node, ParentNode, NonDocumentTypeChildNode, ChildNode, Slotable, InnerHTML, Animatable { readonly assignedSlot: HTMLSlotElement | null; readonly attributes: NamedNodeMap; /** @@ -4855,7 +4921,6 @@ interface Element extends Node, ParentNode, NonDocumentTypeChildNode, ChildNode, * change it. */ id: string; - innerHTML: string; /** * Returns the local name. */ @@ -5010,11 +5075,7 @@ interface ElementContentEditable { readonly isContentEditable: boolean; } -interface ElementCreationOptions { - is?: string; -} - -/** The ErrorEvent interface represents events providing information related to errors in scripts or in files. */ +/** Events providing information related to errors in scripts or in files. */ interface ErrorEvent extends Event { readonly colno: number; readonly error: any; @@ -5028,7 +5089,7 @@ declare var ErrorEvent: { new(type: string, eventInitDict?: ErrorEventInit): ErrorEvent; }; -/** The Event interface represents any event which takes place in the DOM; some are user-generated (such as mouse or keyboard events), while others are generated by APIs (such as events that indicate an animation has finished running, a video has been paused, and so forth). While events are usually triggered by such "external" sources, they can also be triggered programmatically, such as by calling the HTMLElement.click() method of an element, or by defining the event, then sending it to a specified target using EventTarget.dispatchEvent(). There are many types of events, some of which use other interfaces based on the main Event interface. Event itself contains the properties and methods which are common to all events. */ +/** An event which takes place in the DOM. */ interface Event { /** * Returns true or false depending on how event was initialized. True if event goes through its target's ancestors in reverse tree order, and false otherwise. @@ -5145,7 +5206,7 @@ declare var EventSource: { readonly OPEN: number; }; -/** EventTarget is an interface implemented by objects that can receive events and may have listeners for them. */ +/** EventTarget is a DOM interface implemented by objects that can receive events and may have listeners for them. */ interface EventTarget { /** * Appends an event listener for events whose type attribute value is type. The callback argument sets the callback that will be invoked when the event is dispatched. @@ -5198,7 +5259,7 @@ interface External { IsSearchProviderInstalled(): void; } -/** The File interface provides information about files and allows JavaScript in a web page to access their content. */ +/** Provides information about files and allows JavaScript in a web page to access their content. */ interface File extends Blob { readonly lastModified: number; readonly name: string; @@ -5230,7 +5291,7 @@ interface FileReaderEventMap { "progress": ProgressEvent; } -/** The FileReader object lets web applications asynchronously read the contents of files (or raw data buffers) stored on the user's computer, using File or Blob objects to specify the file or data to read. */ +/** Lets web applications asynchronously read the contents of files (or raw data buffers) stored on the user's computer, using File or Blob objects to specify the file or data to read. */ interface FileReader extends EventTarget { readonly error: DOMException | null; onabort: ((this: FileReader, ev: ProgressEvent) => any) | null; @@ -5263,7 +5324,7 @@ declare var FileReader: { readonly LOADING: number; }; -/** The FocusEvent interface represents focus-related events like focus, blur, focusin, or focusout. */ +/** Focus-related events like focus, blur, focusin, or focusout. */ interface FocusEvent extends UIEvent { readonly relatedTarget: EventTarget; initFocusEvent(typeArg: string, canBubbleArg: boolean, cancelableArg: boolean, viewArg: Window, detailArg: number, relatedTargetArg: EventTarget): void; @@ -5288,7 +5349,7 @@ declare var FocusNavigationEvent: { new(type: string, eventInitDict?: FocusNavigationEventInit): FocusNavigationEvent; }; -/** The FormData interface provides a way to easily construct a set of key/value pairs representing form fields and their values, which can then be easily sent using the XMLHttpRequest.send() method. It uses the same format a form would use if the encoding type were set to "multipart/form-data". */ +/** Provides a way to easily construct a set of key/value pairs representing form fields and their values, which can then be easily sent using the XMLHttpRequest.send() method. It uses the same format a form would use if the encoding type were set to "multipart/form-data". */ interface FormData { append(name: string, value: string | Blob, fileName?: string): void; delete(name: string): void; @@ -5304,7 +5365,7 @@ declare var FormData: { new(form?: HTMLFormElement): FormData; }; -/** The GainNode interface represents a change in volume. It is an AudioNode audio-processing module that causes a given gain to be applied to the input data before its propagation to the output. A GainNode always has exactly one input and one output, both with the same number of channels. */ +/** A change in volume. It is an AudioNode audio-processing module that causes a given gain to be applied to the input data before its propagation to the output. A GainNode always has exactly one input and one output, both with the same number of channels. */ interface GainNode extends AudioNode { readonly gain: AudioParam; } @@ -5314,7 +5375,7 @@ declare var GainNode: { new(context: BaseAudioContext, options?: GainOptions): GainNode; }; -/** The Gamepad interface of the Gamepad API defines an individual gamepad or other controller, allowing access to information such as button presses, axis positions, and id. */ +/** An interface of the Gamepad API defines an individual gamepad or other controller, allowing access to information such as button presses, axis positions, and id. */ interface Gamepad { readonly axes: ReadonlyArray; readonly buttons: ReadonlyArray; @@ -5333,7 +5394,7 @@ declare var Gamepad: { new(): Gamepad; }; -/** The GamepadButton interface defines an individual button of a gamepad or other controller, allowing access to the current state of different types of buttons available on the control device. */ +/** An individual button of a gamepad or other controller, allowing access to the current state of different types of buttons available on the control device. */ interface GamepadButton { readonly pressed: boolean; readonly touched: boolean; @@ -5345,7 +5406,7 @@ declare var GamepadButton: { new(): GamepadButton; }; -/** The GamepadEvent interface of the Gamepad API contains references to gamepads connected to the system, which is what the gamepad events Window.gamepadconnected and Window.gamepaddisconnected are fired in response to. */ +/** An interface of the Gamepad API contains references to gamepads connected to the system, which is what the gamepad events Window.gamepadconnected and Window.gamepaddisconnected are fired in response to. */ interface GamepadEvent extends Event { readonly gamepad: Gamepad; } @@ -5355,7 +5416,7 @@ declare var GamepadEvent: { new(type: string, eventInitDict: GamepadEventInit): GamepadEvent; }; -/** The GamepadHapticActuator interface of the Gamepad API represents hardware in the controller designed to provide haptic feedback to the user (if available), most commonly vibration hardware. */ +/** An interface of the Gamepad API represents hardware in the controller designed to provide haptic feedback to the user (if available), most commonly vibration hardware. */ interface GamepadHapticActuator { readonly type: GamepadHapticActuatorType; pulse(value: number, duration: number): Promise; @@ -5366,7 +5427,7 @@ declare var GamepadHapticActuator: { new(): GamepadHapticActuator; }; -/** The GamepadPose interface of the Gamepad API represents the pose of a WebVR controller at a given timestamp (which includes orientation, position, velocity, and acceleration information.) */ +/** An interface of the Gamepad API represents the pose of a WebVR controller at a given timestamp (which includes orientation, position, velocity, and acceleration information.) */ interface GamepadPose { readonly angularAcceleration: Float32Array | null; readonly angularVelocity: Float32Array | null; @@ -5383,7 +5444,19 @@ declare var GamepadPose: { new(): GamepadPose; }; -/** The Geolocation interface represents an object able to programmatically obtain the position of the device. It gives Web content access to the location of the device. This allows a Web site or app to offer customized results based on the user's location. */ +interface GenericTransformStream { + readonly readable: ReadableStream; + /** + * Returns a writable stream which accepts string chunks and runs them through UTF-8's encoder before making them available to readable. + * Typically this will be used via the pipeThrough() method on a ReadableStream source. + * textReadable + * .pipeThrough(new TextEncoderStream()) + * .pipeTo(byteWritable); + */ + readonly writable: WritableStream; +} + +/** An object able to programmatically obtain the position of the device. It gives Web content access to the location of the device. This allows a Web site or app to offer customized results based on the user's location. */ interface Geolocation { clearWatch(watchId: number): void; getCurrentPosition(successCallback: PositionCallback, errorCallback?: PositionErrorCallback, options?: PositionOptions): void; @@ -5396,7 +5469,7 @@ interface GlobalEventHandlersEventMap { "animationend": AnimationEvent; "animationiteration": AnimationEvent; "animationstart": AnimationEvent; - "auxclick": Event; + "auxclick": MouseEvent; "blur": FocusEvent; "cancel": Event; "canplay": Event; @@ -5489,7 +5562,7 @@ interface GlobalEventHandlers { onanimationend: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null; onanimationiteration: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null; onanimationstart: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null; - onauxclick: ((this: GlobalEventHandlers, ev: Event) => any) | null; + onauxclick: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null; /** * Fires when the object loses the input focus. * @param ev The focus event. @@ -5777,7 +5850,7 @@ declare var HTMLAllCollection: { new(): HTMLAllCollection; }; -/** The HTMLAnchorElement interface represents hyperlink elements and provides special properties and methods (beyond those of the regular HTMLElement object interface that they inherit from) for manipulating the layout and presentation of such elements. */ +/** Hyperlink elements and provides special properties and methods (beyond those of the regular HTMLElement object interface that they inherit from) for manipulating the layout and presentation of such elements. */ interface HTMLAnchorElement extends HTMLElement, HTMLHyperlinkElementUtils { /** * Sets or retrieves the character set used to encode the object. @@ -5886,7 +5959,7 @@ declare var HTMLAppletElement: { new(): HTMLAppletElement; }; -/** The HTMLAreaElement interface provides special properties and methods (beyond those of the regular object HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of area elements. */ +/** Provides special properties and methods (beyond those of the regular object HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of elements. */ interface HTMLAreaElement extends HTMLElement, HTMLHyperlinkElementUtils { /** * Sets or retrieves a text alternative to the graphic. @@ -5925,7 +5998,7 @@ declare var HTMLAreaElement: { new(): HTMLAreaElement; }; -/** The HTMLAudioElement interface provides access to the properties of elements, as well as methods to manipulate them. It derives from the HTMLMediaElement interface. */ +/** Provides access to the properties of elements, as well as methods to manipulate them. It derives from the HTMLMediaElement interface. */ interface HTMLAudioElement extends HTMLMediaElement { addEventListener(type: K, listener: (this: HTMLAudioElement, ev: HTMLMediaElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void; @@ -5938,7 +6011,7 @@ declare var HTMLAudioElement: { new(): HTMLAudioElement; }; -/** The HTMLBRElement interface represents a HTML line break element (). It inherits from HTMLElement. */ +/** A HTML line break element (). It inherits from HTMLElement. */ interface HTMLBRElement extends HTMLElement { /** * Sets or retrieves the side on which floating objects are not to be positioned when any IHTMLBlockElement is inserted into the document. @@ -5956,7 +6029,7 @@ declare var HTMLBRElement: { new(): HTMLBRElement; }; -/** The HTMLBaseElement interface contains the base URI for a document. This object inherits all of the properties and methods as described in the HTMLElement interface. */ +/** Contains the base URI for a document. This object inherits all of the properties and methods as described in the HTMLElement interface. */ interface HTMLBaseElement extends HTMLElement { /** * Gets or sets the baseline URL on which relative links are based. @@ -5977,7 +6050,7 @@ declare var HTMLBaseElement: { new(): HTMLBaseElement; }; -/** The HTMLBaseFontElement interface provides special properties (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating elements. */ +/** Provides special properties (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating elements. */ interface HTMLBaseFontElement extends HTMLElement, DOML2DeprecatedColorProperty { /** * Sets or retrieves the current typeface family. @@ -6004,7 +6077,7 @@ interface HTMLBodyElementEventMap extends HTMLElementEventMap, WindowEventHandle "orientationchange": Event; } -/** The HTMLBodyElement interface provides special properties (beyond those of the regular HTMLElement interface they also inherit) for manipulating body elements. */ +/** Provides special properties (beyond those inherited from the regular HTMLElement interface) for manipulating elements. */ interface HTMLBodyElement extends HTMLElement, WindowEventHandlers { /** @deprecated */ aLink: string; @@ -6034,7 +6107,7 @@ declare var HTMLBodyElement: { new(): HTMLBodyElement; }; -/** The HTMLButtonElement interface provides properties and methods (beyond the object interface it also has available to them by inheritance) for manipulating the layout and presentation of button elements. */ +/** Provides properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating elements. */ interface HTMLButtonElement extends HTMLElement { /** * Provides a way to direct a user to a specific field when a document loads. This can provide both direction and convenience for a user, reducing the need to click or tab to a field when a page opens. This attribute is true when present on an element, and false when missing. @@ -6111,7 +6184,7 @@ declare var HTMLButtonElement: { new(): HTMLButtonElement; }; -/** The HTMLCanvasElement interface provides properties and methods for manipulating the layout and presentation of elements. The HTMLCanvasElement interface also inherits the properties and methods of the HTMLElement interface. */ +/** Provides properties and methods for manipulating the layout and presentation of elements. The HTMLCanvasElement interface also inherits the properties and methods of the HTMLElement interface. */ interface HTMLCanvasElement extends HTMLElement { /** * Gets or sets the height of a canvas element on a document. @@ -6134,6 +6207,7 @@ interface HTMLCanvasElement extends HTMLElement { * @param type The standard MIME type for the image format to return. If you do not specify this parameter, the default value is a PNG format image. */ toDataURL(type?: string, quality?: any): string; + transferControlToOffscreen(): OffscreenCanvas; addEventListener(type: K, listener: (this: HTMLCanvasElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void; removeEventListener(type: K, listener: (this: HTMLCanvasElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void; @@ -6145,7 +6219,7 @@ declare var HTMLCanvasElement: { new(): HTMLCanvasElement; }; -/** The HTMLCollection interface represents a generic collection (array-like object similar to arguments) of elements (in document order) and offers methods and properties for selecting from the list. */ +/** A generic collection (array-like object similar to arguments) of elements (in document order) and offers methods and properties for selecting from the list. */ interface HTMLCollectionBase { /** * Sets or retrieves the number of objects in a collection. @@ -6176,7 +6250,7 @@ interface HTMLCollectionOf extends HTMLCollectionBase { [index: number]: T; } -/** The HTMLDListElement interface provides special properties (beyond those of the regular HTMLElement interface it also has available to it by inheritance) for manipulating definition list elements. */ +/** Provides special properties (beyond those of the regular HTMLElement interface it also has available to it by inheritance) for manipulating definition list () elements. */ interface HTMLDListElement extends HTMLElement { /** @deprecated */ compact: boolean; @@ -6191,7 +6265,7 @@ declare var HTMLDListElement: { new(): HTMLDListElement; }; -/** The HTMLDataElement interface provides special properties (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating elements. */ +/** Provides special properties (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating elements. */ interface HTMLDataElement extends HTMLElement { value: string; addEventListener(type: K, listener: (this: HTMLDataElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; @@ -6205,7 +6279,7 @@ declare var HTMLDataElement: { new(): HTMLDataElement; }; -/** The HTMLDataListElement interface provides special properties (beyond the HTMLElement object interface it also has available to it by inheritance) to manipulate elements and their content. */ +/** Provides special properties (beyond the HTMLElement object interface it also has available to it by inheritance) to manipulate elements and their content. */ interface HTMLDataListElement extends HTMLElement { readonly options: HTMLCollectionOf; addEventListener(type: K, listener: (this: HTMLDataListElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; @@ -6263,7 +6337,7 @@ declare var HTMLDirectoryElement: { new(): HTMLDirectoryElement; }; -/** The HTMLDivElement interface provides special properties (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating elements. */ +/** Provides special properties (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating elements. */ interface HTMLDivElement extends HTMLElement { /** * Sets or retrieves how the object is aligned with adjacent text. @@ -6297,7 +6371,7 @@ declare var HTMLDocument: { interface HTMLElementEventMap extends ElementEventMap, GlobalEventHandlersEventMap, DocumentAndElementEventHandlersEventMap { } -/** The HTMLElement interface represents any HTML element. Some elements directly implement this interface, others implement it via an interface that inherits it. */ +/** Any HTML element. Some elements directly implement this interface, while others implement it via an interface that inherits it. */ interface HTMLElement extends Element, GlobalEventHandlers, DocumentAndElementEventHandlers, ElementContentEditable, HTMLOrSVGElement, ElementCSSInlineStyle { accessKey: string; readonly accessKeyLabel: string; @@ -6327,7 +6401,7 @@ declare var HTMLElement: { new(): HTMLElement; }; -/** The HTMLEmbedElement interface, which provides special properties (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating elements. */ +/** Provides special properties (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating elements. */ interface HTMLEmbedElement extends HTMLElement { /** @deprecated */ align: string; @@ -6361,7 +6435,7 @@ declare var HTMLEmbedElement: { new(): HTMLEmbedElement; }; -/** The HTMLFieldSetElement interface has special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of field-set elements. */ +/** Provides special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of elements. */ interface HTMLFieldSetElement extends HTMLElement { disabled: boolean; readonly elements: HTMLCollection; @@ -6426,7 +6500,7 @@ declare var HTMLFontElement: { new(): HTMLFontElement; }; -/** The HTMLFormControlsCollection interface represents a collection of HTML form control elements. */ +/** A collection of HTML form control elements. */ interface HTMLFormControlsCollection extends HTMLCollectionBase { /** * element = collection[name] @@ -6439,7 +6513,7 @@ declare var HTMLFormControlsCollection: { new(): HTMLFormControlsCollection; }; -/** The HTMLFormElement interface represents a element in the DOM; it allows access to and in some cases modification of aspects of the form, as well as access to its component elements. */ +/** A element in the DOM; it allows access to and in some cases modification of aspects of the form, as well as access to its component elements. */ interface HTMLFormElement extends HTMLElement { /** * Sets or retrieves a list of character encodings for input data that must be accepted by the server processing the form. @@ -6576,7 +6650,7 @@ declare var HTMLFrameElement: { interface HTMLFrameSetElementEventMap extends HTMLElementEventMap, WindowEventHandlersEventMap { } -/** The HTMLFrameSetElement interface provides special properties (beyond those of the regular HTMLElement interface they also inherit) for manipulating elements. */ +/** Provides special properties (beyond those of the regular HTMLElement interface they also inherit) for manipulating elements. */ interface HTMLFrameSetElement extends HTMLElement, WindowEventHandlers { /** * Sets or retrieves the frame widths of the object. @@ -6599,7 +6673,7 @@ declare var HTMLFrameSetElement: { new(): HTMLFrameSetElement; }; -/** The HTMLHRElement interface provides special properties (beyond those of the HTMLElement interface it also has available to it by inheritance) for manipulating elements. */ +/** Provides special properties (beyond those of the HTMLElement interface it also has available to it by inheritance) for manipulating elements. */ interface HTMLHRElement extends HTMLElement { /** * Sets or retrieves how the object is aligned with adjacent text. @@ -6631,7 +6705,7 @@ declare var HTMLHRElement: { new(): HTMLHRElement; }; -/** The HTMLHeadElement interface contains the descriptive information, or metadata, for a document. This object inherits all of the properties and methods described in the HTMLElement interface. */ +/** Contains the descriptive information, or metadata, for a document. This object inherits all of the properties and methods described in the HTMLElement interface. */ interface HTMLHeadElement extends HTMLElement { addEventListener(type: K, listener: (this: HTMLHeadElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void; @@ -6644,7 +6718,7 @@ declare var HTMLHeadElement: { new(): HTMLHeadElement; }; -/** The HTMLHeadingElement interface represents the different heading elements. It inherits methods and properties from the HTMLElement interface. */ +/** The different heading elements. It inherits methods and properties from the HTMLElement interface. */ interface HTMLHeadingElement extends HTMLElement { /** * Sets or retrieves a value that indicates the table alignment. @@ -6662,7 +6736,7 @@ declare var HTMLHeadingElement: { new(): HTMLHeadingElement; }; -/** The HTMLHtmlElement interface serves as the root node for a given HTML document. This object inherits the properties and methods described in the HTMLElement interface. */ +/** Serves as the root node for a given HTML document. This object inherits the properties and methods described in the HTMLElement interface. */ interface HTMLHtmlElement extends HTMLElement { /** * Sets or retrieves the DTD version that governs the current document. @@ -6694,7 +6768,7 @@ interface HTMLHyperlinkElementUtils { username: string; } -/** The HTMLIFrameElement interface provides special properties and methods (beyond those of the HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of inline frame elements. */ +/** Provides special properties and methods (beyond those of the HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of inline frame elements. */ interface HTMLIFrameElement extends HTMLElement { /** * Sets or retrieves how the object is aligned with adjacent text. @@ -6771,7 +6845,7 @@ declare var HTMLIFrameElement: { new(): HTMLIFrameElement; }; -/** The HTMLImageElement interface provides special properties and methods for manipulating the layout and presentation of elements. */ +/** Provides special properties and methods for manipulating elements. */ interface HTMLImageElement extends HTMLElement { /** * Sets or retrieves how the object is aligned with adjacent text. @@ -6861,7 +6935,7 @@ declare var HTMLImageElement: { new(): HTMLImageElement; }; -/** The HTMLInputElement interface provides special properties and methods for manipulating the options, layout, and presentation of elements. */ +/** Provides special properties and methods for manipulating the options, layout, and presentation of elements. */ interface HTMLInputElement extends HTMLElement { /** * Sets or retrieves a comma-separated list of content types. @@ -7009,7 +7083,10 @@ interface HTMLInputElement extends HTMLElement { * Returns the value of the data at the cursor's current position. */ value: string; - valueAsDate: any; + /** + * Returns a Date object representing the form control's value, if applicable; otherwise, returns null. Can be set, to change the value. Throws an "InvalidStateError" DOMException if the control isn't date- or time-based. + */ + valueAsDate: Date | null; /** * Returns the input field value as a number. */ @@ -7066,7 +7143,7 @@ declare var HTMLInputElement: { new(): HTMLInputElement; }; -/** The HTMLLIElement interface exposes specific properties and methods (beyond those defined by regular HTMLElement interface it also has available to it by inheritance) for manipulating list elements. */ +/** Exposes specific properties and methods (beyond those defined by regular HTMLElement interface it also has available to it by inheritance) for manipulating list elements. */ interface HTMLLIElement extends HTMLElement { /** @deprecated */ type: string; @@ -7085,7 +7162,7 @@ declare var HTMLLIElement: { new(): HTMLLIElement; }; -/** The HTMLLabelElement interface gives access to properties specific to elements. It inherits methods and properties from the base HTMLElement interface. */ +/** Gives access to properties specific to elements. It inherits methods and properties from the base HTMLElement interface. */ interface HTMLLabelElement extends HTMLElement { readonly control: HTMLElement | null; /** @@ -7126,7 +7203,7 @@ declare var HTMLLegendElement: { new(): HTMLLegendElement; }; -/** The HTMLLinkElement interface represents reference information for external resources and the relationship of those resources to a document and vice-versa. This object inherits all of the properties and methods of the HTMLElement interface. */ +/** Reference information for external resources and the relationship of those resources to a document and vice-versa. This object inherits all of the properties and methods of the HTMLElement interface. */ interface HTMLLinkElement extends HTMLElement, LinkStyle { as: string; /** @@ -7144,6 +7221,8 @@ interface HTMLLinkElement extends HTMLElement, LinkStyle { * Sets or retrieves the language code of the object. */ hreflang: string; + imageSizes: string; + imageSrcset: string; integrity: string; /** * Sets or retrieves the media type. @@ -7181,19 +7260,7 @@ declare var HTMLLinkElement: { new(): HTMLLinkElement; }; -interface HTMLMainElement extends HTMLElement { - addEventListener(type: K, listener: (this: HTMLMainElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; - addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void; - removeEventListener(type: K, listener: (this: HTMLMainElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void; - removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void; -} - -declare var HTMLMainElement: { - prototype: HTMLMainElement; - new(): HTMLMainElement; -}; - -/** The HTMLMapElement interface provides special properties and methods (beyond those of the regular object HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of map elements. */ +/** Provides special properties and methods (beyond those of the regular object HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of map elements. */ interface HTMLMapElement extends HTMLElement { /** * Retrieves a collection of the area objects defined for the given map object. @@ -7220,7 +7287,7 @@ interface HTMLMarqueeElementEventMap extends HTMLElementEventMap { "start": Event; } -/** The HTMLMarqueeElement interface provides methods to manipulate elements. */ +/** Provides methods to manipulate elements. */ interface HTMLMarqueeElement extends HTMLElement { /** @deprecated */ behavior: string; @@ -7271,7 +7338,7 @@ interface HTMLMediaElementEventMap extends HTMLElementEventMap { "waitingforkey": Event; } -/** The HTMLMediaElement interface adds to HTMLElement the properties and methods needed to support basic media-related capabilities that are common to audio and video. */ +/** Adds to HTMLElement the properties and methods needed to support basic media-related capabilities that are common to audio and video. */ interface HTMLMediaElement extends HTMLElement { /** * Returns an AudioTrackList object with the audio tracks for a given video element. @@ -7478,7 +7545,7 @@ declare var HTMLMenuElement: { new(): HTMLMenuElement; }; -/** The HTMLMetaElement interface contains descriptive metadata about a document. It inherits all of the properties and methods described in the HTMLElement interface. */ +/** Contains descriptive metadata about a document. It inherits all of the properties and methods described in the HTMLElement interface. */ interface HTMLMetaElement extends HTMLElement { /** * Gets or sets meta-information to associate with httpEquiv or name. @@ -7528,7 +7595,7 @@ declare var HTMLMeterElement: { new(): HTMLMeterElement; }; -/** The HTMLModElement interface provides special properties (beyond the regular methods and properties available through the HTMLElement interface they also have available to them by inheritance) for manipulating modification elements, that is and . */ +/** Provides special properties (beyond the regular methods and properties available through the HTMLElement interface they also have available to them by inheritance) for manipulating modification elements, that is and . */ interface HTMLModElement extends HTMLElement { /** * Sets or retrieves reference information about the object. @@ -7549,7 +7616,7 @@ declare var HTMLModElement: { new(): HTMLModElement; }; -/** The HTMLOListElement interface provides special properties (beyond those defined on the regular HTMLElement interface it also has available to it by inheritance) for manipulating ordered list elements. */ +/** Provides special properties (beyond those defined on the regular HTMLElement interface it also has available to it by inheritance) for manipulating ordered list elements. */ interface HTMLOListElement extends HTMLElement { /** @deprecated */ compact: boolean; @@ -7570,7 +7637,7 @@ declare var HTMLOListElement: { new(): HTMLOListElement; }; -/** The HTMLObjectElement interface provides special properties and methods (beyond those on the HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of element, representing external resources. */ +/** Provides special properties and methods (beyond those on the HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of element, representing external resources. */ interface HTMLObjectElement extends HTMLElement { /** @deprecated */ align: string; @@ -7675,7 +7742,7 @@ declare var HTMLObjectElement: { new(): HTMLObjectElement; }; -/** The HTMLOptGroupElement interface provides special properties and methods (beyond the regular HTMLElement object interface they also have available to them by inheritance) for manipulating the layout and presentation of elements. */ +/** Provides special properties and methods (beyond the regular HTMLElement object interface they also have available to them by inheritance) for manipulating the layout and presentation of elements. */ interface HTMLOptGroupElement extends HTMLElement { disabled: boolean; /** @@ -7697,7 +7764,7 @@ declare var HTMLOptGroupElement: { new(): HTMLOptGroupElement; }; -/** The HTMLOptionElement interface represents elements and inherits all classes and methods of the HTMLElement interface. */ +/** elements and inherits all classes and methods of the HTMLElement interface. */ interface HTMLOptionElement extends HTMLElement { /** * Sets or retrieves the status of an option. @@ -7781,7 +7848,7 @@ interface HTMLOrSVGElement { focus(options?: FocusOptions): void; } -/** The HTMLOutputElement interface provides properties and methods (beyond those inherited from HTMLElement) for manipulating the layout and presentation of elements. */ +/** Provides properties and methods (beyond those inherited from HTMLElement) for manipulating the layout and presentation of elements. */ interface HTMLOutputElement extends HTMLElement { defaultValue: string; readonly form: HTMLFormElement | null; @@ -7807,7 +7874,7 @@ declare var HTMLOutputElement: { new(): HTMLOutputElement; }; -/** The HTMLParagraphElement interface provides special properties (beyond those of the regular HTMLElement object interface it inherits) for manipulating elements. */ +/** Provides special properties (beyond those of the regular HTMLElement object interface it inherits) for manipulating elements. */ interface HTMLParagraphElement extends HTMLElement { /** * Sets or retrieves how the object is aligned with adjacent text. @@ -7825,7 +7892,7 @@ declare var HTMLParagraphElement: { new(): HTMLParagraphElement; }; -/** The HTMLParamElement interface provides special properties (beyond those of the regular HTMLElement object interface it inherits) for manipulating elements, representing a pair of a key and a value that acts as a parameter for an element. */ +/** Provides special properties (beyond those of the regular HTMLElement object interface it inherits) for manipulating elements, representing a pair of a key and a value that acts as a parameter for an element. */ interface HTMLParamElement extends HTMLElement { /** * Sets or retrieves the name of an input parameter for an element. @@ -7856,7 +7923,7 @@ declare var HTMLParamElement: { new(): HTMLParamElement; }; -/** The HTMLPictureElement interface represents a HTML element. It doesn't implement specific properties or methods. */ +/** A HTML element. It doesn't implement specific properties or methods. */ interface HTMLPictureElement extends HTMLElement { addEventListener(type: K, listener: (this: HTMLPictureElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void; @@ -7869,7 +7936,7 @@ declare var HTMLPictureElement: { new(): HTMLPictureElement; }; -/** The HTMLPreElement interface expose specific properties and methods (beyond those defined by regular HTMLElement interface it also has available to it by inheritance) for manipulating block of preformatted text. */ +/** Exposes specific properties and methods (beyond those of the HTMLElement interface it also has available to it by inheritance) for manipulating a block of preformatted text (). */ interface HTMLPreElement extends HTMLElement { /** * Sets or gets a value that you can use to implement your own width functionality for the object. @@ -7887,7 +7954,7 @@ declare var HTMLPreElement: { new(): HTMLPreElement; }; -/** The HTMLProgressElement interface provides special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of elements. */ +/** Provides special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of elements. */ interface HTMLProgressElement extends HTMLElement { readonly labels: NodeListOf; /** @@ -7913,7 +7980,7 @@ declare var HTMLProgressElement: { new(): HTMLProgressElement; }; -/** The HTMLQuoteElement interface provides special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating quoting elements, like and , but not the element. */ +/** Provides special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating quoting elements, like and , but not the element. */ interface HTMLQuoteElement extends HTMLElement { /** * Sets or retrieves reference information about the object. @@ -7979,7 +8046,7 @@ declare var HTMLScriptElement: { new(): HTMLScriptElement; }; -/** The HTMLSelectElement interface represents a HTML Element. These elements also share all of the properties and methods of other HTML elements via the HTMLElement interface. */ +/** A HTML Element. These elements also share all of the properties and methods of other HTML elements via the HTMLElement interface. */ interface HTMLSelectElement extends HTMLElement { autocomplete: string; /** @@ -8098,7 +8165,7 @@ declare var HTMLSlotElement: { new(): HTMLSlotElement; }; -/** The HTMLSourceElement interface provides special properties (beyond the regular HTMLElement object interface it also has available to it by inheritance) for manipulating elements. */ +/** Provides special properties (beyond the regular HTMLElement object interface it also has available to it by inheritance) for manipulating elements. */ interface HTMLSourceElement extends HTMLElement { /** * Gets or sets the intended media type of the media source. @@ -8125,7 +8192,7 @@ declare var HTMLSourceElement: { new(): HTMLSourceElement; }; -/** The HTMLSpanElement interface represents a element and derives from the HTMLElement interface, but without implementing any additional properties or methods. */ +/** A element and derives from the HTMLElement interface, but without implementing any additional properties or methods. */ interface HTMLSpanElement extends HTMLElement { addEventListener(type: K, listener: (this: HTMLSpanElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void; @@ -8138,7 +8205,7 @@ declare var HTMLSpanElement: { new(): HTMLSpanElement; }; -/** The HTMLStyleElement interface represents a
elements. */ +/** Provides special properties (beyond those of the regular HTMLElement object interface it inherits) for manipulating
elements. */ interface HTMLParagraphElement extends HTMLElement { /** * Sets or retrieves how the object is aligned with adjacent text. @@ -7825,7 +7892,7 @@ declare var HTMLParagraphElement: { new(): HTMLParagraphElement; }; -/** The HTMLParamElement interface provides special properties (beyond those of the regular HTMLElement object interface it inherits) for manipulating elements, representing a pair of a key and a value that acts as a parameter for an element. */ +/** Provides special properties (beyond those of the regular HTMLElement object interface it inherits) for manipulating elements, representing a pair of a key and a value that acts as a parameter for an element. */ interface HTMLParamElement extends HTMLElement { /** * Sets or retrieves the name of an input parameter for an element. @@ -7856,7 +7923,7 @@ declare var HTMLParamElement: { new(): HTMLParamElement; }; -/** The HTMLPictureElement interface represents a HTML element. It doesn't implement specific properties or methods. */ +/** A HTML element. It doesn't implement specific properties or methods. */ interface HTMLPictureElement extends HTMLElement { addEventListener(type: K, listener: (this: HTMLPictureElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void; @@ -7869,7 +7936,7 @@ declare var HTMLPictureElement: { new(): HTMLPictureElement; }; -/** The HTMLPreElement interface expose specific properties and methods (beyond those defined by regular HTMLElement interface it also has available to it by inheritance) for manipulating block of preformatted text. */ +/** Exposes specific properties and methods (beyond those of the HTMLElement interface it also has available to it by inheritance) for manipulating a block of preformatted text (). */ interface HTMLPreElement extends HTMLElement { /** * Sets or gets a value that you can use to implement your own width functionality for the object. @@ -7887,7 +7954,7 @@ declare var HTMLPreElement: { new(): HTMLPreElement; }; -/** The HTMLProgressElement interface provides special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of elements. */ +/** Provides special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of elements. */ interface HTMLProgressElement extends HTMLElement { readonly labels: NodeListOf; /** @@ -7913,7 +7980,7 @@ declare var HTMLProgressElement: { new(): HTMLProgressElement; }; -/** The HTMLQuoteElement interface provides special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating quoting elements, like and , but not the element. */ +/** Provides special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating quoting elements, like and , but not the element. */ interface HTMLQuoteElement extends HTMLElement { /** * Sets or retrieves reference information about the object. @@ -7979,7 +8046,7 @@ declare var HTMLScriptElement: { new(): HTMLScriptElement; }; -/** The HTMLSelectElement interface represents a HTML Element. These elements also share all of the properties and methods of other HTML elements via the HTMLElement interface. */ +/** A HTML Element. These elements also share all of the properties and methods of other HTML elements via the HTMLElement interface. */ interface HTMLSelectElement extends HTMLElement { autocomplete: string; /** @@ -8098,7 +8165,7 @@ declare var HTMLSlotElement: { new(): HTMLSlotElement; }; -/** The HTMLSourceElement interface provides special properties (beyond the regular HTMLElement object interface it also has available to it by inheritance) for manipulating elements. */ +/** Provides special properties (beyond the regular HTMLElement object interface it also has available to it by inheritance) for manipulating elements. */ interface HTMLSourceElement extends HTMLElement { /** * Gets or sets the intended media type of the media source. @@ -8125,7 +8192,7 @@ declare var HTMLSourceElement: { new(): HTMLSourceElement; }; -/** The HTMLSpanElement interface represents a element and derives from the HTMLElement interface, but without implementing any additional properties or methods. */ +/** A element and derives from the HTMLElement interface, but without implementing any additional properties or methods. */ interface HTMLSpanElement extends HTMLElement { addEventListener(type: K, listener: (this: HTMLSpanElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void; @@ -8138,7 +8205,7 @@ declare var HTMLSpanElement: { new(): HTMLSpanElement; }; -/** The HTMLStyleElement interface represents a
). */ interface HTMLPreElement extends HTMLElement { /** * Sets or gets a value that you can use to implement your own width functionality for the object. @@ -7887,7 +7954,7 @@ declare var HTMLPreElement: { new(): HTMLPreElement; }; -/** The HTMLProgressElement interface provides special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of elements. */ +/** Provides special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating the layout and presentation of elements. */ interface HTMLProgressElement extends HTMLElement { readonly labels: NodeListOf; /** @@ -7913,7 +7980,7 @@ declare var HTMLProgressElement: { new(): HTMLProgressElement; }; -/** The HTMLQuoteElement interface provides special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating quoting elements, like and , but not the element. */ +/** Provides special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating quoting elements, like and , but not the element. */ interface HTMLQuoteElement extends HTMLElement { /** * Sets or retrieves reference information about the object. @@ -7979,7 +8046,7 @@ declare var HTMLScriptElement: { new(): HTMLScriptElement; }; -/** The HTMLSelectElement interface represents a HTML Element. These elements also share all of the properties and methods of other HTML elements via the HTMLElement interface. */ +/** A HTML Element. These elements also share all of the properties and methods of other HTML elements via the HTMLElement interface. */ interface HTMLSelectElement extends HTMLElement { autocomplete: string; /** @@ -8098,7 +8165,7 @@ declare var HTMLSlotElement: { new(): HTMLSlotElement; }; -/** The HTMLSourceElement interface provides special properties (beyond the regular HTMLElement object interface it also has available to it by inheritance) for manipulating elements. */ +/** Provides special properties (beyond the regular HTMLElement object interface it also has available to it by inheritance) for manipulating elements. */ interface HTMLSourceElement extends HTMLElement { /** * Gets or sets the intended media type of the media source. @@ -8125,7 +8192,7 @@ declare var HTMLSourceElement: { new(): HTMLSourceElement; }; -/** The HTMLSpanElement interface represents a element and derives from the HTMLElement interface, but without implementing any additional properties or methods. */ +/** A element and derives from the HTMLElement interface, but without implementing any additional properties or methods. */ interface HTMLSpanElement extends HTMLElement { addEventListener(type: K, listener: (this: HTMLSpanElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void; @@ -8138,7 +8205,7 @@ declare var HTMLSpanElement: { new(): HTMLSpanElement; }; -/** The HTMLStyleElement interface represents a
and , but not the element. */ +/** Provides special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating quoting elements, like and , but not the element. */ interface HTMLQuoteElement extends HTMLElement { /** * Sets or retrieves reference information about the object. @@ -7979,7 +8046,7 @@ declare var HTMLScriptElement: { new(): HTMLScriptElement; }; -/** The HTMLSelectElement interface represents a HTML Element. These elements also share all of the properties and methods of other HTML elements via the HTMLElement interface. */ +/** A HTML Element. These elements also share all of the properties and methods of other HTML elements via the HTMLElement interface. */ interface HTMLSelectElement extends HTMLElement { autocomplete: string; /** @@ -8098,7 +8165,7 @@ declare var HTMLSlotElement: { new(): HTMLSlotElement; }; -/** The HTMLSourceElement interface provides special properties (beyond the regular HTMLElement object interface it also has available to it by inheritance) for manipulating elements. */ +/** Provides special properties (beyond the regular HTMLElement object interface it also has available to it by inheritance) for manipulating elements. */ interface HTMLSourceElement extends HTMLElement { /** * Gets or sets the intended media type of the media source. @@ -8125,7 +8192,7 @@ declare var HTMLSourceElement: { new(): HTMLSourceElement; }; -/** The HTMLSpanElement interface represents a element and derives from the HTMLElement interface, but without implementing any additional properties or methods. */ +/** A element and derives from the HTMLElement interface, but without implementing any additional properties or methods. */ interface HTMLSpanElement extends HTMLElement { addEventListener(type: K, listener: (this: HTMLSpanElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void; @@ -8138,7 +8205,7 @@ declare var HTMLSpanElement: { new(): HTMLSpanElement; }; -/** The HTMLStyleElement interface represents a
, but not the element. */ +/** Provides special properties and methods (beyond the regular HTMLElement interface it also has available to it by inheritance) for manipulating quoting elements, like and , but not the element. */ interface HTMLQuoteElement extends HTMLElement { /** * Sets or retrieves reference information about the object. @@ -7979,7 +8046,7 @@ declare var HTMLScriptElement: { new(): HTMLScriptElement; }; -/** The HTMLSelectElement interface represents a HTML Element. These elements also share all of the properties and methods of other HTML elements via the HTMLElement interface. */ +/** A HTML Element. These elements also share all of the properties and methods of other HTML elements via the HTMLElement interface. */ interface HTMLSelectElement extends HTMLElement { autocomplete: string; /** @@ -8098,7 +8165,7 @@ declare var HTMLSlotElement: { new(): HTMLSlotElement; }; -/** The HTMLSourceElement interface provides special properties (beyond the regular HTMLElement object interface it also has available to it by inheritance) for manipulating elements. */ +/** Provides special properties (beyond the regular HTMLElement object interface it also has available to it by inheritance) for manipulating elements. */ interface HTMLSourceElement extends HTMLElement { /** * Gets or sets the intended media type of the media source. @@ -8125,7 +8192,7 @@ declare var HTMLSourceElement: { new(): HTMLSourceElement; }; -/** The HTMLSpanElement interface represents a element and derives from the HTMLElement interface, but without implementing any additional properties or methods. */ +/** A element and derives from the HTMLElement interface, but without implementing any additional properties or methods. */ interface HTMLSpanElement extends HTMLElement { addEventListener(type: K, listener: (this: HTMLSpanElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void; @@ -8138,7 +8205,7 @@ declare var HTMLSpanElement: { new(): HTMLSpanElement; }; -/** The HTMLStyleElement interface represents a
and , but not the element. */ interface HTMLQuoteElement extends HTMLElement { /** * Sets or retrieves reference information about the object. @@ -7979,7 +8046,7 @@ declare var HTMLScriptElement: { new(): HTMLScriptElement; }; -/** The HTMLSelectElement interface represents a HTML Element. These elements also share all of the properties and methods of other HTML elements via the HTMLElement interface. */ +/** A HTML Element. These elements also share all of the properties and methods of other HTML elements via the HTMLElement interface. */ interface HTMLSelectElement extends HTMLElement { autocomplete: string; /** @@ -8098,7 +8165,7 @@ declare var HTMLSlotElement: { new(): HTMLSlotElement; }; -/** The HTMLSourceElement interface provides special properties (beyond the regular HTMLElement object interface it also has available to it by inheritance) for manipulating elements. */ +/** Provides special properties (beyond the regular HTMLElement object interface it also has available to it by inheritance) for manipulating elements. */ interface HTMLSourceElement extends HTMLElement { /** * Gets or sets the intended media type of the media source. @@ -8125,7 +8192,7 @@ declare var HTMLSourceElement: { new(): HTMLSourceElement; }; -/** The HTMLSpanElement interface represents a element and derives from the HTMLElement interface, but without implementing any additional properties or methods. */ +/** A element and derives from the HTMLElement interface, but without implementing any additional properties or methods. */ interface HTMLSpanElement extends HTMLElement { addEventListener(type: K, listener: (this: HTMLSpanElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void; @@ -8138,7 +8205,7 @@ declare var HTMLSpanElement: { new(): HTMLSpanElement; }; -/** The HTMLStyleElement interface represents a
, but not the element. */ interface HTMLQuoteElement extends HTMLElement { /** * Sets or retrieves reference information about the object. @@ -7979,7 +8046,7 @@ declare var HTMLScriptElement: { new(): HTMLScriptElement; }; -/** The HTMLSelectElement interface represents a HTML Element. These elements also share all of the properties and methods of other HTML elements via the HTMLElement interface. */ +/** A HTML Element. These elements also share all of the properties and methods of other HTML elements via the HTMLElement interface. */ interface HTMLSelectElement extends HTMLElement { autocomplete: string; /** @@ -8098,7 +8165,7 @@ declare var HTMLSlotElement: { new(): HTMLSlotElement; }; -/** The HTMLSourceElement interface provides special properties (beyond the regular HTMLElement object interface it also has available to it by inheritance) for manipulating elements. */ +/** Provides special properties (beyond the regular HTMLElement object interface it also has available to it by inheritance) for manipulating elements. */ interface HTMLSourceElement extends HTMLElement { /** * Gets or sets the intended media type of the media source. @@ -8125,7 +8192,7 @@ declare var HTMLSourceElement: { new(): HTMLSourceElement; }; -/** The HTMLSpanElement interface represents a element and derives from the HTMLElement interface, but without implementing any additional properties or methods. */ +/** A element and derives from the HTMLElement interface, but without implementing any additional properties or methods. */ interface HTMLSpanElement extends HTMLElement { addEventListener(type: K, listener: (this: HTMLSpanElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void; addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void; @@ -8138,7 +8205,7 @@ declare var HTMLSpanElement: { new(): HTMLSpanElement; }; -/** The HTMLStyleElement interface represents a