diff --git a/baselines/dom.generated.d.ts b/baselines/dom.generated.d.ts index b73997ab8..8d9387cd3 100644 --- a/baselines/dom.generated.d.ts +++ b/baselines/dom.generated.d.ts @@ -3332,109 +3332,317 @@ interface ANGLE_instanced_arrays { } interface ARIAMixin { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaActiveDescendantElement) */ + /** + * The **`ariaActiveDescendantElement`** property of the Element interface represents the current active element when focus is on a composite widget, combobox, textbox, group, or application. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaActiveDescendantElement) + */ ariaActiveDescendantElement: Element | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaAtomic) */ + /** + * The **`ariaAtomic`** property of the Element interface reflects the value of the aria-atomic attribute, which indicates whether assistive technologies will present all, or only parts of, the changed region based on the change notifications defined by the aria-relevant attribute. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaAtomic) + */ ariaAtomic: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaAutoComplete) */ + /** + * The **`ariaAutoComplete`** property of the Element interface reflects the value of the aria-autocomplete attribute, which indicates whether inputting text could trigger display of one or more predictions of the user's intended value for a combobox, searchbox, or textbox and specifies how predictions would be presented if they were made. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaAutoComplete) + */ ariaAutoComplete: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBrailleLabel) */ + /** + * The **`ariaBrailleLabel`** property of the Element interface reflects the value of the aria-braillelabel attribute, which defines the ARIA braille label of the element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBrailleLabel) + */ ariaBrailleLabel: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBrailleRoleDescription) */ + /** + * The **`ariaBrailleRoleDescription`** property of the Element interface reflects the value of the aria-brailleroledescription attribute, which defines the ARIA braille role description of the element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBrailleRoleDescription) + */ ariaBrailleRoleDescription: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBusy) */ + /** + * The **`ariaBusy`** property of the Element interface reflects the value of the aria-busy attribute, which indicates whether an element is being modified, as assistive technologies may want to wait until the modifications are complete before exposing them to the user. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBusy) + */ ariaBusy: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaChecked) */ + /** + * The **`ariaChecked`** property of the Element interface reflects the value of the aria-checked attribute, which indicates the current "checked" state of checkboxes, radio buttons, and other widgets that have a checked state. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaChecked) + */ ariaChecked: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColCount) */ + /** + * The **`ariaColCount`** property of the Element interface reflects the value of the aria-colcount attribute, which defines the number of columns in a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColCount) + */ ariaColCount: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColIndex) */ + /** + * The **`ariaColIndex`** property of the Element interface reflects the value of the aria-colindex attribute, which defines an element's column index or position with respect to the total number of columns within a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColIndex) + */ ariaColIndex: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColIndexText) */ + /** + * The **`ariaColIndexText`** property of the Element interface reflects the value of the aria-colindextext attribute, which defines a human readable text alternative of aria-colindex. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColIndexText) + */ ariaColIndexText: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColSpan) */ + /** + * The **`ariaColSpan`** property of the Element interface reflects the value of the aria-colspan attribute, which defines the number of columns spanned by a cell or gridcell within a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColSpan) + */ ariaColSpan: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaControlsElements) */ + /** + * The **`ariaControlsElements`** property of the Element interface is an array containing the elements that are controlled by the element it is applied to. For example, this might be set on a combobox to indicate the element that it pops up, or on a scrollbar to indicate the ID of the element it controls. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaControlsElements) + */ ariaControlsElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaCurrent) */ + /** + * The **`ariaCurrent`** property of the Element interface reflects the value of the aria-current attribute, which indicates the element that represents the current item within a container or set of related elements. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaCurrent) + */ ariaCurrent: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDescribedByElements) */ + /** + * The **`ariaDescribedByElements`** property of the Element interface is an array containing the element (or elements) that provide an accessible description for the element it is applied to. The accessible description is similar to the accessible label (see ariaLabelledByElements), but provides more verbose information. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDescribedByElements) + */ ariaDescribedByElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDescription) */ + /** + * The **`ariaDescription`** property of the Element interface reflects the value of the aria-description attribute, which defines a string value that describes or annotates the current element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDescription) + */ ariaDescription: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDetailsElements) */ + /** + * The **`ariaDetailsElements`** property of the Element interface is an array containing the element (or elements) that provide an accessible details for the element it is applied to. The accessible details are similar to the accessible description (see ariaDescribedByElements), but provides more verbose information. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDetailsElements) + */ ariaDetailsElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDisabled) */ + /** + * The **`ariaDisabled`** property of the Element interface reflects the value of the aria-disabled attribute, which indicates that the element is perceivable but disabled, so it is not editable or otherwise operable. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDisabled) + */ ariaDisabled: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaErrorMessageElements) */ + /** + * The **`ariaErrorMessageElements`** property of the Element interface is an array containing the element (or elements) that provide an error message for the element it is applied to. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaErrorMessageElements) + */ ariaErrorMessageElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaExpanded) */ + /** + * The **`ariaExpanded`** property of the Element interface reflects the value of the aria-expanded attribute, which indicates whether a grouping element owned or controlled by this element is expanded or collapsed. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaExpanded) + */ ariaExpanded: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaFlowToElements) */ + /** + * The **`ariaFlowToElements`** property of the Element interface is an array containing the element (or elements) that provide an alternate reading order of content, overriding the general default reading order at the user's discretion. If just one element is provided this is the next element in the reading order. If multiple elements are provided, then each element represents a possible path that should be offered to the user for selection. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaFlowToElements) + */ ariaFlowToElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaHasPopup) */ + /** + * The **`ariaHasPopup`** property of the Element interface reflects the value of the aria-haspopup attribute, which indicates the availability and type of interactive popup element, such as menu or dialog, that can be triggered by an element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaHasPopup) + */ ariaHasPopup: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaHidden) */ + /** + * The **`ariaHidden`** property of the Element interface reflects the value of the aria-hidden) attribute, which indicates whether the element is exposed to an accessibility API. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaHidden) + */ ariaHidden: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaInvalid) */ + /** + * The **`ariaInvalid`** property of the Element interface reflects the value of the aria-invalid attribute. Relevant for the application, checkbox, combobox, gridcell, listbox, radiogroup, slider, spinbutton, textbox, and tree roles, it indicates to the accessibility API whether the entered value does not conform to the format expected by the application. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaInvalid) + */ ariaInvalid: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaKeyShortcuts) */ + /** + * The **`ariaKeyShortcuts`** property of the Element interface reflects the value of the aria-keyshortcuts attribute, which indicates keyboard shortcuts that an author has implemented to activate or give focus to an element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaKeyShortcuts) + */ ariaKeyShortcuts: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLabel) */ + /** + * The **`ariaLabel`** property of the Element interface reflects the value of the aria-label attribute, which defines a string value that labels the current element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLabel) + */ ariaLabel: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLabelledByElements) */ + /** + * The **`ariaLabelledByElements`** property of the Element interface is an array containing the element (or elements) that provide an accessible name for the element it is applied to. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLabelledByElements) + */ ariaLabelledByElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLevel) */ + /** + * The **`ariaLevel`** property of the Element interface reflects the value of the aria-level attribute, which defines the hierarchical level of an element within a structure. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLevel) + */ ariaLevel: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLive) */ + /** + * The **`ariaLive`** property of the Element interface reflects the value of the aria-live attribute, which indicates that an element will be updated, and describes the types of updates the user agents, assistive technologies, and user can expect from the live region. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLive) + */ ariaLive: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaModal) */ + /** + * The **`ariaModal`** property of the Element interface reflects the value of the aria-modal attribute, which indicates whether an element is modal when displayed. Applying the aria-modal property to an element with role="dialog" replaces the technique of using aria-hidden on the background for informing assistive technologies that content outside a dialog is inert. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaModal) + */ ariaModal: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaMultiLine) */ + /** + * The **`ariaMultiLine`** property of the Element interface reflects the value of the aria-multiline attribute, which indicates whether a text box accepts multiple lines of input or only a single line. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaMultiLine) + */ ariaMultiLine: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaMultiSelectable) */ + /** + * The **`ariaMultiSelectable`** property of the Element interface reflects the value of the aria-multiselectable attribute, which indicates that the user may select more than one item from the current selectable descendants. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaMultiSelectable) + */ ariaMultiSelectable: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaOrientation) */ + /** + * The **`ariaOrientation`** property of the Element interface reflects the value of the aria-orientation attribute, which indicates whether the element's orientation is horizontal, vertical, or unknown/ambiguous. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaOrientation) + */ ariaOrientation: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaOwnsElements) */ + /** + * The **`ariaOwnsElements`** property of the Element interface is an array containing the element (or elements) that define a visual, functional, or contextual relationship between a parent element that it is applied to, and its child elements. This is used when the DOM hierarchy cannot be used to represent the relationship, and it would not otherwise be available to assistive technology, + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaOwnsElements) + */ ariaOwnsElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPlaceholder) */ + /** + * The **`ariaPlaceholder`** property of the Element interface reflects the value of the aria-placeholder attribute, which defines a short hint intended to aid the user with data entry when the control has no value. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPlaceholder) + */ ariaPlaceholder: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPosInSet) */ + /** + * The **`ariaPosInSet`** property of the Element interface reflects the value of the aria-posinset attribute, which defines an element's number or position in the current set of listitems or treeitems. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPosInSet) + */ ariaPosInSet: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPressed) */ + /** + * The **`ariaPressed`** property of the Element interface reflects the value of the aria-pressed attribute, which indicates the current "pressed" state of toggle buttons. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPressed) + */ ariaPressed: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaReadOnly) */ + /** + * The **`ariaReadOnly`** property of the Element interface reflects the value of the aria-readonly attribute, which indicates that the element is not editable, but is otherwise operable. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaReadOnly) + */ ariaReadOnly: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRelevant) */ + /** + * The **`ariaRelevant`** property of the Element interface reflects the value of the aria-relevant attribute, which indicates what notifications the user agent will trigger when the accessibility tree within a live region is modified. This is used to describe what changes in an aria-live region are relevant and should be announced. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRelevant) + */ ariaRelevant: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRequired) */ + /** + * The **`ariaRequired`** property of the Element interface reflects the value of the aria-required attribute, which indicates that user input is required on the element before a form may be submitted. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRequired) + */ ariaRequired: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRoleDescription) */ + /** + * The **`ariaRoleDescription`** property of the Element interface reflects the value of the aria-roledescription attribute, which defines a human-readable, author-localized description for the role of an element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRoleDescription) + */ ariaRoleDescription: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowCount) */ + /** + * The **`ariaRowCount`** property of the Element interface reflects the value of the aria-rowcount attribute, which defines the total number of rows in a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowCount) + */ ariaRowCount: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowIndex) */ + /** + * The **`ariaRowIndex`** property of the Element interface reflects the value of the aria-rowindex attribute, which defines an element's row index or position with respect to the total number of rows within a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowIndex) + */ ariaRowIndex: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowIndexText) */ + /** + * The **`ariaRowIndexText`** property of the Element interface reflects the value of the aria-rowindextext attribute, which defines a human readable text alternative of aria-rowindex. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowIndexText) + */ ariaRowIndexText: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowSpan) */ + /** + * The **`ariaRowSpan`** property of the Element interface reflects the value of the aria-rowspan attribute, which defines the number of rows spanned by a cell or gridcell within a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowSpan) + */ ariaRowSpan: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSelected) */ + /** + * The **`ariaSelected`** property of the Element interface reflects the value of the aria-selected attribute, which indicates the current "selected" state of elements that have a selected state. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSelected) + */ ariaSelected: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSetSize) */ + /** + * The **`ariaSetSize`** property of the Element interface reflects the value of the aria-setsize attribute, which defines the number of items in the current set of listitems or treeitems. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSetSize) + */ ariaSetSize: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSort) */ + /** + * The **`ariaSort`** property of the Element interface reflects the value of the aria-sort attribute, which indicates if items in a table or grid are sorted in ascending or descending order. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSort) + */ ariaSort: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueMax) */ + /** + * The **`ariaValueMax`** property of the Element interface reflects the value of the aria-valuemax attribute, which defines the maximum allowed value for a range widget. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueMax) + */ ariaValueMax: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueMin) */ + /** + * The **`ariaValueMin`** property of the Element interface reflects the value of the aria-valuemin attribute, which defines the minimum allowed value for a range widget. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueMin) + */ ariaValueMin: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueNow) */ + /** + * The **`ariaValueNow`** property of the Element interface reflects the value of the aria-valuenow attribute, which defines the current value for a range widget. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueNow) + */ ariaValueNow: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueText) */ + /** + * The **`ariaValueText`** property of the Element interface reflects the value of the aria-valuetext attribute, which defines the human-readable text alternative of aria-valuenow for a range widget. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueText) + */ ariaValueText: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/role) */ + /** + * The **`role`** property of the Element interface returns the explicitly set WAI-ARIA role for the element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/role) + */ role: string | null; } @@ -5205,21 +5413,53 @@ declare var BlobEvent: { }; interface Body { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) */ + /** + * The **`body`** read-only property of the Request interface contains a ReadableStream with the body contents that have been added to the request. Note that a request using the GET or HEAD method cannot have a body and null is returned in these cases. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) + */ readonly body: ReadableStream> | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */ + /** + * The **`bodyUsed`** read-only property of the Request interface is a boolean value that indicates whether the request body has been read yet. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) + */ readonly bodyUsed: boolean; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */ + /** + * The **`arrayBuffer()`** method of the Request interface reads the request body and returns it as a promise that resolves with an ArrayBuffer. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) + */ arrayBuffer(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */ + /** + * The **`blob()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Blob. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) + */ blob(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) */ + /** + * The **`bytes()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Uint8Array. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) + */ bytes(): Promise>; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) */ + /** + * The **`formData()`** method of the Request interface reads the request body and returns it as a promise that resolves with a FormData object. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) + */ formData(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) */ + /** + * The **`json()`** method of the Request interface reads the request body and returns it as a promise that resolves with the result of parsing the body text as JSON. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) + */ json(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) */ + /** + * The **`text()`** method of the Request interface reads the request body and returns it as a promise that resolves with a String. The response is always decoded using UTF-8. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) + */ text(): Promise; } @@ -13440,34 +13680,56 @@ declare var DocumentFragment: { interface DocumentOrShadowRoot { /** - * Returns the deepest element in the document through which or to which key events are being routed. This is, roughly speaking, the focused element in the document. - * - * For the purposes of this API, when a child browsing context is focused, its container is focused in the parent browsing context. For example, if the user moves the focus to a text control in an iframe, the iframe is the element returned by the activeElement API in the iframe's node document. - * - * Similarly, when the focused element is in a different node tree than documentOrShadowRoot, the element returned will be the host that's located in the same node tree as documentOrShadowRoot if documentOrShadowRoot is a shadow-including inclusive ancestor of the focused element, and null if not. + * The **`activeElement`** read-only property of the Document interface returns the Element within the DOM that is receiving keyboard events such as keydown and keyup. This is usually analogous to the focused element. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/activeElement) */ readonly activeElement: Element | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/adoptedStyleSheets) */ + /** + * The **`adoptedStyleSheets`** property of the Document interface is used for setting an array of constructed stylesheets to be used by the document. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/adoptedStyleSheets) + */ adoptedStyleSheets: CSSStyleSheet[]; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/customElementRegistry) */ + /** + * The **`customElementRegistry`** read-only property of the Document interface returns the CustomElementRegistry object associated with this document, or null if one has not been set. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/customElementRegistry) + */ readonly customElementRegistry: CustomElementRegistry | null; /** - * Returns document's fullscreen element. + * The **`Document.fullscreenElement`** read-only property returns the Element that is currently being presented in fullscreen mode in this document, or null if fullscreen mode is not currently in use. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/fullscreenElement) */ readonly fullscreenElement: Element | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/pictureInPictureElement) */ + /** + * The read-only **`pictureInPictureElement`** property of the Document interface returns the Element that is currently being presented in picture-in-picture mode in this document, or null if picture-in-picture mode is not currently in use. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/pictureInPictureElement) + */ readonly pictureInPictureElement: Element | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/pointerLockElement) */ + /** + * The **`pointerLockElement`** read-only property of the Document interface provides the element set as the target for mouse events while the pointer is locked. It is null if lock is pending, pointer is unlocked, or the target is in another document. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/pointerLockElement) + */ readonly pointerLockElement: Element | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/styleSheets) */ + /** + * The **`styleSheets`** read-only property of the Document interface returns a StyleSheetList of CSSStyleSheet objects, for stylesheets explicitly linked into or embedded in a document. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/styleSheets) + */ readonly styleSheets: StyleSheetList; + /** The **`elementFromPoint()`** method, available on the Document object, returns the topmost Element at the specified coordinates (relative to the viewport). */ elementFromPoint(x: number, y: number): Element | null; + /** The **`elementsFromPoint()`** method of the Document interface returns an array of all elements at the specified coordinates (relative to the viewport). The elements are ordered from the topmost to the bottommost box of the viewport. */ elementsFromPoint(x: number, y: number): Element[]; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/getAnimations) */ + /** + * The **`getAnimations()`** method of the Document interface returns an array of all Animation objects currently in effect whose target elements are descendants of the document. This array includes CSS Animations, CSS Transitions, and Web Animations. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/getAnimations) + */ getAnimations(): Animation[]; } @@ -18642,9 +18904,7 @@ declare var HTMLHtmlElement: { interface HTMLHyperlinkElementUtils { /** - * Returns the hyperlink's URL. - * - * Can be set, to change the URL. + * The **`href`** property of the HTMLAnchorElement interface is a stringifier that returns the absolute URL corresponding to the element's href attribute (or an empty string if href is unset). Setting this property updates the element's href attribute to the provided value. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/href) */ @@ -22195,79 +22455,61 @@ declare var History: { interface HyperlinkElementUtils { /** - * Returns the hyperlink's URL's fragment (includes leading "#" if non-empty). - * - * Can be set, to change the URL's fragment (ignores leading "#"). + * The **`hash`** property of the HTMLAnchorElement interface is a string containing a "#" followed by the fragment identifier of the element's href. If the URL does not have a fragment identifier, this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/hash) */ hash: string; /** - * Returns the hyperlink's URL's host and port (if different from the default port for the scheme). - * - * Can be set, to change the URL's host and port. + * The **`host`** property of the HTMLAnchorElement interface is a string containing the host, which is the hostname, and then, if the port of the URL is nonempty, a ":", followed by the port of the URL. If the URL does not have a hostname, this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/host) */ host: string; /** - * Returns the hyperlink's URL's host. - * - * Can be set, to change the URL's host. + * The **`hostname`** property of the HTMLAnchorElement interface is a string containing either the domain name or IP address of the element's href. If the URL does not have a hostname, this property contains an empty string, "". IPv4 and IPv6 addresses are normalized, such as stripping leading zeros, and domain names are converted to IDN. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/hostname) */ hostname: string; /** - * Returns the hyperlink's URL's origin. + * The **`origin`** read-only property of the HTMLAnchorElement interface returns a string containing the Unicode serialization of the origin of the element's href. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/origin) */ readonly origin: string; /** - * Returns the hyperlink's URL's password. - * - * Can be set, to change the URL's password. + * The **`password`** property of the HTMLAnchorElement interface is a string containing the password component of the element's href. If the URL does not have a password, this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/password) */ password: string; /** - * Returns the hyperlink's URL's path. - * - * Can be set, to change the URL's path. + * The **`HTMLAnchorElement.pathname`** property is a string containing an initial '/' followed by the path of the URL not including the query string or fragment (or the empty string if there is no path). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/pathname) */ pathname: string; /** - * Returns the hyperlink's URL's port. - * - * Can be set, to change the URL's port. + * The **`port`** property of the HTMLAnchorElement interface is a string containing the port number of the element's href. If the port is the default for the protocol (80 for ws: and http:, 443 for wss: and https:, and 21 for ftp:), this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/port) */ port: string; /** - * Returns the hyperlink's URL's scheme. - * - * Can be set, to change the URL's scheme. + * The **`protocol`** property of the HTMLAnchorElement interface is a string containing the protocol or scheme of the element's href, including the final ":". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/protocol) */ protocol: string; /** - * Returns the hyperlink's URL's query (includes leading "?" if non-empty). - * - * Can be set, to change the URL's query (ignores leading "?"). + * The **`search`** property of the HTMLAnchorElement interface is a search string, also called a query string, that is a string containing a "?" followed by the parameters of the element's href. If the URL does not have a search query, this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/search) */ search: string; /** - * Returns the hyperlink's URL's username. - * - * Can be set, to change the URL's username. + * The **`username`** property of the HTMLAnchorElement interface is a string containing the username component of the element's href. If the URL does not have a username, this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/username) */ @@ -26702,7 +26944,7 @@ interface NonDocumentTypeChildNode { interface NonElementParentNode { /** - * Returns the first element within node's descendants whose ID is elementId. + * The **`getElementById()`** method of the Document interface returns an Element object representing the element whose id property matches the specified string. Since element IDs are required to be unique if specified, they're a useful way to get access to a specific element quickly. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/getElementById) */ @@ -27380,46 +27622,50 @@ declare var PannerNode: { }; interface ParentNode extends Node { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/childElementCount) */ + /** + * The **`Document.childElementCount`** read-only property returns the number of child elements of the document. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/childElementCount) + */ readonly childElementCount: number; /** - * Returns the child elements. + * The read-only **`children`** property returns a live HTMLCollection which contains all of the child elements of the document upon which it was called. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/children) */ readonly children: HTMLCollection; /** - * Returns the first child that is an element, and null otherwise. + * The **`Document.firstElementChild`** read-only property returns the document's first child Element, or null if there are no child elements. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/firstElementChild) */ readonly firstElementChild: Element | null; /** - * Returns the last child that is an element, and null otherwise. + * The **`Document.lastElementChild`** read-only property returns the document's last child Element, or null if there are no child elements. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/lastElementChild) */ readonly lastElementChild: Element | null; /** - * Inserts nodes after the last child of node, while replacing strings in nodes with equivalent Text nodes. - * - * Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated. + * The **`Document.append()`** method inserts a set of Node objects or strings after the last child of the document. Strings are inserted as equivalent Text nodes. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/append) */ append(...nodes: (Node | string)[]): void; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/moveBefore) */ - moveBefore(node: Node, child: Node | null): void; /** - * Inserts nodes before the first child of node, while replacing strings in nodes with equivalent Text nodes. + * The **`moveBefore()`** method of the Document interface moves a given Node inside the Document DOM node as a direct child, before a given reference node. * - * Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated. + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/moveBefore) + */ + moveBefore(node: Node, child: Node | null): void; + /** + * The **`Document.prepend()`** method inserts a set of Node objects or strings before the first child of the document. Strings are inserted as equivalent Text nodes. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/prepend) */ prepend(...nodes: (Node | string)[]): void; /** - * Returns the first element that is a descendant of node that matches selectors. + * The Document method **`querySelector()`** returns the first Element within the document that matches the specified CSS selector, or group of CSS selectors. If no matches are found, null is returned. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/querySelector) */ @@ -27430,7 +27676,7 @@ interface ParentNode extends Node { querySelector(selectors: K): HTMLElementDeprecatedTagNameMap[K] | null; querySelector(selectors: string): E | null; /** - * Returns all element descendants of node that match selectors. + * The Document method **`querySelectorAll()`** returns a static (not live) NodeList representing a list of the document's elements that match the specified group of selectors. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/querySelectorAll) */ @@ -27441,9 +27687,7 @@ interface ParentNode extends Node { querySelectorAll(selectors: K): NodeListOf; querySelectorAll(selectors: string): NodeListOf; /** - * Replace all children of node with nodes, while replacing strings in nodes with equivalent Text nodes. - * - * Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated. + * The **`Document.replaceChildren()`** method replaces the existing children of a Document with a specified new set of children. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/replaceChildren) */ @@ -28909,9 +29153,17 @@ declare var PopStateEvent: { }; interface PopoverTargetAttributes { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/popoverTargetAction) */ + /** + * The **`popoverTargetAction`** property of the HTMLButtonElement interface gets and sets the action to be performed ("hide", "show", or "toggle") on a popover element being controlled by a button. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/popoverTargetAction) + */ popoverTargetAction: string; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/popoverTargetElement) */ + /** + * The **`popoverTargetElement`** property of the HTMLButtonElement interface gets and sets the popover element to control via a button. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/popoverTargetElement) + */ popoverTargetElement: Element | null; } diff --git a/baselines/serviceworker.generated.d.ts b/baselines/serviceworker.generated.d.ts index c9f0a7ffd..4f9108b78 100644 --- a/baselines/serviceworker.generated.d.ts +++ b/baselines/serviceworker.generated.d.ts @@ -1451,21 +1451,53 @@ declare var Blob: { }; interface Body { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) */ + /** + * The **`body`** read-only property of the Request interface contains a ReadableStream with the body contents that have been added to the request. Note that a request using the GET or HEAD method cannot have a body and null is returned in these cases. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) + */ readonly body: ReadableStream> | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */ + /** + * The **`bodyUsed`** read-only property of the Request interface is a boolean value that indicates whether the request body has been read yet. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) + */ readonly bodyUsed: boolean; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */ + /** + * The **`arrayBuffer()`** method of the Request interface reads the request body and returns it as a promise that resolves with an ArrayBuffer. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) + */ arrayBuffer(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */ + /** + * The **`blob()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Blob. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) + */ blob(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) */ + /** + * The **`bytes()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Uint8Array. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) + */ bytes(): Promise>; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) */ + /** + * The **`formData()`** method of the Request interface reads the request body and returns it as a promise that resolves with a FormData object. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) + */ formData(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) */ + /** + * The **`json()`** method of the Request interface reads the request body and returns it as a promise that resolves with the result of parsing the body text as JSON. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) + */ json(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) */ + /** + * The **`text()`** method of the Request interface reads the request body and returns it as a promise that resolves with a String. The response is always decoded using UTF-8. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) + */ text(): Promise; } diff --git a/baselines/sharedworker.generated.d.ts b/baselines/sharedworker.generated.d.ts index 130f9b4a1..e747503ad 100644 --- a/baselines/sharedworker.generated.d.ts +++ b/baselines/sharedworker.generated.d.ts @@ -1387,21 +1387,53 @@ declare var Blob: { }; interface Body { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) */ + /** + * The **`body`** read-only property of the Request interface contains a ReadableStream with the body contents that have been added to the request. Note that a request using the GET or HEAD method cannot have a body and null is returned in these cases. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) + */ readonly body: ReadableStream> | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */ + /** + * The **`bodyUsed`** read-only property of the Request interface is a boolean value that indicates whether the request body has been read yet. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) + */ readonly bodyUsed: boolean; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */ + /** + * The **`arrayBuffer()`** method of the Request interface reads the request body and returns it as a promise that resolves with an ArrayBuffer. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) + */ arrayBuffer(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */ + /** + * The **`blob()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Blob. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) + */ blob(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) */ + /** + * The **`bytes()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Uint8Array. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) + */ bytes(): Promise>; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) */ + /** + * The **`formData()`** method of the Request interface reads the request body and returns it as a promise that resolves with a FormData object. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) + */ formData(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) */ + /** + * The **`json()`** method of the Request interface reads the request body and returns it as a promise that resolves with the result of parsing the body text as JSON. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) + */ json(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) */ + /** + * The **`text()`** method of the Request interface reads the request body and returns it as a promise that resolves with a String. The response is always decoded using UTF-8. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) + */ text(): Promise; } diff --git a/baselines/ts5.5/dom.generated.d.ts b/baselines/ts5.5/dom.generated.d.ts index 261f23011..3dba659a4 100644 --- a/baselines/ts5.5/dom.generated.d.ts +++ b/baselines/ts5.5/dom.generated.d.ts @@ -3329,109 +3329,317 @@ interface ANGLE_instanced_arrays { } interface ARIAMixin { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaActiveDescendantElement) */ + /** + * The **`ariaActiveDescendantElement`** property of the Element interface represents the current active element when focus is on a composite widget, combobox, textbox, group, or application. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaActiveDescendantElement) + */ ariaActiveDescendantElement: Element | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaAtomic) */ + /** + * The **`ariaAtomic`** property of the Element interface reflects the value of the aria-atomic attribute, which indicates whether assistive technologies will present all, or only parts of, the changed region based on the change notifications defined by the aria-relevant attribute. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaAtomic) + */ ariaAtomic: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaAutoComplete) */ + /** + * The **`ariaAutoComplete`** property of the Element interface reflects the value of the aria-autocomplete attribute, which indicates whether inputting text could trigger display of one or more predictions of the user's intended value for a combobox, searchbox, or textbox and specifies how predictions would be presented if they were made. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaAutoComplete) + */ ariaAutoComplete: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBrailleLabel) */ + /** + * The **`ariaBrailleLabel`** property of the Element interface reflects the value of the aria-braillelabel attribute, which defines the ARIA braille label of the element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBrailleLabel) + */ ariaBrailleLabel: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBrailleRoleDescription) */ + /** + * The **`ariaBrailleRoleDescription`** property of the Element interface reflects the value of the aria-brailleroledescription attribute, which defines the ARIA braille role description of the element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBrailleRoleDescription) + */ ariaBrailleRoleDescription: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBusy) */ + /** + * The **`ariaBusy`** property of the Element interface reflects the value of the aria-busy attribute, which indicates whether an element is being modified, as assistive technologies may want to wait until the modifications are complete before exposing them to the user. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBusy) + */ ariaBusy: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaChecked) */ + /** + * The **`ariaChecked`** property of the Element interface reflects the value of the aria-checked attribute, which indicates the current "checked" state of checkboxes, radio buttons, and other widgets that have a checked state. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaChecked) + */ ariaChecked: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColCount) */ + /** + * The **`ariaColCount`** property of the Element interface reflects the value of the aria-colcount attribute, which defines the number of columns in a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColCount) + */ ariaColCount: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColIndex) */ + /** + * The **`ariaColIndex`** property of the Element interface reflects the value of the aria-colindex attribute, which defines an element's column index or position with respect to the total number of columns within a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColIndex) + */ ariaColIndex: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColIndexText) */ + /** + * The **`ariaColIndexText`** property of the Element interface reflects the value of the aria-colindextext attribute, which defines a human readable text alternative of aria-colindex. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColIndexText) + */ ariaColIndexText: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColSpan) */ + /** + * The **`ariaColSpan`** property of the Element interface reflects the value of the aria-colspan attribute, which defines the number of columns spanned by a cell or gridcell within a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColSpan) + */ ariaColSpan: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaControlsElements) */ + /** + * The **`ariaControlsElements`** property of the Element interface is an array containing the elements that are controlled by the element it is applied to. For example, this might be set on a combobox to indicate the element that it pops up, or on a scrollbar to indicate the ID of the element it controls. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaControlsElements) + */ ariaControlsElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaCurrent) */ + /** + * The **`ariaCurrent`** property of the Element interface reflects the value of the aria-current attribute, which indicates the element that represents the current item within a container or set of related elements. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaCurrent) + */ ariaCurrent: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDescribedByElements) */ + /** + * The **`ariaDescribedByElements`** property of the Element interface is an array containing the element (or elements) that provide an accessible description for the element it is applied to. The accessible description is similar to the accessible label (see ariaLabelledByElements), but provides more verbose information. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDescribedByElements) + */ ariaDescribedByElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDescription) */ + /** + * The **`ariaDescription`** property of the Element interface reflects the value of the aria-description attribute, which defines a string value that describes or annotates the current element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDescription) + */ ariaDescription: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDetailsElements) */ + /** + * The **`ariaDetailsElements`** property of the Element interface is an array containing the element (or elements) that provide an accessible details for the element it is applied to. The accessible details are similar to the accessible description (see ariaDescribedByElements), but provides more verbose information. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDetailsElements) + */ ariaDetailsElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDisabled) */ + /** + * The **`ariaDisabled`** property of the Element interface reflects the value of the aria-disabled attribute, which indicates that the element is perceivable but disabled, so it is not editable or otherwise operable. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDisabled) + */ ariaDisabled: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaErrorMessageElements) */ + /** + * The **`ariaErrorMessageElements`** property of the Element interface is an array containing the element (or elements) that provide an error message for the element it is applied to. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaErrorMessageElements) + */ ariaErrorMessageElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaExpanded) */ + /** + * The **`ariaExpanded`** property of the Element interface reflects the value of the aria-expanded attribute, which indicates whether a grouping element owned or controlled by this element is expanded or collapsed. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaExpanded) + */ ariaExpanded: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaFlowToElements) */ + /** + * The **`ariaFlowToElements`** property of the Element interface is an array containing the element (or elements) that provide an alternate reading order of content, overriding the general default reading order at the user's discretion. If just one element is provided this is the next element in the reading order. If multiple elements are provided, then each element represents a possible path that should be offered to the user for selection. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaFlowToElements) + */ ariaFlowToElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaHasPopup) */ + /** + * The **`ariaHasPopup`** property of the Element interface reflects the value of the aria-haspopup attribute, which indicates the availability and type of interactive popup element, such as menu or dialog, that can be triggered by an element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaHasPopup) + */ ariaHasPopup: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaHidden) */ + /** + * The **`ariaHidden`** property of the Element interface reflects the value of the aria-hidden) attribute, which indicates whether the element is exposed to an accessibility API. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaHidden) + */ ariaHidden: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaInvalid) */ + /** + * The **`ariaInvalid`** property of the Element interface reflects the value of the aria-invalid attribute. Relevant for the application, checkbox, combobox, gridcell, listbox, radiogroup, slider, spinbutton, textbox, and tree roles, it indicates to the accessibility API whether the entered value does not conform to the format expected by the application. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaInvalid) + */ ariaInvalid: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaKeyShortcuts) */ + /** + * The **`ariaKeyShortcuts`** property of the Element interface reflects the value of the aria-keyshortcuts attribute, which indicates keyboard shortcuts that an author has implemented to activate or give focus to an element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaKeyShortcuts) + */ ariaKeyShortcuts: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLabel) */ + /** + * The **`ariaLabel`** property of the Element interface reflects the value of the aria-label attribute, which defines a string value that labels the current element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLabel) + */ ariaLabel: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLabelledByElements) */ + /** + * The **`ariaLabelledByElements`** property of the Element interface is an array containing the element (or elements) that provide an accessible name for the element it is applied to. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLabelledByElements) + */ ariaLabelledByElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLevel) */ + /** + * The **`ariaLevel`** property of the Element interface reflects the value of the aria-level attribute, which defines the hierarchical level of an element within a structure. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLevel) + */ ariaLevel: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLive) */ + /** + * The **`ariaLive`** property of the Element interface reflects the value of the aria-live attribute, which indicates that an element will be updated, and describes the types of updates the user agents, assistive technologies, and user can expect from the live region. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLive) + */ ariaLive: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaModal) */ + /** + * The **`ariaModal`** property of the Element interface reflects the value of the aria-modal attribute, which indicates whether an element is modal when displayed. Applying the aria-modal property to an element with role="dialog" replaces the technique of using aria-hidden on the background for informing assistive technologies that content outside a dialog is inert. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaModal) + */ ariaModal: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaMultiLine) */ + /** + * The **`ariaMultiLine`** property of the Element interface reflects the value of the aria-multiline attribute, which indicates whether a text box accepts multiple lines of input or only a single line. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaMultiLine) + */ ariaMultiLine: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaMultiSelectable) */ + /** + * The **`ariaMultiSelectable`** property of the Element interface reflects the value of the aria-multiselectable attribute, which indicates that the user may select more than one item from the current selectable descendants. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaMultiSelectable) + */ ariaMultiSelectable: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaOrientation) */ + /** + * The **`ariaOrientation`** property of the Element interface reflects the value of the aria-orientation attribute, which indicates whether the element's orientation is horizontal, vertical, or unknown/ambiguous. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaOrientation) + */ ariaOrientation: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaOwnsElements) */ + /** + * The **`ariaOwnsElements`** property of the Element interface is an array containing the element (or elements) that define a visual, functional, or contextual relationship between a parent element that it is applied to, and its child elements. This is used when the DOM hierarchy cannot be used to represent the relationship, and it would not otherwise be available to assistive technology, + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaOwnsElements) + */ ariaOwnsElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPlaceholder) */ + /** + * The **`ariaPlaceholder`** property of the Element interface reflects the value of the aria-placeholder attribute, which defines a short hint intended to aid the user with data entry when the control has no value. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPlaceholder) + */ ariaPlaceholder: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPosInSet) */ + /** + * The **`ariaPosInSet`** property of the Element interface reflects the value of the aria-posinset attribute, which defines an element's number or position in the current set of listitems or treeitems. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPosInSet) + */ ariaPosInSet: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPressed) */ + /** + * The **`ariaPressed`** property of the Element interface reflects the value of the aria-pressed attribute, which indicates the current "pressed" state of toggle buttons. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPressed) + */ ariaPressed: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaReadOnly) */ + /** + * The **`ariaReadOnly`** property of the Element interface reflects the value of the aria-readonly attribute, which indicates that the element is not editable, but is otherwise operable. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaReadOnly) + */ ariaReadOnly: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRelevant) */ + /** + * The **`ariaRelevant`** property of the Element interface reflects the value of the aria-relevant attribute, which indicates what notifications the user agent will trigger when the accessibility tree within a live region is modified. This is used to describe what changes in an aria-live region are relevant and should be announced. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRelevant) + */ ariaRelevant: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRequired) */ + /** + * The **`ariaRequired`** property of the Element interface reflects the value of the aria-required attribute, which indicates that user input is required on the element before a form may be submitted. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRequired) + */ ariaRequired: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRoleDescription) */ + /** + * The **`ariaRoleDescription`** property of the Element interface reflects the value of the aria-roledescription attribute, which defines a human-readable, author-localized description for the role of an element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRoleDescription) + */ ariaRoleDescription: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowCount) */ + /** + * The **`ariaRowCount`** property of the Element interface reflects the value of the aria-rowcount attribute, which defines the total number of rows in a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowCount) + */ ariaRowCount: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowIndex) */ + /** + * The **`ariaRowIndex`** property of the Element interface reflects the value of the aria-rowindex attribute, which defines an element's row index or position with respect to the total number of rows within a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowIndex) + */ ariaRowIndex: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowIndexText) */ + /** + * The **`ariaRowIndexText`** property of the Element interface reflects the value of the aria-rowindextext attribute, which defines a human readable text alternative of aria-rowindex. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowIndexText) + */ ariaRowIndexText: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowSpan) */ + /** + * The **`ariaRowSpan`** property of the Element interface reflects the value of the aria-rowspan attribute, which defines the number of rows spanned by a cell or gridcell within a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowSpan) + */ ariaRowSpan: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSelected) */ + /** + * The **`ariaSelected`** property of the Element interface reflects the value of the aria-selected attribute, which indicates the current "selected" state of elements that have a selected state. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSelected) + */ ariaSelected: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSetSize) */ + /** + * The **`ariaSetSize`** property of the Element interface reflects the value of the aria-setsize attribute, which defines the number of items in the current set of listitems or treeitems. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSetSize) + */ ariaSetSize: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSort) */ + /** + * The **`ariaSort`** property of the Element interface reflects the value of the aria-sort attribute, which indicates if items in a table or grid are sorted in ascending or descending order. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSort) + */ ariaSort: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueMax) */ + /** + * The **`ariaValueMax`** property of the Element interface reflects the value of the aria-valuemax attribute, which defines the maximum allowed value for a range widget. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueMax) + */ ariaValueMax: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueMin) */ + /** + * The **`ariaValueMin`** property of the Element interface reflects the value of the aria-valuemin attribute, which defines the minimum allowed value for a range widget. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueMin) + */ ariaValueMin: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueNow) */ + /** + * The **`ariaValueNow`** property of the Element interface reflects the value of the aria-valuenow attribute, which defines the current value for a range widget. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueNow) + */ ariaValueNow: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueText) */ + /** + * The **`ariaValueText`** property of the Element interface reflects the value of the aria-valuetext attribute, which defines the human-readable text alternative of aria-valuenow for a range widget. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueText) + */ ariaValueText: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/role) */ + /** + * The **`role`** property of the Element interface returns the explicitly set WAI-ARIA role for the element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/role) + */ role: string | null; } @@ -5202,21 +5410,53 @@ declare var BlobEvent: { }; interface Body { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) */ + /** + * The **`body`** read-only property of the Request interface contains a ReadableStream with the body contents that have been added to the request. Note that a request using the GET or HEAD method cannot have a body and null is returned in these cases. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) + */ readonly body: ReadableStream | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */ + /** + * The **`bodyUsed`** read-only property of the Request interface is a boolean value that indicates whether the request body has been read yet. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) + */ readonly bodyUsed: boolean; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */ + /** + * The **`arrayBuffer()`** method of the Request interface reads the request body and returns it as a promise that resolves with an ArrayBuffer. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) + */ arrayBuffer(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */ + /** + * The **`blob()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Blob. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) + */ blob(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) */ + /** + * The **`bytes()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Uint8Array. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) + */ bytes(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) */ + /** + * The **`formData()`** method of the Request interface reads the request body and returns it as a promise that resolves with a FormData object. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) + */ formData(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) */ + /** + * The **`json()`** method of the Request interface reads the request body and returns it as a promise that resolves with the result of parsing the body text as JSON. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) + */ json(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) */ + /** + * The **`text()`** method of the Request interface reads the request body and returns it as a promise that resolves with a String. The response is always decoded using UTF-8. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) + */ text(): Promise; } @@ -13429,34 +13669,56 @@ declare var DocumentFragment: { interface DocumentOrShadowRoot { /** - * Returns the deepest element in the document through which or to which key events are being routed. This is, roughly speaking, the focused element in the document. - * - * For the purposes of this API, when a child browsing context is focused, its container is focused in the parent browsing context. For example, if the user moves the focus to a text control in an iframe, the iframe is the element returned by the activeElement API in the iframe's node document. - * - * Similarly, when the focused element is in a different node tree than documentOrShadowRoot, the element returned will be the host that's located in the same node tree as documentOrShadowRoot if documentOrShadowRoot is a shadow-including inclusive ancestor of the focused element, and null if not. + * The **`activeElement`** read-only property of the Document interface returns the Element within the DOM that is receiving keyboard events such as keydown and keyup. This is usually analogous to the focused element. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/activeElement) */ readonly activeElement: Element | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/adoptedStyleSheets) */ + /** + * The **`adoptedStyleSheets`** property of the Document interface is used for setting an array of constructed stylesheets to be used by the document. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/adoptedStyleSheets) + */ adoptedStyleSheets: CSSStyleSheet[]; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/customElementRegistry) */ + /** + * The **`customElementRegistry`** read-only property of the Document interface returns the CustomElementRegistry object associated with this document, or null if one has not been set. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/customElementRegistry) + */ readonly customElementRegistry: CustomElementRegistry | null; /** - * Returns document's fullscreen element. + * The **`Document.fullscreenElement`** read-only property returns the Element that is currently being presented in fullscreen mode in this document, or null if fullscreen mode is not currently in use. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/fullscreenElement) */ readonly fullscreenElement: Element | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/pictureInPictureElement) */ + /** + * The read-only **`pictureInPictureElement`** property of the Document interface returns the Element that is currently being presented in picture-in-picture mode in this document, or null if picture-in-picture mode is not currently in use. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/pictureInPictureElement) + */ readonly pictureInPictureElement: Element | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/pointerLockElement) */ + /** + * The **`pointerLockElement`** read-only property of the Document interface provides the element set as the target for mouse events while the pointer is locked. It is null if lock is pending, pointer is unlocked, or the target is in another document. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/pointerLockElement) + */ readonly pointerLockElement: Element | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/styleSheets) */ + /** + * The **`styleSheets`** read-only property of the Document interface returns a StyleSheetList of CSSStyleSheet objects, for stylesheets explicitly linked into or embedded in a document. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/styleSheets) + */ readonly styleSheets: StyleSheetList; + /** The **`elementFromPoint()`** method, available on the Document object, returns the topmost Element at the specified coordinates (relative to the viewport). */ elementFromPoint(x: number, y: number): Element | null; + /** The **`elementsFromPoint()`** method of the Document interface returns an array of all elements at the specified coordinates (relative to the viewport). The elements are ordered from the topmost to the bottommost box of the viewport. */ elementsFromPoint(x: number, y: number): Element[]; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/getAnimations) */ + /** + * The **`getAnimations()`** method of the Document interface returns an array of all Animation objects currently in effect whose target elements are descendants of the document. This array includes CSS Animations, CSS Transitions, and Web Animations. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/getAnimations) + */ getAnimations(): Animation[]; } @@ -18625,9 +18887,7 @@ declare var HTMLHtmlElement: { interface HTMLHyperlinkElementUtils { /** - * Returns the hyperlink's URL. - * - * Can be set, to change the URL. + * The **`href`** property of the HTMLAnchorElement interface is a stringifier that returns the absolute URL corresponding to the element's href attribute (or an empty string if href is unset). Setting this property updates the element's href attribute to the provided value. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/href) */ @@ -22171,79 +22431,61 @@ declare var History: { interface HyperlinkElementUtils { /** - * Returns the hyperlink's URL's fragment (includes leading "#" if non-empty). - * - * Can be set, to change the URL's fragment (ignores leading "#"). + * The **`hash`** property of the HTMLAnchorElement interface is a string containing a "#" followed by the fragment identifier of the element's href. If the URL does not have a fragment identifier, this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/hash) */ hash: string; /** - * Returns the hyperlink's URL's host and port (if different from the default port for the scheme). - * - * Can be set, to change the URL's host and port. + * The **`host`** property of the HTMLAnchorElement interface is a string containing the host, which is the hostname, and then, if the port of the URL is nonempty, a ":", followed by the port of the URL. If the URL does not have a hostname, this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/host) */ host: string; /** - * Returns the hyperlink's URL's host. - * - * Can be set, to change the URL's host. + * The **`hostname`** property of the HTMLAnchorElement interface is a string containing either the domain name or IP address of the element's href. If the URL does not have a hostname, this property contains an empty string, "". IPv4 and IPv6 addresses are normalized, such as stripping leading zeros, and domain names are converted to IDN. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/hostname) */ hostname: string; /** - * Returns the hyperlink's URL's origin. + * The **`origin`** read-only property of the HTMLAnchorElement interface returns a string containing the Unicode serialization of the origin of the element's href. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/origin) */ readonly origin: string; /** - * Returns the hyperlink's URL's password. - * - * Can be set, to change the URL's password. + * The **`password`** property of the HTMLAnchorElement interface is a string containing the password component of the element's href. If the URL does not have a password, this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/password) */ password: string; /** - * Returns the hyperlink's URL's path. - * - * Can be set, to change the URL's path. + * The **`HTMLAnchorElement.pathname`** property is a string containing an initial '/' followed by the path of the URL not including the query string or fragment (or the empty string if there is no path). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/pathname) */ pathname: string; /** - * Returns the hyperlink's URL's port. - * - * Can be set, to change the URL's port. + * The **`port`** property of the HTMLAnchorElement interface is a string containing the port number of the element's href. If the port is the default for the protocol (80 for ws: and http:, 443 for wss: and https:, and 21 for ftp:), this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/port) */ port: string; /** - * Returns the hyperlink's URL's scheme. - * - * Can be set, to change the URL's scheme. + * The **`protocol`** property of the HTMLAnchorElement interface is a string containing the protocol or scheme of the element's href, including the final ":". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/protocol) */ protocol: string; /** - * Returns the hyperlink's URL's query (includes leading "?" if non-empty). - * - * Can be set, to change the URL's query (ignores leading "?"). + * The **`search`** property of the HTMLAnchorElement interface is a search string, also called a query string, that is a string containing a "?" followed by the parameters of the element's href. If the URL does not have a search query, this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/search) */ search: string; /** - * Returns the hyperlink's URL's username. - * - * Can be set, to change the URL's username. + * The **`username`** property of the HTMLAnchorElement interface is a string containing the username component of the element's href. If the URL does not have a username, this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/username) */ @@ -26678,7 +26920,7 @@ interface NonDocumentTypeChildNode { interface NonElementParentNode { /** - * Returns the first element within node's descendants whose ID is elementId. + * The **`getElementById()`** method of the Document interface returns an Element object representing the element whose id property matches the specified string. Since element IDs are required to be unique if specified, they're a useful way to get access to a specific element quickly. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/getElementById) */ @@ -27356,46 +27598,50 @@ declare var PannerNode: { }; interface ParentNode extends Node { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/childElementCount) */ + /** + * The **`Document.childElementCount`** read-only property returns the number of child elements of the document. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/childElementCount) + */ readonly childElementCount: number; /** - * Returns the child elements. + * The read-only **`children`** property returns a live HTMLCollection which contains all of the child elements of the document upon which it was called. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/children) */ readonly children: HTMLCollection; /** - * Returns the first child that is an element, and null otherwise. + * The **`Document.firstElementChild`** read-only property returns the document's first child Element, or null if there are no child elements. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/firstElementChild) */ readonly firstElementChild: Element | null; /** - * Returns the last child that is an element, and null otherwise. + * The **`Document.lastElementChild`** read-only property returns the document's last child Element, or null if there are no child elements. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/lastElementChild) */ readonly lastElementChild: Element | null; /** - * Inserts nodes after the last child of node, while replacing strings in nodes with equivalent Text nodes. - * - * Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated. + * The **`Document.append()`** method inserts a set of Node objects or strings after the last child of the document. Strings are inserted as equivalent Text nodes. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/append) */ append(...nodes: (Node | string)[]): void; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/moveBefore) */ - moveBefore(node: Node, child: Node | null): void; /** - * Inserts nodes before the first child of node, while replacing strings in nodes with equivalent Text nodes. + * The **`moveBefore()`** method of the Document interface moves a given Node inside the Document DOM node as a direct child, before a given reference node. * - * Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated. + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/moveBefore) + */ + moveBefore(node: Node, child: Node | null): void; + /** + * The **`Document.prepend()`** method inserts a set of Node objects or strings before the first child of the document. Strings are inserted as equivalent Text nodes. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/prepend) */ prepend(...nodes: (Node | string)[]): void; /** - * Returns the first element that is a descendant of node that matches selectors. + * The Document method **`querySelector()`** returns the first Element within the document that matches the specified CSS selector, or group of CSS selectors. If no matches are found, null is returned. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/querySelector) */ @@ -27406,7 +27652,7 @@ interface ParentNode extends Node { querySelector(selectors: K): HTMLElementDeprecatedTagNameMap[K] | null; querySelector(selectors: string): E | null; /** - * Returns all element descendants of node that match selectors. + * The Document method **`querySelectorAll()`** returns a static (not live) NodeList representing a list of the document's elements that match the specified group of selectors. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/querySelectorAll) */ @@ -27417,9 +27663,7 @@ interface ParentNode extends Node { querySelectorAll(selectors: K): NodeListOf; querySelectorAll(selectors: string): NodeListOf; /** - * Replace all children of node with nodes, while replacing strings in nodes with equivalent Text nodes. - * - * Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated. + * The **`Document.replaceChildren()`** method replaces the existing children of a Document with a specified new set of children. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/replaceChildren) */ @@ -28885,9 +29129,17 @@ declare var PopStateEvent: { }; interface PopoverTargetAttributes { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/popoverTargetAction) */ + /** + * The **`popoverTargetAction`** property of the HTMLButtonElement interface gets and sets the action to be performed ("hide", "show", or "toggle") on a popover element being controlled by a button. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/popoverTargetAction) + */ popoverTargetAction: string; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/popoverTargetElement) */ + /** + * The **`popoverTargetElement`** property of the HTMLButtonElement interface gets and sets the popover element to control via a button. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/popoverTargetElement) + */ popoverTargetElement: Element | null; } diff --git a/baselines/ts5.5/serviceworker.generated.d.ts b/baselines/ts5.5/serviceworker.generated.d.ts index 64b218b98..73b971f65 100644 --- a/baselines/ts5.5/serviceworker.generated.d.ts +++ b/baselines/ts5.5/serviceworker.generated.d.ts @@ -1448,21 +1448,53 @@ declare var Blob: { }; interface Body { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) */ + /** + * The **`body`** read-only property of the Request interface contains a ReadableStream with the body contents that have been added to the request. Note that a request using the GET or HEAD method cannot have a body and null is returned in these cases. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) + */ readonly body: ReadableStream | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */ + /** + * The **`bodyUsed`** read-only property of the Request interface is a boolean value that indicates whether the request body has been read yet. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) + */ readonly bodyUsed: boolean; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */ + /** + * The **`arrayBuffer()`** method of the Request interface reads the request body and returns it as a promise that resolves with an ArrayBuffer. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) + */ arrayBuffer(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */ + /** + * The **`blob()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Blob. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) + */ blob(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) */ + /** + * The **`bytes()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Uint8Array. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) + */ bytes(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) */ + /** + * The **`formData()`** method of the Request interface reads the request body and returns it as a promise that resolves with a FormData object. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) + */ formData(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) */ + /** + * The **`json()`** method of the Request interface reads the request body and returns it as a promise that resolves with the result of parsing the body text as JSON. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) + */ json(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) */ + /** + * The **`text()`** method of the Request interface reads the request body and returns it as a promise that resolves with a String. The response is always decoded using UTF-8. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) + */ text(): Promise; } diff --git a/baselines/ts5.5/sharedworker.generated.d.ts b/baselines/ts5.5/sharedworker.generated.d.ts index 35a6ebfc2..18c1e3e8f 100644 --- a/baselines/ts5.5/sharedworker.generated.d.ts +++ b/baselines/ts5.5/sharedworker.generated.d.ts @@ -1384,21 +1384,53 @@ declare var Blob: { }; interface Body { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) */ + /** + * The **`body`** read-only property of the Request interface contains a ReadableStream with the body contents that have been added to the request. Note that a request using the GET or HEAD method cannot have a body and null is returned in these cases. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) + */ readonly body: ReadableStream | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */ + /** + * The **`bodyUsed`** read-only property of the Request interface is a boolean value that indicates whether the request body has been read yet. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) + */ readonly bodyUsed: boolean; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */ + /** + * The **`arrayBuffer()`** method of the Request interface reads the request body and returns it as a promise that resolves with an ArrayBuffer. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) + */ arrayBuffer(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */ + /** + * The **`blob()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Blob. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) + */ blob(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) */ + /** + * The **`bytes()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Uint8Array. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) + */ bytes(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) */ + /** + * The **`formData()`** method of the Request interface reads the request body and returns it as a promise that resolves with a FormData object. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) + */ formData(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) */ + /** + * The **`json()`** method of the Request interface reads the request body and returns it as a promise that resolves with the result of parsing the body text as JSON. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) + */ json(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) */ + /** + * The **`text()`** method of the Request interface reads the request body and returns it as a promise that resolves with a String. The response is always decoded using UTF-8. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) + */ text(): Promise; } diff --git a/baselines/ts5.5/webworker.generated.d.ts b/baselines/ts5.5/webworker.generated.d.ts index 163cdc03f..7dcc9a41e 100644 --- a/baselines/ts5.5/webworker.generated.d.ts +++ b/baselines/ts5.5/webworker.generated.d.ts @@ -1955,21 +1955,53 @@ declare var Blob: { }; interface Body { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) */ + /** + * The **`body`** read-only property of the Request interface contains a ReadableStream with the body contents that have been added to the request. Note that a request using the GET or HEAD method cannot have a body and null is returned in these cases. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) + */ readonly body: ReadableStream | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */ + /** + * The **`bodyUsed`** read-only property of the Request interface is a boolean value that indicates whether the request body has been read yet. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) + */ readonly bodyUsed: boolean; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */ + /** + * The **`arrayBuffer()`** method of the Request interface reads the request body and returns it as a promise that resolves with an ArrayBuffer. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) + */ arrayBuffer(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */ + /** + * The **`blob()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Blob. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) + */ blob(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) */ + /** + * The **`bytes()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Uint8Array. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) + */ bytes(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) */ + /** + * The **`formData()`** method of the Request interface reads the request body and returns it as a promise that resolves with a FormData object. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) + */ formData(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) */ + /** + * The **`json()`** method of the Request interface reads the request body and returns it as a promise that resolves with the result of parsing the body text as JSON. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) + */ json(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) */ + /** + * The **`text()`** method of the Request interface reads the request body and returns it as a promise that resolves with a String. The response is always decoded using UTF-8. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) + */ text(): Promise; } diff --git a/baselines/ts5.6/dom.generated.d.ts b/baselines/ts5.6/dom.generated.d.ts index 8a0b18daa..00f1b7da7 100644 --- a/baselines/ts5.6/dom.generated.d.ts +++ b/baselines/ts5.6/dom.generated.d.ts @@ -3329,109 +3329,317 @@ interface ANGLE_instanced_arrays { } interface ARIAMixin { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaActiveDescendantElement) */ + /** + * The **`ariaActiveDescendantElement`** property of the Element interface represents the current active element when focus is on a composite widget, combobox, textbox, group, or application. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaActiveDescendantElement) + */ ariaActiveDescendantElement: Element | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaAtomic) */ + /** + * The **`ariaAtomic`** property of the Element interface reflects the value of the aria-atomic attribute, which indicates whether assistive technologies will present all, or only parts of, the changed region based on the change notifications defined by the aria-relevant attribute. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaAtomic) + */ ariaAtomic: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaAutoComplete) */ + /** + * The **`ariaAutoComplete`** property of the Element interface reflects the value of the aria-autocomplete attribute, which indicates whether inputting text could trigger display of one or more predictions of the user's intended value for a combobox, searchbox, or textbox and specifies how predictions would be presented if they were made. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaAutoComplete) + */ ariaAutoComplete: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBrailleLabel) */ + /** + * The **`ariaBrailleLabel`** property of the Element interface reflects the value of the aria-braillelabel attribute, which defines the ARIA braille label of the element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBrailleLabel) + */ ariaBrailleLabel: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBrailleRoleDescription) */ + /** + * The **`ariaBrailleRoleDescription`** property of the Element interface reflects the value of the aria-brailleroledescription attribute, which defines the ARIA braille role description of the element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBrailleRoleDescription) + */ ariaBrailleRoleDescription: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBusy) */ + /** + * The **`ariaBusy`** property of the Element interface reflects the value of the aria-busy attribute, which indicates whether an element is being modified, as assistive technologies may want to wait until the modifications are complete before exposing them to the user. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBusy) + */ ariaBusy: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaChecked) */ + /** + * The **`ariaChecked`** property of the Element interface reflects the value of the aria-checked attribute, which indicates the current "checked" state of checkboxes, radio buttons, and other widgets that have a checked state. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaChecked) + */ ariaChecked: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColCount) */ + /** + * The **`ariaColCount`** property of the Element interface reflects the value of the aria-colcount attribute, which defines the number of columns in a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColCount) + */ ariaColCount: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColIndex) */ + /** + * The **`ariaColIndex`** property of the Element interface reflects the value of the aria-colindex attribute, which defines an element's column index or position with respect to the total number of columns within a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColIndex) + */ ariaColIndex: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColIndexText) */ + /** + * The **`ariaColIndexText`** property of the Element interface reflects the value of the aria-colindextext attribute, which defines a human readable text alternative of aria-colindex. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColIndexText) + */ ariaColIndexText: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColSpan) */ + /** + * The **`ariaColSpan`** property of the Element interface reflects the value of the aria-colspan attribute, which defines the number of columns spanned by a cell or gridcell within a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColSpan) + */ ariaColSpan: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaControlsElements) */ + /** + * The **`ariaControlsElements`** property of the Element interface is an array containing the elements that are controlled by the element it is applied to. For example, this might be set on a combobox to indicate the element that it pops up, or on a scrollbar to indicate the ID of the element it controls. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaControlsElements) + */ ariaControlsElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaCurrent) */ + /** + * The **`ariaCurrent`** property of the Element interface reflects the value of the aria-current attribute, which indicates the element that represents the current item within a container or set of related elements. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaCurrent) + */ ariaCurrent: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDescribedByElements) */ + /** + * The **`ariaDescribedByElements`** property of the Element interface is an array containing the element (or elements) that provide an accessible description for the element it is applied to. The accessible description is similar to the accessible label (see ariaLabelledByElements), but provides more verbose information. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDescribedByElements) + */ ariaDescribedByElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDescription) */ + /** + * The **`ariaDescription`** property of the Element interface reflects the value of the aria-description attribute, which defines a string value that describes or annotates the current element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDescription) + */ ariaDescription: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDetailsElements) */ + /** + * The **`ariaDetailsElements`** property of the Element interface is an array containing the element (or elements) that provide an accessible details for the element it is applied to. The accessible details are similar to the accessible description (see ariaDescribedByElements), but provides more verbose information. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDetailsElements) + */ ariaDetailsElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDisabled) */ + /** + * The **`ariaDisabled`** property of the Element interface reflects the value of the aria-disabled attribute, which indicates that the element is perceivable but disabled, so it is not editable or otherwise operable. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDisabled) + */ ariaDisabled: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaErrorMessageElements) */ + /** + * The **`ariaErrorMessageElements`** property of the Element interface is an array containing the element (or elements) that provide an error message for the element it is applied to. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaErrorMessageElements) + */ ariaErrorMessageElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaExpanded) */ + /** + * The **`ariaExpanded`** property of the Element interface reflects the value of the aria-expanded attribute, which indicates whether a grouping element owned or controlled by this element is expanded or collapsed. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaExpanded) + */ ariaExpanded: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaFlowToElements) */ + /** + * The **`ariaFlowToElements`** property of the Element interface is an array containing the element (or elements) that provide an alternate reading order of content, overriding the general default reading order at the user's discretion. If just one element is provided this is the next element in the reading order. If multiple elements are provided, then each element represents a possible path that should be offered to the user for selection. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaFlowToElements) + */ ariaFlowToElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaHasPopup) */ + /** + * The **`ariaHasPopup`** property of the Element interface reflects the value of the aria-haspopup attribute, which indicates the availability and type of interactive popup element, such as menu or dialog, that can be triggered by an element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaHasPopup) + */ ariaHasPopup: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaHidden) */ + /** + * The **`ariaHidden`** property of the Element interface reflects the value of the aria-hidden) attribute, which indicates whether the element is exposed to an accessibility API. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaHidden) + */ ariaHidden: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaInvalid) */ + /** + * The **`ariaInvalid`** property of the Element interface reflects the value of the aria-invalid attribute. Relevant for the application, checkbox, combobox, gridcell, listbox, radiogroup, slider, spinbutton, textbox, and tree roles, it indicates to the accessibility API whether the entered value does not conform to the format expected by the application. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaInvalid) + */ ariaInvalid: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaKeyShortcuts) */ + /** + * The **`ariaKeyShortcuts`** property of the Element interface reflects the value of the aria-keyshortcuts attribute, which indicates keyboard shortcuts that an author has implemented to activate or give focus to an element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaKeyShortcuts) + */ ariaKeyShortcuts: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLabel) */ + /** + * The **`ariaLabel`** property of the Element interface reflects the value of the aria-label attribute, which defines a string value that labels the current element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLabel) + */ ariaLabel: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLabelledByElements) */ + /** + * The **`ariaLabelledByElements`** property of the Element interface is an array containing the element (or elements) that provide an accessible name for the element it is applied to. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLabelledByElements) + */ ariaLabelledByElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLevel) */ + /** + * The **`ariaLevel`** property of the Element interface reflects the value of the aria-level attribute, which defines the hierarchical level of an element within a structure. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLevel) + */ ariaLevel: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLive) */ + /** + * The **`ariaLive`** property of the Element interface reflects the value of the aria-live attribute, which indicates that an element will be updated, and describes the types of updates the user agents, assistive technologies, and user can expect from the live region. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLive) + */ ariaLive: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaModal) */ + /** + * The **`ariaModal`** property of the Element interface reflects the value of the aria-modal attribute, which indicates whether an element is modal when displayed. Applying the aria-modal property to an element with role="dialog" replaces the technique of using aria-hidden on the background for informing assistive technologies that content outside a dialog is inert. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaModal) + */ ariaModal: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaMultiLine) */ + /** + * The **`ariaMultiLine`** property of the Element interface reflects the value of the aria-multiline attribute, which indicates whether a text box accepts multiple lines of input or only a single line. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaMultiLine) + */ ariaMultiLine: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaMultiSelectable) */ + /** + * The **`ariaMultiSelectable`** property of the Element interface reflects the value of the aria-multiselectable attribute, which indicates that the user may select more than one item from the current selectable descendants. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaMultiSelectable) + */ ariaMultiSelectable: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaOrientation) */ + /** + * The **`ariaOrientation`** property of the Element interface reflects the value of the aria-orientation attribute, which indicates whether the element's orientation is horizontal, vertical, or unknown/ambiguous. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaOrientation) + */ ariaOrientation: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaOwnsElements) */ + /** + * The **`ariaOwnsElements`** property of the Element interface is an array containing the element (or elements) that define a visual, functional, or contextual relationship between a parent element that it is applied to, and its child elements. This is used when the DOM hierarchy cannot be used to represent the relationship, and it would not otherwise be available to assistive technology, + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaOwnsElements) + */ ariaOwnsElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPlaceholder) */ + /** + * The **`ariaPlaceholder`** property of the Element interface reflects the value of the aria-placeholder attribute, which defines a short hint intended to aid the user with data entry when the control has no value. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPlaceholder) + */ ariaPlaceholder: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPosInSet) */ + /** + * The **`ariaPosInSet`** property of the Element interface reflects the value of the aria-posinset attribute, which defines an element's number or position in the current set of listitems or treeitems. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPosInSet) + */ ariaPosInSet: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPressed) */ + /** + * The **`ariaPressed`** property of the Element interface reflects the value of the aria-pressed attribute, which indicates the current "pressed" state of toggle buttons. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPressed) + */ ariaPressed: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaReadOnly) */ + /** + * The **`ariaReadOnly`** property of the Element interface reflects the value of the aria-readonly attribute, which indicates that the element is not editable, but is otherwise operable. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaReadOnly) + */ ariaReadOnly: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRelevant) */ + /** + * The **`ariaRelevant`** property of the Element interface reflects the value of the aria-relevant attribute, which indicates what notifications the user agent will trigger when the accessibility tree within a live region is modified. This is used to describe what changes in an aria-live region are relevant and should be announced. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRelevant) + */ ariaRelevant: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRequired) */ + /** + * The **`ariaRequired`** property of the Element interface reflects the value of the aria-required attribute, which indicates that user input is required on the element before a form may be submitted. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRequired) + */ ariaRequired: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRoleDescription) */ + /** + * The **`ariaRoleDescription`** property of the Element interface reflects the value of the aria-roledescription attribute, which defines a human-readable, author-localized description for the role of an element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRoleDescription) + */ ariaRoleDescription: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowCount) */ + /** + * The **`ariaRowCount`** property of the Element interface reflects the value of the aria-rowcount attribute, which defines the total number of rows in a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowCount) + */ ariaRowCount: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowIndex) */ + /** + * The **`ariaRowIndex`** property of the Element interface reflects the value of the aria-rowindex attribute, which defines an element's row index or position with respect to the total number of rows within a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowIndex) + */ ariaRowIndex: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowIndexText) */ + /** + * The **`ariaRowIndexText`** property of the Element interface reflects the value of the aria-rowindextext attribute, which defines a human readable text alternative of aria-rowindex. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowIndexText) + */ ariaRowIndexText: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowSpan) */ + /** + * The **`ariaRowSpan`** property of the Element interface reflects the value of the aria-rowspan attribute, which defines the number of rows spanned by a cell or gridcell within a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowSpan) + */ ariaRowSpan: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSelected) */ + /** + * The **`ariaSelected`** property of the Element interface reflects the value of the aria-selected attribute, which indicates the current "selected" state of elements that have a selected state. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSelected) + */ ariaSelected: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSetSize) */ + /** + * The **`ariaSetSize`** property of the Element interface reflects the value of the aria-setsize attribute, which defines the number of items in the current set of listitems or treeitems. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSetSize) + */ ariaSetSize: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSort) */ + /** + * The **`ariaSort`** property of the Element interface reflects the value of the aria-sort attribute, which indicates if items in a table or grid are sorted in ascending or descending order. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSort) + */ ariaSort: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueMax) */ + /** + * The **`ariaValueMax`** property of the Element interface reflects the value of the aria-valuemax attribute, which defines the maximum allowed value for a range widget. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueMax) + */ ariaValueMax: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueMin) */ + /** + * The **`ariaValueMin`** property of the Element interface reflects the value of the aria-valuemin attribute, which defines the minimum allowed value for a range widget. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueMin) + */ ariaValueMin: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueNow) */ + /** + * The **`ariaValueNow`** property of the Element interface reflects the value of the aria-valuenow attribute, which defines the current value for a range widget. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueNow) + */ ariaValueNow: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueText) */ + /** + * The **`ariaValueText`** property of the Element interface reflects the value of the aria-valuetext attribute, which defines the human-readable text alternative of aria-valuenow for a range widget. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueText) + */ ariaValueText: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/role) */ + /** + * The **`role`** property of the Element interface returns the explicitly set WAI-ARIA role for the element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/role) + */ role: string | null; } @@ -5202,21 +5410,53 @@ declare var BlobEvent: { }; interface Body { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) */ + /** + * The **`body`** read-only property of the Request interface contains a ReadableStream with the body contents that have been added to the request. Note that a request using the GET or HEAD method cannot have a body and null is returned in these cases. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) + */ readonly body: ReadableStream | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */ + /** + * The **`bodyUsed`** read-only property of the Request interface is a boolean value that indicates whether the request body has been read yet. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) + */ readonly bodyUsed: boolean; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */ + /** + * The **`arrayBuffer()`** method of the Request interface reads the request body and returns it as a promise that resolves with an ArrayBuffer. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) + */ arrayBuffer(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */ + /** + * The **`blob()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Blob. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) + */ blob(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) */ + /** + * The **`bytes()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Uint8Array. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) + */ bytes(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) */ + /** + * The **`formData()`** method of the Request interface reads the request body and returns it as a promise that resolves with a FormData object. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) + */ formData(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) */ + /** + * The **`json()`** method of the Request interface reads the request body and returns it as a promise that resolves with the result of parsing the body text as JSON. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) + */ json(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) */ + /** + * The **`text()`** method of the Request interface reads the request body and returns it as a promise that resolves with a String. The response is always decoded using UTF-8. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) + */ text(): Promise; } @@ -13437,34 +13677,56 @@ declare var DocumentFragment: { interface DocumentOrShadowRoot { /** - * Returns the deepest element in the document through which or to which key events are being routed. This is, roughly speaking, the focused element in the document. - * - * For the purposes of this API, when a child browsing context is focused, its container is focused in the parent browsing context. For example, if the user moves the focus to a text control in an iframe, the iframe is the element returned by the activeElement API in the iframe's node document. - * - * Similarly, when the focused element is in a different node tree than documentOrShadowRoot, the element returned will be the host that's located in the same node tree as documentOrShadowRoot if documentOrShadowRoot is a shadow-including inclusive ancestor of the focused element, and null if not. + * The **`activeElement`** read-only property of the Document interface returns the Element within the DOM that is receiving keyboard events such as keydown and keyup. This is usually analogous to the focused element. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/activeElement) */ readonly activeElement: Element | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/adoptedStyleSheets) */ + /** + * The **`adoptedStyleSheets`** property of the Document interface is used for setting an array of constructed stylesheets to be used by the document. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/adoptedStyleSheets) + */ adoptedStyleSheets: CSSStyleSheet[]; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/customElementRegistry) */ + /** + * The **`customElementRegistry`** read-only property of the Document interface returns the CustomElementRegistry object associated with this document, or null if one has not been set. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/customElementRegistry) + */ readonly customElementRegistry: CustomElementRegistry | null; /** - * Returns document's fullscreen element. + * The **`Document.fullscreenElement`** read-only property returns the Element that is currently being presented in fullscreen mode in this document, or null if fullscreen mode is not currently in use. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/fullscreenElement) */ readonly fullscreenElement: Element | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/pictureInPictureElement) */ + /** + * The read-only **`pictureInPictureElement`** property of the Document interface returns the Element that is currently being presented in picture-in-picture mode in this document, or null if picture-in-picture mode is not currently in use. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/pictureInPictureElement) + */ readonly pictureInPictureElement: Element | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/pointerLockElement) */ + /** + * The **`pointerLockElement`** read-only property of the Document interface provides the element set as the target for mouse events while the pointer is locked. It is null if lock is pending, pointer is unlocked, or the target is in another document. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/pointerLockElement) + */ readonly pointerLockElement: Element | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/styleSheets) */ + /** + * The **`styleSheets`** read-only property of the Document interface returns a StyleSheetList of CSSStyleSheet objects, for stylesheets explicitly linked into or embedded in a document. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/styleSheets) + */ readonly styleSheets: StyleSheetList; + /** The **`elementFromPoint()`** method, available on the Document object, returns the topmost Element at the specified coordinates (relative to the viewport). */ elementFromPoint(x: number, y: number): Element | null; + /** The **`elementsFromPoint()`** method of the Document interface returns an array of all elements at the specified coordinates (relative to the viewport). The elements are ordered from the topmost to the bottommost box of the viewport. */ elementsFromPoint(x: number, y: number): Element[]; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/getAnimations) */ + /** + * The **`getAnimations()`** method of the Document interface returns an array of all Animation objects currently in effect whose target elements are descendants of the document. This array includes CSS Animations, CSS Transitions, and Web Animations. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/getAnimations) + */ getAnimations(): Animation[]; } @@ -18639,9 +18901,7 @@ declare var HTMLHtmlElement: { interface HTMLHyperlinkElementUtils { /** - * Returns the hyperlink's URL. - * - * Can be set, to change the URL. + * The **`href`** property of the HTMLAnchorElement interface is a stringifier that returns the absolute URL corresponding to the element's href attribute (or an empty string if href is unset). Setting this property updates the element's href attribute to the provided value. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/href) */ @@ -22192,79 +22452,61 @@ declare var History: { interface HyperlinkElementUtils { /** - * Returns the hyperlink's URL's fragment (includes leading "#" if non-empty). - * - * Can be set, to change the URL's fragment (ignores leading "#"). + * The **`hash`** property of the HTMLAnchorElement interface is a string containing a "#" followed by the fragment identifier of the element's href. If the URL does not have a fragment identifier, this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/hash) */ hash: string; /** - * Returns the hyperlink's URL's host and port (if different from the default port for the scheme). - * - * Can be set, to change the URL's host and port. + * The **`host`** property of the HTMLAnchorElement interface is a string containing the host, which is the hostname, and then, if the port of the URL is nonempty, a ":", followed by the port of the URL. If the URL does not have a hostname, this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/host) */ host: string; /** - * Returns the hyperlink's URL's host. - * - * Can be set, to change the URL's host. + * The **`hostname`** property of the HTMLAnchorElement interface is a string containing either the domain name or IP address of the element's href. If the URL does not have a hostname, this property contains an empty string, "". IPv4 and IPv6 addresses are normalized, such as stripping leading zeros, and domain names are converted to IDN. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/hostname) */ hostname: string; /** - * Returns the hyperlink's URL's origin. + * The **`origin`** read-only property of the HTMLAnchorElement interface returns a string containing the Unicode serialization of the origin of the element's href. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/origin) */ readonly origin: string; /** - * Returns the hyperlink's URL's password. - * - * Can be set, to change the URL's password. + * The **`password`** property of the HTMLAnchorElement interface is a string containing the password component of the element's href. If the URL does not have a password, this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/password) */ password: string; /** - * Returns the hyperlink's URL's path. - * - * Can be set, to change the URL's path. + * The **`HTMLAnchorElement.pathname`** property is a string containing an initial '/' followed by the path of the URL not including the query string or fragment (or the empty string if there is no path). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/pathname) */ pathname: string; /** - * Returns the hyperlink's URL's port. - * - * Can be set, to change the URL's port. + * The **`port`** property of the HTMLAnchorElement interface is a string containing the port number of the element's href. If the port is the default for the protocol (80 for ws: and http:, 443 for wss: and https:, and 21 for ftp:), this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/port) */ port: string; /** - * Returns the hyperlink's URL's scheme. - * - * Can be set, to change the URL's scheme. + * The **`protocol`** property of the HTMLAnchorElement interface is a string containing the protocol or scheme of the element's href, including the final ":". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/protocol) */ protocol: string; /** - * Returns the hyperlink's URL's query (includes leading "?" if non-empty). - * - * Can be set, to change the URL's query (ignores leading "?"). + * The **`search`** property of the HTMLAnchorElement interface is a search string, also called a query string, that is a string containing a "?" followed by the parameters of the element's href. If the URL does not have a search query, this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/search) */ search: string; /** - * Returns the hyperlink's URL's username. - * - * Can be set, to change the URL's username. + * The **`username`** property of the HTMLAnchorElement interface is a string containing the username component of the element's href. If the URL does not have a username, this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/username) */ @@ -26699,7 +26941,7 @@ interface NonDocumentTypeChildNode { interface NonElementParentNode { /** - * Returns the first element within node's descendants whose ID is elementId. + * The **`getElementById()`** method of the Document interface returns an Element object representing the element whose id property matches the specified string. Since element IDs are required to be unique if specified, they're a useful way to get access to a specific element quickly. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/getElementById) */ @@ -27377,46 +27619,50 @@ declare var PannerNode: { }; interface ParentNode extends Node { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/childElementCount) */ + /** + * The **`Document.childElementCount`** read-only property returns the number of child elements of the document. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/childElementCount) + */ readonly childElementCount: number; /** - * Returns the child elements. + * The read-only **`children`** property returns a live HTMLCollection which contains all of the child elements of the document upon which it was called. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/children) */ readonly children: HTMLCollection; /** - * Returns the first child that is an element, and null otherwise. + * The **`Document.firstElementChild`** read-only property returns the document's first child Element, or null if there are no child elements. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/firstElementChild) */ readonly firstElementChild: Element | null; /** - * Returns the last child that is an element, and null otherwise. + * The **`Document.lastElementChild`** read-only property returns the document's last child Element, or null if there are no child elements. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/lastElementChild) */ readonly lastElementChild: Element | null; /** - * Inserts nodes after the last child of node, while replacing strings in nodes with equivalent Text nodes. - * - * Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated. + * The **`Document.append()`** method inserts a set of Node objects or strings after the last child of the document. Strings are inserted as equivalent Text nodes. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/append) */ append(...nodes: (Node | string)[]): void; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/moveBefore) */ - moveBefore(node: Node, child: Node | null): void; /** - * Inserts nodes before the first child of node, while replacing strings in nodes with equivalent Text nodes. + * The **`moveBefore()`** method of the Document interface moves a given Node inside the Document DOM node as a direct child, before a given reference node. * - * Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated. + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/moveBefore) + */ + moveBefore(node: Node, child: Node | null): void; + /** + * The **`Document.prepend()`** method inserts a set of Node objects or strings before the first child of the document. Strings are inserted as equivalent Text nodes. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/prepend) */ prepend(...nodes: (Node | string)[]): void; /** - * Returns the first element that is a descendant of node that matches selectors. + * The Document method **`querySelector()`** returns the first Element within the document that matches the specified CSS selector, or group of CSS selectors. If no matches are found, null is returned. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/querySelector) */ @@ -27427,7 +27673,7 @@ interface ParentNode extends Node { querySelector(selectors: K): HTMLElementDeprecatedTagNameMap[K] | null; querySelector(selectors: string): E | null; /** - * Returns all element descendants of node that match selectors. + * The Document method **`querySelectorAll()`** returns a static (not live) NodeList representing a list of the document's elements that match the specified group of selectors. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/querySelectorAll) */ @@ -27438,9 +27684,7 @@ interface ParentNode extends Node { querySelectorAll(selectors: K): NodeListOf; querySelectorAll(selectors: string): NodeListOf; /** - * Replace all children of node with nodes, while replacing strings in nodes with equivalent Text nodes. - * - * Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated. + * The **`Document.replaceChildren()`** method replaces the existing children of a Document with a specified new set of children. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/replaceChildren) */ @@ -28906,9 +29150,17 @@ declare var PopStateEvent: { }; interface PopoverTargetAttributes { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/popoverTargetAction) */ + /** + * The **`popoverTargetAction`** property of the HTMLButtonElement interface gets and sets the action to be performed ("hide", "show", or "toggle") on a popover element being controlled by a button. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/popoverTargetAction) + */ popoverTargetAction: string; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/popoverTargetElement) */ + /** + * The **`popoverTargetElement`** property of the HTMLButtonElement interface gets and sets the popover element to control via a button. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/popoverTargetElement) + */ popoverTargetElement: Element | null; } diff --git a/baselines/ts5.6/serviceworker.generated.d.ts b/baselines/ts5.6/serviceworker.generated.d.ts index 64b218b98..73b971f65 100644 --- a/baselines/ts5.6/serviceworker.generated.d.ts +++ b/baselines/ts5.6/serviceworker.generated.d.ts @@ -1448,21 +1448,53 @@ declare var Blob: { }; interface Body { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) */ + /** + * The **`body`** read-only property of the Request interface contains a ReadableStream with the body contents that have been added to the request. Note that a request using the GET or HEAD method cannot have a body and null is returned in these cases. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) + */ readonly body: ReadableStream | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */ + /** + * The **`bodyUsed`** read-only property of the Request interface is a boolean value that indicates whether the request body has been read yet. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) + */ readonly bodyUsed: boolean; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */ + /** + * The **`arrayBuffer()`** method of the Request interface reads the request body and returns it as a promise that resolves with an ArrayBuffer. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) + */ arrayBuffer(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */ + /** + * The **`blob()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Blob. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) + */ blob(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) */ + /** + * The **`bytes()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Uint8Array. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) + */ bytes(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) */ + /** + * The **`formData()`** method of the Request interface reads the request body and returns it as a promise that resolves with a FormData object. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) + */ formData(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) */ + /** + * The **`json()`** method of the Request interface reads the request body and returns it as a promise that resolves with the result of parsing the body text as JSON. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) + */ json(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) */ + /** + * The **`text()`** method of the Request interface reads the request body and returns it as a promise that resolves with a String. The response is always decoded using UTF-8. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) + */ text(): Promise; } diff --git a/baselines/ts5.6/sharedworker.generated.d.ts b/baselines/ts5.6/sharedworker.generated.d.ts index 35a6ebfc2..18c1e3e8f 100644 --- a/baselines/ts5.6/sharedworker.generated.d.ts +++ b/baselines/ts5.6/sharedworker.generated.d.ts @@ -1384,21 +1384,53 @@ declare var Blob: { }; interface Body { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) */ + /** + * The **`body`** read-only property of the Request interface contains a ReadableStream with the body contents that have been added to the request. Note that a request using the GET or HEAD method cannot have a body and null is returned in these cases. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) + */ readonly body: ReadableStream | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */ + /** + * The **`bodyUsed`** read-only property of the Request interface is a boolean value that indicates whether the request body has been read yet. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) + */ readonly bodyUsed: boolean; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */ + /** + * The **`arrayBuffer()`** method of the Request interface reads the request body and returns it as a promise that resolves with an ArrayBuffer. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) + */ arrayBuffer(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */ + /** + * The **`blob()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Blob. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) + */ blob(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) */ + /** + * The **`bytes()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Uint8Array. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) + */ bytes(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) */ + /** + * The **`formData()`** method of the Request interface reads the request body and returns it as a promise that resolves with a FormData object. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) + */ formData(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) */ + /** + * The **`json()`** method of the Request interface reads the request body and returns it as a promise that resolves with the result of parsing the body text as JSON. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) + */ json(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) */ + /** + * The **`text()`** method of the Request interface reads the request body and returns it as a promise that resolves with a String. The response is always decoded using UTF-8. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) + */ text(): Promise; } diff --git a/baselines/ts5.6/webworker.generated.d.ts b/baselines/ts5.6/webworker.generated.d.ts index 163cdc03f..7dcc9a41e 100644 --- a/baselines/ts5.6/webworker.generated.d.ts +++ b/baselines/ts5.6/webworker.generated.d.ts @@ -1955,21 +1955,53 @@ declare var Blob: { }; interface Body { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) */ + /** + * The **`body`** read-only property of the Request interface contains a ReadableStream with the body contents that have been added to the request. Note that a request using the GET or HEAD method cannot have a body and null is returned in these cases. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) + */ readonly body: ReadableStream | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */ + /** + * The **`bodyUsed`** read-only property of the Request interface is a boolean value that indicates whether the request body has been read yet. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) + */ readonly bodyUsed: boolean; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */ + /** + * The **`arrayBuffer()`** method of the Request interface reads the request body and returns it as a promise that resolves with an ArrayBuffer. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) + */ arrayBuffer(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */ + /** + * The **`blob()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Blob. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) + */ blob(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) */ + /** + * The **`bytes()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Uint8Array. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) + */ bytes(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) */ + /** + * The **`formData()`** method of the Request interface reads the request body and returns it as a promise that resolves with a FormData object. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) + */ formData(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) */ + /** + * The **`json()`** method of the Request interface reads the request body and returns it as a promise that resolves with the result of parsing the body text as JSON. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) + */ json(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) */ + /** + * The **`text()`** method of the Request interface reads the request body and returns it as a promise that resolves with a String. The response is always decoded using UTF-8. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) + */ text(): Promise; } diff --git a/baselines/ts5.9/dom.generated.d.ts b/baselines/ts5.9/dom.generated.d.ts index 6088cfcb6..1192373df 100644 --- a/baselines/ts5.9/dom.generated.d.ts +++ b/baselines/ts5.9/dom.generated.d.ts @@ -3329,109 +3329,317 @@ interface ANGLE_instanced_arrays { } interface ARIAMixin { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaActiveDescendantElement) */ + /** + * The **`ariaActiveDescendantElement`** property of the Element interface represents the current active element when focus is on a composite widget, combobox, textbox, group, or application. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaActiveDescendantElement) + */ ariaActiveDescendantElement: Element | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaAtomic) */ + /** + * The **`ariaAtomic`** property of the Element interface reflects the value of the aria-atomic attribute, which indicates whether assistive technologies will present all, or only parts of, the changed region based on the change notifications defined by the aria-relevant attribute. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaAtomic) + */ ariaAtomic: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaAutoComplete) */ + /** + * The **`ariaAutoComplete`** property of the Element interface reflects the value of the aria-autocomplete attribute, which indicates whether inputting text could trigger display of one or more predictions of the user's intended value for a combobox, searchbox, or textbox and specifies how predictions would be presented if they were made. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaAutoComplete) + */ ariaAutoComplete: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBrailleLabel) */ + /** + * The **`ariaBrailleLabel`** property of the Element interface reflects the value of the aria-braillelabel attribute, which defines the ARIA braille label of the element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBrailleLabel) + */ ariaBrailleLabel: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBrailleRoleDescription) */ + /** + * The **`ariaBrailleRoleDescription`** property of the Element interface reflects the value of the aria-brailleroledescription attribute, which defines the ARIA braille role description of the element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBrailleRoleDescription) + */ ariaBrailleRoleDescription: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBusy) */ + /** + * The **`ariaBusy`** property of the Element interface reflects the value of the aria-busy attribute, which indicates whether an element is being modified, as assistive technologies may want to wait until the modifications are complete before exposing them to the user. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaBusy) + */ ariaBusy: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaChecked) */ + /** + * The **`ariaChecked`** property of the Element interface reflects the value of the aria-checked attribute, which indicates the current "checked" state of checkboxes, radio buttons, and other widgets that have a checked state. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaChecked) + */ ariaChecked: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColCount) */ + /** + * The **`ariaColCount`** property of the Element interface reflects the value of the aria-colcount attribute, which defines the number of columns in a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColCount) + */ ariaColCount: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColIndex) */ + /** + * The **`ariaColIndex`** property of the Element interface reflects the value of the aria-colindex attribute, which defines an element's column index or position with respect to the total number of columns within a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColIndex) + */ ariaColIndex: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColIndexText) */ + /** + * The **`ariaColIndexText`** property of the Element interface reflects the value of the aria-colindextext attribute, which defines a human readable text alternative of aria-colindex. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColIndexText) + */ ariaColIndexText: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColSpan) */ + /** + * The **`ariaColSpan`** property of the Element interface reflects the value of the aria-colspan attribute, which defines the number of columns spanned by a cell or gridcell within a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaColSpan) + */ ariaColSpan: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaControlsElements) */ + /** + * The **`ariaControlsElements`** property of the Element interface is an array containing the elements that are controlled by the element it is applied to. For example, this might be set on a combobox to indicate the element that it pops up, or on a scrollbar to indicate the ID of the element it controls. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaControlsElements) + */ ariaControlsElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaCurrent) */ + /** + * The **`ariaCurrent`** property of the Element interface reflects the value of the aria-current attribute, which indicates the element that represents the current item within a container or set of related elements. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaCurrent) + */ ariaCurrent: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDescribedByElements) */ + /** + * The **`ariaDescribedByElements`** property of the Element interface is an array containing the element (or elements) that provide an accessible description for the element it is applied to. The accessible description is similar to the accessible label (see ariaLabelledByElements), but provides more verbose information. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDescribedByElements) + */ ariaDescribedByElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDescription) */ + /** + * The **`ariaDescription`** property of the Element interface reflects the value of the aria-description attribute, which defines a string value that describes or annotates the current element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDescription) + */ ariaDescription: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDetailsElements) */ + /** + * The **`ariaDetailsElements`** property of the Element interface is an array containing the element (or elements) that provide an accessible details for the element it is applied to. The accessible details are similar to the accessible description (see ariaDescribedByElements), but provides more verbose information. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDetailsElements) + */ ariaDetailsElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDisabled) */ + /** + * The **`ariaDisabled`** property of the Element interface reflects the value of the aria-disabled attribute, which indicates that the element is perceivable but disabled, so it is not editable or otherwise operable. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaDisabled) + */ ariaDisabled: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaErrorMessageElements) */ + /** + * The **`ariaErrorMessageElements`** property of the Element interface is an array containing the element (or elements) that provide an error message for the element it is applied to. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaErrorMessageElements) + */ ariaErrorMessageElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaExpanded) */ + /** + * The **`ariaExpanded`** property of the Element interface reflects the value of the aria-expanded attribute, which indicates whether a grouping element owned or controlled by this element is expanded or collapsed. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaExpanded) + */ ariaExpanded: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaFlowToElements) */ + /** + * The **`ariaFlowToElements`** property of the Element interface is an array containing the element (or elements) that provide an alternate reading order of content, overriding the general default reading order at the user's discretion. If just one element is provided this is the next element in the reading order. If multiple elements are provided, then each element represents a possible path that should be offered to the user for selection. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaFlowToElements) + */ ariaFlowToElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaHasPopup) */ + /** + * The **`ariaHasPopup`** property of the Element interface reflects the value of the aria-haspopup attribute, which indicates the availability and type of interactive popup element, such as menu or dialog, that can be triggered by an element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaHasPopup) + */ ariaHasPopup: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaHidden) */ + /** + * The **`ariaHidden`** property of the Element interface reflects the value of the aria-hidden) attribute, which indicates whether the element is exposed to an accessibility API. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaHidden) + */ ariaHidden: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaInvalid) */ + /** + * The **`ariaInvalid`** property of the Element interface reflects the value of the aria-invalid attribute. Relevant for the application, checkbox, combobox, gridcell, listbox, radiogroup, slider, spinbutton, textbox, and tree roles, it indicates to the accessibility API whether the entered value does not conform to the format expected by the application. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaInvalid) + */ ariaInvalid: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaKeyShortcuts) */ + /** + * The **`ariaKeyShortcuts`** property of the Element interface reflects the value of the aria-keyshortcuts attribute, which indicates keyboard shortcuts that an author has implemented to activate or give focus to an element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaKeyShortcuts) + */ ariaKeyShortcuts: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLabel) */ + /** + * The **`ariaLabel`** property of the Element interface reflects the value of the aria-label attribute, which defines a string value that labels the current element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLabel) + */ ariaLabel: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLabelledByElements) */ + /** + * The **`ariaLabelledByElements`** property of the Element interface is an array containing the element (or elements) that provide an accessible name for the element it is applied to. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLabelledByElements) + */ ariaLabelledByElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLevel) */ + /** + * The **`ariaLevel`** property of the Element interface reflects the value of the aria-level attribute, which defines the hierarchical level of an element within a structure. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLevel) + */ ariaLevel: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLive) */ + /** + * The **`ariaLive`** property of the Element interface reflects the value of the aria-live attribute, which indicates that an element will be updated, and describes the types of updates the user agents, assistive technologies, and user can expect from the live region. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaLive) + */ ariaLive: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaModal) */ + /** + * The **`ariaModal`** property of the Element interface reflects the value of the aria-modal attribute, which indicates whether an element is modal when displayed. Applying the aria-modal property to an element with role="dialog" replaces the technique of using aria-hidden on the background for informing assistive technologies that content outside a dialog is inert. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaModal) + */ ariaModal: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaMultiLine) */ + /** + * The **`ariaMultiLine`** property of the Element interface reflects the value of the aria-multiline attribute, which indicates whether a text box accepts multiple lines of input or only a single line. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaMultiLine) + */ ariaMultiLine: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaMultiSelectable) */ + /** + * The **`ariaMultiSelectable`** property of the Element interface reflects the value of the aria-multiselectable attribute, which indicates that the user may select more than one item from the current selectable descendants. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaMultiSelectable) + */ ariaMultiSelectable: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaOrientation) */ + /** + * The **`ariaOrientation`** property of the Element interface reflects the value of the aria-orientation attribute, which indicates whether the element's orientation is horizontal, vertical, or unknown/ambiguous. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaOrientation) + */ ariaOrientation: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaOwnsElements) */ + /** + * The **`ariaOwnsElements`** property of the Element interface is an array containing the element (or elements) that define a visual, functional, or contextual relationship between a parent element that it is applied to, and its child elements. This is used when the DOM hierarchy cannot be used to represent the relationship, and it would not otherwise be available to assistive technology, + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaOwnsElements) + */ ariaOwnsElements: ReadonlyArray | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPlaceholder) */ + /** + * The **`ariaPlaceholder`** property of the Element interface reflects the value of the aria-placeholder attribute, which defines a short hint intended to aid the user with data entry when the control has no value. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPlaceholder) + */ ariaPlaceholder: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPosInSet) */ + /** + * The **`ariaPosInSet`** property of the Element interface reflects the value of the aria-posinset attribute, which defines an element's number or position in the current set of listitems or treeitems. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPosInSet) + */ ariaPosInSet: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPressed) */ + /** + * The **`ariaPressed`** property of the Element interface reflects the value of the aria-pressed attribute, which indicates the current "pressed" state of toggle buttons. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaPressed) + */ ariaPressed: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaReadOnly) */ + /** + * The **`ariaReadOnly`** property of the Element interface reflects the value of the aria-readonly attribute, which indicates that the element is not editable, but is otherwise operable. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaReadOnly) + */ ariaReadOnly: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRelevant) */ + /** + * The **`ariaRelevant`** property of the Element interface reflects the value of the aria-relevant attribute, which indicates what notifications the user agent will trigger when the accessibility tree within a live region is modified. This is used to describe what changes in an aria-live region are relevant and should be announced. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRelevant) + */ ariaRelevant: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRequired) */ + /** + * The **`ariaRequired`** property of the Element interface reflects the value of the aria-required attribute, which indicates that user input is required on the element before a form may be submitted. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRequired) + */ ariaRequired: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRoleDescription) */ + /** + * The **`ariaRoleDescription`** property of the Element interface reflects the value of the aria-roledescription attribute, which defines a human-readable, author-localized description for the role of an element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRoleDescription) + */ ariaRoleDescription: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowCount) */ + /** + * The **`ariaRowCount`** property of the Element interface reflects the value of the aria-rowcount attribute, which defines the total number of rows in a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowCount) + */ ariaRowCount: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowIndex) */ + /** + * The **`ariaRowIndex`** property of the Element interface reflects the value of the aria-rowindex attribute, which defines an element's row index or position with respect to the total number of rows within a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowIndex) + */ ariaRowIndex: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowIndexText) */ + /** + * The **`ariaRowIndexText`** property of the Element interface reflects the value of the aria-rowindextext attribute, which defines a human readable text alternative of aria-rowindex. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowIndexText) + */ ariaRowIndexText: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowSpan) */ + /** + * The **`ariaRowSpan`** property of the Element interface reflects the value of the aria-rowspan attribute, which defines the number of rows spanned by a cell or gridcell within a table, grid, or treegrid. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaRowSpan) + */ ariaRowSpan: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSelected) */ + /** + * The **`ariaSelected`** property of the Element interface reflects the value of the aria-selected attribute, which indicates the current "selected" state of elements that have a selected state. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSelected) + */ ariaSelected: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSetSize) */ + /** + * The **`ariaSetSize`** property of the Element interface reflects the value of the aria-setsize attribute, which defines the number of items in the current set of listitems or treeitems. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSetSize) + */ ariaSetSize: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSort) */ + /** + * The **`ariaSort`** property of the Element interface reflects the value of the aria-sort attribute, which indicates if items in a table or grid are sorted in ascending or descending order. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaSort) + */ ariaSort: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueMax) */ + /** + * The **`ariaValueMax`** property of the Element interface reflects the value of the aria-valuemax attribute, which defines the maximum allowed value for a range widget. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueMax) + */ ariaValueMax: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueMin) */ + /** + * The **`ariaValueMin`** property of the Element interface reflects the value of the aria-valuemin attribute, which defines the minimum allowed value for a range widget. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueMin) + */ ariaValueMin: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueNow) */ + /** + * The **`ariaValueNow`** property of the Element interface reflects the value of the aria-valuenow attribute, which defines the current value for a range widget. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueNow) + */ ariaValueNow: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueText) */ + /** + * The **`ariaValueText`** property of the Element interface reflects the value of the aria-valuetext attribute, which defines the human-readable text alternative of aria-valuenow for a range widget. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/ariaValueText) + */ ariaValueText: string | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/role) */ + /** + * The **`role`** property of the Element interface returns the explicitly set WAI-ARIA role for the element. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Element/role) + */ role: string | null; } @@ -5202,21 +5410,53 @@ declare var BlobEvent: { }; interface Body { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) */ + /** + * The **`body`** read-only property of the Request interface contains a ReadableStream with the body contents that have been added to the request. Note that a request using the GET or HEAD method cannot have a body and null is returned in these cases. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) + */ readonly body: ReadableStream> | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */ + /** + * The **`bodyUsed`** read-only property of the Request interface is a boolean value that indicates whether the request body has been read yet. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) + */ readonly bodyUsed: boolean; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */ + /** + * The **`arrayBuffer()`** method of the Request interface reads the request body and returns it as a promise that resolves with an ArrayBuffer. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) + */ arrayBuffer(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */ + /** + * The **`blob()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Blob. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) + */ blob(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) */ + /** + * The **`bytes()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Uint8Array. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) + */ bytes(): Promise>; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) */ + /** + * The **`formData()`** method of the Request interface reads the request body and returns it as a promise that resolves with a FormData object. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) + */ formData(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) */ + /** + * The **`json()`** method of the Request interface reads the request body and returns it as a promise that resolves with the result of parsing the body text as JSON. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) + */ json(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) */ + /** + * The **`text()`** method of the Request interface reads the request body and returns it as a promise that resolves with a String. The response is always decoded using UTF-8. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) + */ text(): Promise; } @@ -13437,34 +13677,56 @@ declare var DocumentFragment: { interface DocumentOrShadowRoot { /** - * Returns the deepest element in the document through which or to which key events are being routed. This is, roughly speaking, the focused element in the document. - * - * For the purposes of this API, when a child browsing context is focused, its container is focused in the parent browsing context. For example, if the user moves the focus to a text control in an iframe, the iframe is the element returned by the activeElement API in the iframe's node document. - * - * Similarly, when the focused element is in a different node tree than documentOrShadowRoot, the element returned will be the host that's located in the same node tree as documentOrShadowRoot if documentOrShadowRoot is a shadow-including inclusive ancestor of the focused element, and null if not. + * The **`activeElement`** read-only property of the Document interface returns the Element within the DOM that is receiving keyboard events such as keydown and keyup. This is usually analogous to the focused element. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/activeElement) */ readonly activeElement: Element | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/adoptedStyleSheets) */ + /** + * The **`adoptedStyleSheets`** property of the Document interface is used for setting an array of constructed stylesheets to be used by the document. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/adoptedStyleSheets) + */ adoptedStyleSheets: CSSStyleSheet[]; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/customElementRegistry) */ + /** + * The **`customElementRegistry`** read-only property of the Document interface returns the CustomElementRegistry object associated with this document, or null if one has not been set. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/customElementRegistry) + */ readonly customElementRegistry: CustomElementRegistry | null; /** - * Returns document's fullscreen element. + * The **`Document.fullscreenElement`** read-only property returns the Element that is currently being presented in fullscreen mode in this document, or null if fullscreen mode is not currently in use. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/fullscreenElement) */ readonly fullscreenElement: Element | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/pictureInPictureElement) */ + /** + * The read-only **`pictureInPictureElement`** property of the Document interface returns the Element that is currently being presented in picture-in-picture mode in this document, or null if picture-in-picture mode is not currently in use. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/pictureInPictureElement) + */ readonly pictureInPictureElement: Element | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/pointerLockElement) */ + /** + * The **`pointerLockElement`** read-only property of the Document interface provides the element set as the target for mouse events while the pointer is locked. It is null if lock is pending, pointer is unlocked, or the target is in another document. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/pointerLockElement) + */ readonly pointerLockElement: Element | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/styleSheets) */ + /** + * The **`styleSheets`** read-only property of the Document interface returns a StyleSheetList of CSSStyleSheet objects, for stylesheets explicitly linked into or embedded in a document. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/styleSheets) + */ readonly styleSheets: StyleSheetList; + /** The **`elementFromPoint()`** method, available on the Document object, returns the topmost Element at the specified coordinates (relative to the viewport). */ elementFromPoint(x: number, y: number): Element | null; + /** The **`elementsFromPoint()`** method of the Document interface returns an array of all elements at the specified coordinates (relative to the viewport). The elements are ordered from the topmost to the bottommost box of the viewport. */ elementsFromPoint(x: number, y: number): Element[]; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/getAnimations) */ + /** + * The **`getAnimations()`** method of the Document interface returns an array of all Animation objects currently in effect whose target elements are descendants of the document. This array includes CSS Animations, CSS Transitions, and Web Animations. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/getAnimations) + */ getAnimations(): Animation[]; } @@ -18639,9 +18901,7 @@ declare var HTMLHtmlElement: { interface HTMLHyperlinkElementUtils { /** - * Returns the hyperlink's URL. - * - * Can be set, to change the URL. + * The **`href`** property of the HTMLAnchorElement interface is a stringifier that returns the absolute URL corresponding to the element's href attribute (or an empty string if href is unset). Setting this property updates the element's href attribute to the provided value. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/href) */ @@ -22192,79 +22452,61 @@ declare var History: { interface HyperlinkElementUtils { /** - * Returns the hyperlink's URL's fragment (includes leading "#" if non-empty). - * - * Can be set, to change the URL's fragment (ignores leading "#"). + * The **`hash`** property of the HTMLAnchorElement interface is a string containing a "#" followed by the fragment identifier of the element's href. If the URL does not have a fragment identifier, this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/hash) */ hash: string; /** - * Returns the hyperlink's URL's host and port (if different from the default port for the scheme). - * - * Can be set, to change the URL's host and port. + * The **`host`** property of the HTMLAnchorElement interface is a string containing the host, which is the hostname, and then, if the port of the URL is nonempty, a ":", followed by the port of the URL. If the URL does not have a hostname, this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/host) */ host: string; /** - * Returns the hyperlink's URL's host. - * - * Can be set, to change the URL's host. + * The **`hostname`** property of the HTMLAnchorElement interface is a string containing either the domain name or IP address of the element's href. If the URL does not have a hostname, this property contains an empty string, "". IPv4 and IPv6 addresses are normalized, such as stripping leading zeros, and domain names are converted to IDN. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/hostname) */ hostname: string; /** - * Returns the hyperlink's URL's origin. + * The **`origin`** read-only property of the HTMLAnchorElement interface returns a string containing the Unicode serialization of the origin of the element's href. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/origin) */ readonly origin: string; /** - * Returns the hyperlink's URL's password. - * - * Can be set, to change the URL's password. + * The **`password`** property of the HTMLAnchorElement interface is a string containing the password component of the element's href. If the URL does not have a password, this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/password) */ password: string; /** - * Returns the hyperlink's URL's path. - * - * Can be set, to change the URL's path. + * The **`HTMLAnchorElement.pathname`** property is a string containing an initial '/' followed by the path of the URL not including the query string or fragment (or the empty string if there is no path). * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/pathname) */ pathname: string; /** - * Returns the hyperlink's URL's port. - * - * Can be set, to change the URL's port. + * The **`port`** property of the HTMLAnchorElement interface is a string containing the port number of the element's href. If the port is the default for the protocol (80 for ws: and http:, 443 for wss: and https:, and 21 for ftp:), this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/port) */ port: string; /** - * Returns the hyperlink's URL's scheme. - * - * Can be set, to change the URL's scheme. + * The **`protocol`** property of the HTMLAnchorElement interface is a string containing the protocol or scheme of the element's href, including the final ":". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/protocol) */ protocol: string; /** - * Returns the hyperlink's URL's query (includes leading "?" if non-empty). - * - * Can be set, to change the URL's query (ignores leading "?"). + * The **`search`** property of the HTMLAnchorElement interface is a search string, also called a query string, that is a string containing a "?" followed by the parameters of the element's href. If the URL does not have a search query, this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/search) */ search: string; /** - * Returns the hyperlink's URL's username. - * - * Can be set, to change the URL's username. + * The **`username`** property of the HTMLAnchorElement interface is a string containing the username component of the element's href. If the URL does not have a username, this property contains an empty string, "". * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLAnchorElement/username) */ @@ -26699,7 +26941,7 @@ interface NonDocumentTypeChildNode { interface NonElementParentNode { /** - * Returns the first element within node's descendants whose ID is elementId. + * The **`getElementById()`** method of the Document interface returns an Element object representing the element whose id property matches the specified string. Since element IDs are required to be unique if specified, they're a useful way to get access to a specific element quickly. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/getElementById) */ @@ -27377,46 +27619,50 @@ declare var PannerNode: { }; interface ParentNode extends Node { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/childElementCount) */ + /** + * The **`Document.childElementCount`** read-only property returns the number of child elements of the document. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/childElementCount) + */ readonly childElementCount: number; /** - * Returns the child elements. + * The read-only **`children`** property returns a live HTMLCollection which contains all of the child elements of the document upon which it was called. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/children) */ readonly children: HTMLCollection; /** - * Returns the first child that is an element, and null otherwise. + * The **`Document.firstElementChild`** read-only property returns the document's first child Element, or null if there are no child elements. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/firstElementChild) */ readonly firstElementChild: Element | null; /** - * Returns the last child that is an element, and null otherwise. + * The **`Document.lastElementChild`** read-only property returns the document's last child Element, or null if there are no child elements. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/lastElementChild) */ readonly lastElementChild: Element | null; /** - * Inserts nodes after the last child of node, while replacing strings in nodes with equivalent Text nodes. - * - * Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated. + * The **`Document.append()`** method inserts a set of Node objects or strings after the last child of the document. Strings are inserted as equivalent Text nodes. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/append) */ append(...nodes: (Node | string)[]): void; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/moveBefore) */ - moveBefore(node: Node, child: Node | null): void; /** - * Inserts nodes before the first child of node, while replacing strings in nodes with equivalent Text nodes. + * The **`moveBefore()`** method of the Document interface moves a given Node inside the Document DOM node as a direct child, before a given reference node. * - * Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated. + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/moveBefore) + */ + moveBefore(node: Node, child: Node | null): void; + /** + * The **`Document.prepend()`** method inserts a set of Node objects or strings before the first child of the document. Strings are inserted as equivalent Text nodes. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/prepend) */ prepend(...nodes: (Node | string)[]): void; /** - * Returns the first element that is a descendant of node that matches selectors. + * The Document method **`querySelector()`** returns the first Element within the document that matches the specified CSS selector, or group of CSS selectors. If no matches are found, null is returned. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/querySelector) */ @@ -27427,7 +27673,7 @@ interface ParentNode extends Node { querySelector(selectors: K): HTMLElementDeprecatedTagNameMap[K] | null; querySelector(selectors: string): E | null; /** - * Returns all element descendants of node that match selectors. + * The Document method **`querySelectorAll()`** returns a static (not live) NodeList representing a list of the document's elements that match the specified group of selectors. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/querySelectorAll) */ @@ -27438,9 +27684,7 @@ interface ParentNode extends Node { querySelectorAll(selectors: K): NodeListOf; querySelectorAll(selectors: string): NodeListOf; /** - * Replace all children of node with nodes, while replacing strings in nodes with equivalent Text nodes. - * - * Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated. + * The **`Document.replaceChildren()`** method replaces the existing children of a Document with a specified new set of children. * * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Document/replaceChildren) */ @@ -28906,9 +29150,17 @@ declare var PopStateEvent: { }; interface PopoverTargetAttributes { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/popoverTargetAction) */ + /** + * The **`popoverTargetAction`** property of the HTMLButtonElement interface gets and sets the action to be performed ("hide", "show", or "toggle") on a popover element being controlled by a button. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/popoverTargetAction) + */ popoverTargetAction: string; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/popoverTargetElement) */ + /** + * The **`popoverTargetElement`** property of the HTMLButtonElement interface gets and sets the popover element to control via a button. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/HTMLButtonElement/popoverTargetElement) + */ popoverTargetElement: Element | null; } diff --git a/baselines/ts5.9/serviceworker.generated.d.ts b/baselines/ts5.9/serviceworker.generated.d.ts index 5732eefbf..00814a6af 100644 --- a/baselines/ts5.9/serviceworker.generated.d.ts +++ b/baselines/ts5.9/serviceworker.generated.d.ts @@ -1448,21 +1448,53 @@ declare var Blob: { }; interface Body { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) */ + /** + * The **`body`** read-only property of the Request interface contains a ReadableStream with the body contents that have been added to the request. Note that a request using the GET or HEAD method cannot have a body and null is returned in these cases. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) + */ readonly body: ReadableStream> | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */ + /** + * The **`bodyUsed`** read-only property of the Request interface is a boolean value that indicates whether the request body has been read yet. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) + */ readonly bodyUsed: boolean; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */ + /** + * The **`arrayBuffer()`** method of the Request interface reads the request body and returns it as a promise that resolves with an ArrayBuffer. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) + */ arrayBuffer(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */ + /** + * The **`blob()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Blob. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) + */ blob(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) */ + /** + * The **`bytes()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Uint8Array. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) + */ bytes(): Promise>; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) */ + /** + * The **`formData()`** method of the Request interface reads the request body and returns it as a promise that resolves with a FormData object. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) + */ formData(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) */ + /** + * The **`json()`** method of the Request interface reads the request body and returns it as a promise that resolves with the result of parsing the body text as JSON. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) + */ json(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) */ + /** + * The **`text()`** method of the Request interface reads the request body and returns it as a promise that resolves with a String. The response is always decoded using UTF-8. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) + */ text(): Promise; } diff --git a/baselines/ts5.9/sharedworker.generated.d.ts b/baselines/ts5.9/sharedworker.generated.d.ts index eb193687b..e3e7920d2 100644 --- a/baselines/ts5.9/sharedworker.generated.d.ts +++ b/baselines/ts5.9/sharedworker.generated.d.ts @@ -1384,21 +1384,53 @@ declare var Blob: { }; interface Body { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) */ + /** + * The **`body`** read-only property of the Request interface contains a ReadableStream with the body contents that have been added to the request. Note that a request using the GET or HEAD method cannot have a body and null is returned in these cases. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) + */ readonly body: ReadableStream> | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */ + /** + * The **`bodyUsed`** read-only property of the Request interface is a boolean value that indicates whether the request body has been read yet. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) + */ readonly bodyUsed: boolean; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */ + /** + * The **`arrayBuffer()`** method of the Request interface reads the request body and returns it as a promise that resolves with an ArrayBuffer. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) + */ arrayBuffer(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */ + /** + * The **`blob()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Blob. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) + */ blob(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) */ + /** + * The **`bytes()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Uint8Array. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) + */ bytes(): Promise>; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) */ + /** + * The **`formData()`** method of the Request interface reads the request body and returns it as a promise that resolves with a FormData object. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) + */ formData(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) */ + /** + * The **`json()`** method of the Request interface reads the request body and returns it as a promise that resolves with the result of parsing the body text as JSON. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) + */ json(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) */ + /** + * The **`text()`** method of the Request interface reads the request body and returns it as a promise that resolves with a String. The response is always decoded using UTF-8. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) + */ text(): Promise; } diff --git a/baselines/ts5.9/webworker.generated.d.ts b/baselines/ts5.9/webworker.generated.d.ts index c1ed9f8eb..07ed252da 100644 --- a/baselines/ts5.9/webworker.generated.d.ts +++ b/baselines/ts5.9/webworker.generated.d.ts @@ -1955,21 +1955,53 @@ declare var Blob: { }; interface Body { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) */ + /** + * The **`body`** read-only property of the Request interface contains a ReadableStream with the body contents that have been added to the request. Note that a request using the GET or HEAD method cannot have a body and null is returned in these cases. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) + */ readonly body: ReadableStream> | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */ + /** + * The **`bodyUsed`** read-only property of the Request interface is a boolean value that indicates whether the request body has been read yet. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) + */ readonly bodyUsed: boolean; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */ + /** + * The **`arrayBuffer()`** method of the Request interface reads the request body and returns it as a promise that resolves with an ArrayBuffer. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) + */ arrayBuffer(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */ + /** + * The **`blob()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Blob. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) + */ blob(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) */ + /** + * The **`bytes()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Uint8Array. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) + */ bytes(): Promise>; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) */ + /** + * The **`formData()`** method of the Request interface reads the request body and returns it as a promise that resolves with a FormData object. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) + */ formData(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) */ + /** + * The **`json()`** method of the Request interface reads the request body and returns it as a promise that resolves with the result of parsing the body text as JSON. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) + */ json(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) */ + /** + * The **`text()`** method of the Request interface reads the request body and returns it as a promise that resolves with a String. The response is always decoded using UTF-8. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) + */ text(): Promise; } diff --git a/baselines/webworker.generated.d.ts b/baselines/webworker.generated.d.ts index bfe007cc3..4dd30b1eb 100644 --- a/baselines/webworker.generated.d.ts +++ b/baselines/webworker.generated.d.ts @@ -1958,21 +1958,53 @@ declare var Blob: { }; interface Body { - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) */ + /** + * The **`body`** read-only property of the Request interface contains a ReadableStream with the body contents that have been added to the request. Note that a request using the GET or HEAD method cannot have a body and null is returned in these cases. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/body) + */ readonly body: ReadableStream> | null; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) */ + /** + * The **`bodyUsed`** read-only property of the Request interface is a boolean value that indicates whether the request body has been read yet. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bodyUsed) + */ readonly bodyUsed: boolean; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) */ + /** + * The **`arrayBuffer()`** method of the Request interface reads the request body and returns it as a promise that resolves with an ArrayBuffer. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/arrayBuffer) + */ arrayBuffer(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) */ + /** + * The **`blob()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Blob. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/blob) + */ blob(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) */ + /** + * The **`bytes()`** method of the Request interface reads the request body and returns it as a promise that resolves with a Uint8Array. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/bytes) + */ bytes(): Promise>; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) */ + /** + * The **`formData()`** method of the Request interface reads the request body and returns it as a promise that resolves with a FormData object. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/formData) + */ formData(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) */ + /** + * The **`json()`** method of the Request interface reads the request body and returns it as a promise that resolves with the result of parsing the body text as JSON. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/json) + */ json(): Promise; - /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) */ + /** + * The **`text()`** method of the Request interface reads the request body and returns it as a promise that resolves with a String. The response is always decoded using UTF-8. + * + * [MDN Reference](https://developer.mozilla.org/docs/Web/API/Request/text) + */ text(): Promise; } diff --git a/inputfiles/idl/dom.commentmap.json b/inputfiles/idl/dom.commentmap.json index 740a1830f..b348ae3df 100644 --- a/inputfiles/idl/dom.commentmap.json +++ b/inputfiles/idl/dom.commentmap.json @@ -1,13 +1,4 @@ { - "nonelementparentnode-getelementbyid": "Returns the first element within node's descendants whose ID is elementId.", - "parentnode-children": "Returns the child elements.", - "parentnode-firstelementchild": "Returns the first child that is an element, and null otherwise.", - "parentnode-lastelementchild": "Returns the last child that is an element, and null otherwise.", - "parentnode-prepend": "Inserts nodes before the first child of node, while replacing strings in nodes with equivalent Text nodes.\n\nThrows a \"HierarchyRequestError\" DOMException if the constraints of the node tree are violated.", - "parentnode-append": "Inserts nodes after the last child of node, while replacing strings in nodes with equivalent Text nodes.\n\nThrows a \"HierarchyRequestError\" DOMException if the constraints of the node tree are violated.", - "parentnode-replacechildren": "Replace all children of node with nodes, while replacing strings in nodes with equivalent Text nodes.\n\nThrows a \"HierarchyRequestError\" DOMException if the constraints of the node tree are violated.", - "parentnode-queryselector": "Returns the first element that is a descendant of node that matches selectors.", - "parentnode-queryselectorall": "Returns all element descendants of node that match selectors.", "nondocumenttypechildnode-previouselementsibling": "Returns the first preceding sibling that is an element, and null otherwise.", "nondocumenttypechildnode-nextelementsibling": "Returns the first following sibling that is an element, and null otherwise.", "childnode-before": "Inserts nodes just before node, while replacing strings in nodes with equivalent Text nodes.\n\nThrows a \"HierarchyRequestError\" DOMException if the constraints of the node tree are violated.", diff --git a/inputfiles/idl/html.commentmap.json b/inputfiles/idl/html.commentmap.json index d4601b846..8a5d9c8c1 100644 --- a/inputfiles/idl/html.commentmap.json +++ b/inputfiles/idl/html.commentmap.json @@ -1,16 +1,4 @@ { - "htmlhyperlinkelementutils-href": "Returns the hyperlink's URL.\n\nCan be set, to change the URL.", - "hyperlinkelementutils-origin": "Returns the hyperlink's URL's origin.", - "hyperlinkelementutils-protocol": "Returns the hyperlink's URL's scheme.\n\nCan be set, to change the URL's scheme.", - "hyperlinkelementutils-username": "Returns the hyperlink's URL's username.\n\nCan be set, to change the URL's username.", - "hyperlinkelementutils-password": "Returns the hyperlink's URL's password.\n\nCan be set, to change the URL's password.", - "hyperlinkelementutils-host": "Returns the hyperlink's URL's host and port (if different from the default port for the scheme).\n\nCan be set, to change the URL's host and port.", - "hyperlinkelementutils-hostname": "Returns the hyperlink's URL's host.\n\nCan be set, to change the URL's host.", - "hyperlinkelementutils-port": "Returns the hyperlink's URL's port.\n\nCan be set, to change the URL's port.", - "hyperlinkelementutils-pathname": "Returns the hyperlink's URL's path.\n\nCan be set, to change the URL's path.", - "hyperlinkelementutils-search": "Returns the hyperlink's URL's query (includes leading \"?\" if non-empty).\n\nCan be set, to change the URL's query (ignores leading \"?\").", - "hyperlinkelementutils-hash": "Returns the hyperlink's URL's fragment (includes leading \"#\" if non-empty).\n\nCan be set, to change the URL's fragment (ignores leading \"#\").", - "documentorshadowroot-activeelement": "Returns the deepest element in the document through which or to which key events are being routed. This is, roughly speaking, the focused element in the document.\n\nFor the purposes of this API, when a child browsing context is focused, its container is focused in the parent browsing context. For example, if the user moves the focus to a text control in an iframe, the iframe is the element returned by the activeElement API in the iframe's node document.\n\nSimilarly, when the focused element is in a different node tree than documentOrShadowRoot, the element returned will be the host that's located in the same node tree as documentOrShadowRoot if documentOrShadowRoot is a shadow-including inclusive ancestor of the focused element, and null if not.", "plugin-name": "Returns the plugin's name.", "plugin-description": "Returns the plugin's description.", "plugin-filename": "Returns the plugin library's filename, if applicable on the current platform.", diff --git a/src/build/mdn-comments.ts b/src/build/mdn-comments.ts index 654973856..6047aac60 100644 --- a/src/build/mdn-comments.ts +++ b/src/build/mdn-comments.ts @@ -26,6 +26,29 @@ const paths: Record = { "webassembly-static-method": ["methods", "method"], }; +/** + * Maps MDN interface names to internal mixing interface names that should + * share the same documentation comments. + * + * This mapping is primarily used to ensure that documentation from MDN for mixin-related + * interfaces is propagated to all corresponding internal mixin utilities. For example, many DOM + * mixin interfaces in the spec do not exist directly in the MDN docs, but their comments can + * be derived from the main interface. + * + * Key: MDN interface name as it appears in the MDN JSON data. + * Value: Array of internal mixin interface names that should receive the same MDN documentation. + * + * Add to this map whenever a mixin in the internal API structure is meant to expose + * the same set of documentation as an MDN interface. + */ +const interfaceAliasMap: Record = { + HTMLAnchorElement: ["HyperlinkElementUtils", "HTMLHyperlinkElementUtils"], + Document: ["DocumentOrShadowRoot", "NonElementParentNode", "ParentNode"], + HTMLButtonElement: ["PopoverTargetAttributes"], + Element: ["ARIAMixin"], + Request: ["Body"], +}; + function extractSlug(mdnUrl: string): string[] { for (const subdirectory of subdirectories) { if (!mdnUrl.startsWith(subdirectory)) { @@ -78,10 +101,13 @@ function generateComment(summary: string, name: string): string | undefined { export async function generateDescriptions(): Promise<{ interfaces: { interface: Record }; + mixins: { mixin: Record }; }> { const content = await readFile(new URL(inputFile), "utf8"); const mdn = JSON.parse(content); const results: Record = {}; + const mixinResults: Record = {}; + // metadata is an array of objects, each with at least: slug, page-type, summary for (const entry of mdn) { const mdnUrl = entry.mdn_url.split("/en-US/docs/")[1]; @@ -100,7 +126,23 @@ export async function generateDescriptions(): Promise<{ if (!comment) { continue; } + // Insert under the original name insertComment(results, slugArr, comment, path, name); + + // If this is an interface or member of a known-alias interface, insert a duplicate under the alias name(s) + // Only need to do this if the interface being referenced is in our alias map. + // Only alias when the slugArr's 0th element matches an aliased interface. + if (slugArr.length > 0 && interfaceAliasMap[slugArr[0]]) { + for (const alias of interfaceAliasMap[slugArr[0]]) { + // Copy slugArr, but replace the base interface name with the alias + const aliasedSlugArr = [alias, ...slugArr.slice(1)]; + insertComment(mixinResults, aliasedSlugArr, comment, path, name); + } + } } - return { interfaces: { interface: results } }; + // The mixin output will contain interfaces (from mixinInterfaces) that are being aliased as mixins + return { + interfaces: { interface: results }, + mixins: { mixin: mixinResults }, + }; }