Element

Element is the most general base class from which all objects in a Document inherit. It only has methods and properties common to all kinds of elements. More specific classes inherit from Element.

MDN Reference

interface Element {
    charging?: boolean;
    chargingTime?: number;
    dischargingTime?: number;
    level?: number;
    ariaAtomic: null | string;
    ariaAutoComplete: null | string;
    ariaBrailleLabel: null | string;
    ariaBrailleRoleDescription: null | string;
    ariaBusy: null | string;
    ariaChecked: null | string;
    ariaColCount: null | string;
    ariaColIndex: null | string;
    ariaColIndexText: null | string;
    ariaColSpan: null | string;
    ariaCurrent: null | string;
    ariaDescription: null | string;
    ariaDisabled: null | string;
    ariaExpanded: null | string;
    ariaHasPopup: null | string;
    ariaHidden: null | string;
    ariaInvalid: null | string;
    ariaKeyShortcuts: null | string;
    ariaLabel: null | string;
    ariaLevel: null | string;
    ariaLive: null | string;
    ariaModal: null | string;
    ariaMultiLine: null | string;
    ariaMultiSelectable: null | string;
    ariaOrientation: null | string;
    ariaPlaceholder: null | string;
    ariaPosInSet: null | string;
    ariaPressed: null | string;
    ariaReadOnly: null | string;
    ariaRelevant: null | string;
    ariaRequired: null | string;
    ariaRoleDescription: null | string;
    ariaRowCount: null | string;
    ariaRowIndex: null | string;
    ariaRowIndexText: null | string;
    ariaRowSpan: null | string;
    ariaSelected: null | string;
    ariaSetSize: null | string;
    ariaSort: null | string;
    ariaValueMax: null | string;
    ariaValueMin: null | string;
    ariaValueNow: null | string;
    ariaValueText: null | string;
    role: null | string;
    animate(
        keyframes: null | Keyframe[] | PropertyIndexedKeyframes,
        options?: number | KeyframeAnimationOptions,
    ): Animation;
    getAnimations(options?: GetAnimationsOptions): Animation[];
    after(...nodes: (string | Node)[]): void;
    before(...nodes: (string | Node)[]): void;
    remove(): void;
    replaceWith(...nodes: (string | Node)[]): void;
    attributes: NamedNodeMap;
    get classList(): DOMTokenList;
    set classList(value: string): void;
    className: string;
    clientHeight: number;
    clientLeft: number;
    clientTop: number;
    clientWidth: number;
    currentCSSZoom: number;
    id: string;
    innerHTML: string;
    localName: string;
    namespaceURI: null | string;
    onfullscreenchange: null | ((this: Element, ev: Event) => any);
    onfullscreenerror: null | ((this: Element, ev: Event) => any);
    outerHTML: string;
    ownerDocument: Document;
    get part(): DOMTokenList;
    set part(value: string): void;
    prefix: null | string;
    scrollHeight: number;
    scrollLeft: number;
    scrollTop: number;
    scrollWidth: number;
    shadowRoot: null | ShadowRoot;
    slot: string;
    tagName: string;
    attachShadow(init: ShadowRootInit): ShadowRoot;
    checkVisibility(options?: CheckVisibilityOptions): boolean;
    closest<K extends keyof HTMLElementTagNameMap>(
        selector: K,
    ): null | HTMLElementTagNameMap[K];
    closest<K extends keyof SVGElementTagNameMap>(
        selector: K,
    ): null | SVGElementTagNameMap[K];
    closest<K extends keyof MathMLElementTagNameMap>(
        selector: K,
    ): null | MathMLElementTagNameMap[K];
    closest<E extends Element = Element>(selectors: string): null | E;
    computedStyleMap(): StylePropertyMapReadOnly;
    getAttribute(qualifiedName: string): null | string;
    getAttributeNS(namespace: null | string, localName: string): null | string;
    getAttributeNames(): string[];
    getAttributeNode(qualifiedName: string): null | Attr;
    getAttributeNodeNS(
        namespace: null | string,
        localName: string,
    ): null | Attr;
    getBoundingClientRect(): DOMRect;
    getClientRects(): DOMRectList;
    getElementsByClassName(classNames: string): HTMLCollectionOf<Element>;
    getElementsByTagName<K extends keyof HTMLElementTagNameMap>(
        qualifiedName: K,
    ): HTMLCollectionOf<HTMLElementTagNameMap[K]>;
    getElementsByTagName<K extends keyof SVGElementTagNameMap>(
        qualifiedName: K,
    ): HTMLCollectionOf<SVGElementTagNameMap[K]>;
    getElementsByTagName<K extends keyof MathMLElementTagNameMap>(
        qualifiedName: K,
    ): HTMLCollectionOf<MathMLElementTagNameMap[K]>;
    getElementsByTagName<K extends keyof HTMLElementDeprecatedTagNameMap>(
        qualifiedName: K,
    ): HTMLCollectionOf<HTMLElementDeprecatedTagNameMap[K]>;
    getElementsByTagName(qualifiedName: string): HTMLCollectionOf<Element>;
    getElementsByTagNameNS(
        namespaceURI: "http://www.w3.org/1999/xhtml",
        localName: string,
    ): HTMLCollectionOf<HTMLElement>;
    getElementsByTagNameNS(
        namespaceURI: "http://www.w3.org/2000/svg",
        localName: string,
    ): HTMLCollectionOf<SVGElement>;
    getElementsByTagNameNS(
        namespaceURI: "http://www.w3.org/1998/Math/MathML",
        localName: string,
    ): HTMLCollectionOf<MathMLElement>;
    getElementsByTagNameNS(
        namespace: null | string,
        localName: string,
    ): HTMLCollectionOf<Element>;
    getHTML(options?: GetHTMLOptions): string;
    hasAttribute(qualifiedName: string): boolean;
    hasAttributeNS(namespace: null | string, localName: string): boolean;
    hasAttributes(): boolean;
    hasPointerCapture(pointerId: number): boolean;
    insertAdjacentElement(
        where: InsertPosition,
        element: Element,
    ): null | Element;
    insertAdjacentHTML(position: InsertPosition, string: string): void;
    insertAdjacentText(where: InsertPosition, data: string): void;
    matches(selectors: string): boolean;
    releasePointerCapture(pointerId: number): void;
    removeAttribute(qualifiedName: string): void;
    removeAttributeNS(namespace: null | string, localName: string): void;
    removeAttributeNode(attr: Attr): Attr;
    requestFullscreen(options?: FullscreenOptions): Promise<void>;
    requestPointerLock(options?: PointerLockOptions): Promise<void>;
    scroll(options?: ScrollToOptions): void;
    scroll(x: number, y: number): void;
    scrollBy(options?: ScrollToOptions): void;
    scrollBy(x: number, y: number): void;
    scrollIntoView(arg?: boolean | ScrollIntoViewOptions): void;
    scrollTo(options?: ScrollToOptions): void;
    scrollTo(x: number, y: number): void;
    setAttribute(qualifiedName: string, value: string): void;
    setAttributeNS(
        namespace: null | string,
        qualifiedName: string,
        value: string,
    ): void;
    setAttributeNode(attr: Attr): null | Attr;
    setAttributeNodeNS(attr: Attr): null | Attr;
    setHTMLUnsafe(html: string): void;
    setPointerCapture(pointerId: number): void;
    toggleAttribute(qualifiedName: string, force?: boolean): boolean;
    webkitMatchesSelector(selectors: string): boolean;
    addEventListener<K extends keyof ElementEventMap>(
        type: K,
        listener: (this: Element, ev: ElementEventMap[K]) => any,
        options?: boolean | AddEventListenerOptions,
    ): void;
    addEventListener(
        type: string,
        listener: EventListenerOrEventListenerObject,
        options?: boolean | AddEventListenerOptions,
    ): void;
    removeEventListener<K extends keyof ElementEventMap>(
        type: K,
        listener: (this: Element, ev: ElementEventMap[K]) => any,
        options?: boolean | EventListenerOptions,
    ): void;
    removeEventListener(
        type: string,
        listener: EventListenerOrEventListenerObject,
        options?: boolean | EventListenerOptions,
    ): void;
    dispatchEvent(event: Event): boolean;
    baseURI: string;
    childNodes: NodeListOf<ChildNode>;
    firstChild: null | ChildNode;
    isConnected: boolean;
    lastChild: null | ChildNode;
    nextSibling: null | ChildNode;
    nodeName: string;
    nodeType: number;
    nodeValue: null | string;
    parentElement: null | HTMLElement;
    parentNode: null | ParentNode;
    previousSibling: null | ChildNode;
    textContent: null | string;
    appendChild<T extends Node>(node: T): T;
    cloneNode(subtree?: boolean): Node;
    compareDocumentPosition(other: Node): number;
    contains(other: null | Node): boolean;
    getRootNode(options?: GetRootNodeOptions): Node;
    hasChildNodes(): boolean;
    insertBefore<T extends Node>(node: T, child: null | Node): T;
    isDefaultNamespace(namespace: null | string): boolean;
    isEqualNode(otherNode: null | Node): boolean;
    isSameNode(otherNode: null | Node): boolean;
    lookupNamespaceURI(prefix: null | string): null | string;
    lookupPrefix(namespace: null | string): null | string;
    normalize(): void;
    removeChild<T extends Node>(child: T): T;
    replaceChild<T extends Node>(node: Node, child: T): T;
    ELEMENT_NODE: 1;
    ATTRIBUTE_NODE: 2;
    TEXT_NODE: 3;
    CDATA_SECTION_NODE: 4;
    ENTITY_REFERENCE_NODE: 5;
    ENTITY_NODE: 6;
    PROCESSING_INSTRUCTION_NODE: 7;
    COMMENT_NODE: 8;
    DOCUMENT_NODE: 9;
    DOCUMENT_TYPE_NODE: 10;
    DOCUMENT_FRAGMENT_NODE: 11;
    NOTATION_NODE: 12;
    DOCUMENT_POSITION_DISCONNECTED: 1;
    DOCUMENT_POSITION_PRECEDING: 2;
    DOCUMENT_POSITION_FOLLOWING: 4;
    DOCUMENT_POSITION_CONTAINS: 8;
    DOCUMENT_POSITION_CONTAINED_BY: 16;
    DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC: 32;
    nextElementSibling: null | Element;
    previousElementSibling: null | Element;
    childElementCount: number;
    children: HTMLCollection;
    firstElementChild: null | Element;
    lastElementChild: null | Element;
    append(...nodes: (string | Node)[]): void;
    prepend(...nodes: (string | Node)[]): void;
    querySelector<K extends keyof HTMLElementTagNameMap>(
        selectors: K,
    ): null | HTMLElementTagNameMap[K];
    querySelector<K extends keyof SVGElementTagNameMap>(
        selectors: K,
    ): null | SVGElementTagNameMap[K];
    querySelector<K extends keyof MathMLElementTagNameMap>(
        selectors: K,
    ): null | MathMLElementTagNameMap[K];
    querySelector<K extends keyof HTMLElementDeprecatedTagNameMap>(
        selectors: K,
    ): null | HTMLElementDeprecatedTagNameMap[K];
    querySelector<E extends Element = Element>(selectors: string): null | E;
    querySelectorAll<K extends keyof HTMLElementTagNameMap>(
        selectors: K,
    ): NodeListOf<HTMLElementTagNameMap[K]>;
    querySelectorAll<K extends keyof SVGElementTagNameMap>(
        selectors: K,
    ): NodeListOf<SVGElementTagNameMap[K]>;
    querySelectorAll<K extends keyof MathMLElementTagNameMap>(
        selectors: K,
    ): NodeListOf<MathMLElementTagNameMap[K]>;
    querySelectorAll<K extends keyof HTMLElementDeprecatedTagNameMap>(
        selectors: K,
    ): NodeListOf<HTMLElementDeprecatedTagNameMap[K]>;
    querySelectorAll<E extends Element = Element>(
        selectors: string,
    ): NodeListOf<E>;
    replaceChildren(...nodes: (string | Node)[]): void;
    assignedSlot: null | HTMLSlotElement;
}

Index

Properties

Accessors

<internal>.Element.classList <internal>.Element.part

Methods

Properties

`Optional`charging

charging?: boolean

`Optional`chargingTime

chargingTime?: number

`Optional`dischargingTime

dischargingTime?: number

`Optional`level

level?: number

ariaAtomic

ariaAtomic: null | string

MDN Reference

ariaAutoComplete

ariaAutoComplete: null | string

MDN Reference

ariaBrailleLabel

ariaBrailleLabel: null | string

MDN Reference

ariaBrailleRoleDescription

ariaBrailleRoleDescription: null | string

MDN Reference

ariaBusy

ariaBusy: null | string

MDN Reference

ariaChecked

ariaChecked: null | string

MDN Reference

ariaColCount

ariaColCount: null | string

MDN Reference

ariaColIndex

ariaColIndex: null | string

MDN Reference

ariaColIndexText

ariaColIndexText: null | string

MDN Reference

ariaColSpan

ariaColSpan: null | string

MDN Reference

ariaCurrent

ariaCurrent: null | string

MDN Reference

ariaDescription

ariaDescription: null | string

MDN Reference

ariaDisabled

ariaDisabled: null | string

MDN Reference

ariaExpanded

ariaExpanded: null | string

MDN Reference

ariaHasPopup

ariaHasPopup: null | string

MDN Reference

ariaHidden

ariaHidden: null | string

MDN Reference

ariaInvalid

ariaInvalid: null | string

ariaKeyShortcuts

ariaKeyShortcuts: null | string

MDN Reference

ariaLabel

ariaLabel: null | string

MDN Reference

ariaLevel

ariaLevel: null | string

MDN Reference

ariaLive

ariaLive: null | string

MDN Reference

ariaModal

ariaModal: null | string

MDN Reference

ariaMultiLine

ariaMultiLine: null | string

MDN Reference

ariaMultiSelectable

ariaMultiSelectable: null | string

MDN Reference

ariaOrientation

ariaOrientation: null | string

MDN Reference

ariaPlaceholder

ariaPlaceholder: null | string

MDN Reference

ariaPosInSet

ariaPosInSet: null | string

MDN Reference

ariaPressed

ariaPressed: null | string

MDN Reference

ariaReadOnly

ariaReadOnly: null | string

MDN Reference

ariaRelevant

ariaRelevant: null | string

MDN Reference

ariaRequired

ariaRequired: null | string

MDN Reference

ariaRoleDescription

ariaRoleDescription: null | string

MDN Reference

ariaRowCount

ariaRowCount: null | string

MDN Reference

ariaRowIndex

ariaRowIndex: null | string

MDN Reference

ariaRowIndexText

ariaRowIndexText: null | string

MDN Reference

ariaRowSpan

ariaRowSpan: null | string

MDN Reference

ariaSelected

ariaSelected: null | string

MDN Reference

ariaSetSize

ariaSetSize: null | string

MDN Reference

ariaSort

ariaSort: null | string

MDN Reference

ariaValueMax

ariaValueMax: null | string

MDN Reference

ariaValueMin

ariaValueMin: null | string

MDN Reference

ariaValueNow

ariaValueNow: null | string

MDN Reference

ariaValueText

ariaValueText: null | string

MDN Reference

role

role: null | string

`Readonly`attributes

attributes: NamedNodeMap

MDN Reference

className

className: string

Returns the value of element's class content attribute. Can be set to change it.

MDN Reference

`Readonly`clientHeight

clientHeight: number

MDN Reference

`Readonly`clientLeft

clientLeft: number

MDN Reference

`Readonly`clientTop

clientTop: number

MDN Reference

`Readonly`clientWidth

clientWidth: number

MDN Reference

`Readonly`currentCSSZoom

currentCSSZoom: number

MDN Reference

id

id: string

Returns the value of element's id content attribute. Can be set to change it.

MDN Reference

innerHTML

innerHTML: string

MDN Reference

`Readonly`localName

localName: string

Returns the local name.

MDN Reference

`Readonly`namespaceURI

namespaceURI: null | string

Returns the namespace.

MDN Reference

onfullscreenchange

onfullscreenchange: null | ((this: Element, ev: Event) => any)

MDN Reference

onfullscreenerror

onfullscreenerror: null | ((this: Element, ev: Event) => any)

MDN Reference

outerHTML

outerHTML: string

MDN Reference

`Readonly`ownerDocument

ownerDocument: Document

Returns the node document. Returns null for documents.

MDN Reference

`Readonly`prefix

prefix: null | string

Returns the namespace prefix.

MDN Reference

`Readonly`scrollHeight

scrollHeight: number

MDN Reference

scrollLeft

scrollLeft: number

MDN Reference

scrollTop

scrollTop: number

MDN Reference

`Readonly`scrollWidth

scrollWidth: number

MDN Reference

`Readonly`shadowRoot

shadowRoot: null | ShadowRoot

Returns element's shadow root, if any, and if shadow root's mode is "open", and null otherwise.

MDN Reference

slot

slot: string

Returns the value of element's slot content attribute. Can be set to change it.

MDN Reference

`Readonly`tagName

tagName: string

Returns the HTML-uppercased qualified name.

MDN Reference

`Readonly`baseURI

baseURI: string

Returns node's node document's document base URL.

MDN Reference

`Readonly`childNodes

childNodes: NodeListOf<ChildNode>

Returns the children.

MDN Reference

`Readonly`firstChild

firstChild: null | ChildNode

Returns the first child.

MDN Reference

`Readonly`isConnected

isConnected: boolean

Returns true if node is connected and false otherwise.

MDN Reference

`Readonly`lastChild

lastChild: null | ChildNode

Returns the last child.

MDN Reference

`Readonly`nextSibling

nextSibling: null | ChildNode

Returns the next sibling.

MDN Reference

`Readonly`nodeName

nodeName: string

Returns a string appropriate for the type of node.

MDN Reference

`Readonly`nodeType

nodeType: number

Returns the type of node.

MDN Reference

nodeValue

nodeValue: null | string

MDN Reference

`Readonly`parentElement

parentElement: null | HTMLElement

Returns the parent element.

MDN Reference

`Readonly`parentNode

parentNode: null | ParentNode

Returns the parent.

MDN Reference

`Readonly`previousSibling

previousSibling: null | ChildNode

Returns the previous sibling.

MDN Reference

textContent

textContent: null | string

MDN Reference

`Readonly`ELEMENT_NODE

ELEMENT_NODE: 1

node is an element.

`Readonly`ATTRIBUTE_NODE

ATTRIBUTE_NODE: 2

`Readonly`TEXT_NODE

TEXT_NODE: 3

node is a Text node.

`Readonly`CDATA_SECTION_NODE

CDATA_SECTION_NODE: 4

node is a CDATASection node.

`Readonly`ENTITY_REFERENCE_NODE

ENTITY_REFERENCE_NODE: 5

`Readonly`ENTITY_NODE

ENTITY_NODE: 6

`Readonly`PROCESSING_INSTRUCTION_NODE

PROCESSING_INSTRUCTION_NODE: 7

node is a ProcessingInstruction node.

`Readonly`COMMENT_NODE

COMMENT_NODE: 8

node is a Comment node.

`Readonly`DOCUMENT_NODE

DOCUMENT_NODE: 9

node is a document.

`Readonly`DOCUMENT_TYPE_NODE

DOCUMENT_TYPE_NODE: 10

node is a doctype.

`Readonly`DOCUMENT_FRAGMENT_NODE

DOCUMENT_FRAGMENT_NODE: 11

node is a DocumentFragment node.

`Readonly`NOTATION_NODE

NOTATION_NODE: 12

`Readonly`DOCUMENT_POSITION_DISCONNECTED

DOCUMENT_POSITION_DISCONNECTED: 1

Set when node and other are not in the same tree.

`Readonly`DOCUMENT_POSITION_PRECEDING

DOCUMENT_POSITION_PRECEDING: 2

Set when other is preceding node.

`Readonly`DOCUMENT_POSITION_FOLLOWING

DOCUMENT_POSITION_FOLLOWING: 4

Set when other is following node.

`Readonly`DOCUMENT_POSITION_CONTAINS

DOCUMENT_POSITION_CONTAINS: 8

Set when other is an ancestor of node.

`Readonly`DOCUMENT_POSITION_CONTAINED_BY

DOCUMENT_POSITION_CONTAINED_BY: 16

Set when other is a descendant of node.

`Readonly`DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC

DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC: 32

`Readonly`nextElementSibling

nextElementSibling: null | Element

Returns the first following sibling that is an element, and null otherwise.

MDN Reference

`Readonly`previousElementSibling

previousElementSibling: null | Element

Returns the first preceding sibling that is an element, and null otherwise.

MDN Reference

`Readonly`childElementCount

childElementCount: number

MDN Reference

`Readonly`children

children: HTMLCollection

Returns the child elements.

MDN Reference

`Readonly`firstElementChild

firstElementChild: null | Element

Returns the first child that is an element, and null otherwise.

MDN Reference

`Readonly`lastElementChild

lastElementChild: null | Element

Returns the last child that is an element, and null otherwise.

MDN Reference

`Readonly`assignedSlot

assignedSlot: null | HTMLSlotElement

MDN Reference

Accessors

classList

get classList(): DOMTokenList
Allows for manipulation of element's class content attribute as a set of whitespace-separated tokens through a DOMTokenList object.

MDN Reference

Returns DOMTokenList
- Defined in node_modules/typescript/lib/lib.dom.d.ts:8237
set classList(value: string): void
Parameters
- ```
value: string
```
Returns void
- Defined in node_modules/typescript/lib/lib.dom.d.ts:8238

part

get part(): DOMTokenList
MDN Reference

Returns DOMTokenList
- Defined in node_modules/typescript/lib/lib.dom.d.ts:8283
set part(value: string): void
Parameters
- ```
value: string
```
Returns void
- Defined in node_modules/typescript/lib/lib.dom.d.ts:8284

Methods

animate

animate(
    keyframes: null | Keyframe[] | PropertyIndexedKeyframes,
    options?: number | KeyframeAnimationOptions,
): Animation

MDN Reference

Parameters

keyframes: null | Keyframe[] | PropertyIndexedKeyframes

Optionaloptions: number | KeyframeAnimationOptions

getAnimations

getAnimations(options?: GetAnimationsOptions): Animation[]

MDN Reference

Parameters

```
Optionaloptions: GetAnimationsOptions
```

Returns Animation[]

after

after(...nodes: (string | Node)[]): void

Inserts nodes just after node, while replacing strings in nodes with equivalent Text nodes.

Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated.

MDN Reference

Parameters

```
…nodes: (string | Node)[]
```

Returns void

before

before(...nodes: (string | Node)[]): void

Inserts nodes just before node, while replacing strings in nodes with equivalent Text nodes.

Throws a "HierarchyRequestError" DOMException if the constraints of the node tree are violated.

MDN Reference

Parameters

```
…nodes: (string | Node)[]
```

Returns void

remove

remove(): void

Removes node.

MDN Reference

Returns void

replaceWith

replaceWith(...nodes: (string | Node)[]): void

Replaces 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.

MDN Reference

Parameters

```
…nodes: (string | Node)[]
```

Returns void

attachShadow

attachShadow(init: ShadowRootInit): ShadowRoot

Creates a shadow root for element and returns it.

MDN Reference

Parameters

```
init: ShadowRootInit
```

checkVisibility

checkVisibility(options?: CheckVisibilityOptions): boolean

MDN Reference

Parameters

```
Optionaloptions: CheckVisibilityOptions
```

Returns boolean

closest

closest<K extends keyof HTMLElementTagNameMap>(
    selector: K,
): null | HTMLElementTagNameMap[K]

Returns the first (starting at element) inclusive ancestor that matches selectors, and null otherwise.

MDN Reference

Type Parameters

K extends keyof HTMLElementTagNameMap

Parameters

```
selector: K
```

Returns null | HTMLElementTagNameMap[K]

closest<K extends keyof SVGElementTagNameMap>(
    selector: K,
): null | SVGElementTagNameMap[K]

Type Parameters

K extends keyof SVGElementTagNameMap

Parameters

```
selector: K
```

Returns null | SVGElementTagNameMap[K]

closest<K extends keyof MathMLElementTagNameMap>(
    selector: K,
): null | MathMLElementTagNameMap[K]

Type Parameters

K extends keyof MathMLElementTagNameMap

Parameters

```
selector: K
```

Returns null | MathMLElementTagNameMap[K]

closest<E extends Element = Element>(selectors: string): null | E

Type Parameters

E extends Element = Element

Parameters

```
selectors: string
```

Returns null | E

computedStyleMap

computedStyleMap(): StylePropertyMapReadOnly

MDN Reference

Returns StylePropertyMapReadOnly

getAttribute

getAttribute(qualifiedName: string): null | string

Returns element's first attribute whose qualified name is qualifiedName, and null if there is no such attribute otherwise.

MDN Reference

Parameters

```
qualifiedName: string
```

Returns null | string

getAttributeNS

getAttributeNS(namespace: null | string, localName: string): null | string

Returns element's attribute whose namespace is namespace and local name is localName, and null if there is no such attribute otherwise.

MDN Reference

Parameters

```
namespace: null | string
```
```
localName: string
```

Returns null | string

getAttributeNames

getAttributeNames(): string[]

Returns the qualified names of all element's attributes. Can contain duplicates.

MDN Reference

Returns string[]

getAttributeNode

getAttributeNode(qualifiedName: string): null | Attr

MDN Reference

Parameters

```
qualifiedName: string
```

Returns null | Attr

getAttributeNodeNS

getAttributeNodeNS(namespace: null | string, localName: string): null | Attr

MDN Reference

Parameters

```
namespace: null | string
```
```
localName: string
```

Returns null | Attr

getBoundingClientRect

getBoundingClientRect(): DOMRect

MDN Reference

Returns DOMRect

getClientRects

getClientRects(): DOMRectList

MDN Reference

getElementsByClassName

getElementsByClassName(classNames: string): HTMLCollectionOf<Element>

Returns a HTMLCollection of the elements in the object on which the method was invoked (a document or an element) that have all the classes given by classNames. The classNames argument is interpreted as a space-separated list of classes.

MDN Reference

Parameters

```
classNames: string
```

Returns HTMLCollectionOf<Element>

getElementsByTagName

getElementsByTagName<K extends keyof HTMLElementTagNameMap>(
    qualifiedName: K,
): HTMLCollectionOf<HTMLElementTagNameMap[K]>

MDN Reference

Type Parameters

K extends keyof HTMLElementTagNameMap

Parameters

```
qualifiedName: K
```

Returns HTMLCollectionOf<HTMLElementTagNameMap[K]>

getElementsByTagName<K extends keyof SVGElementTagNameMap>(
    qualifiedName: K,
): HTMLCollectionOf<SVGElementTagNameMap[K]>

Type Parameters

K extends keyof SVGElementTagNameMap

Parameters

```
qualifiedName: K
```

Returns HTMLCollectionOf<SVGElementTagNameMap[K]>

getElementsByTagName<K extends keyof MathMLElementTagNameMap>(
    qualifiedName: K,
): HTMLCollectionOf<MathMLElementTagNameMap[K]>

Type Parameters

K extends keyof MathMLElementTagNameMap

Parameters

```
qualifiedName: K
```

Returns HTMLCollectionOf<MathMLElementTagNameMap[K]>

getElementsByTagName<K extends keyof HTMLElementDeprecatedTagNameMap>(
    qualifiedName: K,
): HTMLCollectionOf<HTMLElementDeprecatedTagNameMap[K]>

Type Parameters

K extends keyof HTMLElementDeprecatedTagNameMap

Parameters

```
qualifiedName: K
```

Returns HTMLCollectionOf<HTMLElementDeprecatedTagNameMap[K]>

Deprecated

getElementsByTagName(qualifiedName: string): HTMLCollectionOf<Element>

Parameters

```
qualifiedName: string
```

Returns HTMLCollectionOf<Element>

getElementsByTagNameNS

getElementsByTagNameNS(
    namespaceURI: "http://www.w3.org/1999/xhtml",
    localName: string,
): HTMLCollectionOf<HTMLElement>

MDN Reference

Parameters

namespaceURI: "http://www.w3.org/1999/xhtml"

```
localName: string
```

Returns HTMLCollectionOf<HTMLElement>

getElementsByTagNameNS(
    namespaceURI: "http://www.w3.org/2000/svg",
    localName: string,
): HTMLCollectionOf<SVGElement>

Parameters

namespaceURI: "http://www.w3.org/2000/svg"

```
localName: string
```

Returns HTMLCollectionOf<SVGElement>

getElementsByTagNameNS(
    namespaceURI: "http://www.w3.org/1998/Math/MathML",
    localName: string,
): HTMLCollectionOf<MathMLElement>

Parameters

namespaceURI: "http://www.w3.org/1998/Math/MathML"

```
localName: string
```

Returns HTMLCollectionOf<MathMLElement>

getElementsByTagNameNS(
    namespace: null | string,
    localName: string,
): HTMLCollectionOf<Element>

Parameters

```
namespace: null | string
```
```
localName: string
```

Returns HTMLCollectionOf<Element>

getHTML

getHTML(options?: GetHTMLOptions): string

MDN Reference

Parameters

```
Optionaloptions: GetHTMLOptions
```

Returns string

hasAttribute

hasAttribute(qualifiedName: string): boolean

Returns true if element has an attribute whose qualified name is qualifiedName, and false otherwise.

MDN Reference

Parameters

```
qualifiedName: string
```

Returns boolean

hasAttributeNS

hasAttributeNS(namespace: null | string, localName: string): boolean

Returns true if element has an attribute whose namespace is namespace and local name is localName.

MDN Reference

Parameters

```
namespace: null | string
```
```
localName: string
```

Returns boolean

hasAttributes

hasAttributes(): boolean

Returns true if element has attributes, and false otherwise.

MDN Reference

Returns boolean

hasPointerCapture

hasPointerCapture(pointerId: number): boolean

MDN Reference

Parameters

```
pointerId: number
```

Returns boolean

insertAdjacentElement

insertAdjacentElement(where: InsertPosition, element: Element): null | Element

MDN Reference

Parameters

```
where: InsertPosition
```
```
element: Element
```

Returns null | Element

insertAdjacentHTML

insertAdjacentHTML(position: InsertPosition, string: string): void

MDN Reference

Parameters

```
position: InsertPosition
```
```
string: string
```

Returns void

insertAdjacentText

insertAdjacentText(where: InsertPosition, data: string): void

MDN Reference

Parameters

```
where: InsertPosition
```
```
data: string
```

Returns void

matches

matches(selectors: string): boolean

Returns true if matching selectors against element's root yields element, and false otherwise.

MDN Reference

Parameters

```
selectors: string
```

Returns boolean

releasePointerCapture

releasePointerCapture(pointerId: number): void

MDN Reference

Parameters

```
pointerId: number
```

Returns void

removeAttribute

removeAttribute(qualifiedName: string): void

Removes element's first attribute whose qualified name is qualifiedName.

MDN Reference

Parameters

```
qualifiedName: string
```

Returns void

removeAttributeNS

removeAttributeNS(namespace: null | string, localName: string): void

Removes element's attribute whose namespace is namespace and local name is localName.

MDN Reference

Parameters

```
namespace: null | string
```
```
localName: string
```

Returns void

removeAttributeNode

removeAttributeNode(attr: Attr): Attr

MDN Reference

Parameters

```
attr: Attr
```

Returns Attr

requestFullscreen

requestFullscreen(options?: FullscreenOptions): Promise<void>

Displays element fullscreen and resolves promise when done.

When supplied, options's navigationUI member indicates whether showing navigation UI while in fullscreen is preferred or not. If set to "show", navigation simplicity is preferred over screen space, and if set to "hide", more screen space is preferred. User agents are always free to honor user preference over the application's. The default value "auto" indicates no application preference.

MDN Reference

Parameters

```
Optionaloptions: FullscreenOptions
```

Returns Promise<void>

requestPointerLock

requestPointerLock(options?: PointerLockOptions): Promise<void>

MDN Reference

Parameters

```
Optionaloptions: PointerLockOptions
```

Returns Promise<void>

scroll

scroll(options?: ScrollToOptions): void

MDN Reference

Parameters

```
Optionaloptions: ScrollToOptions
```

Returns void

scroll(x: number, y: number): void

Parameters

```
x: number
```
```
y: number
```

Returns void

scrollBy

scrollBy(options?: ScrollToOptions): void

MDN Reference

Parameters

```
Optionaloptions: ScrollToOptions
```

Returns void

scrollBy(x: number, y: number): void

Parameters

```
x: number
```
```
y: number
```

Returns void

scrollIntoView

scrollIntoView(arg?: boolean | ScrollIntoViewOptions): void

MDN Reference

Parameters

Optionalarg: boolean | ScrollIntoViewOptions

Returns void

scrollTo

scrollTo(options?: ScrollToOptions): void

MDN Reference

Parameters

```
Optionaloptions: ScrollToOptions
```

Returns void

scrollTo(x: number, y: number): void

Parameters

```
x: number
```
```
y: number
```

Returns void

setAttribute

setAttribute(qualifiedName: string, value: string): void

Sets the value of element's first attribute whose qualified name is qualifiedName to value.

MDN Reference

Parameters

```
qualifiedName: string
```
```
value: string
```

Returns void

setAttributeNS

setAttributeNS(
    namespace: null | string,
    qualifiedName: string,
    value: string,
): void

Sets the value of element's attribute whose namespace is namespace and local name is localName to value.

MDN Reference

Parameters

```
namespace: null | string
```
```
qualifiedName: string
```
```
value: string
```

Returns void

setAttributeNode

setAttributeNode(attr: Attr): null | Attr

MDN Reference

Parameters

```
attr: Attr
```

Returns null | Attr

setAttributeNodeNS

setAttributeNodeNS(attr: Attr): null | Attr

MDN Reference

Parameters

```
attr: Attr
```

Returns null | Attr

setHTMLUnsafe

setHTMLUnsafe(html: string): void

MDN Reference

Parameters

```
html: string
```

Returns void

setPointerCapture

setPointerCapture(pointerId: number): void

MDN Reference

Parameters

```
pointerId: number
```

Returns void

toggleAttribute

toggleAttribute(qualifiedName: string, force?: boolean): boolean

If force is not given, "toggles" qualifiedName, removing it if it is present and adding it if it is not present. If force is true, adds qualifiedName. If force is false, removes qualifiedName.

Returns true if qualifiedName is now present, and false otherwise.

MDN Reference

Parameters

```
qualifiedName: string
```
```
Optionalforce: boolean
```

Returns boolean

webkitMatchesSelector

webkitMatchesSelector(selectors: string): boolean

Parameters

```
selectors: string
```

Returns boolean

Deprecated

This is a legacy alias of matches.

MDN Reference

addEventListener

addEventListener<K extends keyof ElementEventMap>(
    type: K,
    listener: (this: Element, ev: ElementEventMap[K]) => any,
    options?: boolean | AddEventListenerOptions,
): void

Appends an event listener for events whose type attribute value is type. The callback argument sets the callback that will be invoked when the event is dispatched.

The options argument sets listener-specific options. For compatibility this can be a boolean, in which case the method behaves exactly as if the value was specified as options's capture.

When set to true, options's capture prevents callback from being invoked when the event's eventPhase attribute value is BUBBLING_PHASE. When false (or not present), callback will not be invoked when event's eventPhase attribute value is CAPTURING_PHASE. Either way, callback will be invoked if event's eventPhase attribute value is AT_TARGET.

When set to true, options's passive indicates that the callback will not cancel the event by invoking preventDefault(). This is used to enable performance optimizations described in § 2.8 Observing event listeners.

When set to true, options's once indicates that the callback will only be invoked once after which the event listener will be removed.

If an AbortSignal is passed for options's signal, then the event listener will be removed when signal is aborted.

The event listener is appended to target's event listener list and is not appended if it has the same type, callback, and capture.

MDN Reference

Type Parameters

K extends keyof ElementEventMap

Parameters

```
type: K
```

listener: (this: Element, ev: ElementEventMap[K]) => any

Optionaloptions: boolean | AddEventListenerOptions

Returns void

addEventListener(
    type: string,
    listener: EventListenerOrEventListenerObject,
    options?: boolean | AddEventListenerOptions,
): void

Appends an event listener for events whose type attribute value is type. The callback argument sets the callback that will be invoked when the event is dispatched.

The options argument sets listener-specific options. For compatibility this can be a boolean, in which case the method behaves exactly as if the value was specified as options's capture.

When set to true, options's once indicates that the callback will only be invoked once after which the event listener will be removed.

If an AbortSignal is passed for options's signal, then the event listener will be removed when signal is aborted.

The event listener is appended to target's event listener list and is not appended if it has the same type, callback, and capture.

MDN Reference

Parameters

```
type: string
```

listener: EventListenerOrEventListenerObject

Optionaloptions: boolean | AddEventListenerOptions

Returns void

removeEventListener

removeEventListener<K extends keyof ElementEventMap>(
    type: K,
    listener: (this: Element, ev: ElementEventMap[K]) => any,
    options?: boolean | EventListenerOptions,
): void

Removes the event listener in target's event listener list with the same type, callback, and options.

MDN Reference

Type Parameters

K extends keyof ElementEventMap

Parameters

```
type: K
```

listener: (this: Element, ev: ElementEventMap[K]) => any

Optionaloptions: boolean | EventListenerOptions

Returns void

removeEventListener(
    type: string,
    listener: EventListenerOrEventListenerObject,
    options?: boolean | EventListenerOptions,
): void

Removes the event listener in target's event listener list with the same type, callback, and options.

MDN Reference

Parameters

```
type: string
```

listener: EventListenerOrEventListenerObject

Optionaloptions: boolean | EventListenerOptions

Returns void

dispatchEvent

dispatchEvent(event: Event): boolean

Dispatches a synthetic event event to target and returns true if either event's cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise.

MDN Reference

Parameters

```
event: Event
```

Returns boolean

appendChild

appendChild<T extends Node>(node: T): T

MDN Reference

Type Parameters

T extends Node

Parameters

```
node: T
```

Returns T

cloneNode

cloneNode(subtree?: boolean): Node

Returns a copy of node. If deep is true, the copy also includes the node's descendants.

MDN Reference

Parameters

```
Optionalsubtree: boolean
```

Returns Node

compareDocumentPosition

compareDocumentPosition(other: Node): number

Returns a bitmask indicating the position of other relative to node.

MDN Reference

Parameters

```
other: Node
```

Returns number

contains

contains(other: null | Node): boolean

Returns true if other is an inclusive descendant of node, and false otherwise.

MDN Reference

Parameters

```
other: null | Node
```

Returns boolean

getRootNode

getRootNode(options?: GetRootNodeOptions): Node

Returns node's root.

MDN Reference

Parameters

```
Optionaloptions: GetRootNodeOptions
```

Returns Node

hasChildNodes

hasChildNodes(): boolean

Returns whether node has children.

MDN Reference

Returns boolean

insertBefore

insertBefore<T extends Node>(node: T, child: null | Node): T

MDN Reference

Type Parameters

T extends Node

Parameters

```
node: T
```
```
child: null | Node
```

Returns T

isDefaultNamespace

isDefaultNamespace(namespace: null | string): boolean

MDN Reference

Parameters

```
namespace: null | string
```

Returns boolean

isEqualNode

isEqualNode(otherNode: null | Node): boolean

Returns whether node and otherNode have the same properties.

MDN Reference

Parameters

```
otherNode: null | Node
```

Returns boolean

isSameNode

isSameNode(otherNode: null | Node): boolean

MDN Reference

Parameters

```
otherNode: null | Node
```

Returns boolean

lookupNamespaceURI

lookupNamespaceURI(prefix: null | string): null | string

MDN Reference

Parameters

```
prefix: null | string
```

Returns null | string

lookupPrefix

lookupPrefix(namespace: null | string): null | string

MDN Reference

Parameters

```
namespace: null | string
```

Returns null | string

normalize

normalize(): void

Removes empty exclusive Text nodes and concatenates the data of remaining contiguous exclusive Text nodes into the first of their nodes.

MDN Reference

Returns void

removeChild

removeChild<T extends Node>(child: T): T

MDN Reference

Type Parameters

T extends Node

Parameters

```
child: T
```

Returns T

replaceChild

replaceChild<T extends Node>(node: Node, child: T): T

MDN Reference

Type Parameters

T extends Node

Parameters

```
node: Node
```
```
child: T
```

Returns T

append

append(...nodes: (string | Node)[]): void

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.

MDN Reference

Parameters

```
…nodes: (string | Node)[]
```

Returns void

prepend

prepend(...nodes: (string | Node)[]): void

Inserts nodes before the first 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.

MDN Reference

Parameters

```
…nodes: (string | Node)[]
```

Returns void

querySelector

querySelector<K extends keyof HTMLElementTagNameMap>(
    selectors: K,
): null | HTMLElementTagNameMap[K]

Returns the first element that is a descendant of node that matches selectors.

MDN Reference

Type Parameters

K extends keyof HTMLElementTagNameMap

Parameters

```
selectors: K
```

Returns null | HTMLElementTagNameMap[K]

querySelector<K extends keyof SVGElementTagNameMap>(
    selectors: K,
): null | SVGElementTagNameMap[K]

Type Parameters

K extends keyof SVGElementTagNameMap

Parameters

```
selectors: K
```

Returns null | SVGElementTagNameMap[K]

querySelector<K extends keyof MathMLElementTagNameMap>(
    selectors: K,
): null | MathMLElementTagNameMap[K]

Type Parameters

K extends keyof MathMLElementTagNameMap

Parameters

```
selectors: K
```

Returns null | MathMLElementTagNameMap[K]

querySelector<K extends keyof HTMLElementDeprecatedTagNameMap>(
    selectors: K,
): null | HTMLElementDeprecatedTagNameMap[K]

Type Parameters

K extends keyof HTMLElementDeprecatedTagNameMap

Parameters

```
selectors: K
```

Returns null | HTMLElementDeprecatedTagNameMap[K]

Deprecated

querySelector<E extends Element = Element>(selectors: string): null | E

Type Parameters

E extends Element = Element

Parameters

```
selectors: string
```

Returns null | E

querySelectorAll

querySelectorAll<K extends keyof HTMLElementTagNameMap>(
    selectors: K,
): NodeListOf<HTMLElementTagNameMap[K]>

Returns all element descendants of node that match selectors.

MDN Reference

Type Parameters

K extends keyof HTMLElementTagNameMap

Parameters

```
selectors: K
```

Returns NodeListOf<HTMLElementTagNameMap[K]>

querySelectorAll<K extends keyof SVGElementTagNameMap>(
    selectors: K,
): NodeListOf<SVGElementTagNameMap[K]>

Type Parameters

K extends keyof SVGElementTagNameMap

Parameters

```
selectors: K
```

Returns NodeListOf<SVGElementTagNameMap[K]>

querySelectorAll<K extends keyof MathMLElementTagNameMap>(
    selectors: K,
): NodeListOf<MathMLElementTagNameMap[K]>

Type Parameters

K extends keyof MathMLElementTagNameMap

Parameters

```
selectors: K
```

Returns NodeListOf<MathMLElementTagNameMap[K]>

querySelectorAll<K extends keyof HTMLElementDeprecatedTagNameMap>(
    selectors: K,
): NodeListOf<HTMLElementDeprecatedTagNameMap[K]>

Type Parameters

K extends keyof HTMLElementDeprecatedTagNameMap

Parameters

```
selectors: K
```

Returns NodeListOf<HTMLElementDeprecatedTagNameMap[K]>

Deprecated

querySelectorAll<E extends Element = Element>(selectors: string): NodeListOf<E>

Type Parameters

E extends Element = Element

Parameters

```
selectors: string
```

Returns NodeListOf<E>

replaceChildren

replaceChildren(...nodes: (string | Node)[]): void

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.

MDN Reference

Parameters

```
…nodes: (string | Node)[]
```

Element

Hierarchy (View Summary)

Index

Properties

Accessors

Methods

Properties

Optionalcharging

OptionalchargingTime

OptionaldischargingTime

Optionallevel

ariaAtomic

ariaAutoComplete

ariaBrailleLabel

ariaBrailleRoleDescription

ariaBusy

ariaChecked

ariaColCount

ariaColIndex

ariaColIndexText

ariaColSpan

ariaCurrent

ariaDescription

ariaDisabled

ariaExpanded

ariaHasPopup

ariaHidden

ariaInvalid

ariaKeyShortcuts

ariaLabel

ariaLevel

ariaLive

ariaModal

ariaMultiLine

ariaMultiSelectable

ariaOrientation

ariaPlaceholder

ariaPosInSet

ariaPressed

ariaReadOnly

ariaRelevant

ariaRequired

ariaRoleDescription

ariaRowCount

ariaRowIndex

ariaRowIndexText

ariaRowSpan

ariaSelected

ariaSetSize

ariaSort

ariaValueMax

ariaValueMin

ariaValueNow

ariaValueText

role

Readonlyattributes

className

ReadonlyclientHeight

ReadonlyclientLeft

ReadonlyclientTop

ReadonlyclientWidth

ReadonlycurrentCSSZoom

id

innerHTML

ReadonlylocalName

ReadonlynamespaceURI

onfullscreenchange

onfullscreenerror

outerHTML

ReadonlyownerDocument

Readonlyprefix

ReadonlyscrollHeight

scrollLeft

scrollTop

ReadonlyscrollWidth

ReadonlyshadowRoot

slot

ReadonlytagName

ReadonlybaseURI

ReadonlychildNodes

`Optional`charging

`Optional`chargingTime

`Optional`dischargingTime

`Optional`level

`Readonly`attributes

`Readonly`clientHeight

`Readonly`clientLeft

`Readonly`clientTop

`Readonly`clientWidth

`Readonly`currentCSSZoom

`Readonly`localName

`Readonly`namespaceURI

`Readonly`ownerDocument

`Readonly`prefix

`Readonly`scrollHeight

`Readonly`scrollWidth

`Readonly`shadowRoot

`Readonly`tagName

`Readonly`baseURI

`Readonly`childNodes

`Readonly`firstChild

`Readonly`isConnected

`Readonly`lastChild

`Readonly`nextSibling

`Readonly`nodeName

`Readonly`nodeType

`Readonly`parentElement

`Readonly`parentNode

`Readonly`previousSibling

`Readonly`ELEMENT_NODE

`Readonly`ATTRIBUTE_NODE

`Readonly`TEXT_NODE

`Readonly`CDATA_SECTION_NODE

`Readonly`ENTITY_REFERENCE_NODE

`Readonly`ENTITY_NODE

`Readonly`PROCESSING_INSTRUCTION_NODE

`Readonly`COMMENT_NODE

`Readonly`DOCUMENT_NODE

`Readonly`DOCUMENT_TYPE_NODE

`Readonly`DOCUMENT_FRAGMENT_NODE

`Readonly`NOTATION_NODE

`Readonly`DOCUMENT_POSITION_DISCONNECTED

`Readonly`DOCUMENT_POSITION_PRECEDING

`Readonly`DOCUMENT_POSITION_FOLLOWING

`Readonly`DOCUMENT_POSITION_CONTAINS

`Readonly`DOCUMENT_POSITION_CONTAINED_BY

`Readonly`DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC

`Readonly`nextElementSibling

`Readonly`previousElementSibling

`Readonly`childElementCount

`Readonly`children

`Readonly`firstElementChild

`Readonly`lastElementChild

`Readonly`assignedSlot