AwaitedDOM/ HTMLInputElement

The HTMLInputElement interface provides special properties and methods for manipulating the options, layout, and presentation of <input> elements.

Properties

elem.accept
W3C

string: Returns / Sets the element's accept attribute, containing comma-separated list of file types accepted by the server when type is file.

Type: Promise<string>

elem.alt
W3C

string: Returns / Sets the element's alt attribute, containing alternative text to use when type is image.

Type: Promise<string>

elem.autocomplete
W3C

string: Returns / Sets the element's autocomplete attribute, indicating whether the value of the control can be automatically completed by the browser.

Ignored if the value of the type attribute is hidden, checkbox, radio, file, or a button type (button, submit, reset, image).

Possible values are:
on: the browser can autocomplete the value using previously stored value
off: the user must explicity enter a value

Type: Promise<string>

elem.autofocus
W3C

boolean:Returns / Sets the element's autofocus attribute, which specifies that a form control should have input focus when the page loads, unless the user overrides it, for example by typing in a different control. Only one form element in a document can have the autofocus attribute. It cannot be applied if the type attribute is set to hidden (that is, you cannot automatically set focus to a hidden control).

Type: Promise<boolean>

elem.checked
W3C

boolean:Returns / Sets the current state of the element when type is checkbox or radio.

Type: Promise<boolean>

elem.defaultChecked
W3C

boolean:Returns / Sets the default state of a radio button or checkbox as originally specified in HTML that created this object.

Type: Promise<boolean>

elem.defaultValue
W3C

string:Returns / Sets the default value as originally specified in the HTML that created this object.

Type: Promise<string>

elem.dirName
W3C

string:Returns / Sets the directionality of the element.

Type: Promise<string>

elem.disabled
W3C

boolean:Returns / Sets the element's disabled attribute, indicating that the control is not available for interaction. The input values will not be submitted with the form. See also readonly

Type: Promise<boolean>

elem.files
W3C

FileList array:Returns the list of selected files.

Type: FileList

elem.form
W3C

HTMLFormElement object:Returns a reference to the parent <form> element.

Type: HTMLFormElement

elem.formAction
W3C

string: Returns / Sets the element's formaction attribute, containing the URI of a program that processes information submitted by the element. This overrides the action attribute of the parent form.

Type: Promise<string>

elem.formEnctype
W3C

string:Returns / Sets the element's formenctype attribute, containing the type of content that is used to submit the form to the server. This overrides the enctype attribute of the parent form.

Type: Promise<string>

elem.formMethod
W3C

string:Returns / Sets the element's formmethod attribute, containing the HTTP method that the browser uses to submit the form. This overrides the method attribute of the parent form.

Type: Promise<string>

elem.formNoValidate
W3C

boolean:Returns / Sets the element's formnovalidate attribute, indicating that the form is not to be validated when it is submitted. This overrides the novalidate attribute of the parent form.

Type: Promise<boolean>

elem.formTarget
W3C

string:Returns / Sets the element's formtarget attribute, containing a name or keyword indicating where to display the response that is received after submitting the form. This overrides the target attribute of the parent form.

Type: Promise<string>

elem.height
W3C

string: Returns / Sets the element's height attribute, which defines the height of the image displayed for the button, if the value of type is image.

Type: Promise<number>

elem.indeterminate
W3C

boolean:Returns whether the checkbox or radio button is in indeterminate state. For checkboxes, the effect is that the appearance of the checkbox is obscured/greyed in some way as to indicate its state is indeterminate (not checked but not unchecked). Does not affect the value of the checked attribute, and clicking the checkbox will set the value to false.

Type: Promise<boolean>

elem.inputMode
W3C

Provides a hint to browsers as to the type of virtual keyboard configuration to use when editing this element or its contents.

Type: Promise<string>

elem.labels
W3C

NodeList array:Returns a list of <label> elements that are labels for this element.

Type: SuperNodeList

elem.list
W3C

HTMLElement object:Returns the element pointed by the list attribute. The property may be null if no HTML element found in the same tree.

Type: SuperHTMLElement

elem.max
W3C

string:Returns / Sets the element's max attribute, containing the maximum (numeric or date-time) value for this item, which must not be less than its minimum (min attribute) value.

Type: Promise<string>

elem.maxLength
W3C

long:Returns / Sets the element's maxlength attribute, containing the maximum number of characters (in Unicode code points) that the value can have. (If you set this to a negative number, an exception will be thrown.)

Type: Promise<number>

elem.min
W3C

string:Returns / Sets the element's min attribute, containing the minimum (numeric or date-time) value for this item, which must not be greater than its maximum (max attribute) value.

Type: Promise<string>

elem.minLength
W3C

long:Returns / Sets the element's minlength attribute, containing the minimum number of characters (in Unicode code points) that the value can have. (If you set this to a negative number, an exception will be thrown.)

Type: Promise<number>

elem.multiple
W3C

boolean:Returns / Sets the element's multiple attribute, indicating whether more than one value is possible (e.g., multiple files).

Type: Promise<boolean>

elem.name
W3C

string:Returns / Sets the element's name attribute, containing a name that identifies the element when submitting the form.

Type: Promise<string>

elem.pattern
W3C

string:Returns / Sets the element's pattern attribute, containing a regular expression that the control's value is checked against. Use the title attribute to describe the pattern to help the user.

This attribute only applies when the value of the type attribute is text, search, tel, url or email.

Type: Promise<string>

elem.placeholder
W3C

string: Returns / Sets the element's placeholder attribute, containing a hint to the user of what can be entered in the control. The placeholder text must not contain carriage returns or line-feeds.

This attribute only applies when the value of the type attribute is text, search, tel, url or email.

Type: Promise<string>

elem.readOnly
W3C

boolean: Returns / Sets the element's readonly attribute, indicating that the user cannot modify the value of the control.
HTML5.

This attribute is ignored if the value of the type attribute is hidden, range, color, checkbox, radio, file, or a button type.

Type: Promise<boolean>

elem.required
W3C

boolean:Returns / Sets the element's required attribute, indicating that the user must fill in a value before submitting a form.

Type: Promise<boolean>

elem.selectionDirection
W3C

string:Returns / Sets the direction in which selection occurred.

Possible values are:
forward if selection was performed in the start-to-end direction of the current locale
backward for the opposite direction
none if the direction is unknown

Type: Promise<string>

elem.selectionEnd
W3C

unsigned long:Returns / Sets the end index of the selected text. When there's no selection, this returns the offset of the character immediately following the current text input cursor position.

Type: Promise<number>

elem.selectionStart
W3C

unsigned long:Returns / Sets the beginning index of the selected text. When nothing is selected, this returns the position of the text input cursor (caret) inside of the <input> element.

Type: Promise<number>

elem.size
W3C

unsigned long:Returns / Sets the element's size attribute, which contains the visual size of the control. This value is in pixels unless the value of type is text or password, in which case, it is an integer number of characters.

This attribute only applies when type is set to text, search, tel, url, email, or password.

Type: Promise<number>

elem.src
W3C

string:Returns / Sets the element's src attribute, which specifies a URI for the location of an image to display on the graphical submit button, if the value of type is image; otherwise it is ignored.

Type: Promise<string>

elem.step
W3C

string:Returns / Sets the element's step attribute, which works withmin and max to limit the increments at which a numeric or date-time value can be set. It can be the string any or a positive floating point number. If this is not set to any, the control accepts only values at multiples of the step value greater than the minimum.

Type: Promise<string>

elem.type
W3C

string: Returns / Sets the element's type attribute, indicating the type of control to display. See type attribute of <input> for possible values.

Type: Promise<string>

elem.validationMessage
W3C

string:Returns a localized message that describes the validation constraints that the control does not satisfy (if any). This is the empty string if the control is not a candidate for constraint validation (willvalidate is false), or it satisfies its constraints. This value can be set by the setCustomValidity method.

Type: Promise<string>

elem.validity
W3C

ValidityState object:Returns the element's current validity state.

Type: Promise<ValidityState>

elem.value
W3C

string:Returns / Sets the current value of the control.

		<p class="note"><strong>Note:</strong> If the user enters a value different from the value expected, this may return an empty string.</p>

Type: Promise<string>

elem.valueAsDate
W3C

Date object:Returns / Sets the value of the element, interpreted as a date, or null if conversion is not possible.

Type: Promise<any>

elem.valueAsNumber
W3C

double:Returns the value of the element, interpreted as one of the following, in order:

		<ul>
			<li>A time value</li>
			<li>A number</li>
			<li><code>NaN</code> if conversion is impossible</li>
		</ul>

Type: Promise<number>

elem.width
W3C

string:Returns / Sets the document's width attribute, which defines the width of the image displayed for the button, if the value of type is image.

Type: Promise<number>

elem.willValidate
W3C

`boolean`:Returns whether the element is a candidate for constraint validation.

It is false if any conditions bar it from constraint validation, including: its type is hidden, reset, or button; it has a datalist ancestor; or its disabled property is true.

Type: Promise<boolean>

elem.accessKey
W3C

Is a string representing the access key assigned to the element.

Type: Promise<string>

elem.autoCapitalize
W3C

Needs content.

Type: Promise<string>

elem.dir
W3C

Is a string, reflecting the dir global attribute, representing the directionality of the element. Possible values are "ltr", "rtl", and "auto".

Type: Promise<string>

elem.draggable
W3C

Is a boolean indicating if the element can be dragged.

Type: Promise<boolean>

elem.hidden
W3C

Is a boolean indicating if the element is hidden or not.

Type: Promise<boolean>

elem.inert
W3C

Is a boolean indicating whether the user agent must act as though the given node is absent for the purposes of user interaction events, in-page text searches ("find in page"), and text selection.

Type: Promise<boolean>

elem.innerText
W3C

Represents the "rendered" text content of a node and its descendants. As a getter, it approximates the text the user would get if they highlighted the contents of the element with the cursor and then copied it to the clipboard.

Type: Promise<string>

elem.lang
W3C

Is a string representing the language of an element's attributes, text, and element contents.

Type: Promise<string>

elem.offsetHeight
W3C

Returns a double containing the height of an element, relative to the layout.

Type: Promise<number>

elem.offsetLeft
W3C

Returns a double, the distance from this element's left border to its offsetParent's left border.

Type: Promise<number>

elem.offsetParent
W3C

Returns a Element that is the element from which all offset calculations are currently computed.

Type: SuperElement

elem.offsetTop
W3C

Returns a double, the distance from this element's top border to its offsetParent's top border.

Type: Promise<number>

elem.offsetWidth
W3C

Returns a double containing the width of an element, relative to the layout.

Type: Promise<number>

elem.spellcheck
W3C

Is a boolean that controls spell-checking. It is present on all HTML elements, though it doesn't have an effect on all of them.

Type: Promise<boolean>

elem.title
W3C

Is a string containing the text that appears in a popup box when mouse is over the element.

Type: Promise<string>

elem.translate
W3C

Is a boolean representing the translation.

Type: Promise<boolean>

elem.attributes
W3C

Returns a NamedNodeMap object containing the assigned attributes of the corresponding HTML element.

Type: NamedNodeMap

elem.classList
W3C

Returns a DOMTokenList containing the list of class attributes.

Type: DOMTokenList

elem.className
W3C

Is a string representing the class of the element.

Type: Promise<string>

elem.clientHeight
W3C

Returns a number representing the inner height of the element.

Type: Promise<number>

elem.clientLeft
W3C

Returns a number representing the width of the left border of the element.

Type: Promise<number>

elem.clientTop
W3C

Returns a number representing the width of the top border of the element.

Type: Promise<number>

elem.clientWidth
W3C

Returns a number representing the inner width of the element.

Type: Promise<number>

elem.id
W3C

Is a string representing the id of the element.

Type: Promise<string>

elem.innerHTML
W3C

Is a string representing the markup of the element's content.

Type: Promise<string>

elem.localName
W3C

A string representing the local part of the qualified name of the element.

Type: Promise<string>

elem.namespaceURI
W3C

The namespace URI of the element, or null if it is no namespace.

Note: In Firefox 3.5 and earlier, HTML elements are in no namespace. In later versions, HTML elements are in the http://www.w3.org/1999/xhtml namespace in both HTML and XML trees.

Type: Promise<string>

elem.outerHTML
W3C

Is a string representing the markup of the element including its content. When used as a setter, replaces the element with nodes parsed from the given string.

Type: Promise<string>

elem.part
W3C

Represents the part identifier(s) of the element (i.e. set using the part attribute), returned as a DOMTokenList.

Type: DOMTokenList

elem.prefix
W3C

A string representing the namespace prefix of the element, or null if no prefix is specified.

Type: Promise<string>

elem.scrollHeight
W3C

Returns a number representing the scroll view height of an element.

Type: Promise<number>

elem.scrollLeft
W3C

Is a number representing the left scroll offset of the element.

Type: Promise<number>

elem.scrollTop
W3C

A number representing number of pixels the top of the document is scrolled vertically.

Type: Promise<number>

elem.scrollWidth
W3C

Returns a number representing the scroll view width of the element.

Type: Promise<number>

elem.shadowRoot
W3C

Returns the open shadow root that is hosted by the element, or null if no open shadow root is present.

Type: ShadowRoot

elem.slot
W3C

Returns the name of the shadow DOM slot the element is inserted in.

Type: Promise<string>

elem.tagName
W3C

Returns a String with the name of the tag for the given element.

Type: Promise<string>

elem.baseURI
W3C

Returns a string representing the base URL of the document containing the Node.

Type: Promise<string>

elem.childNodes
W3C

Returns a live NodeList containing all the children of this node. NodeList being live means that if the children of the Node change, the NodeList object is automatically updated.

Type: SuperNodeList

elem.firstChild
W3C

Returns a Node representing the first direct child node of the node, or null if the node has no child.

Type: SuperNode

elem.isConnected
W3C

A boolean indicating whether or not the Node is connected (directly or indirectly) to the context object, e.g. the Document object in the case of the normal DOM, or the ShadowRoot in the case of a shadow DOM.

Type: Promise<boolean>

elem.lastChild
W3C

Returns a Node representing the last direct child node of the node, or null if the node has no child.

Type: SuperNode

elem.nextSibling
W3C

Returns a Node representing the next node in the tree, or null if there isn't such node.

Type: SuperNode

elem.nodeName
W3C

Returns a string containing the name of the Node. The structure of the name will differ with the node type. E.g. An HTMLElement will contain the name of the corresponding tag, like 'audio' for an HTMLAudioElement, a Text node will have the '#text' string, or a Document node will have the '#document' string.

Type: Promise<string>

elem.nodeType
W3C

Returns an unsigned short representing the type of the node. Possible values are:

NameValue
ELEMENT_NODE1
ATTRIBUTE_NODE 2
TEXT_NODE3
CDATA_SECTION_NODE4
ENTITY_REFERENCE_NODE 5
ENTITY_NODE 6
PROCESSING_INSTRUCTION_NODE7
COMMENT_NODE8
DOCUMENT_NODE9
DOCUMENT_TYPE_NODE10
DOCUMENT_FRAGMENT_NODE11
NOTATION_NODE 12

Type: Promise<number>

elem.nodeValue
W3C

Returns / Sets the value of the current node.

Type: Promise<string>

elem.ownerDocument
W3C

Returns the Document that this node belongs to. If the node is itself a document, returns null.

Type: SuperDocument

elem.parentElement
W3C

Returns an Element that is the parent of this node. If the node has no parent, or if that parent is not an Element, this property returns null.

Type: SuperElement

elem.parentNode
W3C

Returns a Node that is the parent of this node. If there is no such node, like if this node is the top of the tree or if doesn't participate in a tree, this property returns null.

Type: SuperNode

elem.previousSibling
W3C

Returns a Node representing the previous node in the tree, or null if there isn't such node.

Type: SuperNode

elem.textContent
W3C

Returns / Sets the textual content of an element and all its descendants.

Type: Promise<string>

elem.style
W3C

The style property is used to get as well as set the inline style of an element. When getting, it returns a CSSStyleDeclaration object that contains a list of all styles properties for that element with values assigned for the attributes that are defined in the element's inline style attribute.

Type: CSSStyleDeclaration

elem.contentEditable
W3C

Needs content.

Type: Promise<string>

elem.isContentEditable
W3C

Needs content.

Type: Promise<boolean>

elem.dataset
W3C

Needs content.

Type: Promise<Record<string, string>>

elem.nonce
W3C

Needs content.

Type: Promise<string>

elem.tabIndex
W3C

Needs content.

Type: Promise<number>

elem.nextElementSibling
W3C

Returns the Element immediately following this node in its parent's children list, or null if there is no Element in the list following this node.

Type: SuperElement

elem.previousElementSibling
W3C

Returns the Element immediately prior to this node in its parent's children list, or null if there is no Element in the list prior to this node.

Type: SuperElement

elem.childElementCount
W3C

Returns the number of children of this ParentNode which are elements.

Type: Promise<number>

elem.children
W3C

Returns a live HTMLCollection containing all of the Element objects that are children of this ParentNode, omitting all of its non-element nodes.

Type: SuperHTMLCollection

elem.firstElementChild
W3C

Returns the first node which is both a child of this ParentNodeand is also an Element, or null if there is none.

Type: SuperElement

elem.lastElementChild
W3C

Returns the last node which is both a child of this ParentNodeand is an Element, or null if there is none.

Type: SuperElement

elem.assignedSlot
W3C

Returns the <slot> the node is inserted in.

Type: HTMLSlotElement

Methods

elem.checkValidity()
W3C

Returns a boolean that is false if the element is a candidate for constraint validation, and it does not satisfy its constraints. In this case, it also fires an invalid event at the element. It returns true if the element is not a candidate for constraint validation, or if it satisfies its constraints. Inherited from HTMLObjectElement

Returns: Promise<boolean>

elem.reportValidity()
W3C

Runs the checkValidity() method, and if it returns false (for an invalid input or no pattern pattern attribute provided), then it reports to the user that the input is invalid in the same manner as if you submitted a form. Inherited from HTMLFormElement

Returns: Promise<boolean>

elem.select()
W3C

Selects all the text in the input element, and focuses it so the user can subsequently replace all of its content.

Returns: Promise<void>

elem.setRangeText(replacement, start?, end?, selectionMode?)
W3C

Replaces a range of text in the input element with new text.

Arguments:

  • replacement string. Needs content.
  • start number. Needs content.
  • end number. Needs content.
  • selectionMode SelectionMode. Needs content.

Returns: Promise<void>

elem.setSelectionRange(start, end, direction?)
W3C

Selects a range of text in the input element (but does not focus it).

Arguments:

  • start number. Needs content.
  • end number. Needs content.
  • direction string. Needs content.

Returns: Promise<void>

elem.stepDown(n?)
W3C

Decrements the value by (step * n), where n defaults to 1 if not specified.

Arguments:

  • n number. Needs content.

Returns: Promise<void>

elem.stepUp(n?)
W3C

Increments the value by (step * n), where n defaults to 1 if not specified.

Arguments:

  • n number. Needs content.

Returns: Promise<void>

elem.click()
W3C

Sends a mouse click event to the element.

Returns: Promise<void>

elem.closest(selectors)
W3C

Returns the Element which is the closest ancestor of the current element (or the current element itself) which matches the selectors given in parameter.

Arguments:

  • selectors string. selectors is a string containing a selector list.
    ex: p:hover, .toto + q

Returns: SuperElement

elem.getAttribute(qualifiedName)
W3C

Retrieves the value of the named attribute from the current node and returns it as an Object.

Arguments:

  • qualifiedName string. attributeName is the name of the attribute whose value you want to get.

Returns: Promise<string>

elem.getAttributeNames()
W3C

Returns an array of attribute names from the current element.

Returns: Promise<Iterable,string>

elem.getAttributeNode(qualifiedName)
W3C

Retrieves the node representation of the named attribute from the current node and returns it as an Attr.

Arguments:

  • qualifiedName string. attrName is a string containing the name of the attribute.

Returns: Promise<Attr>

elem.getAttributeNodeNS(namespace, localName)
W3C

Retrieves the node representation of the attribute with the specified name and namespace, from the current node and returns it as an Attr.

Arguments:

  • namespace string. namespace is a string specifying the namespace of the attribute.
  • localName string. nodeName is a string specifying the name of the attribute.

Returns: Promise<Attr>

elem.getAttributeNS(namespace, localName)
W3C

Retrieves the value of the attribute with the specified name and namespace, from the current node and returns it as an Object.

Arguments:

  • namespace string. The namespace in which to look for the specified attribute.
  • localName string. The name of the attribute to look for.

Returns: Promise<string>

elem.getBoundingClientRect()
W3C

Returns the size of an element and its position relative to the viewport.

Returns: Promise<DOMRect>

elem.getClientRects()
W3C

Returns a collection of rectangles that indicate the bounding rectangles for each line of text in a client.

Returns: Promise<DOMRectList>

elem.getElementsByClassName(classNames)
W3C

Returns a live HTMLCollection that contains all descendants of the current element that possess the list of classes given in the parameter.

Arguments:

  • classNames string. A string containing one or more class names to match on, separated by whitespace.

Returns: SuperHTMLCollection

elem.getElementsByTagName(qualifiedName)
W3C

Returns a live HTMLCollection containing all descendant elements, of a particular tag name, from the current element.

Arguments:

  • qualifiedName string. tagName is the qualified name to look for. The special string "*" represents all elements. For compatibility with XHTML, lower-case should be used.

Returns: SuperHTMLCollection

elem.getElementsByTagNameNS(namespace, localName)
W3C

Returns a live HTMLCollection containing all descendant elements, of a particular tag name and namespace, from the current element.

Arguments:

  • namespace string. namespaceURI is the namespace URI of elements to look for (see Element.namespaceURI and Attr.namespaceURI). For example, if you need to look for XHTML elements, use the XHTML namespace URI, http://www.w3.org/1999/xhtml.
  • localName string. localName is either the local name of elements to look for or the special value "*", which matches all elements (see Element.localName and Attr.localName).

Returns: SuperHTMLCollection

elem.hasAttribute(qualifiedName)
W3C

Returns a boolean indicating if the element has the specified attribute or not.

Arguments:

  • qualifiedName string. is a string representing the name of the attribute.

Returns: Promise<boolean>

elem.hasAttributeNS(namespace, localName)
W3C

Returns a boolean indicating if the element has the specified attribute, in the specified namespace, or not.

Arguments:

  • namespace string. namespace is a string specifying the namespace of the attribute.
  • localName string. localName is the name of the attribute.

Returns: Promise<boolean>

elem.hasAttributes()
W3C

Returns a boolean indicating if the element has one or more HTML attributes present.

Returns: Promise<boolean>

elem.hasPointerCapture(pointerId)
W3C

Indicates whether the element on which it is invoked has pointer capture for the pointer identified by the given pointer ID.

Arguments:

  • pointerId number. The pointerId of a PointerEvent object.

Returns: Promise<boolean>

elem.matches(selectors)
W3C

Returns a boolean indicating whether or not the element would be selected by the specified selector string.

Arguments:

  • selectors string. selectorString is a string representing the selector to test.

Returns: Promise<boolean>

elem.requestFullscreen(options?)
W3C

Asynchronously asks the browser to make the element full-screen.

Arguments:

  • options FullscreenOptions. A FullscreenOptions object  providing options that control the behavior of the transition to full-screen mode. Currently, the only option is navigationUI, which controls whether or not to show navigation UI while the element is in full-screen mode. The default value is "auto", which indicates that the browser should decide what to do.

Returns: Promise<void>

elem.requestPointerLock()
W3C

Allows to asynchronously ask for the pointer to be locked on the given element.

Returns: Promise<void>

elem.scrollIntoView(arg?)
W3C

Scrolls the page until the element gets into the view.

Arguments:

  • arg boolean | ScrollIntoViewOptions
    • Is a boolean value:
      • If true, the top of the element will be aligned to the top of the visible area of the scrollable ancestor. Corresponds to scrollIntoViewOptions: {block: "start", inline: "nearest"}. This is the default value.
      • If false, the bottom of the element will be aligned to the bottom of the visible area of the scrollable ancestor. Corresponds to scrollIntoViewOptions: {block: "end", inline: "nearest"}.
    • Is an Object with the following properties:
      behaviorOptional
      Defines the transition animation.
      One of auto or smooth. Defaults to auto.
      blockOptional
      Defines vertical alignment.
      One of start, center, end, or nearest. Defaults to start.
      inlineOptional
      Defines horizontal alignment.
      One of start, center, end, or nearest. Defaults to nearest.

Returns: Promise<void>

elem.compareDocumentPosition(other)
W3C

Compares the position of the current node against another node in any other document.

Arguments:

  • other Node. The other Node with which to compare the first node’s document position.

Returns: Promise<number>

elem.contains(other)
W3C

Returns a boolean value indicating whether or not a node is a descendant of the calling node.

Arguments:

  • other Node. Needs content.

Returns: Promise<boolean>

elem.getRootNode(options?)
W3C

Returns the context object's root which optionally includes the shadow root if it is available. 

Arguments:

  • options GetRootNodeOptions. An object that sets options for getting the root node. The available options are:
    • composed: A `boolean` that indicates whether the shadow root should be returned (false, the default), or a root node beyond shadow root (true).

Returns: SuperNode

elem.hasChildNodes()
W3C

Returns a boolean indicating whether or not the element has any child nodes.

Returns: Promise<boolean>

elem.isDefaultNamespace(namespace)
W3C

Accepts a namespace URI as an argument and returns a boolean with a value of true if the namespace is the default namespace on the given node or false if not.

Arguments:

  • namespace string. namespaceURI is a string representing the namespace against which the element will be checked.

Returns: Promise<boolean>

elem.isEqualNode(otherNode)
W3C

Returns a boolean which indicates whether or not two nodes are of the same type and all their defining data points match.

Arguments:

  • otherNode Node. otherNode: The Node to compare equality with.

Returns: Promise<boolean>

elem.isSameNode(otherNode)
W3C

Returns a boolean value indicating whether or not the two nodes are the same (that is, they reference the same object).

Arguments:

  • otherNode Node. otherNode The Node to test against.

Returns: Promise<boolean>

elem.lookupNamespaceURI(prefix)
W3C

Accepts a prefix and returns the namespace URI associated with it on the given node if found (and null if not). Supplying null for the prefix will return the default namespace.

Arguments:

  • prefix string. The prefix to look for. If this parameter is null, the method will return the default namespace URI, if any.

Returns: Promise<string>

elem.lookupPrefix(namespace)
W3C

Returns a string containing the prefix for a given namespace URI, if present, and null if not. When multiple prefixes are possible, the result is implementation-dependent.

Arguments:

  • namespace string. Needs content.

Returns: Promise<string>

elem.normalize()
W3C

Clean up all the text nodes under this element (merge adjacent, remove empty).

Returns: Promise<void>

elem.blur()
W3C

Needs content.

Returns: Promise<void>

elem.focus()
W3C

Needs content.

Returns: Promise<void>

elem.querySelector(selectors)
W3C

Returns the first Element with the current element as root that matches the specified group of selectors.

Arguments:

  • selectors string. A string containing one or more selectors to match against. This string must be a valid compound selector list supported by the browser; if it's not, a SyntaxError exception is thrown. See Locating DOM elements using selectors for more information about using selectors to identify elements. Multiple selectors may be specified by separating them using commas.

Returns: SuperElement

elem.querySelectorAll(selectors)
W3C

Returns a NodeList representing a list of elements with the current element as root that matches the specified group of selectors.

Arguments:

  • selectors string. A string containing one or more selectors to match against. This string must be a valid CSS selector string; if it's not, a SyntaxError exception is thrown. See Locating DOM elements using selectors for more information about using selectors to identify elements. Multiple selectors may be specified by separating them using commas.

Returns: SuperNodeList

Unimplemented Specs

Properties

onfullscreenchangeonfullscreenerror
oncopyoncut
onpasteonabort
onanimationendonanimationiteration
onanimationstartonauxclick
onbluroncancel
oncanplayoncanplaythrough
onchangeonclick
oncloseoncontextmenu
oncuechangeondblclick
ondragondragend
ondragenterondragleave
ondragoverondragstart
ondropondurationchange
onemptiedonended
onerroronfocus
onformdataongotpointercapture
oninputoninvalid
onkeydownonkeypress
onkeyuponload
onloadeddataonloadedmetadata
onloadstartonlostpointercapture
onmousedownonmouseenter
onmouseleaveonmousemove
onmouseoutonmouseover
onmouseuponpause
onplayonplaying
onpointercancelonpointerdown
onpointerenteronpointerleave
onpointermoveonpointerout
onpointeroveronpointerup
onprogressonratechange
onresetonresize
onscrollonseeked
onseekingonselect
onselectionchangeonselectstart
onstalledonsubmit
onsuspendontimeupdate
ontouchcancelontouchend
ontouchmoveontouchstart
ontransitionendonvolumechange
onwaitingonwheel

Methods

setCustomValidity()attachShadow()
computedStyleMap()insertAdjacentElement()
insertAdjacentHTML()insertAdjacentText()
releasePointerCapture()removeAttribute()
removeAttributeNode()removeAttributeNS()
scroll()scrollBy()
scrollTo()setAttribute()
setAttributeNode()setAttributeNodeNS()
setAttributeNS()setPointerCapture()
toggleAttribute()appendChild()
cloneNode()insertBefore()
removeChild()replaceChild()
addEventListener()dispatchEvent()
removeEventListener()animate()
getAnimations()after()
before()remove()
replaceWith()append()
prepend()

Edit this page on GitHub