DOM

The read-only localName property of the Attr interface returns the local part of the qualified name of an attribute, that is the name of the attribute, stripped from any namespace in front of it. For example, if the qualified name is xml:lang, the returned local name is lang, if the element supports that namespace.

The read-only name property of the Attr interface returns the qualified name of an attribute, that is the name of the attribute, with the namespace prefix, if any, in front of it. For example, if the local name is lang and the namespace prefix is xml, the returned qualified name is xml:lang.

The read-only namespaceURI property of the Attr interface returns the namespace URI of the attribute, or null if the element is not in a namespace.

The read-only ownerElement property of the Attr interface returns the Element the attribute belongs to.

The read-only prefix property of the Attr returns the namespace prefix of the attribute, or null if no prefix is specified.

The value property of the Attr interface contains the value of the attribute.

The CDATASection interface represents a CDATA section that can be used within XML to include extended portions of unescaped text. When inside a CDATA section, the symbols < and & don't need escaping as they normally do.

The CharacterData abstract interface represents a Node object that contains characters. This is an abstract interface, meaning there aren't any objects of type CharacterData: it is implemented by other interfaces like Text, Comment, CDATASection, or ProcessingInstruction, which aren't abstract.

The after() method of the CharacterData interface inserts a set of Node objects or strings in the children list of the object's parent, just after the object itself.

The appendData() method of the CharacterData interface adds the provided data to the end of the node's current data.

The before() method of the CharacterData interface inserts a set of Node objects and strings in the children list of the CharacterData's parent, just before the CharacterData node.

The data property of the CharacterData interface represent the value of the current object's data.

The deleteData() method of the CharacterData interface removes all or part of the data from this CharacterData node.

The insertData() method of the CharacterData interface inserts the provided data into this CharacterData node's current data, at the provided offset from the start of the existing data. The provided data is spliced into the existing data.

The read-only CharacterData.length property returns the number of characters in the contained data, as a positive integer.

The read-only nextElementSibling property of the CharacterData interface returns the first Element node following the specified one in its parent's children list, or null if the specified element is the last one in the list.

The read-only previousElementSibling property of the CharacterData interface returns the first Element before the current node in its parent's children list, or null if there is none.

The remove() method of the CharacterData removes it from its parent node. If it has no parent node, calling remove() does nothing.

The replaceData() method of the CharacterData interface removes a certain number of characters of the existing text in a given CharacterData node and replaces those characters with the text provided.

The replaceWith() method of the CharacterData interface replaces this node in the children list of its parent with a set of Node objects or string.

The substringData() method of the CharacterData interface returns a portion of the existing data, starting at the specified index and extending for a given number of characters afterwards.

The Comment interface represents textual notations within markup; although it is generally not visually shown, such comments are available to be read in the source view.

The Comment() constructor returns a newly created Comment object with the optional string given in parameter as its textual content.

The Document interface represents any web page loaded in the browser and serves as an entry point into the web page's content, which is the DOM tree.

The activeElement read-only property of the Document interface returns the Element within the DOM that is receiving keyboard events such as Element/keydownevent and Element/keyupevent. This is usually analogous to the focused element.

Document.adoptNode() transfers a node/dom from another Document into the method's document. The adopted node and its subtree are removed from their original document (if any), and their Node.ownerDocument is changed to the current document. The node can then be inserted into the current document.

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.

The Document.body property represents the body or frameset node of the current document, or null if no such element exists.

The Document.characterSet read-only property returns the character encoding of the document that it's currently rendered with.

The Document.childElementCount read-only property returns the number of child elements of the document.

The read-only children property returns a live HTMLCollection which contains all of the child Element of the document upon which it was called.

The Document.compatMode read-only property indicates whether the document is rendered in Quirks mode or Standards mode.

The Document.contentType read-only property returns the MIME type that the document is being rendered as. This may come from HTTP headers or other sources of MIME information, and might be affected by automatic type conversions performed by either the browser or extensions.

The createAttribute() method of the Document interface creates a new attribute node.

The createAttributeNS() method of the Document interface creates a new attribute node with the specified namespace URI and qualified name.

createCDATASection() creates a new CDATA section node, and returns it.

createComment() creates a new comment node, and returns it.

Creates a new empty DocumentFragment into which DOM nodes can be added to build an offscreen DOM tree.

The createElement() method of the Document interface creates a new HTMLElement that has the specified localName.

`options` parameter

The createElementNS() method of the Document interface creates a new element with the specified namespace URI and qualified name.

`options` parameter

The Document.createNodeIterator() method returns a new NodeIterator object.

createProcessingInstruction() generates a new processing instruction node and returns it.

Creates a new Text node. This method can be used to escape HTML characters.

The Document.createTreeWalker() creator method returns a newly created TreeWalker object.

`whatToShow` and `filter` parameters are optional

The Document.currentScript property returns the script element whose script is currently being processed and isn't a JavaScript module. (For modules use import.meta instead.)

In browsers, document.defaultView returns the Window object associated with Browsing_context, or null if none is available.

The Document.dir property is a string representing the directionality of the text of the document, whether left to right (default) or right to left. Possible values are 'rtl', right to left, and 'ltr', left to right.

The doctype read-only property of the Document interface is a DocumentType object representing the Doctype associated with the current document.

The Document constructor creates a new Document object that is a web page loaded in the browser and serving as an entry point into the page's content.

The documentElement read-only property of the Document interface returns the Element that is the root element of the document (for example, the html element for HTML documents).

The documentURI read-only property of the Document interface returns the document location as a string.

The DOMContentLoaded event fires when the HTML document has been completely parsed, and all deferred scripts ( and ) have downloaded and executed. It doesn't wait for other things like images, subframes, and async scripts to finish loading.

The embeds read-only property of the Document interface returns a list of the embedded embed elements within the current document.

The Document.firstElementChild read-only property returns the document's first child Element, or null if there are no child elements.

The forms read-only property of the Document interface returns an HTMLCollection listing all the form elements contained in the document.

The getElementById() method of the Document interface returns an Element object representing the element whose Element.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.

The getElementsByClassName method of Document interface returns an array-like object of all child elements which have all of the given class name(s).

The getElementsByName() method of the Document object returns a NodeList Collection of elements with a given name attribute in the document.

The getElementsByTagName method of Document interface returns an HTMLCollection of elements with the given tag name.

Returns a list of elements with the given tag name belonging to the given namespace. The complete document is searched, including the root node.

The hasFocus() method of the Document interface returns a boolean value indicating whether the document or any element inside the document has focus. This method can be used to determine whether the active element in a document has focus.

The head read-only property of the Document interface returns the head element of the current document.

The images read-only property of the Document interface returns a collection of the images in the current HTML document.

The Document.implementation property returns a DOMImplementation object associated with the current document.

The importNode() method of the Document interface creates a copy of a Node or DocumentFragment from another document, to be inserted into the current document later.

The Document.lastElementChild read-only property returns the document's last child Element, or null if there are no child elements.

The lastModified property of the Document interface returns a string containing the date and local time on which the current document was last modified.

The links read-only property of the Document interface returns a collection of all area elements and a elements in a document with a value for the href attribute.

The plugins read-only property of the Document interface returns an HTMLCollection object containing one or more HTMLEmbedElements representing the embed elements in the current document.

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.

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.

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.

The Document.readyState property describes the loading state of the document. When the value of this property changes, a Document/readystatechange_event event fires on the document object.

The readystatechange event is fired when the Document.readyState attribute of a document has changed.

The Document.referrer property returns the URI of the page that linked to this page.

The Document.replaceChildren() method replaces the existing children of a Document with a specified new set of children.

The scripts property of the Document interface returns a list of the script elements in the document. The returned object is an HTMLCollection.

The document.title property gets or sets the current title of the document. When present, it defaults to the value of the .

The URL read-only property of the Document interface returns the document location as a string.

The DocumentFragment interface represents a minimal document object that has no parent.

The DocumentFragment.append() method inserts a set of Node objects or strings after the last child of the document fragment. Strings are inserted as equivalent Text nodes.

The DocumentFragment.childElementCount read-only property returns the number of child elements of a DocumentFragment.

The read-only children property returns a live HTMLCollection which contains all of the child Element of the document fragment upon which it was called.

The DocumentFragment() constructor returns a new, empty DocumentFragment object.

The DocumentFragment.firstElementChild read-only property returns the document fragment's first child Element, or null if there are no child elements.

The getElementById() method of the DocumentFragment returns an Element object representing the element whose Element.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.

The DocumentFragment.lastElementChild read-only property returns the document fragment's last child Element, or null if there are no child elements.

The DocumentFragment.prepend() method inserts a set of Node objects or strings before the first child of the document fragment. Strings are inserted as equivalent Text nodes.

The DocumentFragment.querySelector() method returns the first element, or null if no matches are found, within the DocumentFragment (using depth-first pre-order traversal of the document's nodes) that matches the specified group of selectors.

The DocumentFragment.querySelectorAll() method returns a NodeList of elements within the DocumentFragment (using depth-first pre-order traversal of the document's nodes) that matches the specified group of selectors.

The DocumentFragment.replaceChildren() method replaces the existing children of a DocumentFragment with a specified new set of children. These can be string or Node objects.

The DocumentType interface represents a Node containing a doctype.

The DocumentType.after() method inserts a set of Node objects or strings in the children list of the DocumentType's parent, just after the DocumentType. Strings are inserted as equivalent Text nodes.

The DocumentType.before() method inserts a set of Node objects or strings in the children list of the DocumentType's parent, just before the DocumentType. Strings are inserted as equivalent Text nodes.

The read-only name property of the DocumentType returns the type of the document.

The read-only publicId property of the DocumentType returns a formal identifier of the document.

The DocumentType.remove() method removes a document's doctype. If it is already detached from the document, calling remove() does nothing.

The DocumentType.replaceWith() method replaces the document type with a set of given nodes.

The read-only systemId property of the DocumentType returns the URL of the associated DTD.

The DOMException interface represents an abnormal event (called an exception) that occurs as a result of calling a method or accessing a property of a web API. This is how error conditions are described in web APIs.

The DOMException() constructor returns a DOMException object with a specified message and name.

The message read-only property of the DOMException interface returns a string representing a message or description associated with the given error name.

The name read-only property of the DOMException interface returns a string that contains one of the strings associated with an error name.

The DOMImplementation interface represents an object providing methods which are not dependent on any particular document. Such an object is returned by the Document.implementation property.

The createDocument() method of the DOMImplementation interface creates and returns an XMLDocument.

The DOMImplementation.createDocumentType() method returns a DocumentType object which can either be used with DOMImplementation.createDocument upon document creation or can be put into the document via methods like Node.insertBefore() or Node.replaceChild().

The DOMImplementation.createHTMLDocument() method creates a new HTML .

The DOMStringList interface is a legacy type returned by some APIs and represents a non-modifiable list of strings (DOMString).

The contains() method returns a boolean indicating whether the given string is in the list.

The item() method returns a string from a DOMStringList by index.

The read-only length property indicates the number of strings in the DOMStringList.

The DOMTokenList interface represents a set of space-separated tokens. Such a set is returned by Element.classList or HTMLLinkElement.relList, and many others.

[Symbol.iterator]

The add() method of the DOMTokenList interface adds the given tokens to the list, omitting any that are already present.

Multiple parameters for `add()`

The contains() method of the DOMTokenList interface returns a boolean value — true if the underlying list contains the given token, otherwise false.

The entries() method of the DOMTokenList interface returns an Iteration_protocols allowing you to go through all key/value pairs contained in this object. The values are Arrays which have [key, value] pairs, each representing a single token.

The forEach() method of the DOMTokenList interface calls the callback given in parameter once for each value pair in the list, in insertion order.

The item() method of the DOMTokenList interface returns an item in the list, determined by its position in the list, its index.

The keys() method of the DOMTokenList interface returns an Iteration_protocols allowing to go through all keys contained in this object. The keys are unsigned integers.

The read-only length property of the DOMTokenList interface is an integer representing the number of objects stored in the object.

The remove() method of the DOMTokenList interface removes the specified tokens from the list.

Methods that modify the DOMTokenList (such as DOMTokenList.add()) automatically trim any excess Whitespace and remove duplicate values from the list. For example:

Multiple parameters for `remove()`

The replace() method of the DOMTokenList interface replaces an existing token with a new token. If the first token doesn't exist, replace() returns false immediately, without adding the new token to the token list.

`return()`'s value is a boolean, not void as it used to be.

The supports() method of the DOMTokenList interface returns true if a given token is in the associated attribute's supported tokens. This method is intended to support feature detection.

The toggle() method of the DOMTokenList interface removes an existing token from the list and returns false. If the token doesn't exist it's added and the function returns true.

`force` parameter

The toString() stringifier method of the DOMTokenList interface returns the values of the token list serialized as a string. The return value is a space-separated list of tokens equal to the DOMTokenList.value property.

Methods that modify the DOMTokenList (such as DOMTokenList.add()) automatically trim any excess Whitespace and remove duplicate values from the list. For example:

The value property of the DOMTokenList interface is a stringifier that returns the value of the list serialized as a string, or clears and sets the list to the given value.

The values() method of the DOMTokenList interface returns an Iteration_protocols allowing the caller to go through all values contained in the DOMTokenList. The individual values are strings.

Element is the most general base class from which all element objects (i.e., objects that represent elements) in a Document inherit. It only has methods and properties common to all kinds of elements. More specific classes inherit from Element.

The Element.after() method inserts a set of Node objects or strings in the children list of the Element's parent, just after the Element. Strings are inserted as equivalent Text nodes.

The Element.append() method inserts a set of Node objects or strings after the last child of the Element. Strings are inserted as equivalent Text nodes.

The Element.attributes property returns a live collection of all attribute nodes registered to the specified node. It is a NamedNodeMap, not an Array, so it has no Array methods and the Attr nodes' indexes may differ among browsers. To be more specific, attributes is a key/value pair of strings that represents any information regarding that attribute.

The Element.before() method inserts a set of Node objects or strings in the children list of this Element's parent, just before this Element. Strings are inserted as equivalent Text nodes.

The Element.childElementCount read-only property returns the number of child elements of this element.

The read-only children property returns a live HTMLCollection which contains all of the child Element of the element upon which it was called.

The read-only classList property of the Element interface contains a live DOMTokenList collection representing the class attribute of the element. This can then be used to manipulate the class list.

The className property of the Element interface gets and sets the value of the class attribute of the specified element.

The clientHeight read-only property of the Element interface is zero for elements with no CSS or inline layout boxes; otherwise, it's the inner height of an element in pixels. It includes padding but excludes borders, margins, and horizontal scrollbars (if present).

The clientLeft read-only property of the Element interface returns the width of the left border of an element in pixels. It includes the width of the vertical scrollbar if the text direction of the element is right-to-left and if there is an overflow causing a left vertical scrollbar to be rendered. clientLeft does not include the left margin or the left…

The clientTop read-only property of the Element interface returns the width of the top border of an element in pixels.

The clientWidth read-only property of the Element interface is zero for inline elements and elements with no CSS; otherwise, it's the inner width of an element in pixels. It includes padding but excludes borders, margins, and vertical scrollbars (if present).

The closest() method of the Element interface traverses the element and its parents (heading toward the document root) until it finds a node that matches the specified CSS selector.

The currentCSSZoom read-only property of the Element interface provides the "effective" CSS zoom of an element, taking into account the zoom applied to the element and all its parent elements.

The Element.firstElementChild read-only property returns an element's first child Element, or null if there are no child elements.

The getAttribute() method of the Element interface returns the value of a specified attribute on the element.

The getAttributeNames() method of the Element interface returns the attribute names of the element as an Array of strings. If the element has no attributes it returns an empty array.

Returns the specified attribute of the specified element, as an Attr node.

The getAttributeNodeNS() method of the Element interface returns the namespaced Attr node of an element.

The getAttributeNS() method of the Element interface returns the string value of the attribute with the specified namespace and name. If the named attribute does not exist, the value returned will either be null or "" (the empty string); see Notes for details.

The Element.getBoundingClientRect() method returns a DOMRect object providing information about the size of an element and its position relative to the viewport.

The getClientRects() method of the Element interface returns a collection of DOMRect objects that indicate the bounding rectangles for each CSS border box in a client.

The Element method getElementsByClassName() returns a live HTMLCollection which contains every descendant element which has the specified class name or names.

The Element.getElementsByTagName() method returns a live HTMLCollection of elements with the given tag name.

`getElementsByTagName("*")`

The Element.getElementsByTagNameNS() method returns a live HTMLCollection of elements with the given tag name belonging to the given namespace. It is similar to Document.getElementsByTagNameNS, except that its search is restricted to descendants of the specified element.

`getElementsByTagNameNS(namespaceURI, "*")`

The Element.hasAttribute() method returns a Boolean value indicating whether the specified element has the specified attribute or not.

The hasAttributeNS() method of the Element interface returns a boolean value indicating whether the current element has the specified attribute with the specified namespace.

The hasAttributes() method of the Element interface returns a boolean value indicating whether the current element has any attributes or not.

The id property of the Element interface represents the element's identifier, reflecting the id global attribute.

The innerHTML property of the Element interface gets or sets the HTML or XML markup contained within the element, omitting any shadow tree in both cases.

The insertAdjacentElement() method of the Element interface inserts a given element node at a given position relative to the element it is invoked upon.

The insertAdjacentHTML() method of the Element interface parses the specified input as HTML or XML and inserts the resulting nodes into the DOM tree at a specified position.

The insertAdjacentText() method of the Element interface, given a relative position and a string, inserts a new text node at the given position relative to the element it is called from.

The Element.lastElementChild read-only property returns an element's last child Element, or null if there are no child elements.

The Element.localName read-only property returns the local part of the qualified name of an element.

The matches() method of the Element interface tests whether the element would be selected by the specified CSS selector.

The Element.namespaceURI read-only property returns the namespace URI of the element, or null if the element is not in a namespace.

The Element.nextElementSibling read-only property returns the element immediately following the specified one in its parent's Element.children list, or null if the specified element is the last one in the list.

The outerHTML attribute of the Element interface gets or sets the HTML or XML markup of the element and its descendants, omitting any shadow tree in both cases.

The Element.prefix read-only property returns the namespace prefix of the specified element, or null if no prefix is specified.

The Element.prepend() method inserts a set of Node objects or strings before the first child of the Element. Strings are inserted as equivalent Text nodes.

The Element.previousElementSibling read-only property returns the Element immediately prior to the specified one in its parent's Element.children list, or null if the specified element is the first one in the list.

The querySelector() method of the Element interface returns the first element that is a descendant of the element on which it is invoked that matches the specified group of selectors.