dom
Source: lib/dom.js (pure JS)
A lightweight DOM implementation: node/element classes, a parser, collections, serialization, and mutation observers.
Core node classes
| Class | Description |
|---|---|
Node | Base node (extends Interface): parent/child links, nodeType, traversal. |
Element | Element node (extends Node): attributes, children, query methods. |
Document | Document root (extends Element). |
Attr | Attribute node (extends Node). |
CharacterData | Base for text-bearing nodes (extends Node). |
Text | Text node (extends CharacterData). |
Comment | Comment node (extends CharacterData). |
Interface | Shared base providing property plumbing. |
DOMException | DOM error type (extends Error). |
Collections
| Class / function | Description |
|---|---|
NodeList | Live/static list of nodes. |
HTMLCollection | Element collection. |
NamedNodeMap | Attribute map. |
NamedMap(node, get, keys) | Generic name-keyed map. |
Collection(obj, get, len, proto) | Builds an array-like collection facade. |
TokenList | classList-style token set. |
CSSStyleDeclaration | style-attribute model. |
ListAdapter(list, key) | Adapts a list to a named map. |
MapItems(list, t) / FindItem(list, pred) / FindItemIndex(list, pred) | List helpers. |
Parsing, building & serialization
| Class / function | Description |
|---|---|
Parser | Parses markup into a node tree. |
Factory | Creates nodes of the right class for an owner document. |
Classes() / Prototypes(constructors) | Build the class/prototype tables. |
GetType(raw) / GetNode(raw, owner, factory) | Map raw parse nodes to DOM nodes. |
Serializer | Serializes a node tree back to markup. |
Mutation observation
| Class | Description |
|---|---|
MutationObserver | Observes subtree mutations and delivers records. |
MutationRecord | A single recorded mutation. |
Constants
Entities, nodeTypes, NODE_TYPES — entity tables and node-type enumerations.
Export list
Generated by utilities/doc-api.js from the dom dump of utilities/api-surface.sh: 1015 members. Edit the text above this block, not the block.
Functions: Document[Symbol.hasInstance](), Element[Symbol.hasInstance](), Interface[Symbol.hasInstance](), Node[Symbol.hasInstance](), Text[Symbol.hasInstance](), Classes(), Collection(), FindItem(), FindItemIndex(), GetNode(), GetType(), ListAdapter(), MapItems(), NamedMap(), Prototypes(), installTimers()
Attr
class, constructible
- methods:
[Symbol.inspect]() - properties:
name (get),nodeType = 2,ownerDocument (get),ownerElement (get),path (get),value (get/set),[Symbol.toStringTag]
CSSStyleDeclaration
class, constructible
- methods:
getPropertyPriority(),getPropertyValue(),item(),removeProperty(),setProperty(),[Symbol.inspect]() - properties:
cssFloat (get),cssText (get/set),parentRule (get),[Symbol.toStringTag]
CharacterData
class, constructible
- methods:
appendData(),deleteData(),insertData(),replaceData() - properties:
data (get/set)
Comment
class, constructible
- static methods:
cache() - methods:
[Symbol.inspect]() - properties:
data (get),nodeName,nodeType = 8,nodeValue (get),[Symbol.toStringTag]
CustomEvent
class, constructible
- properties:
detail (get),[Symbol.toStringTag]
DOMException
class, constructible
- properties:
name
DOMRect
class, constructible
- static methods:
fromRect() - properties:
height (get/set),width (get/set),x (get/set),y (get/set),[Symbol.toStringTag]
DOMRectReadOnly
class, constructible
- static methods:
fromRect() - methods:
toJSON() - properties:
bottom (get),height (get),left (get),right (get),top (get),width (get),x (get),y (get),[Symbol.toStringTag]
DOMStringMap
class, constructible
- methods:
delete(),get(),set(),[Symbol.iterator]() - properties:
[Symbol.toStringTag] (get)
Document
class, constructible
- methods:
createAttribute(),createDocumentFragment(),createElement(),createRange(),createTextNode(),createTreeWalker(),getElementById(),[Symbol.inspect]() - properties:
body (get),documentElement (get),nodeType = 9,[Symbol.toStringTag]
DocumentFragment
class, constructible
- methods:
appendChild() - properties:
nodeName (get),nodeType = 11,[Symbol.toStringTag]
Element
class, constructible
- static methods:
cache(),xpath() - static values:
elements - methods:
getAttribute(),getAttributeNames(),getAttributeNode(),getBoundingClientRect(),getClientRects(),hasAttribute(),hasAttributes(),removeAttribute(),setAttribute(),[Symbol.inspect]() - properties:
attributes (get),childElementCount (get),children (get),firstElementChild (get),id (get/set),innerHTML (get),innerText (get/set),lastElementChild (get),namespaceURI,nextElementSibling (get),nodeName (get/set),nodeType = 1,outerHTML (get),outerText (get),previousElementSibling (get),style (get),tagName (get/set),[Symbol.toStringTag]
Entities
object
- static values:
Attr = 5,CSSStyleDeclaration = 9,Comment = 7,Document = 0,DocumentFragment = 13,Element = 3,Event = 11,EventTarget = 12,HTMLCollection = 10,HTMLElement = 14,NamedNodeMap = 4,Node = 1,NodeList = 2,Text = 6,TokenList = 8
Event
class, constructible
- static values:
AT_TARGET = 2,BUBBLING_PHASE = 3,CAPTURING_PHASE = 1,NONE = 0 - methods:
isImmediatePropagationStopped(),isPropagationStopped(),preventDefault(),setCurrentTarget(),setEventPhase(),setTarget(),stopImmediatePropagation(),stopPropagation() - properties:
bubbles (get),cancelable (get),composed (get),currentTarget (get),defaultPrevented (get),eventPhase (get),target (get),timeStamp (get),type (get),[Symbol.toStringTag]
EventTarget
class, constructible
- methods:
addEventListener(),dispatchEvent(),invokeListeners(),removeEventListener() - properties:
[Symbol.toStringTag]
Factory
class, constructible
- static methods:
for(),get(),set(),type() - properties:
[Symbol.toStringTag]
File
class, constructible
- properties:
lastModified (get),name (get),webkitRelativePath (get),[Symbol.toStringTag]
FocusEvent
class, constructible
- properties:
relatedTarget (get),[Symbol.toStringTag]
HTMLAnchorElement
class, constructible
- properties:
download (get/set),hash (get),host (get),hostname (get),href (get/set),origin (get),pathname (get),port (get),protocol (get),rel (get/set),search (get),target (get/set),[Symbol.toStringTag]
HTMLAreaElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLAudioElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLBRElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLBaseElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLBodyElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLButtonElement
class, constructible
- properties:
disabled (get/set),form (get),name (get/set),type (get/set),value (get/set),[Symbol.toStringTag]
HTMLCanvasElement
class, constructible
- methods:
getContext(),toBlob(),toDataURL() - properties:
height (get/set),width (get/set),[Symbol.toStringTag]
HTMLColElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLColGroupElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLCollection
class, constructible
- methods:
[Symbol.iterator]() - properties:
[Symbol.toStringTag]
HTMLDataElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLDataListElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLDetailsElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLDialogElement
class, constructible
- methods:
close(),show(),showModal() - properties:
open (get/set),returnValue (get/set),[Symbol.toStringTag]
HTMLDivElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLElement
class, constructible
- methods:
blur(),click(),closest(),focus(),insertAdjacentElement() - properties:
clientHeight (get/set),clientLeft (get/set),clientTop (get/set),clientWidth (get/set),contentEditable (get/set),dataset (get),dir (get/set),draggable (get/set),hidden (get/set),lang (get/set),offsetHeight (get/set),offsetLeft (get/set),offsetParent (get/set),offsetTop (get/set),offsetWidth (get/set),scrollHeight (get/set),scrollLeft (get/set),scrollTop (get/set),scrollWidth (get/set),tabIndex (get/set),title (get/set),[Symbol.toStringTag]
HTMLEmbedElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLFieldSetElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLFormElement
class, constructible
- methods:
checkValidity(),reportValidity(),reset(),submit() - properties:
action (get/set),elements (get),enctype (get/set),length (get),method (get/set),name (get/set),noValidate (get/set),target (get/set),[Symbol.toStringTag]
HTMLHRElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLHeadElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLHeadingElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLHtmlElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLIFrameElement
class, constructible
- properties:
contentDocument (get),contentWindow (get),height (get/set),name (get/set),sandbox (get/set),src (get/set),width (get/set),[Symbol.toStringTag]
HTMLImageElement
class, constructible
- properties:
alt (get/set),crossOrigin (get/set),height (get/set),src (get/set),width (get/set),[Symbol.toStringTag]
HTMLInputElement
class, constructible
- methods:
checkValidity(),reportValidity(),select(),setCustomValidity(),setSelectionRange(),stepDown(),stepUp() - properties:
autocomplete (get/set),checked (get/set),disabled (get/set),form (get),max (get/set),maxLength (get/set),min (get/set),minLength (get/set),multiple (get/set),name (get/set),pattern (get/set),placeholder (get/set),readOnly (get/set),required (get/set),size (get/set),step (get/set),type (get/set),validationMessage (get),validity (get),value (get/set),willValidate (get),[Symbol.toStringTag]
HTMLLIElement
class, constructible
- properties:
value (get/set),[Symbol.toStringTag]
HTMLLabelElement
class, constructible
- properties:
control (get),form (get),htmlFor (get/set),[Symbol.toStringTag]
HTMLLegendElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLLinkElement
class, constructible
- properties:
crossOrigin (get/set),href (get/set),media (get/set),rel (get/set),type (get/set),[Symbol.toStringTag]
HTMLMapElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLMediaElement
class, constructible
- properties:
autoplay (get/set),controls (get/set),crossOrigin (get/set),loop (get/set),muted (get/set),preload (get/set),src (get/set),[Symbol.toStringTag]
HTMLMetaElement
class, constructible
- properties:
content (get/set),httpEquiv (get/set),name (get/set),[Symbol.toStringTag]
HTMLMeterElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLOListElement
class, constructible
- properties:
reversed (get/set),start (get/set),type (get/set),[Symbol.toStringTag]
HTMLObjectElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLOptGroupElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLOptionElement
class, constructible
- properties:
defaultSelected (get),disabled (get/set),index (get),label (get/set),selected (get/set),text (get/set),value (get/set),[Symbol.toStringTag]
HTMLParagraphElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLParamElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLPictureElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLPreElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLProgressElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLQuoteElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLScriptElement
class, constructible
- properties:
async (get/set),crossOrigin (get/set),defer (get/set),src (get/set),text (get/set),type (get/set),[Symbol.toStringTag]
HTMLSelectElement
class, constructible
- methods:
add(),checkValidity(),remove() - properties:
disabled (get/set),form (get),length (get),multiple (get/set),name (get/set),options (get),required (get/set),selectedIndex (get/set),size (get/set),value (get/set),[Symbol.toStringTag]
HTMLSlotElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLSourceElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLSpanElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLStyleElement
class, constructible
- properties:
media (get/set),type (get/set),[Symbol.toStringTag]
HTMLSummaryElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLTableCaptionElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLTableCellElement
class, constructible
- properties:
cellIndex (get),colSpan (get/set),headers (get/set),rowSpan (get/set),scope (get/set),[Symbol.toStringTag]
HTMLTableElement
class, constructible
- methods:
createCaption(),createTBody(),createTFoot(),createTHead(),deleteRow(),insertRow() - properties:
caption (get),rows (get),tBodies (get),tBody (get),tFoot (get),tHead (get),[Symbol.toStringTag]
HTMLTableRowElement
class, constructible
- methods:
deleteCell(),insertCell() - properties:
cells (get),rowIndex (get),sectionRowIndex (get),[Symbol.toStringTag]
HTMLTableSectionElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLTemplateElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLTextAreaElement
class, constructible
- methods:
checkValidity(),select(),setSelectionRange() - properties:
cols (get/set),disabled (get/set),form (get),maxLength (get/set),name (get/set),placeholder (get/set),readOnly (get/set),required (get/set),rows (get/set),value (get/set),[Symbol.toStringTag]
HTMLTimeElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLTitleElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLTrackElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLUnknownElement
class, constructible
- properties:
[Symbol.toStringTag]
HTMLVideoElement
class, constructible
- properties:
height (get/set),poster (get/set),width (get/set),[Symbol.toStringTag]
HashChangeEvent
class, constructible
- properties:
newURL (get),oldURL (get),[Symbol.toStringTag]
History
class, constructible
- methods:
back(),forward(),go(),pushState(),replaceState() - properties:
length (get),state (get),[Symbol.toStringTag]
InputEvent
class, constructible
- properties:
data (get),inputType (get),isComposing (get),[Symbol.toStringTag]
Interface
class, constructible
- methods:
appendChild(),cloneNode(),contains(),getElementsByTagName(),getRootNode(),hasChildNodes(),insertBefore(),isEqualNode(),isSameNode(),querySelector(),querySelectorAll(),removeChild(),replaceChild() - properties:
ATTRIBUTE_NODE = 2,CDATA_SECTION_NODE = 4,COMMENT_NODE = 8,DOCUMENT_FRAGMENT_NODE = 11,DOCUMENT_NODE = 9,DOCUMENT_TYPE_NODE = 10,ELEMENT_NODE = 1,ENTITY_NODE = 6,ENTITY_REFERENCE_NODE = 5,NOTATION_NODE = 12,PROCESSING_INSTRUCTION_NODE = 7,TEXT_NODE = 3,childNodes (get),firstChild (get),isConnected (get),lastChild (get),nextSibling (get),nodeName (get),nodeValue (get),ownerDocument (get),parentElement (get),parentNode (get),previousSibling (get),textContent (get/set)
KeyboardEvent
class, constructible
- static values:
DOM_KEY_LOCATION_LEFT = 1,DOM_KEY_LOCATION_NUMPAD = 3,DOM_KEY_LOCATION_RIGHT = 2,DOM_KEY_LOCATION_STANDARD = 0 - methods:
getModifierState() - properties:
altKey (get),charCode (get),code (get),ctrlKey (get),isComposing (get),key (get),keyCode (get),location (get),metaKey (get),repeat (get),shiftKey (get),[Symbol.toStringTag]
Location
class, constructible
- methods:
assign(),reload(),replace(),toString() - properties:
hash (get),host (get),hostname (get),href (get/set),origin (get),pathname (get),port (get),protocol (get),search (get),[Symbol.toStringTag]
MouseEvent
class, constructible
- methods:
getModifierState() - properties:
altKey (get),button (get),buttons (get),clientX (get),clientY (get),ctrlKey (get),metaKey (get),offsetX (get),offsetY (get),pageX (get),pageY (get),relatedTarget (get),screenX (get),screenY (get),shiftKey (get),[Symbol.toStringTag]
MutationObserver
class, constructible
- static methods:
eventFor(),observationsFor() - methods:
disconnect(),event(),observe(),takeRecords() - properties:
[Symbol.toStringTag]
MutationRecord
class, constructible
- static methods:
attribute(),characterData(),childList() - properties:
[Symbol.toStringTag]
NODE_TYPES
object
- static values:
ATTRIBUTE_NODE = 2,CDATA_SECTION_NODE = 4,COMMENT_NODE = 8,DOCUMENT_FRAGMENT_NODE = 11,DOCUMENT_NODE = 9,DOCUMENT_TYPE_NODE = 10,ELEMENT_NODE = 1,ENTITY_NODE = 6,ENTITY_REFERENCE_NODE = 5,NOTATION_NODE = 12,PROCESSING_INSTRUCTION_NODE = 7,TEXT_NODE = 3
NamedNodeMap
class, constructible
- static methods:
inspect(),toString() - methods:
getNamedItem(),item(),removeNamedItem(),setNamedItem(),[Symbol.inspect](),[Symbol.iterator]() - properties:
path (get),[Symbol.toStringTag]
Navigator
class, constructible
- methods:
javaEnabled(),sendBeacon() - properties:
appName (get),appVersion (get),clipboard (get),cookieEnabled (get),geolocation (get),hardwareConcurrency (get),language (get),languages (get),maxTouchPoints (get),mediaDevices (get),onLine (get),permissions (get),platform (get),product (get),userAgent (get),vendor (get),[Symbol.toStringTag]
Node
class, constructible
- static methods:
check(),depth(),document(),hier(),owner(),parent(),path(),proxyFor(),proxyOf(),raw(),up() - static values:
types - methods:
[Symbol.inspect]() - properties:
[Symbol.toStringTag]
NodeList
class, constructible
- methods:
[Symbol.iterator]() - properties:
[Symbol.toStringTag]
Parser
class, constructible
- static methods:
for() - methods:
parseFromFile(),parseFromString() - properties:
[Symbol.toStringTag]
PointerEvent
class, constructible
- properties:
height (get),isPrimary (get),pointerId (get),pointerType (get),pressure (get),tiltX (get),tiltY (get),width (get),[Symbol.toStringTag]
PopStateEvent
class, constructible
- properties:
oldState (get),state (get),[Symbol.toStringTag]
Range
class, constructible
- methods:
cloneContents(),cloneRange(),collapse(),deleteContents(),detach(),extractContents(),insertNode(),selectNode(),selectNodeContents(),setEnd(),setEndAfter(),setEndBefore(),setStart(),setStartAfter(),setStartBefore(),surroundContents(),toString() - properties:
collapsed (get),commonAncestorContainer (get),endContainer (get),endOffset (get),startContainer (get),startOffset (get),[Symbol.toStringTag]
Selection
class, constructible
- methods:
addRange(),collapse(),collapseToEnd(),collapseToStart(),containsNode(),deleteFromDocument(),empty(),extend(),getRangeAt(),removeAllRanges(),removeRange(),selectAllChildren(),setBaseAndExtent(),toString() - properties:
anchorNode (get),anchorOffset (get),focusNode (get),focusOffset (get),isCollapsed (get),rangeCount (get),type (get),[Symbol.toStringTag]
Serializer
class, constructible
- methods:
serializeToString() - properties:
[Symbol.toStringTag]
Storage
class, constructible
- methods:
clear(),getItem(),key(),removeItem(),setItem() - properties:
length (get),[Symbol.toStringTag]
Text
class, constructible
- static methods:
cache(),own(),store() - methods:
toString(),[Symbol.inspect]() - properties:
data (get/set),nodeName,nodeType = 3,nodeValue (get),[Symbol.toStringTag]
TokenList
class, constructible
- static methods:
tokens() - methods:
add(),contains(),entries(),every(),forEach(),item(),keys(),map(),reduce(),remove(),replace(),some(),supports(),toggle(),values(),[Symbol.inspect](),[Symbol.iterator]() - properties:
length (get),value (get),[Symbol.toStringTag]
Touch
class, constructible
- properties:
clientX (get),clientY (get),identifier (get),pageX (get),pageY (get),screenX (get),screenY (get),target (get),[Symbol.toStringTag]
TouchEvent
class, constructible
- properties:
altKey (get),changedTouches (get),ctrlKey (get),metaKey (get),shiftKey (get),targetTouches (get),touches (get),[Symbol.toStringTag]
TouchList
class, constructible
- methods:
item(),[Symbol.iterator]() - properties:
length (get),[Symbol.toStringTag]
UIEvent
class, constructible
- properties:
detail (get),view (get),[Symbol.toStringTag]
WheelEvent
class, constructible
- static values:
DOM_DELTA_LINE = 1,DOM_DELTA_PAGE = 2,DOM_DELTA_PIXEL = 0 - properties:
deltaMode (get),deltaX (get),deltaY (get),deltaZ (get),[Symbol.toStringTag]
Window
class, constructible
- methods:
alert(),atob(),blur(),btoa(),cancelAnimationFrame(),cleanup(),clearInterval(),clearTimeout(),close(),confirm(),fetch(),focus(),getComputedStyle(),getSelection(),matchMedia(),open(),postMessage(),print(),prompt(),queueMicrotask(),requestAnimationFrame(),scrollBy(),scrollTo(),setInterval(),setTimeout(),stop() - properties:
console (get),devicePixelRatio (get),document (get/set),globalThis (get),history (get),innerHeight (get),innerWidth (get),localStorage (get),location (get/set),navigator (get),outerHeight (get),outerWidth (get),pageXOffset (get),pageYOffset (get),performance (get),screenX (get),screenY (get),scrollX (get),scrollY (get),self (get),sessionStorage (get),window (get),[Symbol.toStringTag]
nodeTypes
object
- static values:
'0','1','10','11','12','2','3','4','5','6','7','8','9',length = 13