diff --git a/baselines/dom.generated.d.ts b/baselines/dom.generated.d.ts index 199e918bf..ead994236 100644 --- a/baselines/dom.generated.d.ts +++ b/baselines/dom.generated.d.ts @@ -16795,82 +16795,82 @@ declare var HTMLIFrameElement: { */ interface HTMLImageElement extends HTMLElement { /** - * The obsolete **`align`** property of the HTMLImageElement interface is a string which indicates how to position the image relative to its container. + * The deprecated **`align`** property of the HTMLImageElement interface is a string which indicates how to position the image relative to its container. It reflects the element's align content attribute. * @deprecated * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/align) */ align: string; /** - * The HTMLImageElement property **`alt`** provides fallback (alternate) text to display when the image specified by the element is not loaded. + * The **`alt`** property of the HTMLImageElement interface provides fallback (alternate) text to display when the image specified by the element is not displayed, whether because of an error, because the user has disabled the loading of images, or because the image hasn't finished loading yet. It reflects the element's alt content attribute. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/alt) */ alt: string; /** - * The obsolete HTMLImageElement property **`border`** specifies the number of pixels thick the border surrounding the image should be. A value of 0, the default, indicates that no border should be drawn. + * The deprecated **`border`** property of the HTMLImageElement interface specifies the number of pixels thick the border surrounding the image should be. A value of 0, the default, indicates that no border should be drawn. It reflects the element's border content attribute. * @deprecated * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/border) */ border: string; /** - * The read-only HTMLImageElement interface's **`complete`** attribute is a Boolean value which indicates whether or not the image has completely loaded. + * The **`complete`** read-only property of the HTMLImageElement interface is a Boolean value indicating whether or not the image has completely loaded. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/complete) */ readonly complete: boolean; /** - * The HTMLImageElement interface's **`crossOrigin`** attribute is a string which specifies the Cross-Origin Resource Sharing (CORS) setting to use when retrieving the image. + * The **`crossOrigin`** property of the HTMLImageElement interface is a string which specifies the Cross-Origin Resource Sharing (CORS) setting to use when retrieving the image. It reflects the element's crossorigin content attribute. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/crossOrigin) */ crossOrigin: string | null; /** - * The read-only HTMLImageElement property **`currentSrc`** indicates the URL of the image which is currently presented in the element it represents. + * The **`currentSrc`** read-only property of the HTMLImageElement interface indicates the URL of the image selected by the browser to load. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/currentSrc) */ readonly currentSrc: string; /** - * The **`decoding`** property of the HTMLImageElement interface provides a hint to the browser as to how it should decode the image. More specifically, whether it should wait for the image to be decoded before presenting other content updates or not. + * The **`decoding`** property of the HTMLImageElement interface provides a hint to the browser as to how it should decode the image. More specifically, whether it should wait for the image to be decoded before presenting other content updates or not. It reflects the element's decoding content attribute. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/decoding) */ decoding: "async" | "sync" | "auto"; /** - * The **`fetchPriority`** property of the HTMLImageElement interface represents a hint to the browser indicating how it should prioritize fetching a particular image relative to other images. It reflects the fetchpriority attribute of the corresponding element. + * The **`fetchPriority`** property of the HTMLImageElement interface represents a hint to the browser indicating how it should prioritize fetching a particular image relative to other images. It reflects the element's fetchpriority content attribute. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/fetchPriority) */ fetchPriority: "high" | "low" | "auto"; /** - * The **`height`** property of the HTMLImageElement interface indicates the height at which the image is drawn, in CSS pixels if the image is being drawn or rendered to any visual medium such as the screen or a printer; otherwise, it's the natural, pixel density corrected height of the image. + * The **`height`** property of the HTMLImageElement interface indicates the height at which the image is drawn, in CSS pixels, if the image is being drawn or rendered to any visual medium such as a screen or printer. Otherwise, it's the natural, pixel density-corrected height of the image. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/height) */ height: number; /** - * The obsolete **`hspace`** property of the HTMLImageElement interface specifies the number of pixels of empty space to leave empty on the left and right sides of the element when laying out the page. + * The deprecated **`hspace`** property of the HTMLImageElement interface specifies the number of pixels of empty space to leave empty on the left and right sides of the element when laying out the page. It reflects the element's hspace content attribute. * @deprecated * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/hspace) */ hspace: number; /** - * The HTMLImageElement property **`isMap`** is a Boolean value which indicates that the image is to be used by a server-side image map. This may only be used on images located within an element. + * The **`isMap`** property of the HTMLImageElement interface indicates thatthe image is part of a server-side map. If so, the coordinates where the user clicked on the image are sent to the server. It reflects the element's ismap content attribute. This attribute is allowed only if the element is a descendant of an element with a valid href attribute. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/isMap) */ isMap: boolean; /** - * The HTMLImageElement property **`loading`** is a string whose value provides a hint to the user agent on how to handle the loading of the image which is currently outside the window's visual viewport. + * The **`loading`** property of the HTMLImageElement interface provides a hint to the user agent on how to handle the loading of the image which is currently outside the window's visual viewport. This helps to optimize the loading of the document's contents by postponing loading the image until it's expected to be needed, rather than immediately during the initial page load. It reflects the element's loading content attribute. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/loading) */ loading: "eager" | "lazy"; /** - * The deprecated property **`longDesc`** on the HTMLImageElement interface specifies the URL of a text or HTML file which contains a long-form description of the image. This can be used to provide optional added details beyond the short description provided in the title attribute. + * The deprecated **`longDesc`** property of the HTMLImageElement interface specifies the URL of a text or HTML file which contains a long-form description of the image. This can be used to provide optional added details beyond the short description provided in the title attribute. It reflects the element's longdesc content attribute. * @deprecated * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/longDesc) @@ -16879,81 +16879,81 @@ interface HTMLImageElement extends HTMLElement { /** @deprecated */ lowsrc: string; /** - * The HTMLImageElement interface's deprecated **`name`** property specifies a name for the element. This has been replaced by the id property available on all elements. + * The deprecated **`name`** property of the HTMLImageElement interface specifies a name for the element. It reflects the element's name content attribute. It has been replaced by the id property available on all elements, and is kept only for compatibility reasons. * @deprecated * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/name) */ name: string; /** - * The HTMLImageElement interface's **`naturalHeight`** property is a read-only value which returns the intrinsic (natural), density-corrected height of the image in CSS pixels. + * The read-only **`naturalHeight`** property of the HTMLImageElement interface returns the intrinsic (natural), density-corrected height of the image in CSS pixels. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/naturalHeight) */ readonly naturalHeight: number; /** - * The HTMLImageElement interface's read-only **`naturalWidth`** property returns the intrinsic (natural), density-corrected width of the image in CSS pixels. + * The read-only **`naturalWidth`** property of the HTMLImageElement interface returns the intrinsic (natural), density-corrected width of the image in CSS pixels. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/naturalWidth) */ readonly naturalWidth: number; /** - * The **`HTMLImageElement.referrerPolicy`** property reflects the HTML referrerpolicy attribute of the element defining which referrer is sent when fetching the resource. + * The **`referrerPolicy`** property of the HTMLImageElement interface defining which referrer is sent when fetching the resource. It reflects the element's referrerpolicy content attribute. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/referrerPolicy) */ referrerPolicy: string; /** - * The HTMLImageElement property **`sizes`** allows you to specify the layout width of the image for each of a list of media conditions. This provides the ability to automatically select among different images—even images of different orientations or aspect ratios—as the document state changes to match different media conditions. + * The **`sizes`** property of the HTMLImageElement interface allows you to specify the layout width of the image for each of a list of media queries. This provides the ability to automatically select among different images—even images of different orientations or aspect ratios—as the document state changes to match different media conditions. It reflects the element's sizes content attribute. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/sizes) */ sizes: string; /** - * The HTMLImageElement property **`src`**, which reflects the HTML src attribute, specifies the image to display in the element. + * The **`src`** property of the HTMLImageElement interface specifies the image to display in the element. It reflects the element's src content attribute. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/src) */ src: string; /** - * The HTMLImageElement property **`srcset`** is a string which identifies one or more image candidate strings, separated using commas (,) each specifying image resources to use under given circumstances. + * The **`srcset`** property of the HTMLImageElement interface identifies one or more image candidate strings, separated using commas (,), each specifying image resources to use under given circumstances. Each image candidate string contains an image URL and an optional width or pixel density descriptor that indicates the conditions under which that candidate should be used instead of the image specified by the src property. It reflects the element's srcset content attribute. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/srcset) */ srcset: string; /** - * The **`useMap`** property on the HTMLImageElement interface reflects the value of the HTML usemap attribute, which is a string providing the name of the client-side image map to apply to the image. + * The **`useMap`** property of the HTMLImageElement interface providing the name of the client-side image map to apply to the image. It reflects the element's usemap content attribute. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/useMap) */ useMap: string; /** - * The obsolete **`vspace`** property of the HTMLImageElement interface specifies the number of pixels of empty space to leave empty on the top and bottom of the element when laying out the page. + * The deprecated **`vspace`** property of the HTMLImageElement interface specifies the number of pixels of empty space to leave empty on the top and bottom sides of the element when laying out the page. It reflects the element's vspace content attribute. * @deprecated * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/vspace) */ vspace: number; /** - * The **`width`** property of the HTMLImageElement interface indicates the width at which an image is drawn in CSS pixels if it's being drawn or rendered to any visual medium such as a screen or printer. Otherwise, it's the natural, pixel density-corrected width of the image. + * The **`width`** property of the HTMLImageElement interface indicates the width at which the image is drawn, in CSS pixels, if the image is being drawn or rendered to any visual medium such as a screen or printer. Otherwise, it's the natural, pixel density-corrected width of the image. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/width) */ width: number; /** - * The read-only HTMLImageElement property **`x`** indicates the x-coordinate of the element's left border edge relative to the root element's origin. + * The read-only **`x`** property of the HTMLImageElement interface indicates the x-coordinate of the element's left border edge relative to the root element's origin. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/x) */ readonly x: number; /** - * The read-onl**`y`** HTMLImageElement property y indicates the y-coordinate of the element's top border edge relative to the root element's origin. + * The read-onl**`y`** y property of the HTMLImageElement interface indicates the y-coordinate of the element's top border edge relative to the root element's origin. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/y) */ readonly y: number; /** - * The **`decode()`** method of the HTMLImageElement interface returns a Promise that resolves once the image is decoded and it is safe to append it to the DOM. + * The **`decode()`** method of the HTMLImageElement interface returns a Promise that resolves once the image is decoded and is safe to be appended to the DOM. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLImageElement/decode) */ @@ -17440,7 +17440,7 @@ interface HTMLLinkElement extends HTMLElement, LinkStyle { */ disabled: boolean; /** - * The **`fetchPriority`** property of the HTMLLinkElement interface represents a hint to the browser indicating how it should prioritize fetching a particular resource relative to other resources of the same type. It reflects the fetchpriority attribute of the corresponding element. + * The **`fetchPriority`** property of the HTMLLinkElement interface represents a hint to the browser indicating how it should prioritize fetching a particular resource relative to other resources of the same type. It reflects the element's fetchpriority content attribute. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLLinkElement/fetchPriority) */ @@ -18638,7 +18638,7 @@ interface HTMLScriptElement extends HTMLElement { /** @deprecated */ event: string; /** - * The **`fetchPriority`** property of the HTMLScriptElement interface represents a hint to the browser indicating how it should prioritize fetching an external script relative to other external scripts. It reflects the fetchpriority attribute of the