+Group: WHATWG H1: DOM Shortname: dom Text Macro: TWITTER thedomstandard +Text Macro: LATESTRD 2021-06 Abstract: DOM defines a platform-neutral model for events, aborting activities, and node trees. Translation: ja https://triple-underscore.github.io/DOM4-ja.html Translate IDs: slottable slotable @@ -27,8 +28,6 @@ type: interface url: https://w3c.github.io/deviceorientation/spec-source-orientation.html#devicemotion text: DeviceMotionEvent text: DeviceOrientationEvent - url: https://www.khronos.org/registry/webgl/specs/latest/1.0/#5.15 - text: WebGLContextEvent urlPrefix: https://tc39.github.io/ecma262/#; spec: ECMASCRIPT text: Construct; url: sec-construct; type: abstract-op type: dfn @@ -38,49 +37,16 @@ urlPrefix: https://w3c.github.io/hr-time/#; spec: HR-TIME type:typedef; urlPrefix: dom-; text: DOMHighResTimeStamp type:dfn; text: time origin; url: dfn-time-origin type:dfn; text: clock resolution + type:dfn; text: current high resolution time; url: dfn-current-high-resolution-time + type:dfn; text: relative high resolution coarse time; url: dfn-relative-high-resolution-coarse-timespec:html; type:element text: title text: script -spec:infra; type:dfn; text:list-Goals
- -This specification standardizes the DOM. It does so as follows: - --
- -
By consolidating DOM Level 3 Core [[DOM-Level-3-Core]], - Element Traversal [[ELEMENTTRAVERSAL]], - Selectors API Level 2 [[SELECTORS-API2]], the - "DOM Event Architecture" and "Basic Event Interfaces" chapters of - DOM Level 3 Events [[uievents-20031107]] (specific types of events do not - belong in the DOM Standard), and DOM Level 2 Traversal and Range - [[DOM-Level-2-Traversal-Range]], and: - -
-
- -- Aligning them with the JavaScript ecosystem where possible. -
- Aligning them with existing implementations. -
- Simplifying them as much as possible. -
By moving features from the HTML Standard [[!HTML]] that make more sense to be - specified as part of the DOM Standard. - -
- -
By defining a replacement for the "Mutation Events" and - "Mutation Name Event Types" chapters of DOM Level 3 Events - [[uievents-20031107]] as the old model - was problematic. - -
The old model is expected to be removed from implementations - in due course. - -
By defining new features that simplify common DOM operations. -
Infrastructure
@@ -95,10 +61,6 @@ This specification standardizes the DOM. It does so as follows: [[!XML]] [[!XML-NAMES]] -The term context object is an alias for this. - -
Usage of context object is deprecated in favor of this. -
When extensions are needed, the DOM Standard can be updated accordingly, or a new standard can be written that hooks into the provided extensibility hooks for applicable specifications. @@ -169,11 +131,11 @@ same tree and A comes after B in tree order. -The first child of an object is its -first child or null if it has no children. +
The first child of an object is its first +child or null if it has no children. -The last child of an object is its -last child or null if it has no children. +
The last child of an object is its last +child or null if it has no children. The previous sibling of an object is its first preceding @@ -253,7 +215,7 @@ added.
To validate a qualifiedName, throw an "{{InvalidCharacterError!!exception}}" {{DOMException}} if qualifiedName does not match -the
NameorQNameproduction. +theQNameproduction. To validate and extract a namespace and qualifiedName, run these steps: @@ -314,6 +276,10 @@ by utilizing the {{EventTarget/removeEventListener()}} method, passing the same arguments. +Alternatively, event listeners can be removed by passing an {{AbortSignal}} to +{{EventTarget/addEventListener()}} and calling {{AbortController/abort()}} on the controller +owning the signal. + Events are objects too and implement the {{Event}} interface (or a derived interface). In the example above ev is the event. ev is @@ -358,34 +324,24 @@ use of this functionality through events (synthetic events) can make use of the return value of the {{EventTarget/dispatchEvent()}} method: -+if(obj.dispatchEvent(event)) { // event was not canceled, time for some magic … }-When an event is -dispatched to an object that -participates in a -tree (e.g. an -element), it can reach -event listeners on that object's -ancestors too. First all object's -ancestor -event listeners whose -capture variable is set to true are invoked, in -tree order. Second, object's own -event listeners are invoked. And -finally, and only if event's -{{Event/bubbles}} attribute value is true, -object's ancestor -event listeners are invoked again, -but now in reverse tree order. - -Let's look at an example of how events work in a tree: - -+When an event is dispatched to an object that participates in a tree +(e.g., an element), it can reach event listeners on that object's +ancestors too. Effectively, all the object's inclusive ancestor event listeners +whose capture is true are invoked, in tree order. And then, if +event's {{Event/bubbles}} is true, all the object's inclusive ancestor +event listeners whose capture is false are invoked, now in +reverse tree order. + +
Let's look at an example of how events work in a tree: + +
<!doctype html> <html> <head> @@ -406,31 +362,25 @@ Let's look at an example of how events work in a tree: </html>-Thedebugfunction will be invoked twice. Each time the event's -{{Event/target}} attribute value will be the -spanelement. The -first time {{Event/currentTarget}} attribute's -value will be the document, the second -time thebodyelement. -{{Event/eventPhase}} attribute's value -switches from {{Event/CAPTURING_PHASE}} -to {{Event/BUBBLING_PHASE}}. If an -event listener was registered for -thespanelement, -{{Event/eventPhase}} attribute's value -would have been {{Event/AT_TARGET}}. +The
debugfunction will be invoked twice. Each time the event's +{{Event/target}} attribute value will be thespanelement. The first time +{{Event/currentTarget}} attribute's value will be the document, the second time the +bodyelement. {{Event/eventPhase}} attribute's value switches from +{{Event/CAPTURING_PHASE}} to {{Event/BUBBLING_PHASE}}. If an event listener was registered +for thespanelement, {{Event/eventPhase}} attribute's value would have +been {{Event/AT_TARGET}}.Interface {{Event}}
-+[Exposed=(Window,Worker,AudioWorklet)] interface Event { constructor(DOMString type, optional EventInit eventInitDict = {}); readonly attribute DOMString type; readonly attribute EventTarget? target; - readonly attribute EventTarget? srcElement; // historical + readonly attribute EventTarget? srcElement; // legacy readonly attribute EventTarget? currentTarget; sequence<EventTarget> composedPath(); @@ -440,21 +390,21 @@ interface Event { const unsigned short BUBBLING_PHASE = 3; readonly attribute unsigned short eventPhase; - void stopPropagation(); - attribute boolean cancelBubble; // historical alias of .stopPropagation - void stopImmediatePropagation(); + undefined stopPropagation(); + attribute boolean cancelBubble; // legacy alias of .stopPropagation() + undefined stopImmediatePropagation(); readonly attribute boolean bubbles; readonly attribute boolean cancelable; - attribute boolean returnValue; // historical - void preventDefault(); + attribute boolean returnValue; // legacy + undefined preventDefault(); readonly attribute boolean defaultPrevented; readonly attribute boolean composed; - [Unforgeable] readonly attribute boolean isTrusted; + [LegacyUnforgeable] readonly attribute boolean isTrusted; readonly attribute DOMHighResTimeStamp timeStamp; - void initEvent(DOMString type, optional boolean bubbles = false, optional boolean cancelable = false); // historical + undefined initEvent(DOMString type, optional boolean bubbles = false, optional boolean cancelable = false); // legacy }; dictionary EventInit { @@ -544,7 +494,7 @@ the empty list.
event . {{Event/bubbles}}
event . {{Event/cancelable}}
event . {{Event/defaultPrevented}}
- event . {{Event/composed}}
event . {{Event/isTrusted}}
The target attribute's getter, when invoked, must
-return this's target.
+
The target getter steps are to return this's
+target.
-
The srcElement attribute's getter, when invoked, must
-return this's target.
+
The srcElement getter steps are to return
+this's target.
The currentTarget attribute must return the value it
was initialized to. When an event is created the attribute must be initialized to null.
-
The composedPath() method, when invoked, must run these
-steps:
+
The composedPath() method steps are:
Let composedPath be an empty list. @@ -726,18 +675,18 @@ initialized to, which must be one of the following:
The stopPropagation() method, when invoked, must set
+
The stopPropagation() method steps are to set
this's stop propagation flag.
The cancelBubble attribute's getter, when invoked,
-must return true if this's stop propagation flag is set, and false otherwise.
+
The cancelBubble getter steps are to return true if
+this's stop propagation flag is set; otherwise false.
-
The {{Event/cancelBubble}} attribute's setter, when invoked, must set this's -stop propagation flag if the given value is true, and do nothing otherwise. +
The {{Event/cancelBubble}} setter steps are to set this's stop propagation flag if +the given value is true; otherwise do nothing. -
The stopImmediatePropagation() method, when invoked,
-must set this's stop propagation flag and this's
-stop immediate propagation flag.
The stopImmediatePropagation() method steps are to set
+this's stop propagation flag and this's
+stop immediate propagation flag.
The bubbles and
cancelable attributes must return the values they were
@@ -748,31 +697,31 @@ initialized to.
in passive listener flag is unset, then set event's canceled flag, and do
nothing otherwise.
-
The returnValue attribute's getter, when invoked,
-must return false if this's canceled flag is set, and true otherwise.
+
The returnValue getter steps are to return false if
+this's canceled flag is set; otherwise true.
-
The {{Event/returnValue}} attribute's setter, when invoked, must set the canceled flag -with this if the given value is false, and do nothing otherwise. +
The {{Event/returnValue}} setter steps are to set the canceled flag with this if +the given value is false; otherwise do nothing. -
The preventDefault() method, when invoked, must
+
The preventDefault() method steps are to
set the canceled flag with this.
-
There are scenarios where invoking {{Event/preventDefault()}} has no +
There are scenarios where invoking {{Event/preventDefault()}} has no effect. User agents are encouraged to log the precise cause in a developer console, to aid debugging. -
The defaultPrevented attribute's getter, when
-invoked, must return true if this's canceled flag is set, and false otherwise.
The defaultPrevented getter steps are to return true
+if this's canceled flag is set; otherwise false.
-
The composed attribute's getter, when invoked, must
-return true if this's composed flag is set, and false otherwise.
The composed getter steps are to return true if
+this's composed flag is set; otherwise false.
The isTrusted attribute must return the value it was
initialized to. When an event is created the attribute must be initialized to false.
-
{{Event/isTrusted}} is a convenience that indicates whether an +
{{Event/isTrusted}} is a convenience that indicates whether an event is dispatched by the user agent (as opposed to using {{EventTarget/dispatchEvent()}}). The sole legacy exception is {{HTMLElement/click()}}, which causes the user agent to dispatch an event whose {{Event/isTrusted}} attribute is initialized to @@ -805,7 +754,7 @@ initialized to.
The
initEvent(type, bubbles, cancelable)
-method, when invoked, must run these steps:
If this's dispatch flag is set, then return. @@ -814,7 +763,7 @@ method, when invoked, must run these steps:
cancelable.As events have constructors {{Event/initEvent()}} is redundant and +
{{Event/initEvent()}} is redundant with event constructors and incapable of setting {{Event/composed}}. It has to be supported for legacy content. @@ -822,15 +771,15 @@ incapable of setting {{Event/composed}}. It has to be supported for legacy conte
partial interface Window {
- [Replaceable] readonly attribute any event; // historical
+ [Replaceable] readonly attribute (Event or undefined) event; // legacy
};
Each {{Window}} object has an associated current event (undefined or an {{Event}} object). Unless stated otherwise it is undefined. -
The event attribute's getter, when invoked, must
-return this's current event.
+
The event getter steps are to return this's
+current event.
Web developers are strongly encouraged to instead rely on the {{Event}} object passed to event listeners, as that will result in more portable code. This attribute is not available in @@ -846,7 +795,7 @@ interface CustomEvent : Event { readonly attribute any detail; - void initCustomEvent(DOMString type, optional boolean bubbles = false, optional boolean cancelable = false, optional any detail = null); // historical + undefined initCustomEvent(DOMString type, optional boolean bubbles = false, optional boolean cancelable = false, optional any detail = null); // legacy }; dictionary CustomEventInit : EventInit { @@ -874,7 +823,7 @@ was initialized to.
The
initCustomEvent(type, bubbles, cancelable, detail)
-method must, when invoked, run these steps:
+method steps are:
If this's dispatch flag is set, then return. @@ -890,8 +839,8 @@ method must, when invoked, run these steps: Specifications may define event constructing steps for all or some -events. The algorithm is passed an event as indicated in the -inner event creation steps. +events. The algorithm is passed an event event and an {{EventInit}} +eventInitDict as indicated in the inner event creation steps.
This construct can be used by {{Event}} subclasses that have a more complex structure than a simple 1:1 mapping between their initializing dictionary members and IDL attributes. @@ -923,7 +872,7 @@ it, and optionally given a Realm realm, run these steps:
constructor. (This dictionary type will either be {{EventInit}} or a dictionary that inherits from it.) -This does not work if members are required; see +
This does not work if members are required; see whatwg/dom#600.
As of the time of this writing Web IDL does not yet define any default behavior; +
As of the time of this writing Web IDL does not yet define any default behavior; see heycam/webidl#135.
Set event's initialized flag. -
Initialize event's {{Event/timeStamp}} attribute to a {{DOMHighResTimeStamp}} - representing the high resolution time from the time origin to time. - -
User agents should set a minimum resolution of event's - {{Event/timeStamp}} attribute to 5 microseconds following the existing clock resolution - recommendation. [[!HR-TIME]] +
Initialize event's {{Event/timeStamp}} attribute to the + relative high resolution coarse time given time and event's + relevant global object.
For each member → value in dictionary, if event has an attribute whose identifier is member, then initialize that attribute to value. -
Run the event constructing steps with event. +
Run the event constructing steps with event and dictionary.
Return event.
An event listener can be used to observe a specific event and consists of: -
Although callback is an {{EventListener}} +
Although callback is an {{EventListener}} object, an event listener is a broader concept as can be seen above.
Each {{EventTarget}} object also has an associated get the parent algorithm, which takes an event event, and returns an {{EventTarget}} object. Unless specified otherwise it returns null. -
Nodes, shadow roots, and documents +
Nodes, shadow roots, and documents override the get the parent algorithm.
Each {{EventTarget}} object can have an associated @@ -1049,7 +996,7 @@ override the get the parent algorithm. activation behavior algorithm is passed an event, as indicated in the dispatch algorithm.
-This exists because user agents perform certain actions for certain +
This exists because user agents perform certain actions for certain
{{EventTarget}} objects, e.g., the <{area}> element, in response to synthetic {{MouseEvent}}
events whose {{Event/type}} attribute is click. Web compatibility prevented it
from being removed and it is now the enshrined way of defining an activation of something. [[!HTML]]
@@ -1058,7 +1005,7 @@ from being removed and it is now the enshrined way of defining an activation of
have both (not either) a legacy-pre-activation behavior algorithm
and a legacy-canceled-activation behavior algorithm.
-
These algorithms only exist for checkbox and radio <{input}> elements and +
These algorithms only exist for checkbox and radio <{input}> elements and are not to be used for anything else. [[!HTML]]
If an {{AbortSignal}} is passed for options's {{AddEventListenerOptions/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 @@ -1105,7 +1055,7 @@ are not to be used for anything else. [[!HTML]]
target . dispatchEvent(event)
Dispatches a synthetic event event to target and returns true if either event's {{Event/cancelable}} attribute value is false or its - {{Event/preventDefault()}} method was not invoked, and false otherwise. + {{Event/preventDefault()}} method was not invoked; otherwise false.
To flatten options, run these @@ -1114,7 +1064,7 @@ steps:
If options is a boolean, then return options. -
Return options's {{EventListenerOptions/capture}}.
+
Return |options|["{{EventListenerOptions/capture}}"].
To flatten more options, run these @@ -1125,21 +1075,30 @@ steps:
Let once and passive be false. -
If options is a dictionary, then set passive to options's
- {{AddEventListenerOptions/passive}} and once to options's
- {{AddEventListenerOptions/once}}.
+
Let |signal| be null. + +
If |options| is a dictionary, then: + +
Set |passive| to |options|["{{AddEventListenerOptions/passive}}"] and |once| to + |options|["{{AddEventListenerOptions/once}}"]. + +
If |options|["{{AddEventListenerOptions/signal}}"] [=map/exists=], then set |signal| to + |options|["{{AddEventListenerOptions/signal}}"]. +
Return capture, passive, and once. +
Return capture, passive, once, and signal.
The EventTarget() constructor, when invoked,
-must return a new {{EventTarget}}.
+
The new EventTarget()
+constructor steps are to do nothing.
-
Because of the defaults stated elsewhere, the returned {{EventTarget}}'s +
Because of the defaults stated elsewhere, the returned {{EventTarget}}'s get the parent algorithm will return null, and it will have no activation behavior, legacy-pre-activation behavior, or legacy-canceled-activation behavior. -
In the future we could allow custom get the parent algorithms. Let us know +
In the future we could allow custom get the parent algorithms. Let us know if this would be useful for your programs. For now, all author-created {{EventTarget}}s do not participate in a tree structure.
@@ -1155,6 +1114,9 @@ participate in a tree structure. service worker events, then report a warning to the console that this might not give the expected results. [[!SERVICE-WORKERS]] +If signal is not null and its [=AbortSignal/aborted flag=] is + set, then return. +
If listener's callback is null, then return.
If eventTarget's event listener list does not contain an @@ -1163,6 +1125,14 @@ participate in a tree structure.
callback, and capture is listener's capture, then append listener to eventTarget's event listener list. + +If listener's signal is not null, then + add the following abort steps to it: + +
The add an event listener concept exists to ensure event handlers use @@ -1170,17 +1140,17 @@ the same code path. [[HTML]]
The
addEventListener(type, callback, options)
-method, when invoked, must run these steps:
+method steps are:
Let capture, passive, and once be the result of - flattening more options. +
Let capture, passive, once, and signal be the + result of flattening more options.
Add an event listener with this and an event listener whose type is type, callback is callback, capture is capture, - passive is passive, and once is - once. + passive is passive, once is + once, and signal is signal.
To remove an event listener, given an {{EventTarget}} object @@ -1209,7 +1179,7 @@ method, when invoked, must run these steps:
The
removeEventListener(type, callback, options)
-method, when invoked, must run these steps:
+method steps are:
Let capture be the result of flattening options. @@ -1225,8 +1195,8 @@ method, when invoked, must run these steps: type, callback, and capture, as add an event listener prevents that. -
The dispatchEvent(event) method, when
-invoked, must run these steps:
+
The dispatchEvent(event) method steps
+are:
If event's dispatch flag is set, or if its initialized flag is not
@@ -1276,7 +1246,7 @@ for discussion).
is not given, and target's associated Document otherwise.
[[!HTML]]
-
legacy target override flag is only used by HTML and only when +
legacy target override flag is only used by HTML and only when target is a {{Window}} object.
Let activationTarget be null. @@ -1299,7 +1269,7 @@ for discussion). targetOverride, relatedTarget, touchTargets, and false.
Let isActivationEvent be true, if event is a {{MouseEvent}} object
- and event's {{Event/type}} attribute is "click", and false otherwise.
+ and event's {{Event/type}} attribute is "click"; otherwise false.
If isActivationEvent is true and target has activation behavior, then set activationTarget to @@ -1343,9 +1313,9 @@ for discussion). touchTarget against parent to touchTargets.
If parent is a {{Window}} object, or parent is a node and - target's root is a shadow-including inclusive ancestor of - parent, then: +
If parent is a {{Window}} object, or parent is a node + and target's root is a shadow-including inclusive ancestor + of parent, then:
If isActivationEvent is true, event's {{Event/bubbles}} @@ -1386,7 +1356,7 @@ for discussion). shadow-adjusted target, clearTargetsStruct's relatedTarget, or an {{EventTarget}} object in clearTargetsStruct's touch target list is a node - and its root is a shadow root, and false otherwise. + and its root is a shadow root; otherwise false.
If activationTarget is non-null and activationTarget has legacy-pre-activation behavior, then run activationTarget's @@ -1461,7 +1431,7 @@ for discussion). activationTarget's legacy-canceled-activation behavior.
Return false if event's canceled flag is set, and true otherwise. +
Return false if event's canceled flag is set; otherwise true.
To append to an event path, given an @@ -1515,11 +1485,15 @@ run these steps:
Let listeners be a clone of event's {{Event/currentTarget}} attribute value's event listener list. -
This avoids event listeners added after this point from being +
This avoids event listeners added after this point from being run. Note that removal still has an effect due to the removed field. +
Let invocationTargetInShadowTree be struct's + invocation-target-in-shadow-tree. +
Let found be the result of running inner invoke with event, - listeners, phase, and legacyOutputDidListenersThrowFlag if given. + listeners, phase, invocationTargetInShadowTree, and + legacyOutputDidListenersThrowFlag if given.
If found is false and event's {{Event/isTrusted}} attribute is true, @@ -1543,16 +1517,17 @@ run these steps:
transitionend"webkitTransitionEnd"
- Inner invoke with event, listeners, phase, and - legacyOutputDidListenersThrowFlag if given. +
Inner invoke with event, listeners, phase, + invocationTargetInShadowTree, and legacyOutputDidListenersThrowFlag + if given.
Set event's {{Event/type}} attribute value to originalEventType.
To inner invoke, given an -event, listeners, phase, and an optional -legacyOutputDidListenersThrowFlag, run these steps: +event, listeners, phase, invocationTargetInShadowTree, +and an optional legacyOutputDidListenersThrowFlag, run these steps:
Let found be false. @@ -1590,8 +1565,8 @@ run these steps:
Set currentEvent to global's current event. -
If struct's invocation-target-in-shadow-tree is false, - then set global's current event to event. +
If invocationTargetInShadowTree is false, then set global's + current event to event.
If listener's passive is true, then set @@ -1644,17 +1619,17 @@ initialized, and a legacy target override flag, run these steps:
Initialize any other IDL attributes of event as described in the invocation of this algorithm. -
This also allows for the {{Event/isTrusted}} attribute to be set to false. +
This also allows for the {{Event/isTrusted}} attribute to be set to false.
Return the result of dispatching event at target, with legacy target override flag set if set.
Fire in the context of DOM is short for +
Fire in the context of DOM is short for creating, initializing, and dispatching an event. Fire an event makes that process easier to write down. -
If the event needs its {{Event/bubbles}} or {{Event/cancelable}} attribute initialized,
one could write "fire an event named This is called out here specifically because previous
+ This is called out here specifically because previous
iterations of the DOM had a concept of "default actions" associated with events
that gave folks all the wrong ideas. Events do not represent or cause actions, they
can only be used to influence an ongoing one.
@@ -1747,14 +1722,14 @@ function doAmazingness({signal}) {
An {{AbortController}} object has an associated signal (an
{{AbortSignal}} object).
- The The
+ Let signal be a new {{AbortSignal}} object.
- Let controller be a new {{AbortController}} object whose
- signal is signal.
-
- Return controller.
+ The The The The An {{AbortSignal}} object has an associated aborted flag. It is
@@ -1830,13 +1808,23 @@ object signal, run these steps:
{{AbortSignal}} signal, remove algorithm from
signal's abort algorithms.
- The [=AbortSignal/abort algorithms=] enable APIs with complex
+ The [=AbortSignal/abort algorithms=] enable APIs with complex
requirements to react in a reasonable way to {{AbortController/abort()}}. For example, a given API's
[=AbortSignal/aborted flag=] might need to be propagated to a cross-thread environment, such as a
service worker.
- The aborted attribute's getter, when invoked, must return
-true if this's [=AbortSignal/aborted flag=] is set, and false otherwise.
+ The static Let signal be a new {{AbortSignal}} object.
+
+ Set signal's [=AbortSignal/aborted flag=].
+
+ The aborted getter steps are to return true if this's
+[=AbortSignal/aborted flag=] is set; otherwise false.
The To signal abort, given a {{AbortSignal}} object
+ To signal abort, given an {{AbortSignal}} object
signal, run these steps:
Each such document is represented as a node tree. Some of the nodes in a
-tree can have children, while others are always leaves.
+tree can have children, while others are always leaves.
To illustrate, consider this HTML document:
- The most excellent
+ The most excellent
Live DOM Viewer
can be used to explore this matter in more detail.
{{Document}}, {{DocumentType}}, {{DocumentFragment}}, {{Element}}, {{Text}},
-{{ProcessingInstruction}}, and {{Comment}} objects (simply called
-nodes) participate in a tree, simply named the
+ Nodes are objects that implement {{Node}}.
+Nodes participate in a tree, which is known as the
node tree.
- A node tree is constrained as follows, expressed as a relationship between the type of
-node and its allowed children:
+ In practice you deal with more specific objects.
+
+ Objects that implement {{Node}} also implement an inherited interface: {{Document}},
+ {{DocumentType}}, {{DocumentFragment}}, {{Element}}, {{CharacterData}}, or {{Attr}}.
+
+ Objects that implement {{DocumentFragment}} sometimes implement {{ShadowRoot}}.
+
+ Objects that implement {{Element}} also typically implement an inherited interface, such as
+ {{HTMLAnchorElement}}.
+
+ Objects that implement {{CharacterData}} also implement an inherited interface: {{Text}},
+ {{ProcessingInstruction}}, or {{Comment}}.
+
+ Objects that implement {{Text}} sometimes implement {{CDATASection}}.
+ For brevity, this specification refers to an object that implements {{Node}} and an
+inherited interface A node tree is constrained as follows, expressed as a relationship between a
+node and its potential children:
In tree order:
Zero or more nodes each of which is {{ProcessingInstruction}} or {{Comment}}.
- Optionally one {{DocumentType}} node.
- Zero or more nodes each of which is {{ProcessingInstruction}} or {{Comment}}.
- Optionally one {{Element}} node.
- Zero or more nodes each of which is {{ProcessingInstruction}} or {{Comment}}.
+ Zero or more {{ProcessingInstruction}} or {{Comment}} nodes.
+ Optionally one {{DocumentType}} node.
+ Zero or more {{ProcessingInstruction}} or {{Comment}} nodes.
+ Optionally one {{Element}} node.
+ Zero or more {{ProcessingInstruction}} or {{Comment}} nodes.
Zero or more nodes each of which is {{Element}}, {{Text}}, {{ProcessingInstruction}}, or
- {{Comment}}.
+ Zero or more {{Element}} or {{CharacterData}} nodes.
+
None.
+ No children.
To determine the length of a node
-node, switch on node:
+ {{Attr}} nodes participate in a tree for historical
+reasons; they never have a (non-null) parent or any children and are
+therefore alone in a tree.
- If node is a {{CharacterData}} node, then return node's
+ data's length.
- Return the number of node's children.
+ A node is considered empty if its
+length is 0.
A document tree is a node tree whose
root is a document.
- The document element of a document is the element whose
-parent is that document, if it exists, and null otherwise.
+ The document element of a document is the element whose
+parent is that document, if it exists; otherwise null.
- Per the node tree constraints, there can be only one such
-element.
+ Per the node tree constraints, there can be only one such
+element.
An element is in a document tree if its root is a
document.
An element is in a document if it is in a document tree.
-The term in a document is no longer supposed to be used. It indicates that
+The term in a document is no longer supposed to be used. It indicates that
the standard using it has not been updated to account for shadow trees.
@@ -2092,7 +2100,7 @@ the standard using it has not been updated to account for shadow trees.node treesubmit at target with its
{{Event/cancelable}} attribute initialized to true".
@@ -1681,7 +1656,7 @@ of that algorithm (e.g., through invoking {{Event/preventDefault()}}). Events
used as actions or initiators that cause some algorithm to start running. That is not what
they are for.
-Interface {{AbortController}}
-
+
[Exposed=(Window,Worker)]
interface AbortController {
constructor();
[SameObject] readonly attribute AbortSignal signal;
- void abort();
+ undefined abort();
};
@@ -1774,39 +1749,42 @@ interface AbortController {
AbortController() constructor, when
-invoked, must run these steps:
+new AbortController()
+constructor steps are:
-signal attribute's getter, when
-invoked, must return this's signal.
+signal getter steps are to return
+this's signal.
-abort() method, when invoked, must
+abort() method steps are to
signal abort on this's signal.
Interface {{AbortSignal}}
-
+
[Exposed=(Window,Worker)]
interface AbortSignal : EventTarget {
+ [NewObject] static AbortSignal abort();
+
readonly attribute boolean aborted;
attribute EventHandler onabort;
};
+
AbortSignal . abort()
+ signal . aborted
- abort() method steps are:
+
+
+
+
+onabort attribute is an
event handler IDL attribute for the onabort
@@ -1847,7 +1835,7 @@ true if this's [=AbortSignal/aborted flag=] is set, and false otherwise.
{{AbortController}} object, but an API observing the {{AbortSignal}} object can chose to ignore
them. For instance, if the operation has already completed.
-
@@ -1952,11 +1940,11 @@ reports with rich multimedia, as well as to fully-fledged interactive
applications.
+
+
+
<!DOCTYPE html>
<html class=e>
<head><title>Aliens?</title></head>
@@ -1966,29 +1954,29 @@ To illustrate, consider this HTML document:
It is represented as follows:
-
+
-
html
- html class="e"
+ html
+ html class="e"
-
@@ -2006,61 +1994,81 @@ https://software.hixie.ch/utilities/js/live-dom-viewer/?%3C!DOCTYPE%20html%3E%0D
clear. Markup goes in, a tree of nodes comes out.
-head
-
- title
-
body
-
Node tree
-NodeInterface, as a
+NodeInterface node.
+
+
-
-
+
Document tree
@@ -2068,17 +2076,17 @@ can be used to explore this matter in more detail.
A shadow tree's corresponding light tree can be a shadow tree +
A shadow tree's corresponding light tree can be a shadow tree itself.
An element is connected if its @@ -2103,7 +2111,7 @@ itself.
A shadow tree contains zero or more elements that are slots.
-A slot can only be created through HTML's <{slot}> element.
+A slot can only be created through HTML's <{slot}> element.
A slot has an associated name (a string). Unless stated otherwise it is the empty string.
@@ -2131,7 +2139,7 @@ otherwise it is the empty string. -The first slot in a shadow tree, in tree order, whose +
The first slot in a shadow tree, in tree order, whose name is the empty string, is sometimes known as the "default slot".
A slot has an associated assigned nodes (a list of @@ -2142,7 +2150,7 @@ otherwise it is the empty string.
{{Element}} and {{Text}} nodes are slottables.
-A slottable has an associated name (a string). Unless stated otherwise it is the empty string.
@@ -2178,6 +2186,12 @@ Unless stated otherwise it is null. A slottable is assigned if its assigned slot is non-null. +A slottable has an associated manual slot assignment (null +or a slot). Unless stated otherwise, it is null. + +
A slottable's manual slot assignment can be implemented using a weak +reference to the slot, because this variable is not directly accessible from script. +
To find a slot for a given slottable @@ -2195,9 +2209,14 @@ steps:
If the open flag is set and shadow's mode is
not "open", then return null.
If shadow's slot assignment is "manual", then
+ return the slot in shadow's descendants whose
+ manually assigned nodes contains slottable, if any; otherwise
+ null.
+
Return the first slot in tree order in shadow's descendants whose name is slottable's - name, if any, and null otherwise.
To find slottables @@ -2206,22 +2225,33 @@ for a given slot slot, run these steps:
Let result be an empty list.
If slot's root is not a shadow root, then return - result.
Let root be slot's root. + +
If root is not a shadow root, then return result. -
Let host be root's host.
For each slottable child of host, slottable, in - tree order:
+If root's slot assignment is "manual", then:
+
+
Let result be « ». + +
For each slottable slottable of slot's + manually assigned nodes, if slottable's parent is + host, append slottable to result. +
Otherwise, for each slottable child slottable of + host, in tree order:
Let foundSlot be the result of finding a slot given - slottable.
If foundSlot is slot, then append slottable to - result.
If foundSlot is slot, then append + slottable to result.
If parent is not a {{Document}}, {{DocumentFragment}}, or {{Element}} - node, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}. + node, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
If node is a host-including inclusive ancestor of parent, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}. @@ -2328,41 +2358,41 @@ of a node into a parent before a child, run the
If child is non-null and its parent is not parent, then throw a "{{NotFoundError!!exception}}" {{DOMException}}. -
If node is not a {{DocumentFragment}}, {{DocumentType}}, {{Element}}, {{Text}}, - {{ProcessingInstruction}}, or {{Comment}} node, then throw a +
If node is not a {{DocumentFragment}}, {{DocumentType}}, {{Element}}, or + {{CharacterData}} node, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}. -
If either node is a {{Text}} node and parent is a +
If either node is a {{Text}} node and parent is a document, or node is a doctype and parent is not a document, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
If parent is a document, and any of the statements below, switched on - node, are true, then throw a +
If parent is a document, and any of the statements below, switched on the + interface node implements, are true, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
If node has more than one element child or has a - {{Text}} node child. +
If node has more than one element child or has a + {{Text}} node child. -
Otherwise, if node has one element child and either - parent has an element child, child is a +
Otherwise, if node has one element child and either + parent has an element child, child is a doctype, or child is non-null and a doctype is following child. -
parent has an element child, child is a doctype, or child is non-null and a doctype is following child. -
parent has a doctype child, child is non-null - and an element is preceding child, or child is null - and parent has an element child. + and an element is preceding child, or child is null + and parent has an element child.
Let nodes be node's children, if node is a - {{DocumentFragment}} node; otherwise « node ». +
Let nodes be node's children, if node is a + {{DocumentFragment}} node; otherwise « node ».
Let count be nodes's size.
If count is 0, then return.
If node is a {{DocumentFragment}} node, then: +
If node is a {{DocumentFragment}} node, then:
Queue a tree mutation record for node with « », nodes, null, and null. -
This step intentionally does not pay attention to the +
This step intentionally does not pay attention to the suppress observers flag.
Otherwise, insert node into parent's children before child's index. -
If parent is a shadow host and node is a +
If parent is a shadow host whose shadow root's
+ slot assignment is "named" and node is a
slottable, then assign a slot for node.
If parent's root is a shadow root, and @@ -2507,7 +2539,7 @@ within a parent, run these steps:
If parent is not a {{Document}}, {{DocumentFragment}}, or {{Element}} - node, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}. + node, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
If node is a host-including inclusive ancestor of parent, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}. @@ -2515,39 +2547,39 @@ within a parent, run these steps:
If child's parent is not parent, then throw a "{{NotFoundError!!exception}}" {{DOMException}}. -
If node is not a {{DocumentFragment}}, {{DocumentType}}, {{Element}}, {{Text}}, - {{ProcessingInstruction}}, or {{Comment}} node, then throw a +
If node is not a {{DocumentFragment}}, {{DocumentType}}, {{Element}}, or + {{CharacterData}} node, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}. -
If either node is a {{Text}} node and parent is a +
If either node is a {{Text}} node and parent is a document, or node is a doctype and parent is not a document, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
If parent is a document, and any of the statements below, switched on - node, are true, then throw a +
If parent is a document, and any of the statements below, switched on the + interface node implements, are true, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
If node has more than one element child or has a - {{Text}} node child. +
If node has more than one element child or has a + {{Text}} node child. -
Otherwise, if node has one element child and either - parent has an element child that is not +
Otherwise, if node has one element child and either + parent has an element child that is not child or a doctype is following child. -
parent has an element child that is not child or a doctype is following child. -
parent has a doctype child that is not child, - or an element is preceding child. + or an element is preceding child.
The above statements differ from the pre-insert algorithm. +
The above statements differ from the pre-insert algorithm.
Let referenceChild be child's next sibling. @@ -2567,10 +2599,10 @@ within a parent, run these steps:
Remove child with the suppress observers flag set.
The above can only be false if child is node. +
The above can only be false if child is node. -
Let nodes be node's children if node is a - {{DocumentFragment}} node; otherwise « node ». +
Let nodes be node's children if node is a + {{DocumentFragment}} node; otherwise « node ». @@ -2588,17 +2620,17 @@ within a parent, run these steps: within a parent, run these steps:
Let removedNodes be parent's children. +
Let removedNodes be parent's children.
Let addedNodes be the empty set. -
If node is a {{DocumentFragment}} node, then set addedNodes to - node's children. +
If node is a {{DocumentFragment}} node, then set + addedNodes to node's children.
Otherwise, if node is non-null, set addedNodes to « node ». -
Remove all parent's children, in tree order, with the - suppress observers flag set. +
Remove all parent's children, in tree order, + with the suppress observers flag set.
If node is non-null, then insert node into parent before null with the suppress observers flag set. @@ -2608,7 +2640,7 @@ within a parent, run these steps: removedNodes, null, and null.
This algorithm does not make any checks with regards to the +
This algorithm does not make any checks with regards to the node tree constraints. Specification authors need to use it wisely. @@ -2711,7 +2743,7 @@ indicated in the remove algorithm below.
For each inclusive ancestor inclusiveAncestor of parent, and then for each registered of inclusiveAncestor's registered observer list, if registered's - options's {{MutationObserverInit/subtree}} is true, then + options["{{MutationObserverInit/subtree}}"] is true, then append a new transient registered observer whose observer is registered's observer, options is @@ -2729,8 +2761,8 @@ indicated in the remove algorithm below.
Web compatibility prevents the {{NonElementParentNode/getElementById()}} -method from being exposed on elements (and therefore on {{ParentNode}}). +
Web compatibility prevents the {{NonElementParentNode/getElementById()}} +method from being exposed on elements (and therefore on {{ParentNode}}).
interface mixin NonElementParentNode {
@@ -2742,14 +2774,14 @@ DocumentFragment includes NonElementParentNode;
node . getElementById(elementId)
- Returns the first element within node's descendants whose +
Returns the first element within node's descendants whose ID is elementId.
The getElementById(elementId)
-method, when invoked, must return the first element, in tree order, within
-this's descendants, whose ID is elementId, and null if
-there is no such element otherwise.
+method steps are to return the first element, in tree order, within
+this's descendants, whose ID is elementId; otherwise, if
+there is no such element, null.
The {{DocumentOrShadowRoot}} mixin is expected to be used by other +
The {{DocumentOrShadowRoot}} mixin is expected to be used by other standards that want to define APIs shared between documents and shadow roots. @@ -2774,16 +2806,16 @@ standards that want to define APIs shared between documents and
Let node be null. -
Replace each string in nodes with a new {{Text}} node whose +
Replace each string in nodes with a new {{Text}} node whose data is the string and node document is document. -
If nodes contains one node, then set node to + nodes[0]. -
Otherwise, set node to a new {{DocumentFragment}} whose - node document is document, and then append each node in - nodes, if any, to it. +
Otherwise, set node to a new {{DocumentFragment}} node whose + node document is document, and then append each node + in nodes, if any, to it.
Return node.
collection = node . {{ParentNode/children}}
- element = node . {{ParentNode/firstElementChild}}
- element = node . {{ParentNode/lastElementChild}}
- node . replaceChildren(nodes)
+ Replace all children of node with nodes, + while replacing strings in nodes with equivalent {{Text}} nodes. + +
Throws a "{{HierarchyRequestError!!exception}}" {{DOMException}} if the constraints of + the node tree are violated. + +
node . querySelector(selectors)
node . querySelectorAll(selectors)
The children attribute's getter must return an
-{{HTMLCollection}} collection rooted at this matching only element
-children.
+
The children getter steps are to return an
+{{HTMLCollection}} collection rooted at this matching only element
+children.
-
The firstElementChild attribute's getter must
-return the first child that is an element, and null otherwise.
+
The firstElementChild getter steps are to return
+the first child that is an element; otherwise null.
-
The lastElementChild attribute's getter must
-return the last child that is an element, and null otherwise.
+
The lastElementChild getter steps are to return
+the last child that is an element; otherwise null.
-
The childElementCount attribute's getter must
-return the number of children of this that are elements.
+
The childElementCount getter steps are to return
+the number of children of this that are elements.
-
The prepend(nodes) method, when invoked,
-must run these steps:
+
The prepend(nodes) method steps are:
Let node be the result of converting nodes into a node given @@ -2873,8 +2914,7 @@ must run these steps: first child.
The append(nodes) method, when invoked,
-must run these steps:
+
The append(nodes) method steps are:
Let node be the result of converting nodes into a node given @@ -2883,18 +2923,31 @@ must run these steps:
The querySelector(selectors) method,
-when invoked, must return the first result of running scope-match a selectors string
-selectors against this, if the result is not an empty list, and null otherwise.
+
The replaceChildren(nodes) method steps
+are:
+
+
Let node be the result of converting nodes into a node given + nodes and this's node document. + +
Ensure pre-insertion validity of node into this before + null. + +
Replace all with node within this. +
The querySelector(selectors) method
+steps are to return the first result of running scope-match a selectors string
+selectors against this, if the result is not an empty list; otherwise null.
-
The querySelectorAll(selectors)
-method, when invoked, must return the static result of running
+
The querySelectorAll(selectors) method
+steps are to return the static result of running
scope-match a selectors string selectors against this.
Web compatibility prevents the {{previousElementSibling}} and +
Web compatibility prevents the {{previousElementSibling}} and {{nextElementSibling}} attributes from being exposed on doctypes (and therefore on {{ChildNode}}). @@ -2909,35 +2962,31 @@ CharacterData includes NonDocumentTypeChildNode;
element = node . {{previousElementSibling}}
- element = node . {{nextElementSibling}}
- The previousElementSibling
-attribute's getter must return the first preceding sibling that is an
-element, and null otherwise.
+
The previousElementSibling getter
+steps are to return the first preceding sibling that is an
+element; otherwise null.
-
The nextElementSibling attribute's
-getter must return the first following sibling that is an
-element, and null otherwise.
+
The nextElementSibling getter
+steps are to return the first following sibling that is an
+element; otherwise null.
interface mixin ChildNode {
- [CEReactions, Unscopable] void before((Node or DOMString)... nodes);
- [CEReactions, Unscopable] void after((Node or DOMString)... nodes);
- [CEReactions, Unscopable] void replaceWith((Node or DOMString)... nodes);
- [CEReactions, Unscopable] void remove();
+ [CEReactions, Unscopable] undefined before((Node or DOMString)... nodes);
+ [CEReactions, Unscopable] undefined after((Node or DOMString)... nodes);
+ [CEReactions, Unscopable] undefined replaceWith((Node or DOMString)... nodes);
+ [CEReactions, Unscopable] undefined remove();
};
DocumentType includes ChildNode;
Element includes ChildNode;
@@ -2973,8 +3022,7 @@ CharacterData includes ChildNode;
The before(nodes) method, when invoked,
-must run these steps:
+
The before(nodes) method steps are:
Let parent be this's parent. @@ -2982,21 +3030,20 @@ must run these steps:
If parent is null, then return.
Let viablePreviousSibling be this's first preceding - sibling not in nodes, and null otherwise. + sibling not in nodes; otherwise null.
Let node be the result of converting nodes into a node, given nodes and this's node document. -
If viablePreviousSibling is null, set it to parent's - first child, and to viablePreviousSibling's next sibling - otherwise. +
If viablePreviousSibling is null, then set it to parent's + first child; otherwise to viablePreviousSibling's + next sibling.
Pre-insert node into parent before viablePreviousSibling.
The after(nodes) method, when invoked,
-must run these steps:
+
The after(nodes) method steps are:
Let parent be this's parent. @@ -3004,7 +3051,7 @@ must run these steps:
If parent is null, then return.
Let viableNextSibling be this's first following - sibling not in nodes, and null otherwise. + sibling not in nodes; otherwise null.
Let node be the result of converting nodes into a node, given nodes and this's node document. @@ -3013,8 +3060,7 @@ must run these steps: viableNextSibling.
The replaceWith(nodes) method, when
-invoked, must run these steps:
+
The replaceWith(nodes) method steps are:
Let parent be this's parent. @@ -3022,7 +3068,7 @@ invoked, must run these steps:
If parent is null, then return.
Let viableNextSibling be this's first following - sibling not in nodes, and null otherwise. + sibling not in nodes; otherwise null.
Let node be the result of converting nodes into a node, given nodes and this's node document. @@ -3037,8 +3083,7 @@ invoked, must run these steps: viableNextSibling.
The remove() method, when invoked, must run these
-steps:
+
The remove() method steps are:
If this's parent is null, then return. @@ -3058,8 +3103,8 @@ Text includes Slottable;
The assignedSlot
-attribute's getter must return the result of find a slot given this and with the
-open flag set.
The item(index) method must return the
-indexth node in the collection. If there is no
-indexth node in the collection, then the method must return
-null.
+indexth node in the collection. If there is no
+indexth node in the collection, then the method must
+return null.
An {{HTMLCollection}} object is a collection of elements. +
An {{HTMLCollection}} object is a collection of elements. -
{{HTMLCollection}} is a historical artifact we cannot rid the web of. +
{{HTMLCollection}} is a historical artifact we cannot rid the web of.
While developers are of course welcome to keep using it, new API standard designers ought not to use
it (use sequence<T> in IDL instead).
sequence<T> in IDL instead).
the number of elements represented by the collection. If there are no such
elements, then there are no supported property indices.
-The length attribute's getter must return
-the number of nodes represented by the collection.
+
The length getter steps are to return the
+number of nodes represented by the collection.
-
The item(index) method, when
-invoked, must return the indexth element in the
-collection. If there is no indexth element in the
-collection, then the method must return null.
+
The item(index) method steps are to
+return the indexth element in the collection. If there
+is no indexth element in the collection, then the method
+must return null.
The supported property names are the values from the list returned by these steps: @@ -3196,14 +3241,13 @@ invoked, must return the indexth element in
Return result. -
The namedItem(key) method, when
-invoked, must run these steps:
+
The namedItem(key) method steps are:
If key is the empty string, return null.
Return the first element in the collection for which at least one of +
Return the first element in the collection for which at least one of the following is true:
or null if there is no such element. +
or null if there is no such element.
If records is not empty, then invoke mo's callback with « records, mo », - and mo. If this throws an exception, then report the exception. + and mo. If this throws an exception, catch it, and report the exception.
For each slot of signalSet, fire an event @@ -3292,7 +3336,7 @@ zero or more registered observers), which is initially empty. registered observer that also consists of a source (a registered observer). -
Transient registered observers are used to track mutations within +
Transient registered observers are used to track mutations within
a given node's descendants after node has been removed so
they do not get lost when {{MutationObserverInit/subtree}} is set to true on node's
parent.
@@ -3300,17 +3344,17 @@ they do not get lost when {{MutationObserverInit/subtree}} is set to true on Interface {{MutationObserver}}
- The
- Let mo be a new {{MutationObserver}} object whose
- callback is callback.
+ Append mo to mo's relevant agent's
+ Append this to this's relevant agent's
mutation observers.
-
- Return mo.
The
If either options's {{MutationObserverInit/attributeOldValue}} or
- {{MutationObserverInit/attributeFilter}} is present and options's
- {{MutationObserverInit/attributes}} is omitted, then set options's
- {{MutationObserverInit/attributes}} to true.
+ If either options["{{MutationObserverInit/attributeOldValue}}"] or
+ options["{{MutationObserverInit/attributeFilter}}"] exists, and
+ options["{{MutationObserverInit/attributes}}"] does not exist, then set
+ options["{{MutationObserverInit/attributes}}"] to true.
- If options's {{MutationObserverInit/characterDataOldValue}} is present and
- options's {{MutationObserverInit/characterData}} is omitted, then set
- options's {{MutationObserverInit/characterData}} to true.
+ If options["{{MutationObserverInit/characterDataOldValue}}"]
+ exists and options["{{MutationObserverInit/characterData}}"] does not
+ exist, then set options["{{MutationObserverInit/characterData}}"] to
+ true.
- If none of options's {{MutationObserverInit/childList}},
- {{MutationObserverInit/attributes}}, and {{MutationObserverInit/characterData}} is true, then
- throw a If options's {{MutationObserverInit/elementByAttributeFilter}} is present and
+ options's {{MutationObserverInit/childList}} is omitted, then set
+ options's {{MutationObserverInit/childList}} to true.
- If options's {{MutationObserverInit/attributeOldValue}} is true and
- options's {{MutationObserverInit/attributes}} is false, then throw a
+ If options's {{MutationObserverInit/elementFilter}} is present and
+ options's {{MutationObserverInit/childList}} is omitted, then set
+ options's {{MutationObserverInit/childList}} to true.
+
+ If none of options["{{MutationObserverInit/childList}}"],
+ options["{{MutationObserverInit/attributes}}"], and
+ options["{{MutationObserverInit/characterData}}"] is true, then throw a
+ If options["{{MutationObserverInit/attributeOldValue}}"] is true and
+ options["{{MutationObserverInit/attributes}}"] is false, then throw a
If options's {{MutationObserverInit/attributeFilter}} is present and
- options's {{MutationObserverInit/attributes}} is false, then throw a
+ If options["{{MutationObserverInit/attributeFilter}}"] is present and
+ options["{{MutationObserverInit/attributes}}"] is false, then throw a
If options's {{MutationObserverInit/characterDataOldValue}} is true and
- options's {{MutationObserverInit/characterData}} is false, then throw a
+ If options["{{MutationObserverInit/characterDataOldValue}}"] is true and
+ options["{{MutationObserverInit/characterData}}"] is false, then throw a
+ If options's {{MutationObserverInit/elementByAttributeFilter}} is present and
+ options's {{MutationObserverInit/childList}} is false, then throw a
+ If options's {{MutationObserverInit/elementFilter}} is present and
+ options's {{MutationObserverInit/childList}} is false, then throw a
The The The The Let records be a clone of this's
@@ -3530,24 +3602,24 @@ run these steps:
If none of the following are true
then:
@@ -3558,11 +3630,11 @@ run these steps:
If interestedObservers[mo] does not exist, then
set interestedObservers[mo] to null.
- If either type is " If either type is " Assert: either addedNodes or removedNodes is not empty.
+ If either options's' {{MutationObserverInit/elementFilter}} or
+ {{MutationObserverInit/elementByAttributeFilter}} is present, then:
+
+
+
[Exposed=Window]
interface MutationObserver {
constructor(MutationCallback callback);
- void observe(Node target, optional MutationObserverInit options = {});
- void disconnect();
+ undefined observe(Node target, optional MutationObserverInit options = {});
+ undefined disconnect();
sequence<MutationRecord> takeRecords();
};
-callback MutationCallback = void (sequence<MutationRecord> mutations, MutationObserver observer);
+callback MutationCallback = undefined (sequence<MutationRecord> mutations, MutationObserver observer);
dictionary MutationObserverInit {
boolean childList = false;
@@ -3320,6 +3364,8 @@ dictionary MutationObserverInit {
boolean attributeOldValue;
boolean characterDataOldValue;
sequence<DOMString> attributeFilter;
+ sequence<DOMString> elementByAttributeFilter;
+ sequence<DOMString> elementFilter;
};
@@ -3347,7 +3393,7 @@ dictionary MutationObserverInit {
observer . {{observe(target, options)}}
observer . {{disconnect()}}
@@ -3410,47 +3469,62 @@ dictionary MutationObserverInit {
MutationObserver(callback)
-constructor, when invoked, must run these steps:
+new MutationObserver(callback)
+constructor steps are:
-
observe(target, options)
-method, when invoked, must run these steps:
+method steps are:
-
-TypeError.
+ TypeError.
+
+ TypeError.
- TypeError.
- TypeError.
+
+ TypeError.
+
+ TypeError.
disconnect() method, when invoked, must
-run these steps:
+disconnect() method steps are:
takeRecords() method, when invoked, must
-run these steps:
+takeRecords() method steps are:
@@ -3594,6 +3666,67 @@ run these steps:
-
attributes" and options's
- {{MutationObserverInit/attributes}} is not true
-
+ attributes" and
+ options["{{MutationObserverInit/attributes}}"] either does not exist
+ or is false
- attributes", options's
- {{MutationObserverInit/attributeFilter}} is present, and options's
- {{MutationObserverInit/attributeFilter}} does not contain name or
- namespace is non-null
+ attributes",
+ options["{{MutationObserverInit/attributeFilter}}"] exists, and
+ options["{{MutationObserverInit/attributeFilter}}"] does not contain
+ name or namespace is non-null
- characterData" and options's
- {{MutationObserverInit/characterData}} is not true
-
+ characterData" and
+ options["{{MutationObserverInit/characterData}}"] either does not
+ exist or is false
- childList" and options's
- {{MutationObserverInit/childList}} is false
+ childList" and
+ options["{{MutationObserverInit/childList}}"] is false
attributes" and options's
- {{MutationObserverInit/attributeOldValue}} is true, or type is
- "characterData" and options's
- {{MutationObserverInit/characterDataOldValue}} is true, then set
- interestedObservers[mo] to oldValue.
+ attributes" and
+ options["{{MutationObserverInit/attributeOldValue}}"] is true, or type is
+ "characterData" and
+ options["{{MutationObserverInit/characterDataOldValue}}"] is true, then
+ set interestedObservers[mo] to oldValue.
Let nodeAttributesList be the set of local names of node's + attributes. + +
If none of the following are true + +
then append node to filteredAddedNodes. +
For each node in removedNodes: + +
Let nodeAttributesList be the set of local names of node's + attributes. + +
If none of the following are true + +
then append node to filterRemovedNodes. +
Assert: either filteredAddedNodes or filteredRemovedNodes + is not empty. + +
Set addedNodes to filteredAddedNodes + +
Set removedNodes to filteredRemovedNodes + +
Queue a mutation record of "childList" for target with
null, null, null, addedNodes, removedNodes, previousSibling,
and nextSibling.
@@ -3622,21 +3755,21 @@ interface MutationRecord {
attributes" if it was an
attribute mutation.
"characterData" if it was a mutation to a
- {{CharacterData}} node. And
+ {{CharacterData}} node. And
"childList" if it was a mutation to the
tree of
nodes.
record . {{MutationRecord/target}}
- attributes", it is the
- element whose
+ element whose
attribute changed. For
"characterData", it is the {{CharacterData}}
- node. For "childList",
- it is the node whose
- children changed.
+ node. For "childList",
+ it is the node whose
+ children changed.
record . {{MutationRecord/addedNodes}}
record . {{MutationRecord/removedNodes}}
@@ -3646,16 +3779,13 @@ interface MutationRecord {
record . {{MutationRecord/previousSibling}}
record . {{MutationRecord/nextSibling}}
record . {{MutationRecord/attributeName}}
- record . {{MutationRecord/attributeNamespace}}
- record . {{MutationRecord/oldValue}}
characterData", it is the
data of the changed
- node before the change. For
+ node before the change. For
"childList", it is null.
@@ -3698,14 +3828,14 @@ interface Node : EventTarget {
const unsigned short ATTRIBUTE_NODE = 2;
const unsigned short TEXT_NODE = 3;
const unsigned short CDATA_SECTION_NODE = 4;
- const unsigned short ENTITY_REFERENCE_NODE = 5; // historical
- const unsigned short ENTITY_NODE = 6; // historical
+ const unsigned short ENTITY_REFERENCE_NODE = 5; // legacy
+ const unsigned short ENTITY_NODE = 6; // legacy
const unsigned short PROCESSING_INSTRUCTION_NODE = 7;
const unsigned short COMMENT_NODE = 8;
const unsigned short DOCUMENT_NODE = 9;
const unsigned short DOCUMENT_TYPE_NODE = 10;
const unsigned short DOCUMENT_FRAGMENT_NODE = 11;
- const unsigned short NOTATION_NODE = 12; // historical
+ const unsigned short NOTATION_NODE = 12; // legacy
readonly attribute unsigned short nodeType;
readonly attribute DOMString nodeName;
@@ -3725,11 +3855,11 @@ interface Node : EventTarget {
[CEReactions] attribute DOMString? nodeValue;
[CEReactions] attribute DOMString? textContent;
- [CEReactions] void normalize();
+ [CEReactions] undefined normalize();
[CEReactions, NewObject] Node cloneNode(optional boolean deep = false);
boolean isEqualNode(Node? otherNode);
- boolean isSameNode(Node? otherNode); // historical alias of ===
+ boolean isSameNode(Node? otherNode); // legacy alias of ===
const unsigned short DOCUMENT_POSITION_DISCONNECTED = 0x01;
const unsigned short DOCUMENT_POSITION_PRECEDING = 0x02;
@@ -3755,66 +3885,61 @@ dictionary GetRootNodeOptions {
};
-{{Node}} is an abstract interface and does not exist as node. It -is used by all nodes ({{Document}}, {{DocumentType}}, {{DocumentFragment}}, {{Element}}, -{{Text}}, {{ProcessingInstruction}}, and {{Comment}}). +
{{Node}} is an abstract interface that is used by all nodes. You cannot +get a direct instance of it. -
Each node has an associated +
Each node has an associated node document, set upon creation, that is a document. -
A node's node document can be changed by the +
A node's node document can be changed by the adopt algorithm. -
A node's get the parent algorithm, given an event, returns the -node's assigned slot, if node is assigned, and node's -parent otherwise. +
A node's get the parent algorithm, given an event, returns the +node's assigned slot, if node is assigned; otherwise +node's parent. -
Each node also has a registered observer list. +
Each node also has a registered observer list.
node . {{Node/nodeType}}
Returns a number appropriate for the type of node, as follows:
{{Node}} . {{Node/ELEMENT_NODE}} (1)
- {{Node}} . {{Node/ELEMENT_NODE}} (1).
+
+ {{Node}} . {{Node/ATTRIBUTE_NODE}} (2).
- {{Node}} . {{Node/TEXT_NODE}} (3)
- Text node
+ {{Node}} . {{Node/TEXT_NODE}} (3).
- {{Node}} . {{Node/CDATA_SECTION_NODE}} (4)
- {{Node}} . {{Node/CDATA_SECTION_NODE}} (4).
- {{Node}} . {{Node/PROCESSING_INSTRUCTION_NODE}} (7)
- {{Node}} . {{Node/PROCESSING_INSTRUCTION_NODE}} (7).
- {{Node}} . {{Node/COMMENT_NODE}} (8)
- {{Node}} . {{Node/COMMENT_NODE}} (8).
- {{Node}} . {{Node/DOCUMENT_NODE}} (9)
- {{Node}} . {{Node/DOCUMENT_NODE}} (9).
- {{Node}} . {{Node/DOCUMENT_TYPE_NODE}} (10)
- {{Node}} . {{Node/DOCUMENT_TYPE_NODE}} (10).
- {{Node}} . {{Node/DOCUMENT_FRAGMENT_NODE}} (11)
- {{Node}} . {{Node/DOCUMENT_FRAGMENT_NODE}} (11).
node . {{Node/nodeName}}
Returns a string appropriate for the type of node, as follows:
Text node
#text".
The nodeType getter steps are to return the first matching +statement, switching on the interface this implements:
Text node
The nodeName attribute's getter, when invoked, must return the -first matching statement, switching on this: +
The nodeName getter steps are to return the first matching +statement, switching on the interface this implements:
Text node
#text".
baseURI attribute's getter must return
+The baseURI getter steps are to return this's
node document's document base URL, serialized.
node . {{Node/isConnected}}
- Returns true if node is connected and false otherwise. +
Returns true if node is connected; otherwise false.
node . {{Node/ownerDocument}}
baseURI attribute's getter must r
node . {{Node/hasChildNodes()}}
node . {{Node/childNodes}}
- node . {{Node/firstChild}}
baseURI attribute's getter must r
next sibling.
The isConnected attribute's getter must return true,
-if this is connected, and false otherwise.
The isConnected getter steps are to return true,
+if this is connected; otherwise false.
The ownerDocument attribute's getter must return null,
-if this is a document, and this's node document otherwise.
+
The ownerDocument getter steps are to return null,
+if this is a document; otherwise this's node document.
-
The node document of a document is that document itself. All -nodes have a node document at all times. +
The node document of a document is that document itself. +All nodes have a node document at all times. -
The getRootNode(options) method, when invoked,
-must return this's shadow-including root if options's
-{{GetRootNodeOptions/composed}} is true, and this's root otherwise.
+
The getRootNode(options) method steps are to
+return this's shadow-including root if
+options["{{GetRootNodeOptions/composed}}"] is true; otherwise this's
+root.
-
The parentNode attribute's getter must return
+
The parentNode getter steps are to return
this's parent.
-
An {{Attr}} node has no parent. - -
The parentElement attribute's getter must return
+
The parentElement getter steps are to return
this's parent element.
-
The hasChildNodes() method, when invoked, must return
-true if this has children, and false otherwise.
+
The hasChildNodes() method steps are to return true if
+this has children; otherwise false.
-
The childNodes attribute's getter must return a
-{{NodeList}} rooted at this matching only children.
+
The childNodes getter steps are to return a
+{{NodeList}} rooted at this matching only children.
-
The firstChild attribute's getter must return
+
The firstChild getter steps are to return
this's first child.
-
The lastChild attribute's getter must return
-this's last child.
+
The lastChild getter steps are to return this's
+last child.
-
The previousSibling attribute's getter must return
+
The previousSibling getter steps are to return
this's previous sibling.
-
An {{Attr}} node has no siblings. - -
The nextSibling attribute's getter must return
+
The nextSibling getter steps are to return
this's next sibling.
The nodeValue getter steps are to return the following, switching +on the interface this implements:
The {{Node/nodeValue}} setter steps are to, if the given value is null, act as if it was the +empty string instead, and then do as described below, switching on the interface this +implements:
Set an existing attribute value with this and new value. +
Set an existing attribute value with this and the given value. -
Replace data with node this, offset 0, count this's - length, and data new value. + length, and data the given value. -
Do nothing.
The textContent attribute's getter must return the
-following, switching on this:
+
The textContent getter steps are to return the
+following, switching on the interface this implements:
Replace all with node within parent. -
The {{Node/textContent}} attribute's setter must, if the given value is null, act as if it was -the empty string instead, and then do as described below, switching on this: +
The {{Node/textContent}} setter steps are to, if the given value is null, act as if it was the +empty string instead, and then do as described below, switching on the interface this +implements:
String replace all with the given value within this.
Set an existing attribute value with this and new value. +
Set an existing attribute value with this and the given value. -
Replace data with node this, offset 0, count this's length, and data the given value. -
Do nothing.
The normalize() method, when invoked, must run these
-steps for each descendant exclusive Text node node of
-this:
+
The normalize() method steps are to run these steps for
+each descendant exclusive Text node node of this:
Text node no
algorithm is passed copy, node, document, and an optional
clone children flag, as indicated in the clone algorithm.
-HTML defines cloning steps for <{script}> and <{input}> +
HTML defines cloning steps for <{script}> and <{input}> elements. SVG ought to do the same for its <{script}> elements, but does not call this out at the moment. @@ -4242,34 +4329,34 @@ dom-Range-extractContents, dom-Range-cloneContents -->
Otherwise, let copy be a node that implements the same interfaces as - node, and fulfills these additional requirements, switching on - node: +
Otherwise, let copy be a node that implements the same + interfaces as node, and fulfills these additional requirements, switching on the + interface node implements:
Set copy's encoding, content type, URL, origin, type, and - mode, to those of node. + mode to those of node.
Set copy's name, public ID, and - system ID, to those of node. + system ID to those of node.
Set copy's namespace, namespace prefix, - local name, and value, to those of node. + local name, and value to those of node.
Set copy's data to that of node.
Do nothing.
Set copy's node document and document to @@ -4281,14 +4368,13 @@ dom-Range-extractContents, dom-Range-cloneContents --> document and the clone children flag if set, as parameters.
The cloneNode(deep) method, when
-invoked, must run these steps:
+
The cloneNode(deep) method steps are:
If this is a shadow root, then throw a @@ -4298,20 +4384,18 @@ invoked, must run these steps: clone children flag set if deep is true.
A node A equals a +node B if all of the following conditions are true:
A and B implement the same interfaces. +
The following are equal, switching on the interface A implements: +
If A is an element, each attribute in its attribute list has an attribute that equals an attribute in B's attribute list. -
A and B have the same number of children. + +
Each child of A equals the child + of B at the identical index.
The isEqualNode(otherNode) method, when
-invoked, must return true if otherNode is non-null and this equals
-otherNode, and false otherwise.
+
The isEqualNode(otherNode) method steps are to
+return true if otherNode is non-null and this equals
+otherNode; otherwise false.
-
The isSameNode(otherNode) method, when
-invoked, must return true if otherNode is this, and false otherwise.
+
The isSameNode(otherNode) method steps are to
+return true if otherNode is this; otherwise false.
node . {{Node/contains(other)}}
- These are the constants {{compareDocumentPosition()}} returns as mask: -
The compareDocumentPosition(other) method,
-when invoked, must run these steps:
+
The compareDocumentPosition(other) method
+steps are:
If this is other, then return zero. @@ -4452,9 +4532,9 @@ when invoked, must run these steps: either {{Node/DOCUMENT_POSITION_PRECEDING}} or {{Node/DOCUMENT_POSITION_FOLLOWING}}, with the constraint that this is to be consistent, together. -
Whether to return {{Node/DOCUMENT_POSITION_PRECEDING}} or +
Whether to return {{Node/DOCUMENT_POSITION_PRECEDING}} or
{{Node/DOCUMENT_POSITION_FOLLOWING}} is typically implemented via pointer comparison. In
- JavaScript implementations a cached Math.random() value can
+ JavaScript implementations a cached Math.random() value can
be used.
If node1 is an ancestor of node2 and attr1 is null, @@ -4469,16 +4549,17 @@ when invoked, must run these steps:
If node1 is preceding node2, then return {{Node/DOCUMENT_POSITION_PRECEDING}}. -
Due to the way attributes are handled in this algorithm this results in a - node's attributes counting as preceding that node's children, - despite attributes not participating in a tree. +
Due to the way attributes are handled in this algorithm this results in a + node's attributes counting as preceding that node's + children, despite attributes not participating in the same + tree.
Return {{Node/DOCUMENT_POSITION_FOLLOWING}}.
The contains(other) method, when invoked, must
-return true if other is an inclusive descendant of this, and false
-otherwise (including when other is null).
+
The contains(other) method steps are to return
+true if other is an inclusive descendant of this; otherwise false
+(including when other is null).
If element's parent element is not null, then return the result of running - locate a namespace prefix on that element using namespace. + locate a namespace prefix on that element using namespace.
Return null.
To locate a namespace for a node using prefix, switch on -node: +the interface node implements:
If its parent element is null, then return null. @@ -4567,14 +4648,13 @@ for an element using namespace, run these steps:
The lookupPrefix(namespace) method, when
-invoked, must run these steps:
+
The lookupPrefix(namespace) method steps are:
If namespace is null or the empty string, then return null.
Switch on this: +
Switch on the interface this implements:
Return the result of locating a namespace prefix for its document element, - if its document element is non-null, and null otherwise. + if its document element is non-null; otherwise null.
Return the result of locating a namespace prefix for its element, - if its element is non-null, and null otherwise. + if its element is non-null; otherwise null. -
Return the result of locating a namespace prefix for its parent element, if - its parent element is non-null, and null otherwise. + its parent element is non-null; otherwise null.
The lookupNamespaceURI(prefix) method, when
-invoked, must run these steps:
+
The lookupNamespaceURI(prefix) method steps
+are:
If prefix is the empty string, then set it to null. @@ -4608,8 +4688,8 @@ invoked, must run these steps: prefix.
The isDefaultNamespace(namespace) method, when
-invoked, must run these steps:
+
The isDefaultNamespace(namespace) method steps
+are:
If namespace is the empty string, then set it to null. @@ -4617,40 +4697,41 @@ invoked, must run these steps:
Let defaultNamespace be the result of running locate a namespace for this using null. -
Return true if defaultNamespace is the same as namespace, and false - otherwise. +
Return true if defaultNamespace is the same as namespace; otherwise + false.
The insertBefore(node, child)
-method, when invoked, must return the result of pre-inserting node into
-this before child.
+method steps are to return the result of pre-inserting node into this
+before child.
-
The appendChild(node) method, when invoked,
-must return the result of appending node to this.
+
The appendChild(node) method steps are to
+return the result of appending node to this.
The replaceChild(node, child)
-method, when invoked, must return the result of replacing child with
-node within this.
+method steps are to return the result of replacing child with node
+within this.
-
The removeChild(child) method, when invoked,
-must return the result of pre-removing child from this.
+
The removeChild(child) method steps are to
+return the result of pre-removing child from this.
The list of elements with qualified name qualifiedName -for a node root is the {{HTMLCollection}} returned by the following algorithm: +for a node root is the {{HTMLCollection}} returned by the following +algorithm:
If qualifiedName is "*" (U+002A), return a {{HTMLCollection}} rooted
- at root, whose filter matches only descendant elements.
+ at root, whose filter matches only descendant elements.
Otherwise, if root's node document is an HTML document, return a {{HTMLCollection}} rooted at root, whose filter matches the following - descendant elements: + descendant elements:
Whose namespace is the HTML namespace and whose @@ -4661,7 +4742,7 @@ for a node root is the {{HTMLCollection}} returned by the foll
Otherwise, return a {{HTMLCollection}} rooted at root, whose filter matches - descendant elements whose qualified name is + descendant elements whose qualified name is qualifiedName.
The +list of elements with namespace namespace and local name localName +for a node root is the {{HTMLCollection}} returned by the following +algorithm:
*" (U+002A), return a {{HTMLCollection}} rooted at
root, whose filter matches
descendant
- elements.
+ elements.
*"
(U+002A), return a {{HTMLCollection}} rooted at
root, whose filter matches
descendant
- elements whose
+ elements whose
local name is
localName.
@@ -4696,28 +4776,28 @@ for a node root is the
(U+002A), return a {{HTMLCollection}} rooted at
root, whose filter matches
descendant
- elements whose
+ elements whose
namespace is
namespace.
When invoked with the same arguments, the same {{HTMLCollection}} object may be returned as +returned by an earlier call. -The +
The list of elements with class names classNames -for a node root is the -{{HTMLCollection}} returned by the following algorithm: +for a node root is the {{HTMLCollection}} returned by the following +algorithm: +
Return a {{HTMLCollection}} rooted at root, whose filter matches descendant - elements that have all their + elements that have all their classes in classes.
The comparisons for the classes must be done in an
ASCII case-insensitive manner if root's node document's
- mode is "quirks", and in a case-sensitive manner
- otherwise.
+ mode is "quirks"; otherwise in an identical to
+ manner.
When invoked with the same argument, the same {{HTMLCollection}} object may be returned as +returned by an earlier call.
{{Document}} nodes are simply known as documents. -Each document has an associated -encoding (an encoding), +
Each document has an associated +encoding (an encoding), content type (a string), URL (a URL), origin (an origin), @@ -4811,19 +4891,18 @@ Each document has an associated [[!URL]] [[!HTML]] -Unless stated otherwise, a document's encoding is the utf-8 -encoding, content type is +
Unless stated otherwise, a document's encoding is the utf-8
+encoding, content type is
"application/xml", URL is "about:blank",
origin is an opaque origin,
type is "xml", and its
mode is "no-quirks".
-A document is said to be an XML document if its
-type is "xml", and an HTML document
-otherwise. Whether a document is an HTML document or an XML document
-affects the behavior of certain APIs.
+
A document is said to be an XML document if its type
+is "xml"; otherwise an HTML document. Whether a document is an
+HTML document or an XML document affects the behavior of certain APIs.
-A document is said to be in
+
A document is said to be in
no-quirks mode if its
mode is "no-quirks",
quirks mode if its mode
@@ -4831,7 +4910,7 @@ is "quirks", and
limited-quirks mode if its
mode is "limited-quirks".
-
The mode is only ever changed from the default for documents created
by the HTML parser based on the presence, absence, or value of the DOCTYPE string, and by a
new browsing context (initial "about:blank"). [[!HTML]]
@@ -4844,8 +4923,8 @@ is "quirks", and
A document's get the parent algorithm, given an event, returns
null if event's {{Event/type}} attribute value is "load" or
-document does not have a browsing context, and the document's
-relevant global object otherwise.
+document does not have a browsing context; otherwise the
+document's relevant global object.
load"
document . {{Document/compatMode}}
BackCompat" if document's
- mode is "quirks", and "CSS1Compat"
- otherwise.
+ Returns the string "BackCompat" if document's mode is
+ "quirks"; otherwise "CSS1Compat".
document . {{Document/characterSet}}
load"
content type.
-The Document() constructor, when invoked, must
-return a new document whose origin is the origin of
+
The new Document() constructor
+steps are to set this's origin to the origin of
current global object's associated Document. [[!HTML]]
-
Unlike {{DOMImplementation/createDocument()}}, this constructor does not +
Unlike {{DOMImplementation/createDocument()}}, this constructor does not
return an {{XMLDocument}} object, but a document ({{Document}} object).
-The
-implementation attribute's getter must return the
-{{DOMImplementation}} object that is associated with the document.
+
The
+implementation getter steps are to return the
+{{DOMImplementation}} object that is associated with this.
-The URL attribute's getter and
-documentURI attribute's getter must return the
+
The URL and
+documentURI getter steps are to return this's
URL, serialized.
-The compatMode attribute's getter must
-return "BackCompat" if this's mode is
-"quirks", and "CSS1Compat" otherwise.
+
The compatMode getter steps are to return
+"BackCompat" if this's mode is "quirks";
+otherwise "CSS1Compat".
-The characterSet attribute's getter,
-charset attribute's getter, and
-inputEncoding attribute's getter, must return
+
The characterSet,
+charset, and
+inputEncoding getter steps are to return
this's encoding's name.
-The contentType attribute's getter must return the
-content type.
+
The contentType getter steps are to return
+this's content type.
contentType attribute's gette
If qualifiedName is "*" returns a {{HTMLCollection}} of all
- descendant elements.
+ descendant elements.
-
Otherwise, returns a {{HTMLCollection}} of all descendant elements whose +
Otherwise, returns a {{HTMLCollection}} of all descendant elements whose qualified name is qualifiedName. (Matches case-insensitively against - elements in the HTML namespace within an HTML document.) + elements in the HTML namespace within an HTML document.)
contentType attribute's gette
If namespace and localName are
"*" returns a {{HTMLCollection}} of all
descendant
- elements.
+ elements.
If only namespace is "*" returns a
{{HTMLCollection}} of all
descendant
- elements whose
+ elements whose
local name is
localName.
If only localName is "*" returns a
{{HTMLCollection}} of all
descendant
- elements whose
+ elements whose
namespace is
namespace.
Otherwise, returns a {{HTMLCollection}} of all
descendant
- elements whose
+ elements whose
namespace is
namespace and
local name is
@@ -4956,45 +5034,44 @@ The contentType attribute's gette
doctype attribute's getter must return the
-child of the document that is a doctype, and null otherwise.
+The doctype getter steps are to return the
+child of this that is a doctype; otherwise null.
-The documentElement attribute's getter must return
-the document element.
+
The documentElement getter steps are to return
+this's document element.
-The getElementsByTagName(qualifiedName)
-method, when invoked, must return the
-list of elements with qualified name qualifiedName for this.
+
The getElementsByTagName(qualifiedName)
+method steps are to return the list of elements with qualified name qualifiedName
+for this.
-
Thus, in an HTML document,
-document.getElementsByTagName("FOO") will match
+
Thus, in an HTML document,
+document.getElementsByTagName("FOO") will match
<FOO> elements that are not in the
HTML namespace, and <foo> elements that are in
the HTML namespace, but not <FOO> elements
that are in the HTML namespace.
-The
+
The
getElementsByTagNameNS(namespace, localName)
-method, when invoked, must return the
-list of elements with namespace namespace and local name localName for
-this.
+method steps are to return the list of elements with namespace namespace and local
+name localName for this.
-The getElementsByClassName(classNames)
-method, when invoked, must return the list of elements with class names classNames
-for this.
+
The getElementsByClassName(classNames)
+method steps are to return the list of elements with class names classNames for
+this.
+
<div id="example">
<p id="p1" class="aaa bbb"/>
<p id="p2" class="aaa ccc"/>
@@ -5003,18 +5080,18 @@ for this.
A call to
- document.getElementById("example").getElementsByClassName("aaa")
+ document.getElementById("example").getElementsByClassName("aaa")
would return a {{HTMLCollection}} with the two paragraphs
p1 and p2 in it.
A call to
- getElementsByClassName("ccc bbb")
+ getElementsByClassName("ccc bbb")
would only return one node, however, namely p3. A call to
- document.getElementById("example").getElementsByClassName("bbb ccc ")
+ document.getElementById("example").getElementsByClassName("bbb ccc ")
would return the same thing.
A call to
- getElementsByClassName("aaa,bbb")
+ getElementsByClassName("aaa,bbb")
would return no nodes; none of the elements above are in the
aaa,bbb class.
element = document . createElement(localName [, options])
Returns an element with localName as local name +
Returns an element with localName as local name
(if document is an HTML document, localName gets lowercased). The
- element's namespace is the HTML namespace when
+ element's namespace is the HTML namespace when
document is an HTML document or document's
- content type is "application/xhtml+xml", and null otherwise.
+ content type is "application/xhtml+xml"; otherwise null.
If localName does not match the Name production an
"{{InvalidCharacterError!!exception}}" {{DOMException}} will be thrown.
@@ -5039,20 +5116,18 @@ for this.
element = document . createElementNS(namespace, qualifiedName [, options])
Returns an element with namespace namespace. Its +
Returns an element with namespace namespace. Its
namespace prefix will be everything before ":" (U+003E) in
qualifiedName or null. Its local name will be everything after
":" (U+003E) in qualifiedName or qualifiedName.
-
If localName does not match the Name production an
+
If qualifiedName does not match the QName production an
"{{InvalidCharacterError!!exception}}" {{DOMException}} will be thrown.
If one of the following conditions is true a "{{NamespaceError!!exception}}" {{DOMException}} will be thrown:
QName production.
documentFragment = document . {{createDocumentFragment()}}
- text = document . {{createTextNode(data)}}
- text = document . {{createCDATASection(data)}}
- comment = document . {{createComment(data)}}
- processingInstruction = document . {{createProcessingInstruction(target, data)}}
The element interface for any name and +namespace is {{Element}}, unless stated otherwise. -
The HTML Standard will e.g. define that for html
-and the HTML namespace, the {{HTMLHtmlElement}} interface is used.
-[[!HTML]]
+
The HTML Standard will, e.g., define that for html and the
+HTML namespace, the {{HTMLHtmlElement}} interface is used. [[!HTML]]
-The createElement(localName, options) method, when
-invoked, must run these steps:
+
The
+createElement(localName, options)
+method steps are:
If localName does not match the Name production, then
@@ -5119,12 +5192,13 @@ invoked, must run these steps:
Let is be null. -
If options is a dictionary and options's - {{ElementCreationOptions/is}} is present, then set is to it. +
If options is a dictionary and + options["{{ElementCreationOptions/is}}"] exists, then set is + to it.
Let namespace be the HTML namespace, if this is an
HTML document or this's content type is
- "application/xhtml+xml", and null otherwise.
+ "application/xhtml+xml"; otherwise null.
Return the result of creating an element given this, localName, namespace, null, is, and with the synchronous custom elements flag @@ -5140,8 +5214,9 @@ invoked, must run these steps:
Let is be null. -
If options is a dictionary and options's - {{ElementCreationOptions/is}} is present, then set is to it. +
If options is a dictionary and + options["{{ElementCreationOptions/is}}"] exists, then set is + to it.
Return the result of creating an element given document, localName, namespace, prefix, is, and with the @@ -5150,26 +5225,26 @@ invoked, must run these steps:
The
createElementNS(namespace, qualifiedName, options)
-method, when invoked, must return the result of running the
+method steps are to return the result of running the
internal createElementNS steps, given this, namespace,
qualifiedName, and options.
-
{{Document/createElement()}} and {{Document/createElementNS()}}'s options +
{{Document/createElement()}} and {{Document/createElementNS()}}'s options
parameter is allowed to be a string for web compatibility.
-The createDocumentFragment() method, when invoked,
-must return a new {{DocumentFragment}} node with its node document set to
+
The createDocumentFragment() method steps are to
+return a new {{DocumentFragment}} node whose node document is
this.
-The createTextNode(data) method, when
-invoked, must return a new {{Text}} node with its data set to
-data and node document set to this.
+
The createTextNode(data) method steps are
+to return a new {{Text}} node whose data is data
+and node document is this.
-
No check is performed that data consists of +
No check is performed that data consists of
characters that match the Char production.
-
The createCDATASection(data) method, when
-invoked, must run these steps:
+
The createCDATASection(data) method steps
+are:
If this is an HTML document, then throw a @@ -5178,21 +5253,21 @@ invoked, must run these steps:
If data contains the string "]]>", then throw an
"{{InvalidCharacterError!!exception}}" {{DOMException}}.
-
Return a new {{CDATASection}} node with its data set to - data and node document set to this. +
Return a new {{CDATASection}} node with its data set + to data and node document set to this.
createComment(data) method, when invoked,
-must return a new {{Comment}} node with its data set to
-data and node document set to this.
+The createComment(data) method steps are
+to return a new {{Comment}} node whose data is data
+and node document is this.
-
No check is performed that data consists of +
No check is performed that data consists of
characters that match the Char production
or that it contains two adjacent hyphens or ends with a hyphen.
-The
+
The
createProcessingInstruction(target, data)
-method, when invoked, must run these steps:
+method steps are:
No check is performed that target contains +
No check is performed that target contains
"xml" or ":", or that
data contains characters that match the
Char production.
@@ -5239,8 +5314,8 @@ method, when invoked, must run these steps:
"{{HierarchyRequestError!!exception}}" {{DOMException}}.
-The importNode(node, deep) method,
-when invoked, must run these steps:
+
The importNode(node, deep)
+method steps are:
If node is a document or shadow root, then throw a @@ -5292,8 +5367,7 @@ these steps:
adoptNode(node) method, when invoked,
-must run these steps:
+The adoptNode(node) method steps are:
If node is a document, then throw a @@ -5312,8 +5386,8 @@ must run these steps:
createAttribute(localName) method, when
-invoked, must run these steps:
+The createAttribute(localName) method
+steps are:
If localName does not match the Name production in XML,
@@ -5326,9 +5400,9 @@ invoked, must run these steps:
node document is this.
The
createAttributeNS(namespace, qualifiedName)
-method, when invoked, must run these steps:
+method steps are:
Let namespace, prefix, and localName be the result of @@ -5341,8 +5415,8 @@ method, when invoked, must run these steps:
The createEvent(interface) method, when
-invoked, must run these steps:
+
The createEvent(interface) method steps
+are:
Let constructor be null. @@ -5396,8 +5470,8 @@ invoked, must run these steps:
Initialize event's {{Event/type}} attribute to the empty string. -
Initialize event's {{Event/timeStamp}} attribute to a {{DOMHighResTimeStamp}} - representing the high resolution time from the time origin to now. +
Initialize event's {{Event/timeStamp}} attribute to the result of calling + current high resolution time with this's relevant global object.
Initialize event's {{Event/isTrusted}} attribute to false. @@ -5410,8 +5484,8 @@ invoked, must run these steps:
The createRange() method, when invoked, must return a
-new live range with (this, 0) as its start an end.
+
The createRange() method steps are to return a new
+live range with (this, 0) as its start an end.
The {{Range/Range()}} constructor can be used instead.
@@ -5419,7 +5493,7 @@ new live range with (this, 0) as its start an The
Let iterator be a new {{NodeIterator}} object.
@@ -5438,7 +5512,7 @@ method, when invoked, must run these steps:
The
Let walker be a new {{TreeWalker}} object.
@@ -5464,7 +5538,7 @@ with that document.
[Exposed=Window]
interface DOMImplementation {
[NewObject] DocumentType createDocumentType(DOMString qualifiedName, DOMString publicId, DOMString systemId);
- [NewObject] XMLDocument createDocument(DOMString? namespace, [TreatNullAs=EmptyString] DOMString qualifiedName, optional DocumentType? doctype = null);
+ [NewObject] XMLDocument createDocument(DOMString? namespace, [LegacyNullToEmptyString] DOMString qualifiedName, optional DocumentType? doctype = null);
[NewObject] Document createHTMLDocument(optional DOMString title);
boolean hasFeature(); // useless; always returns true
@@ -5509,9 +5583,9 @@ interface DOMImplementation {
The
Validate qualifiedName.
@@ -5528,7 +5602,7 @@ method, when invoked, must run these steps:
The
Let document be a new {{XMLDocument}}.
@@ -5563,9 +5637,9 @@ method, when invoked, must run these steps:
Return document.
The
Let doc be a new document that is an HTML document.
@@ -5589,9 +5663,9 @@ method, when invoked, must run these steps:
Append the result of creating an element given doc, <{title}>,
and the HTML namespace, to the <{head}> element created earlier.
- Append a new {{Text}} node, with its data set to
- title (which could be the empty string) and its node document set to
- doc, to the <{title}> element created earlier.
+ Append a new {{Text}} node, with its data set
+ to title (which could be the empty string) and its node document set
+ to doc, to the <{title}> element created earlier.
Append the result of creating an element given doc, <{body}>, and
@@ -5603,10 +5677,10 @@ method, when invoked, must run these steps:
Return doc.
The {{hasFeature()}} originally would report whether the user agent
+ {{hasFeature()}} originally would report whether the user agent
claimed to support a given DOM feature, but experience proved it was not nearly as
reliable or granular as simply checking whether the desired objects, attributes, or
methods existed. As such, it is no longer to be used, but continues to exist (and simply
@@ -5638,13 +5712,13 @@ interface DocumentType : Node {
explicitly given when a doctype is created, its public ID and system ID are the
empty string.
- The The The The The The A {{DocumentFragment}} node has an associated
+ A {{DocumentFragment}} node has an associated
host (null or an
-element in a different node tree). It is null unless otherwise stated.
+element in a different node tree). It is null unless otherwise stated.
An object A is a
host-including inclusive ancestor
@@ -5668,17 +5742,18 @@ or if B's root has a non-null A is a host-including inclusive ancestor of B's root's
host.
- The {{DocumentFragment}} node's host
+ The {{DocumentFragment}} node's host
concept is useful for HTML's <{template}> element and for shadow roots, and impacts the
pre-insert and replace algorithms.
The The
+ {{ShadowRoot}} nodes are simply known as
@@ -5704,20 +5782,32 @@ or " Shadow roots have an associated delegates focus.
It is initially set to false. Shadow roots have an associated
+available to element internals. It is initially set to false. Shadow roots's associated host is never null. Shadow roots have an associated slot assignment
+(" A shadow root's get the parent algorithm, given an event, returns
null if event's composed flag is unset and shadow root is the
root of event's path's first struct's
-invocation target, and shadow root's
-host otherwise.
+invocation target; otherwise shadow root's
+host.
- The The The The The The The The shadow-including root of an object is its
root's host's shadow-including root, if the
-object's root is a shadow root, and its root
-otherwise. An object A is a
shadow-including descendant of an object
@@ -5758,8 +5847,8 @@ is an object or one of its shadow-including descendants.
shadow-including inclusive ancestor
is an object or one of its shadow-including ancestors.
- A node A is
-closed-shadow-hidden from a node
+ A node A is
+closed-shadow-hidden from a node
B if all of the following conditions are true:
If one of the following is true
An element's custom element state is one of
-" Whether or not an element is defined is used to determine the
behavior of the '':defined'' pseudo-class. Whether or not an element is custom is
used to determine the behavior of the mutation algorithms. The
-" The following code illustrates elements in each of these four states: An element's
qualified name is its
-local name if its namespace prefix is null, and its
+local name if its namespace prefix is null; otherwise its
namespace prefix, followed by " An element's HTML-uppercased qualified name is the return
value of these steps:
@@ -5973,8 +6063,23 @@ given a document, localName, namespace, and opt
If the synchronous custom elements flag is set,
- upgrade element using definition.
+ If the synchronous custom elements flag is set, then run this step while
+ catching any exceptions:
+
+ Upgrade element using definition.
+ If this step threw an exception, then: Report the exception.
+
+ Set result's custom element state to
+ " Otherwise, enqueue a custom element upgrade reaction given result and
definition.
@@ -6008,7 +6113,7 @@ given a document, localName, namespace, and opt
If result's attribute list is not empty,
then throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
- If result has children, then throw a
"{{NotSupportedError!!exception}}" {{DOMException}}.
If result's parent is not null, then throw a
@@ -6085,11 +6190,11 @@ given a document, localName, namespace, and opt
Elements also have an
-attribute list, which is a list
-exposed through a {{NamedNodeMap}}. Unless explicitly given when an element is created,
-its attribute list is empty.
+attribute list, which is a
+list exposed through a {{NamedNodeMap}}. Unless explicitly given when an
+element is created, its attribute list is empty.
- An element
+ An element
has an attribute
A if its attribute list contains A.
@@ -6128,7 +6233,7 @@ its attribute list is empty.
To append an
-attribute attribute to an element element, run these
+attribute attribute to an element element, run these
steps:
To get an attribute by name given a
-qualifiedName and element element, run these steps:
+qualifiedName and element element, run these steps:
If element is in the HTML namespace and its node document
@@ -6182,23 +6287,20 @@ steps:
ASCII lowercase.
Return the first attribute in element's attribute list
- whose qualified name is qualifiedName, and null otherwise.
+ whose qualified name is qualifiedName; otherwise null.
To
get an attribute by namespace and local name
-given a namespace, localName, and element element,
+given a namespace, localName, and element element,
run these steps:
If namespace is the empty string, then set it to null.
- Return the attribute in element's attribute list whose
+ namespace is namespace and local name is
+ localName, if any; otherwise null.
To get an attribute value given an
@@ -6224,7 +6326,7 @@ run these steps:
Let oldAttr be the result of
getting an attribute given
- attr's namespace, attr's local name, and
+ attr's namespace, attr's local name, and
element.
If oldAttr is attr, return attr.
@@ -6238,7 +6340,7 @@ run these steps:
To set an attribute value for an
-element element, using a localName and value, and an
+element element, using a localName and value, and an
optional prefix, and namespace, run these steps:
To remove an attribute by name
-given a qualifiedName and element element, run these steps:
+given a qualifiedName and element element, run these steps:
Let attr be the result of
@@ -6275,7 +6377,7 @@ given a qualifiedName and element element,
To
remove an attribute by namespace and local name
-given a namespace, localName, and element element,
+given a namespace, localName, and element element,
run these steps:
An element can have an associated
unique identifier (ID)
- Historically elements could have multiple identifiers e.g., by using
+ Historically elements could have multiple identifiers e.g., by using
the HTML Use these attribute change steps to update an element's
@@ -6310,16 +6412,14 @@ a concept of the DOM and allows for only one per element, given b
set element's ID to value.
While this specification defines requirements for While this specification defines requirements for A node's parent of type {{Element}} is known as its
+parent element. If the node has a
parent of a different type, its
parent element is null.
@@ -6341,16 +6441,16 @@ A node's
The The The The The The The The The The The The Returns true if element has attributes, and false otherwise.
+ Returns true if element has attributes; otherwise false.
Returns the qualified names of all element's attributes.
@@ -6448,33 +6548,32 @@ namespace. Returns true if qualifiedName is now present, and false otherwise.
+ Returns true if qualifiedName is now present; otherwise false.
Returns true if element has an attribute whose
- qualified name is qualifiedName, and false otherwise.
+ qualified name is qualifiedName; otherwise false.
Returns true if element has an attribute whose namespace
is namespace and local name is localName.
The The The The The The These are not guaranteed to be unique.
- The The Let attr be the result of
@@ -6488,7 +6587,7 @@ when invoked, must run these steps:
The
Let attr be the result of
@@ -6502,7 +6601,7 @@ method, when invoked, must these steps:
The
If qualifiedName does not match the If attribute is null, create an attribute whose
- local name is qualifiedName, value is
+ local name is qualifiedName, value is
value, and node document is this's node document,
then append this attribute to this, and then return.
@@ -6527,7 +6626,7 @@ method, when invoked, must run these steps:
The
Let namespace, prefix, and localName be the result of
@@ -6539,17 +6638,16 @@ method, when invoked, must run these steps:
The
The
The The If this is in the HTML namespace and its node document is an
@@ -6557,11 +6655,12 @@ when invoked, must run these steps:
ASCII lowercase.
Return true if this has an attribute whose
- qualified name is qualifiedName, and false otherwise.
+ qualified name is qualifiedName; otherwise false.
The The
+ If qualifiedName does not match the If force is not given or is true, create an attribute whose
- local name is qualifiedName, value is the empty
+ local name is qualifiedName, value is the empty
string, and node document is this's node document, then
append this attribute to this, and then return
true.
@@ -6598,39 +6697,35 @@ method, when invoked, must run these steps:
The
If namespace is the empty string, then set it to null.
- The The The
The The The If this's attribute list does not contain
@@ -6652,33 +6747,39 @@ when invoked, must run these steps:
shadow root's mode is " The The If this's namespace is not the HTML namespace,
+ If this's namespace is not the HTML namespace,
then throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
- If this's local name is not a
-valid custom element name,
- " If this's local name is not one of the following:
+
+ then throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
+ If this's local name is a valid custom element name, or
@@ -6701,18 +6802,24 @@ invoked, must run these steps:
Let shadow be a new shadow root whose node document
is this's node document, host is this,
- and mode is init's {{ShadowRootInit/mode}}.
+ and mode is init["{{ShadowRootInit/mode}}"].
+
+ Set shadow's delegates focus to
+ init["{{ShadowRootInit/delegatesFocus}}"].
- Set shadow's delegates focus to init's
- {{ShadowRootInit/delegatesFocus}}.
+ If this's custom element state is " Set shadow's slot assignment to
+ init["{{ShadowRootInit/slotAssignment}}"].
Set this's shadow root to shadow.
Return shadow.
The The Let shadow be this's shadow root.
@@ -6732,13 +6839,11 @@ steps:
selectors, and null otherwise.
The The Let s be the result of parse a selector from selectors.
[[!SELECTORS4]]
- If s is failure, then throw a "{{SyntaxError!!exception}}"
+ {{DOMException}}.
- If the result of match a selector against an element, using s,
+ this, and :scope element this, returns success, then return true; otherwise,
+ return false. [[!SELECTORS4]]
The The
The To insert adjacent, given an element element, string
-where, and a node node, run the steps associated with the first
+where, and a node node, run the steps associated with the first
ASCII case-insensitive match for where:
The
The
Let text be a new {{Text}} node whose data is
- data and node document is this's node document.
+ Let text be a new {{Text}} node whose data
+ is data and node document is this's
+ node document.
Run insert adjacent, given this, where, and text.
This method returns nothing because it existed before we had a chance to design it.
+ This method returns nothing because it existed before we had a chance to design it.
A {{NamedNodeMap}} has an associated
element (an
-element).
+element).
-A {{NamedNodeMap}} object's
+ A {{NamedNodeMap}} object's
attribute list is its
element's
attribute list.
@@ -6882,11 +6984,10 @@ range zero to its attribute list's size
the attribute list is empty, in which case there are no
supported property indices.
- The The The The If index is equal to or greater than this's
@@ -6921,25 +7022,23 @@ steps:
Return names.
The The The
- The The The The Let attr be the result of
@@ -6953,8 +7052,8 @@ method, when invoked, must run these steps:
The
- Let attr be the result of
@@ -6994,9 +7093,9 @@ to as content attributes to avoid confusion with IDL attributes.
local name (a non-empty string),
value (a string), and
element (null or an
-element).
+element).
- If designed today they would just have a name and value. ☹
+ If designed today they would just have a name and value. ☹
An attribute's
qualified name is its
@@ -7025,19 +7124,19 @@ null.
The The The The The The The The The The To set an existing attribute value, given an attribute attribute and
@@ -7050,17 +7149,17 @@ string value, run these steps:
Otherwise, change attribute to value.
The {{Attr/value}} attribute's setter must set an existing attribute value with
-this and the given value.
+ The {{Attr/value}} setter steps are to set an existing attribute value with this
+and the given value.
The The The The {{CharacterData}} is an abstract interface and does not exist as
-node. It is used by {{Text}}, {{ProcessingInstruction}}, and {{Comment}} nodes.
+ {{CharacterData}} is an abstract interface. You cannot get a direct instance of it. It
+is used by {{Text}}, {{ProcessingInstruction}}, and {{Comment}} nodes.
-Each node inheriting from the
-{{CharacterData}} interface has an associated mutable string
-called data.
+ Each node inheriting from the {{CharacterData}} interface has an associated mutable
+string called data.
-To replace data of node node with offset
+ To replace data of node node with offset
offset, count count, and data data, run these steps:
The The The The The
The The The
The
The
An exclusive {{Text}} node is a {{Text}} node that is not a
-{{CDATASection}} node.
+ An exclusive {{Text}} node is a {{Text}} node that is not a
+{{CDATASection}} node.
- The contiguous {{Text}} nodes of a node node are
-node, node's previous sibling {{Text}} node, if any, and its
-contiguous The contiguous {{Text}} nodes of a node node are
+node, node's previous sibling {{Text}} node, if any, and
+its contiguous The contiguous exclusive {{Text}} nodes of a node node are
-node, node's previous sibling exclusive The contiguous exclusive {{Text}} nodes of a node node
+are node, node's previous sibling
+exclusive The child text content of a node
node is the concatenation of the data of all
-the {{Text}} node children of node, in tree order.
+the {{Text}} node children of node, in tree order.
The descendant text content of a
node node is the concatenation of the
@@ -7276,14 +7376,13 @@ the {{Text}} node children of node, in tree or
The The To split a {{Text}}
+node node with offset offset, run these steps:
The The The The {{ProcessingInstruction}} nodes have an associated
+target.
-{{ProcessingInstruction}} nodes
-have an associated target.
-
-The target
-attribute must return the target.
+ The target getter steps are to return
+this's target.
The The Ranges are frequently used in editing for selecting and copying content.
- In the node tree above, a
range can be used to represent the sequence
“syndata is awes”. Assuming p is assigned to the
- Attributes such as Attributes such as See the insert and remove algorithms, the
+ See the insert and remove algorithms, the
{{Node/normalize()}} method, and the replace data and split
algorithms for details.
@@ -7473,7 +7570,7 @@ when a mutation occurs.
node (a node) and an
offset (a non-negative integer).
- A correct boundary point's offset will
+ A correct boundary point's offset will
be between 0 and the boundary point's node's
length, inclusive.
@@ -7562,25 +7659,24 @@ interface AbstractRange {
The
The The The The Returns a new range object that does not update when the node tree mutates.
The The
+ If init's {{StaticRangeInit/startContainer}} or {{StaticRangeInit/endContainer}}
- is a {{DocumentType}} or {{Attr}} node, then throw an
- "{{InvalidNodeTypeError!!exception}}" {{DOMException}}.
+ If init["{{StaticRangeInit/startContainer}}"] or
+ init["{{StaticRangeInit/endContainer}}"] is a {{DocumentType}} or {{Attr}}
+ node, then throw an "{{InvalidNodeTypeError!!exception}}" {{DOMException}}.
- Let staticRange be a new {{StaticRange}} object.
+ Set this's start to
+ (init["{{StaticRangeInit/startContainer}}"],
+ init["{{StaticRangeInit/startOffset}}"]) and end to
+ (init["{{StaticRangeInit/endContainer}}"],
+ init["{{StaticRangeInit/endOffset}}"]).
+ Set staticRange's start to (init's
- {{StaticRangeInit/startContainer}}, init's {{StaticRangeInit/startOffset}}) and
- end to (init's {{StaticRangeInit/endContainer}}, init's
- {{StaticRangeInit/endOffset}}).
+ A {{StaticRange}} is valid if all of the following are true:
- Return staticRange.
-
+ Its start offset is between 0 and its start node's
+ length, inclusive.
+
+ Its end offset is between 0 and its end node's
+ length, inclusive.
+
+ Objects implementing the {{Range}} interface are known as
live ranges.
- Algorithms that modify a tree (in particular the insert,
+ Algorithms that modify a tree (in particular the insert,
remove, replace data, and split algorithms) modify
live ranges associated with that tree.
@@ -7689,14 +7798,14 @@ in a live range range if node's rootinclusive ancestor of the live range's start node
but not its end node, or vice versa.
- Some facts to better understand these definitions:
The content that one would think of as being within the live range consists of all
contained nodes, plus possibly some of the contents of the
- start node and end node if those are {{Text}},
- {{ProcessingInstruction}}, or {{Comment}} nodes.
+ start node and end node if those are {{CharacterData}}
+ nodes.
The nodes that are contained in a live range will generally not be
contiguous, because the parent of a contained
@@ -7722,7 +7831,7 @@ but not its end node, or vice versa.
If the start node is an ancestor of the end node,
the common inclusive ancestor will be the start node. Exactly one
- of its children will be partially contained, and a
+ of its children will be partially contained, and a
child will be contained if and only if it
precedes the partially contained
child. If the end node is an ancestor of the
@@ -7730,7 +7839,7 @@ but not its end node, or vice versa.
If the start node is not an inclusive ancestor of the
end node, nor vice versa, the common inclusive ancestor will be
- distinct from both of them. Exactly two of its children will be
+ distinct from both of them. Exactly two of its children will be
partially contained, and a child will be contained if and
only if it lies between those two.
The The The The The The The The The The The The Let parent be node's parent.
@@ -7867,8 +7972,7 @@ must run these steps:
(parent, node's index plus 1).
The The The The Let parent be node's parent.
@@ -7896,9 +7999,9 @@ must run these steps:
(parent, node's index plus 1).
The The To select a node node
within a range range, run these steps:
@@ -7918,11 +8021,11 @@ within a range range, run these steps:
(parent, index plus 1).
The The The The The
The The If this is collapsed, then return.
@@ -8050,10 +8152,8 @@ run these steps:
end node, and
end offset, respectively.
- If original start node is original end node and it is a
+ {{CharacterData}} node, then
replace data with node
original start node, offset
original start offset, count
@@ -8064,7 +8164,7 @@ run these steps:
nodes that are contained in
this, in
tree order, omitting any
- node whose
+ node whose
parent is also
contained in this.
@@ -8093,7 +8193,7 @@ run these steps:
plus the index of
reference node.
- If reference node's
+ If reference node's
parent were null, it would be the
root of
this, so would be an
@@ -8101,9 +8201,7 @@ run these steps:
original end node, and we could not reach this point.
If original start node is a {{CharacterData}} node, then
replace data with node
original start node, offset
original start offset, count
@@ -8114,9 +8212,7 @@ run these steps:
For each node in nodes to remove, in tree order,
remove node.
- If original end node is a {{CharacterData}} node, then
replace data with node
original end node, offset 0, count
original end offset and data the empty string.
@@ -8150,8 +8246,8 @@ run these steps:
end offset, respectively.
If original start node is original end node and it is a
+ {{CharacterData}} node, then:
These variable assignments do actually always make sense.
+ These variable assignments do actually always make sense.
For instance, if original start node is not an
inclusive ancestor of
original end node, original start node is itself
@@ -8215,10 +8311,10 @@ run these steps:
common ancestor cannot be original start node, because
it has to be an inclusive ancestor of
original end node. The other case is similar. Also, notice that the two
- children will never be equal if both are defined.
+ children will never be equal if both are defined.
We do not have to worry about the first or last partially
+ We do not have to worry about the first or last partially
contained node, because a doctype can never be
partially contained. It cannot be a boundary point of a range, and it
cannot be the ancestor of anything.
@@ -8259,7 +8355,7 @@ run these steps:
new offset to one plus reference node's
index.
- If reference node's
+ If reference node's
parent is null, it would be the
root of range, so would be an
inclusive ancestor of
@@ -8270,11 +8366,9 @@ run these steps:
how it will have mutated. -->
If first partially contained child is a {{CharacterData}} node, then:
- In this case, first partially contained child is
+ In this case, first partially contained child is
original start node.
If last partially contained child is a {{CharacterData}} node, then:
- In this case, last partially contained child is
+ In this case, last partially contained child is
original end node.
The The To
clone the contents
@@ -8417,8 +8509,8 @@ of a live range range, run these steps:
end offset, respectively.
If original start node is original end node and it is a
+ {{CharacterData}} node, then:
These variable assignments do actually always make sense.
+ These variable assignments do actually always make sense.
For instance, if original start node is not an
inclusive ancestor of
original end node, original start node is itself
@@ -8476,10 +8568,10 @@ of a live range range, run these steps:
common ancestor cannot be original start node, because
it has to be an inclusive ancestor of
original end node. The other case is similar. Also, notice that the two
- children will never be equal if both are defined.
+ children will never be equal if both are defined.
If any member of contained children is a doctype, then throw a
"{{HierarchyRequestError!!exception}}" {{DOMException}}.
- We do not have to worry about the first or last partially
+ We do not have to worry about the first or last partially
contained node, because a doctype can never be
partially contained. It cannot be a boundary point of a range, and it
cannot be the ancestor of anything.
If first partially contained child is a {{CharacterData}} node, then:
- In this case, first partially contained child is
+ In this case, first partially contained child is
original start node.
If last partially contained child is a {{CharacterData}} node, then:
- In this case, last partially contained child is
+ In this case, last partially contained child is
original end node.
The The To insert a node
node into a live range range, run these steps:
The The The The If a non-{{Text}} node is partially contained in
+ If a non-{{Text}} node is partially contained in
this, then throw an "{{InvalidStateError!!exception}}" {{DOMException}}.
@@ -8739,7 +8827,7 @@ check first thing, which matches everyone but Firefox.
If newParent is a {{Document}}, {{DocumentType}}, or {{DocumentFragment}}
node, then throw an "{{InvalidNodeTypeError!!exception}}" {{DOMException}}.
- For historical reasons {{Text}}, {{ProcessingInstruction}}, and {{Comment}}
+ For historical reasons {{CharacterData}}
nodes are not checked here and end up throwing later on as a side effect.
Let fragment be the result of extracting this.
@@ -8749,8 +8837,8 @@ check first thing, which matches everyone but Firefox.
extractContents() proper, and also affects surroundContents(). I match DOM 2
Range, IE9, and Chrome 12 dev. -->
- If newParent has children, then replace all with null
- within newParent.
+ If newParent has children, then replace all with
+ null within newParent.
Insert newParent into this.
@@ -8762,10 +8850,10 @@ check first thing, which matches everyone but Firefox.
range lies in a single text node). -->
The The The The The The The The Let s be the empty string.
If this's start node is this's end node and
- it is a {{Text}} node, then return the substring of that {{Text}} node's
+ it is a {{Text}} node, then return the substring of that {{Text}} node's
data beginning at this's start offset and ending
at this's end offset.
- If this's start node is a {{Text}} node, then append the
- substring of that node's data from this's
+ If this's start node is a {{Text}} node, then append
+ the substring of that node's data from this's
start offset until the end to s.
Append the concatenation of the data of all
{{Text}} nodes that are contained in this, in
tree order, to s.
- If this's end node is a {{Text}} node, then
- append the substring of that node's data from its start until
+ If this's end node is a {{Text}} node, then
+ append the substring of that node's data from its start until
this's end offset to s.
Return s.
@@ -8920,7 +9007,7 @@ these steps:
The {{createContextualFragment()}}, {{Range/getClientRects()}},
+ The {{createContextualFragment()}}, {{Range/getClientRects()}},
and {{Range/getBoundingClientRect()}} methods are defined in other specifications.
[[DOM-Parsing]]
[[CSSOM-VIEW]]
@@ -8985,11 +9072,11 @@ interface NodeIterator {
Node? nextNode();
Node? previousNode();
- void detach();
+ undefined detach();
};
- {{NodeIterator}} objects can be created using the
+ {{NodeIterator}} objects can be created using the
{{createNodeIterator()}} method on {{Document}} objects.
Each {{NodeIterator}} object has an associated
@@ -9000,7 +9087,7 @@ filter matches any node.
Each {{NodeIterator}} object also has an associated reference (a
node) and pointer before reference (a boolean).
- As mentioned earlier, {{NodeIterator}} objects have an associated
+ As mentioned earlier, {{NodeIterator}} objects have an associated
active flag, root, whatToShow, and
filter as well.
@@ -9017,9 +9104,9 @@ filter matches any node.
Let next be toBeRemovedNode's first following
- node that is an inclusive descendant of nodeIterator's
+ node that is an inclusive descendant of nodeIterator's
root and is not an inclusive descendant of
- toBeRemovedNode, and null if there is no such node.
+ toBeRemovedNode, and null if there is no such node.
If next is non-null, then set nodeIterator's
reference to next and return.
@@ -9028,7 +9115,7 @@ filter matches any node.
Otherwise, set nodeIterator's pointer before reference to
false.
- Steps are not terminated here.
+ Steps are not terminated here.
Set nodeIterator's reference to
@@ -9040,20 +9127,20 @@ filter matches any node.
The The The The The The The The The The To traverse, given a
{{NodeIterator}} object iterator and a direction direction, run these steps:
@@ -9105,15 +9192,15 @@ must return this's filter.
Return node.
- The The The The The The {{TreeWalker}} objects can be created using the {{createTreeWalker()}}
+ {{TreeWalker}} objects can be created using the {{createTreeWalker()}}
method on {{Document}} objects.
Each {{TreeWalker}} object has an associated current (a
node).
- As mentioned earlier {{TreeWalker}} objects have an associated
+ As mentioned earlier {{TreeWalker}} objects have an associated
root, whatToShow, and filter as well.
- The The The The The The The The The {{TreeWalker/currentNode}} attribute's setter, when invoked, must set this's
+ The {{TreeWalker/currentNode}} setter steps are to set this's
current to the given value.
The The The The The The To traverse siblings, given a walker
@@ -9288,14 +9374,13 @@ and type, run these steps:
- The The The The The The The The Let node be this's current.
@@ -9414,27 +9498,27 @@ callback interface NodeFilter {
const unsigned long SHOW_ATTRIBUTE = 0x2;
const unsigned long SHOW_TEXT = 0x4;
const unsigned long SHOW_CDATA_SECTION = 0x8;
- const unsigned long SHOW_ENTITY_REFERENCE = 0x10; // historical
- const unsigned long SHOW_ENTITY = 0x20; // historical
+ const unsigned long SHOW_ENTITY_REFERENCE = 0x10; // legacy
+ const unsigned long SHOW_ENTITY = 0x20; // legacy
const unsigned long SHOW_PROCESSING_INSTRUCTION = 0x40;
const unsigned long SHOW_COMMENT = 0x80;
const unsigned long SHOW_DOCUMENT = 0x100;
const unsigned long SHOW_DOCUMENT_TYPE = 0x200;
const unsigned long SHOW_DOCUMENT_FRAGMENT = 0x400;
- const unsigned long SHOW_NOTATION = 0x800; // historical
+ const unsigned long SHOW_NOTATION = 0x800; // legacy
unsigned short acceptNode(Node node);
};
- {{NodeFilter}} objects can be used as filter for
+ {{NodeFilter}} objects can be used as filter for
{{NodeIterator}} and {{TreeWalker}} objects and also provide constants for their
whatToShow bitmask. A {{NodeFilter}} object is typically implemented as a
JavaScript function.
These constants can be used as filter return value:
- These constants can be used for whatToShow:
- Yes, the name {{DOMTokenList}} is an unfortunate legacy mishap.
+ Yes, the name {{DOMTokenList}} is an unfortunate legacy mishap.
A {{DOMTokenList}} object also has an associated element and an attribute's
+ A {{DOMTokenList}} object also has an associated element and an attribute's
local name.
Specifications may define
@@ -9508,10 +9592,10 @@ associated attribute's local name.
A {{DOMTokenList}} object's update steps are:
If the associated element does not have an associated attribute and
+ If the associated element does not have an associated attribute and
token set is empty, then return.
- Set an attribute value for the associated element using associated
+ Set an attribute value for the associated element using associated
attribute's local name and the result of running the ordered set
serializer for token set.
Returns the number of tokens.
@@ -9559,7 +9643,7 @@ are to return the result of running get an attribute value given the asso
Returns the token with index index.
Returns true if token is present, and false otherwise.
+ Returns true if token is present; otherwise false.
Returns true if token is now present, and false otherwise.
+ Returns true if token is now present; otherwise false.
Throws a "{{SyntaxError!!exception}}" {{DOMException}} if token is empty.
Throws an "{{InvalidCharacterError!!exception}}" {{DOMException}} if token contains
any spaces.
@@ -9591,7 +9675,7 @@ are to return the result of running get an attribute value given the asso
Replaces token with newToken.
- Returns true if token was replaced with newToken, and false otherwise.
+ Returns true if token was replaced with newToken; otherwise false.
Throws a "{{SyntaxError!!exception}}" {{DOMException}} if one of the arguments is the empty
string.
Throws an "{{InvalidCharacterError!!exception}}" {{DOMException}} if one of the arguments
@@ -9616,8 +9700,7 @@ are to return the result of running get an attribute value given the asso
token set's size minus one, unless token set is empty,
in which case there are no supported property indices.
- The The If index is equal to or greater than this's token set's
@@ -9626,13 +9709,13 @@ invoked, must run these steps:
The The The
The
The If token is the empty string, then throw a "{{SyntaxError!!exception}}"
@@ -9701,12 +9784,12 @@ method, when invoked, must run these steps:
Return false.
The update steps are not always run for {{DOMTokenList/toggle()}}
+ The update steps are not always run for {{DOMTokenList/toggle()}}
for web compatibility.
The
Return true.
The update steps are not always run for {{DOMTokenList/replace()}}
+ The update steps are not always run for {{DOMTokenList/replace()}}
for web compatibility.
The
Let result be the return value of validation steps called with
@@ -9745,7 +9828,7 @@ method, when invoked, must run these steps:
result of running this's serialize steps.
Setting the {{DOMTokenList/value}} attribute must set an attribute value for the
-associated element using associated attribute's local name and
+associated element using associated attribute's local name and
the given value.
@@ -9834,49 +9917,39 @@ methods on {{Document}}.
- As explained in goals this standard is a significant revision of various
-obsolete DOM specifications. This section enumerates the incompatible changes.
+ XSL Transformations (XSLT) is a language for transforming XML documents
+into other XML documents. The APIs defined in this section have been widely implemented, and are
+maintained here so that they can be updated when Web IDL changes. Complete definitions
+of these APIs remain necessary and such work is tracked and can be contributed to in
+whatwg/dom#181. [[XSLT]]
- These are the changes made to the features described in the "DOM Event Architecture",
-"Basic Event Interfaces", "Mutation Events", and "Mutation Name Event Types" chapters of
-DOM Level 3 Events. The other chapters are defined by the UI Events
-specification. [[!UIEVENTS]]
+ These are the changes made to the features described in DOM Level 3 Core.
-
- {{DOMString}}, {{DOMException}}, and {{DOMTimeStamp}} are now defined in Web IDL.
+ {{DOMStringList}} is now defined in HTML.
- The remainder of interfaces and interface members listed in this section were removed to simplify
-the web platform. Implementations conforming to this specification will not support them.
+ This standard used to contain several interfaces and interface members that have been removed.
- Interfaces:
+ These interfaces have been removed:
Interface members:
+ And these interface members have been removed:
These are the changes made to the features described in the "Document Object Model Range" chapter
-of DOM Level 2 Traversal and Range.
-
- These are the changes made to the features described in the "Document Object Model Traversal"
-chapter of DOM Level 2 Traversal and Range.
+ Part of the revision history of the integration points related to custom
-elements can be found in
+ Part of the revision history of the integration points related to
+custom elements can be found in
the w3c/webcomponents repository, which is
available under the
-W3C Permissive Document License.
-
-
+W3C Software and Document License.
diff --git a/review-drafts/2020-06.bs b/review-drafts/2020-06.bs
new file mode 100644
index 000000000..7801498fe
--- /dev/null
+++ b/review-drafts/2020-06.bs
@@ -0,0 +1,10214 @@
+ By consolidating DOM Level 3 Core [[DOM-Level-3-Core]],
+ Element Traversal [[ELEMENTTRAVERSAL]],
+ Selectors API Level 2 [[SELECTORS-API2]], the
+ "DOM Event Architecture" and "Basic Event Interfaces" chapters of
+ DOM Level 3 Events [[uievents-20031107]] (specific types of events do not
+ belong in the DOM Standard), and DOM Level 2 Traversal and Range
+ [[DOM-Level-2-Traversal-Range]], and:
+
+ By moving features from the HTML Standard [[!HTML]] that make more sense to be
+ specified as part of the DOM Standard.
+
+ By defining a replacement for the "Mutation Events" and
+ "Mutation Name Event Types" chapters of DOM Level 3 Events
+ [[uievents-20031107]] as the old model
+ was problematic.
+
+ The old model is expected to be removed from implementations
+ in due course.
+
+ By defining new features that simplify common DOM operations.
+ This specification depends on the Infra Standard. [[!INFRA]]
+
+ Some of the terms used in this specification are defined in Encoding,
+Selectors, Web IDL, XML, and Namespaces in XML.
+[[!ENCODING]]
+[[!SELECTORS4]]
+[[!WEBIDL]]
+[[!XML]]
+[[!XML-NAMES]]
+
+ The term context object is an alias for this.
+
+ Usage of context object is deprecated in favor of this.
+
+ When extensions are needed, the DOM Standard can be updated accordingly, or a new standard
+can be written that hooks into the provided extensibility hooks for
+applicable specifications.
+
+
+
+ A tree is a finite hierarchical tree structure. In
+tree order is preorder, depth-first traversal of a
+tree.
+
+
+ An object that
+participates
+in a tree has a parent, which is either
+null or an object, and has
+children, which is an
+ordered set of objects. An object A whose parent is object
+B is a child of B.
+
+ The root of an object is itself, if its
+parent is null, or else it is the root of its
+parent. The root of a tree is any object
+participating in that tree whose parent is null.
+
+An object A is called a
+descendant of an object
+B, if either A is a
+child of B or
+A is a child of an
+object C that is a
+descendant of B.
+
+An
+inclusive descendant is
+an object or one of its
+descendants.
+
+An object A is called an
+ancestor of an object
+B if and only if B is a
+descendant of
+A.
+
+An inclusive ancestor is
+an object or one of its ancestors.
+
+An object A is called a
+sibling of an object
+B, if and only if B and A
+share the same non-null parent.
+
+An inclusive sibling is an
+object or one of its siblings.
+
+An object A is
+preceding an object
+B if A and B are in the
+same tree and A comes
+before B in
+tree order.
+
+An object A is
+following an object
+B if A and B are in the
+same tree and A comes
+after B in
+tree order.
+
+The first child of an object is its
+first child or null if it has no children.
+
+The last child of an object is its
+last child or null if it has no children.
+
+The previous sibling of an
+object is its first preceding
+sibling or null if it has no
+preceding
+sibling.
+
+The next sibling of an
+object is its first following
+sibling or null if it has no
+following
+sibling.
+
+ The index of an object is its number of
+preceding siblings, or 0 if it has none.
+
+
+ The ordered set parser takes a string
+input and then runs these steps:
+
+ Let inputTokens be the result of
+ splitting input on ASCII whitespace.
+
+ Let tokens be a new ordered set.
+
+ For each token in inputTokens, append
+ token to tokens.
+
+ The ordered set serializer takes a
+set and returns the concatenation of set using U+0020 SPACE.
+
+
+ To scope-match a selectors string selectors against a
+node, run these steps:
+
+ Let s be the result of parse a selector selectors.
+ [[!SELECTORS4]]
+
+ If s is failure, then throw a "{{SyntaxError!!exception}}"
+ {{DOMException}}.
+
+ Return the result of match a selector against a tree with s and
+ node's root using scoping root node. [[!SELECTORS4]].
+ Support for namespaces within selectors is not planned and will not be
+added.
+
+
+ To validate a qualifiedName, throw an
+"{{InvalidCharacterError!!exception}}" {{DOMException}} if qualifiedName does not match
+the Although events are typically dispatched by the user agent
+as the result of user interaction or the completion of some task, applications can dispatch
+events themselves by using what are commonly known as synthetic events:
+
+ An {{Event}} object is simply named an event. It allows for
+signaling that something has occurred, e.g., that an image has completed downloading. A potential event target is null or an {{EventTarget}} object.
+
+ An event has an associated target (a
+potential event target). Unless stated otherwise it is null.
+
+ An event has an associated relatedTarget (a
+potential event target). Unless stated otherwise it is null.
+
+ Other specifications use relatedTarget to define a
+ An event has an associated touch target list (a
+list of zero or more potential event targets). Unless stated otherwise it is the
+empty list.
+
+ The touch target list is for the exclusive use of defining the
+{{TouchEvent}} interface and related interfaces. [[TOUCH-EVENTS]]
+
+ An event has an associated path. A path is a
+list of structs. Each struct consists of an
+invocation target (an {{EventTarget}} object), an
+invocation-target-in-shadow-tree (a boolean), a
+shadow-adjusted target (a potential event target), a
+relatedTarget (a
+potential event target), a touch target list (a list
+of potential event targets), a root-of-closed-tree (a boolean), and
+a slot-in-closed-tree (a boolean). A path is initially
+the empty list. The The The The The Let composedPath be an empty list.
+
+ If path is empty, then return composedPath.
+
+ Let currentTarget be this's {{Event/currentTarget}} attribute value.
+
+ Append currentTarget to composedPath.
+
+ Let currentTargetIndex be 0.
+
+ Let currentTargetHiddenSubtreeLevel be 0.
+
+ Let index be path's size − 1.
+
+ While index is greater than or equal to 0:
+
+ If path[index]'s root-of-closed-tree is true,
+ then increase currentTargetHiddenSubtreeLevel by 1.
+
+ If path[index]'s invocation target is
+ currentTarget, then set currentTargetIndex to index and
+ break.
+
+ If path[index]'s slot-in-closed-tree is true,
+ then decrease currentTargetHiddenSubtreeLevel by 1.
+
+ Decrease index by 1.
+ Let currentHiddenLevel and maxHiddenLevel be
+ currentTargetHiddenSubtreeLevel.
+
+ Set index to currentTargetIndex − 1.
+
+ While index is greater than or equal to 0:
+
+ If path[index]'s root-of-closed-tree is true,
+ then increase currentHiddenLevel by 1.
+
+ If currentHiddenLevel is less than or equal to maxHiddenLevel, then
+ prepend path[index]'s
+ invocation target to composedPath.
+
+ If path[index]'s slot-in-closed-tree is true,
+ then:
+
+ Decrease currentHiddenLevel by 1.
+
+ If currentHiddenLevel is less than maxHiddenLevel, then set
+ maxHiddenLevel to currentHiddenLevel.
+ Decrease index by 1.
+ Set currentHiddenLevel and maxHiddenLevel to
+ currentTargetHiddenSubtreeLevel.
+
+ Set index to currentTargetIndex + 1.
+
+ While index is less than path's size:
+
+ If path[index]'s slot-in-closed-tree is true,
+ then increase currentHiddenLevel by 1.
+
+ If currentHiddenLevel is less than or equal to maxHiddenLevel, then
+ append path[index]'s
+ invocation target to composedPath.
+
+ If path[index]'s root-of-closed-tree is true,
+ then:
+
+ Decrease currentHiddenLevel by 1.
+
+ If currentHiddenLevel is less than maxHiddenLevel, then set
+ maxHiddenLevel to currentHiddenLevel.
+ Increase index by 1.
+ Return composedPath.
+ The Initially the attribute must be initialized to {{Event/NONE}}.
+
+ Each event has the following associated flags that are all initially unset:
+
+ The The The {{Event/cancelBubble}} attribute's setter, when invoked, must set this's
+stop propagation flag if the given value is true, and do nothing otherwise.
+
+ The The To set the canceled flag, given an event event, if
+event's {{Event/cancelable}} attribute value is true and event's
+in passive listener flag is unset, then set event's canceled flag, and do
+nothing otherwise.
+
+ The The {{Event/returnValue}} attribute's setter, when invoked, must set the canceled flag
+with this if the given value is false, and do nothing otherwise.
+
+ The There are scenarios where invoking {{Event/preventDefault()}} has no
+effect. User agents are encouraged to log the precise cause in a developer console, to aid
+debugging.
+
+ The The The {{Event/isTrusted}} is a convenience that indicates whether an
+event is dispatched by the user agent (as opposed to using
+{{EventTarget/dispatchEvent()}}). The sole legacy exception is {{HTMLElement/click()}}, which causes
+the user agent to dispatch an event whose {{Event/isTrusted}} attribute is initialized to
+false.
+
+ The To initialize an event, with
+type, bubbles, and cancelable, run these steps:
+
+ Set event's initialized flag.
+
+ Unset event's stop propagation flag,
+ stop immediate propagation flag, and canceled flag.
+
+ Set event's {{Event/isTrusted}} attribute to false.
+
+ Set event's target to null.
+
+ Set event's {{Event/type}} attribute to type.
+
+ Set event's {{Event/bubbles}} attribute to bubbles.
+
+ Set event's {{Event/cancelable}} attribute to cancelable.
+ The
+ If this's dispatch flag is set, then return.
+
+ Initialize this with type, bubbles, and
+ cancelable.
+ As events have constructors {{Event/initEvent()}} is redundant and
+incapable of setting {{Event/composed}}. It has to be supported for legacy content.
+
+
+ Each {{Window}} object has an associated current event (undefined or an
+{{Event}} object). Unless stated otherwise it is undefined.
+
+ The Web developers are strongly encouraged to instead rely on the {{Event}} object passed
+to event listeners, as that will result in more portable code. This attribute is not available in
+workers or worklets, and is inaccurate for events dispatched in shadow trees.
+
+
+ The The
+ If this's dispatch flag is set, then return.
+
+ Initialize this with type, bubbles, and
+ cancelable.
+
+ Set this's {{CustomEvent/detail}} attribute to detail.
+ This construct can be used by {{Event}} subclasses that have a more complex structure
+than a simple 1:1 mapping between their initializing dictionary members and IDL attributes.
+
+ When a constructor of the {{Event}}
+interface, or of an interface that inherits from the {{Event}} interface, is invoked, these steps
+must be run, given the arguments type and eventInitDict:
+
+ Let event be the result of running the inner event creation steps with
+ this interface, null, now, and eventInitDict.
+
+ Initialize event's {{Event/type}} attribute to type.
+
+ Return event.
+ To
+create an event
+using eventInterface, which must be either {{Event}} or an interface that inherits from
+it, and optionally given a Realm realm, run these steps: If realm is not given, then set it to null.
+
+ Let dictionary be the result of converting
+ the JavaScript value undefined to the dictionary type accepted by eventInterface's
+ constructor. (This dictionary type will either be {{EventInit}} or a dictionary that inherits from
+ it.)
+
+ This does not work if members are required; see
+ whatwg/dom#600.
+
+ Let event be the result of running the inner event creation steps with
+ eventInterface, realm, the time of the occurrence that the event is
+ signaling, and dictionary.
+
+ In macOS the time of the occurrence for input
+ actions is available via the Initialize event's {{Event/isTrusted}} attribute to true.
+
+ Return event.
+ Create an event is meant to be used by other specifications which need to
+separately create and dispatch events, instead of simply
+firing them. It ensures the event's attributes are initialized to the
+correct defaults. The inner event creation steps, given an interface,
+realm, time, and dictionary, are as follows: Let event be the result of creating a new object using eventInterface. If
+ realm is non-null, then use that Realm; otherwise, use the default behavior defined in
+ Web IDL.
+
+ As of the time of this writing Web IDL does not yet define any default behavior;
+ see heycam/webidl#135.
+
+ Set event's initialized flag.
+
+ Initialize event's {{Event/timeStamp}} attribute to a {{DOMHighResTimeStamp}}
+ representing the high resolution time from the time origin to time.
+
+ User agents should set a minimum resolution of event's
+ {{Event/timeStamp}} attribute to 5 microseconds following the existing clock resolution
+ recommendation. [[!HR-TIME]]
+
+ For each member → value in dictionary, if
+ event has an attribute whose identifier is member, then
+ initialize that attribute to value.
+
+ Run the event constructing steps with event.
+
+ Return event.
+ An {{EventTarget}} object represents a target to which an event can be dispatched
+when something has occurred.
+
+ Each {{EventTarget}} object has an associated event listener list (a
+list of zero or more event listeners). It is initially the empty list.
+
+
+ An event listener can be used to observe a specific
+event and consists of:
+
+ Although callback is an {{EventListener}}
+object, an event listener is a broader concept as can be seen above.
+
+ Each {{EventTarget}} object also has an associated get the parent algorithm,
+which takes an event event, and returns an {{EventTarget}} object. Unless
+specified otherwise it returns null.
+
+ Nodes, shadow roots, and documents
+override the get the parent algorithm.
+
+ Each {{EventTarget}} object can have an associated
+activation behavior algorithm. The
+activation behavior algorithm is passed an event, as indicated in the
+dispatch algorithm. This exists because user agents perform certain actions for certain
+{{EventTarget}} objects, e.g., the <{area}> element, in response to synthetic {{MouseEvent}}
+events whose {{Event/type}} attribute is Each {{EventTarget}} object that has activation behavior, can additionally
+have both (not either) a legacy-pre-activation behavior algorithm
+and a legacy-canceled-activation behavior algorithm.
+
+ These algorithms only exist for checkbox and radio <{input}> elements and
+are not to be used for anything else. [[!HTML]]
+
+ Creates a new {{EventTarget}} object, which can be used by developers to dispatch and
+ listen for events.
+
+ Appends an event listener for events whose {{Event/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 {{EventListenerOptions/capture}}.
+
+ When set to true, options's {{EventListenerOptions/capture}} prevents
+ callback from being invoked when the event's
+ {{Event/eventPhase}} attribute value is {{Event/BUBBLING_PHASE}}. When false (or not present),
+ callback will not be invoked when event's {{Event/eventPhase}}
+ attribute value is {{Event/CAPTURING_PHASE}}. Either way, callback
+ will be invoked if event's {{Event/eventPhase}} attribute value is {{Event/AT_TARGET}}.
+
+ When set to true, options's {{AddEventListenerOptions/passive}} indicates that the
+ callback will not cancel the event by invoking
+ {{Event/preventDefault()}}. This is used to enable performance optimizations described in
+ [[#observing-event-listeners]].
+
+ When set to true, options's {{AddEventListenerOptions/once}} indicates that the
+ callback will only be invoked once after which the event listener will
+ be removed.
+
+ The event listener is appended to target's
+ event listener list and is not appended if it has the same
+ type, callback, and
+ capture.
+
+ Removes the event listener in target's
+ event listener list with the same type, callback, and
+ options.
+
+ Dispatches a synthetic event event to target and returns true
+ if either event's {{Event/cancelable}} attribute value is false or its
+ {{Event/preventDefault()}} method was not invoked, and false otherwise.
+ To flatten options, run these
+steps:
+
+ If options is a boolean, then return options.
+
+ Return options's To flatten more options, run these
+steps:
+
+ Let capture be the result of flattening options.
+
+ Let once and passive be false.
+
+ If options is a dictionary, then set passive to options's
+ Return capture, passive, and once.
+ The Because of the defaults stated elsewhere, the returned {{EventTarget}}'s
+get the parent algorithm will return null, and it will have no activation behavior,
+legacy-pre-activation behavior, or legacy-canceled-activation behavior.
+
+ In the future we could allow custom get the parent algorithms. Let us know
+if this would be useful for your programs. For now, all author-created {{EventTarget}}s do not
+participate in a tree structure. To add an event listener, given an {{EventTarget}} object
+eventTarget and an event listener listener, run these steps:
+
+ If eventTarget is a {{ServiceWorkerGlobalScope}} object, its
+ service worker's
+ script resource's
+ has ever been evaluated flag is set, and listener's
+ type matches the {{Event/type}} attribute value of any of the
+ service worker events, then report a warning to the console that this might not give
+ the expected results. [[!SERVICE-WORKERS]]
+
+ If listener's callback is null, then return.
+
+ If eventTarget's event listener list does not contain an
+ event listener whose type is listener's
+ type, callback is listener's
+ callback, and capture is
+ listener's capture, then append
+ listener to eventTarget's event listener list.
+ The add an event listener concept exists to ensure event handlers use
+the same code path. [[HTML]]
+
+ The
+ Let capture, passive, and once be the result of
+ flattening more options.
+
+ Add an event listener with this and an event listener whose
+ type is type, callback is
+ callback, capture is capture,
+ passive is passive, and once is
+ once.
+ To remove an event listener, given an {{EventTarget}} object
+eventTarget and an event listener listener, run these steps:
+
+ If eventTarget is a {{ServiceWorkerGlobalScope}} object and its
+ service worker's
+ set of event types to handle contains type, then
+ report a warning to the console that this might not give the expected results.
+ [[!SERVICE-WORKERS]]
+
+ Set listener's removed to true and
+ remove listener from eventTarget's
+ event listener list.
+ HTML needs this to define event handlers. [[HTML]]
+
+ To remove all event listeners, given an {{EventTarget}} object
+eventTarget, for each listener of eventTarget's
+event listener list, remove an event listener with
+eventTarget and listener.
+
+ HTML needs this to define The
+ Let capture be the result of flattening options.
+
+ If this's event listener list contains an
+ event listener whose type is type,
+ callback is callback, and
+ capture is capture, then remove an event listener
+ with this and that event listener.
+ The event listener list will not contain multiple event listeners with equal
+type, callback, and capture, as add an event listener
+prevents that.
+
+ The If event's dispatch flag is set, or if its initialized flag is not
+ set, then throw an "{{InvalidStateError!!exception}}" {{DOMException}}.
+
+ Initialize event's {{Event/isTrusted}} attribute to false.
+
+ Return the result of dispatching event to this.
+ In general, developers do not expect the presence of an event listener to be observable.
+The impact of an event listener is determined by its callback. That is, a developer
+adding a no-op event listener would not expect it to have any side effects.
+
+ Unfortunately, some event APIs have been designed such that implementing them efficiently
+requires observing event listeners. This can make the presence of listeners observable in
+that even empty listeners can have a dramatic performance impact on the behavior of the application.
+For example, touch and wheel events which can be used to block asynchronous scrolling. In some cases
+this problem can be mitigated by specifying the event to be {{Event/cancelable}} only when there is
+at least one non-{{AddEventListenerOptions/passive}} listener. For example,
+non-{{AddEventListenerOptions/passive}} {{TouchEvent}} listeners must block scrolling, but if all
+listeners are {{AddEventListenerOptions/passive}} then scrolling can be allowed to start
+in parallel by making the {{TouchEvent}} uncancelable (so that calls to
+{{Event/preventDefault()}} are ignored). So code dispatching an event is able to observe the absence
+of non-{{AddEventListenerOptions/passive}} listeners, and use that to clear the {{Event/cancelable}}
+property of the event being dispatched.
+
+ Ideally, any new event APIs are defined such that they do not need this property (use
+public-script-coord@w3.org
+for discussion).
+
+
+ To dispatch an event to a
+target, with an optional legacy target override flag and an optional
+legacyOutputDidListenersThrowFlag, run these steps:
+
+ Set event's dispatch flag.
+
+ Let targetOverride be target, if legacy target override flag
+ is not given, and target's associated legacy target override flag is only used by HTML and only when
+ target is a {{Window}} object.
+
+ Let activationTarget be null.
+
+ Let relatedTarget be the result of retargeting event's
+ relatedTarget against target.
+
+ If target is not relatedTarget or target is event's
+ relatedTarget, then:
+
+ Let touchTargets be a new list.
+
+ For each touchTarget of event's
+ touch target list, append the result of retargeting
+ touchTarget against target to touchTargets.
+
+ Append to an event path with event, target,
+ targetOverride, relatedTarget, touchTargets, and false.
+
+ Let isActivationEvent be true, if event is a {{MouseEvent}} object
+ and event's {{Event/type}} attribute is " If isActivationEvent is true and target has
+ activation behavior, then set activationTarget to
+ target.
+
+ Let slottable be target, if target is a slottable
+ and is assigned, and null otherwise.
+
+ Let slot-in-closed-tree be false.
+
+ Let parent be the result of invoking target's get the parent
+ with event.
+
+ While parent is non-null: If slottable is non-null:
+
+ Assert: parent is a slot.
+
+ Set slottable to null.
+
+ If parent's root is a shadow root whose
+ mode is " If parent is a slottable and is assigned, then
+ set slottable to parent.
+
+ Let relatedTarget be the result of retargeting event's
+ relatedTarget against parent.
+
+ Let touchTargets be a new list.
+
+ For each touchTarget of event's
+ touch target list, append the result of retargeting
+ touchTarget against parent to touchTargets.
+
+ If parent is a {{Window}} object, or parent is a node and
+ target's root is a shadow-including inclusive ancestor of
+ parent, then:
+
+ If isActivationEvent is true, event's {{Event/bubbles}}
+ attribute is true, activationTarget is null, and parent has
+ activation behavior, then set activationTarget to
+ parent.
+
+ Append to an event path with event, parent, null,
+ relatedTarget, touchTargets, and slot-in-closed-tree.
+ Otherwise, if parent is relatedTarget, then set parent
+ to null.
+
+ Otherwise, set target to parent and then:
+
+ If isActivationEvent is true, activationTarget is null, and
+ target has activation behavior, then set
+ activationTarget to target.
+
+ Append to an event path with event, parent,
+ target, relatedTarget, touchTargets, and
+ slot-in-closed-tree.
+ If parent is non-null, then set parent to the result of invoking
+ parent's get the parent with event.
+
+ Set slot-in-closed-tree to false.
+ Let clearTargetsStruct be the last struct in event's
+ path whose shadow-adjusted target is non-null.
+
+ Let clearTargets be true if clearTargetsStruct's
+ shadow-adjusted target, clearTargetsStruct's
+ relatedTarget, or an {{EventTarget}} object in
+ clearTargetsStruct's touch target list is a node
+ and its root is a shadow root, and false otherwise.
+
+ If activationTarget is non-null and activationTarget has
+ legacy-pre-activation behavior, then run activationTarget's
+ legacy-pre-activation behavior.
+
+ For each struct in event's path, in
+ reverse order:
+
+ If struct's shadow-adjusted target is non-null, then
+ set event's {{Event/eventPhase}} attribute to {{Event/AT_TARGET}}.
+
+ Otherwise, set event's {{Event/eventPhase}} attribute to
+ {{Event/CAPTURING_PHASE}}.
+
+ Invoke with struct, event, " For each struct in event's path:
+
+ If struct's shadow-adjusted target is non-null, then
+ set event's {{Event/eventPhase}} attribute to {{Event/AT_TARGET}}.
+
+ Otherwise:
+
+ If event's {{Event/bubbles}} attribute is false, then
+ continue.
+
+ Set event's {{Event/eventPhase}} attribute to {{Event/BUBBLING_PHASE}}.
+ Invoke with struct, event, " Set event's {{Event/eventPhase}} attribute to {{Event/NONE}}.
+
+ Set event's {{Event/currentTarget}} attribute to null.
+
+ Set event's path to the empty list.
+
+ Unset event's dispatch flag, stop propagation flag, and
+ stop immediate propagation flag.
+
+ If clearTargets, then:
+
+ Set event's target to null.
+
+ Set event's relatedTarget to null.
+
+ Set event's touch target list to the empty list.
+ If activationTarget is non-null, then:
+
+ If event's canceled flag is unset, then run
+ activationTarget's activation behavior with event.
+
+ Otherwise, if activationTarget has
+ legacy-canceled-activation behavior, then run
+ activationTarget's legacy-canceled-activation behavior.
+ Return false if event's canceled flag is set, and true otherwise.
+ To append to an event path, given an
+event, invocationTarget, shadowAdjustedTarget,
+relatedTarget, touchTargets, and a slot-in-closed-tree, run these
+steps: Let invocationTargetInShadowTree be false.
+
+ If invocationTarget is a node and its root is a
+ shadow root, then set invocationTargetInShadowTree to true.
+
+ Let root-of-closed-tree be false.
+
+ If invocationTarget is a shadow root whose mode
+ is " Append a new struct to event's path
+ whose invocation target is invocationTarget,
+ invocation-target-in-shadow-tree is invocationTargetInShadowTree,
+ shadow-adjusted target is shadowAdjustedTarget,
+ relatedTarget is relatedTarget,
+ touch target list is touchTargets,
+ root-of-closed-tree is root-of-closed-tree, and
+ slot-in-closed-tree is slot-in-closed-tree.
+ To invoke, given a struct,
+event, phase, and an optional legacyOutputDidListenersThrowFlag,
+run these steps:
+
+ Set event's target to the
+ shadow-adjusted target of the last struct in event's
+ path, that is either struct or preceding struct, whose
+ shadow-adjusted target is non-null.
+
+ Set event's relatedTarget to struct's
+ relatedTarget.
+
+ Set event's touch target list to struct's
+ touch target list.
+
+ If event's stop propagation flag is set, then return.
+
+ Initialize event's {{Event/currentTarget}} attribute to struct's
+ invocation target.
+
+ Let listeners be a clone of event's
+ {{Event/currentTarget}} attribute value's event listener list.
+
+ This avoids event listeners added after this point from being
+ run. Note that removal still has an effect due to the removed field.
+
+ Let found be the result of running inner invoke with event,
+ listeners, phase, and legacyOutputDidListenersThrowFlag if given.
+
+ If found is false and event's {{Event/isTrusted}} attribute is true,
+ then:
+
+ Let originalEventType be event's {{Event/type}} attribute value.
+
+ If event's {{Event/type}} attribute value is a match for any of the strings in the
+ first column in the following table, set event's {{Event/type}} attribute value to
+ the string in the second column on the same row as the matching string, and return otherwise.
+
+ Inner invoke with event, listeners, phase, and
+ legacyOutputDidListenersThrowFlag if given.
+
+ Set event's {{Event/type}} attribute value to originalEventType.
+ To inner invoke, given an
+event, listeners, phase, and an optional
+legacyOutputDidListenersThrowFlag, run these steps:
+
+ Let found be false.
+
+ For each listener in listeners, whose
+ removed is false:
+
+ If event's {{Event/type}} attribute value is not listener's
+ type, then continue.
+
+ Set found to true.
+
+ If phase is " If phase is " If listener's once is true, then
+ remove listener from event's {{Event/currentTarget}}
+ attribute value's event listener list.
+
+
+ Let global be listener callback's
+ associated Realm's global object.
+
+ Let currentEvent be undefined.
+
+ If global is a {{Window}} object, then:
+
+ Set currentEvent to global's current event.
+
+ If struct's invocation-target-in-shadow-tree is false,
+ then set global's current event to event.
+ If listener's passive is true, then set
+ event's in passive listener flag.
+
+ Call a user object's operation with listener's
+ callback, " Report the exception.
+
+ Set legacyOutputDidListenersThrowFlag if given.
+
+ The legacyOutputDidListenersThrowFlag is only used by Indexed
+ Database API. [[INDEXEDDB]]
+ Unset event's in passive listener flag.
+
+ If global is a {{Window}} object, then set global's
+ current event to currentEvent.
+
+ If event's stop immediate propagation flag is set, then return
+ found.
+ Return found.
+ To fire an event named e at target,
+optionally using an eventConstructor, with a description of how IDL attributes are to be
+initialized, and a legacy target override flag, run these steps:
+
+ If eventConstructor is not given, then let eventConstructor be
+ {{Event}}.
+
+ Let event be the result of creating an event given
+ eventConstructor, in the relevant Realm of target.
+
+ Initialize event's {{Event/type}} attribute to e.
+
+ Initialize any other IDL attributes of event as described in the invocation of this
+ algorithm.
+
+ This also allows for the {{Event/isTrusted}} attribute to be set to false.
+
+ Return the result of dispatching event at target, with
+ legacy target override flag set if set.
+ Fire in the context of DOM is short for
+creating, initializing, and dispatching an event.
+Fire an event makes that process easier to write down.
+
+ If the event needs its {{Event/bubbles}} or {{Event/cancelable}} attribute initialized,
+ one could write "fire an event named Or, when a custom constructor is needed, "fire an event named Occasionally the return value is important:
+
+ Let doAction be the result of firing an event named
+ If doAction is true, then …
+ An event signifies an occurrence, not an action. Phrased differently, it
+represents a notification from an algorithm and can be used to influence the future course
+of that algorithm (e.g., through invoking {{Event/preventDefault()}}). Events must not be
+used as actions or initiators that cause some algorithm to start running. That is not what
+they are for.
+
+ This is called out here specifically because previous
+iterations of the DOM had a concept of "default actions" associated with events
+that gave folks all the wrong ideas. Events do not represent or cause actions, they
+can only be used to influence an ongoing one.
+
+
+
+ Though promises do not have a built-in aborting mechanism, many APIs using them require abort
+semantics. {{AbortController}} is meant to support these requirements by providing an
+{{AbortController/abort()}} method that toggles the state of a corresponding {{AbortSignal}} object.
+The API which wishes to support aborting can accept an {{AbortSignal}} object, and use its state to
+determine how to proceed.
+
+ APIs that rely upon {{AbortController}} are encouraged to respond to {{AbortController/abort()}}
+by rejecting any unsettled promise with a new "{{AbortError!!exception}}" {{DOMException}}.
+
+ A hypothetical APIs that require more granular control could extend both {{AbortController}} and
+ {{AbortSignal}} objects according to their needs.
+ An {{AbortController}} object has an associated signal (an
+{{AbortSignal}} object).
+
+ The Let signal be a new {{AbortSignal}} object.
+
+ Let controller be a new {{AbortController}} object whose
+ signal is signal.
+
+ Return controller.
+ The The An {{AbortSignal}} object has an associated aborted flag. It is
+unset unless specified otherwise.
+
+ An {{AbortSignal}} object has associated abort algorithms, which is a
+set of algorithms which are to be executed when its [=AbortSignal/aborted flag=] is
+set. Unless specified otherwise, its value is the empty set.
+
+ To add an algorithm algorithm to an {{AbortSignal}}
+object signal, run these steps:
+
+ If signal's aborted flag is set, then return.
+
+ Append algorithm to signal's
+ abort algorithms.
+ To remove an algorithm algorithm from an
+{{AbortSignal}} signal, remove algorithm from
+signal's abort algorithms.
+
+ The [=AbortSignal/abort algorithms=] enable APIs with complex
+requirements to react in a reasonable way to {{AbortController/abort()}}. For example, a given API's
+[=AbortSignal/aborted flag=] might need to be propagated to a cross-thread environment, such as a
+service worker.
+
+ The aborted attribute's getter, when invoked, must return
+true if this's [=AbortSignal/aborted flag=] is set, and false otherwise.
+
+ The Changes to an {{AbortSignal}} object represent the wishes of the corresponding
+{{AbortController}} object, but an API observing the {{AbortSignal}} object can chose to ignore
+them. For instance, if the operation has already completed.
+
+ To signal abort, given a {{AbortSignal}} object
+signal, run these steps:
+
+ If signal's [=AbortSignal/aborted flag=] is set, then return.
+
+ Set signal's [=AbortSignal/aborted flag=].
+
+ For each algorithm in signal's
+ [=AbortSignal/abort algorithms=]: run algorithm.
+
+ Empty signal's abort algorithms.
+
+ [=Fire an event=] named {{AbortSignal/abort}} at signal.
+ A followingSignal (an {{AbortSignal}}) is made to
+follow a parentSignal (an {{AbortSignal}}) by running
+these steps:
+
+ If followingSignal's [=AbortSignal/aborted flag=] is set, then return.
+
+ If parentSignal's [=AbortSignal/aborted flag=] is set, then
+ signal abort on followingSignal.
+
+ Otherwise, add the following abort steps to
+ parentSignal:
+
+ Signal abort on followingSignal.
+ Any web platform API using promises to represent operations that can be aborted must adhere to
+the following:
+
+ The steps for a promise-returning method Let |p| be [=a new promise=].
+
+ If |options|' If |options|' [=AbortSignal/Add|Add the following abort steps=] to |options|' Stop doing amazing things.
+
+ [=Reject=] |p| with an "{{AbortError!!exception}}" {{DOMException}}.
+ Run these steps [=in parallel=]:
+
+ Let |amazingResult| be the result of doing some amazing things.
+
+ [=/Resolve=] |p| with |amazingResult|.
+ Return |p|.
+ APIs not using promises should still adhere to the above as much as possible.
+
+
+
+ Each such document is represented as a node tree. Some of the nodes in a
+tree can have children, while others are always leaves.
+
+To illustrate, consider this HTML document:
+
+ Note that, due to the magic that is HTML parsing, not all
+ASCII whitespace were turned into {{Text}} nodes, but the general concept is
+clear. Markup goes in, a tree of nodes comes out.
+
+
+ The most excellent
+Live DOM Viewer
+can be used to explore this matter in more detail.
+
+
+ {{Document}}, {{DocumentType}}, {{DocumentFragment}}, {{Element}}, {{Text}},
+{{ProcessingInstruction}}, and {{Comment}} objects (simply called
+nodes) participate in a tree, simply named the
+node tree.
+
+ A node tree is constrained as follows, expressed as a relationship between the type of
+node and its allowed children:
+
+ In tree order:
+ Zero or more nodes each of which is {{ProcessingInstruction}} or {{Comment}}.
+ Optionally one {{DocumentType}} node.
+ Zero or more nodes each of which is {{ProcessingInstruction}} or {{Comment}}.
+ Optionally one {{Element}} node.
+ Zero or more nodes each of which is {{ProcessingInstruction}} or {{Comment}}.
+ Zero or more nodes each of which is {{Element}}, {{Text}}, {{ProcessingInstruction}}, or
+ {{Comment}}.
+ None.
+ To determine the length of a node
+node, switch on node:
+
+ Zero.
+
+ Its number of children.
+ A node is considered empty if its
+length is zero.
+
+
+ A document tree is a node tree whose
+root is a document.
+
+ The document element of a document is the element whose
+parent is that document, if it exists, and null otherwise.
+
+ Per the node tree constraints, there can be only one such
+element.
+
+ An element is in a document tree if its root is a
+document.
+
+ An element is in a document if it is in a document tree.
+The term in a document is no longer supposed to be used. It indicates that
+the standard using it has not been updated to account for shadow trees.
+
+
+ A shadow tree is a node tree whose
+root is a shadow root.
+
+ A shadow root is always attached to another node tree through its
+host. A shadow tree is therefore never alone. The
+node tree of a shadow root's host is sometimes
+referred to as the light tree. A shadow tree's corresponding light tree can be a shadow tree
+itself. An element is connected if its
+shadow-including root is a document.
+
+ A shadow tree contains zero or more elements that are
+slots. A slot can only be created through HTML's <{slot}> element. A slot has an associated name (a string). Unless stated
+otherwise it is the empty string. Use these attribute change steps to update a slot's name:
+
+ If element is a slot, localName is If value is oldValue, then return.
+
+ If value is null and oldValue is the empty string, then return.
+
+ If value is the empty string and oldValue is null, then return.
+
+ If value is null or the empty string, then set element's
+ name to the empty string.
+
+ Otherwise, set element's name to value.
+
+ Run assign slottables for a tree with element's root.
+ The first slot in a shadow tree, in tree order, whose
+name is the empty string, is sometimes known as the "default slot". A slot has an associated assigned nodes (a list of
+slottables). Unless stated otherwise it is empty. {{Element}} and {{Text}} nodes are
+slottables. A slot can be a slottable.
+
+ A slottable has an associated name (a
+string). Unless stated otherwise it is the empty string. Use these attribute change steps to update a slottable's name:
+
+ If localName is If value is oldValue, then return.
+
+ If value is null and oldValue is the empty string, then return.
+
+ If value is the empty string and oldValue is null, then return.
+
+ If value is null or the empty string, then set element's
+ name to the empty string.
+
+ Otherwise, set element's name to value.
+
+ If element is assigned, then run assign slottables
+ for element's assigned slot.
+
+ Run assign a slot for element.
+ A slottable has an associated
+assigned slot (null or a slot).
+Unless stated otherwise it is null. A slottable is
+assigned if its assigned slot is
+non-null. To find a slot for a given slottable
+slottable and an optional open flag (unset unless stated otherwise), run these
+steps: If slottable's parent is null, then return null. Let shadow be slottable's parent's
+ shadow root. If shadow is null, then return null. If the open flag is set and shadow's mode is
+ not " Return the first slot in tree order in shadow's
+ descendants whose name is slottable's
+ name, if any, and null otherwise. To find slottables
+for a given slot slot, run these steps: Let result be an empty list. If slot's root is not a shadow root, then return
+ result. For each slottable child of host, slottable, in
+ tree order: Let foundSlot be the result of finding a slot given
+ slottable. If foundSlot is slot, then append slottable to
+ result. Return result. To
+find flattened slottables
+for a given slot slot, run these steps: Let result be an empty list. If slot's root is not a shadow root, then return
+ result. Let slottables be the result of finding slottables given
+ slot. If slottables is the empty list, then append each slottable
+ child of slot, in tree order, to slottables. For each node in slottables:
+
+ If node is a slot whose root is a shadow root,
+ then:
+
+ Let temporaryResult be the result of finding flattened slottables given
+ node. Append each slottable in temporaryResult, in order, to
+ result. Otherwise, append node to result. Return result. To assign slottables for a slot slot,
+run these steps:
+
+ Let slottables be the result of finding slottables for slot.
+
+ If slottables and slot's assigned nodes are not
+ identical, then run signal a slot change for slot.
+
+ Set slot's assigned nodes to slottables.
+
+ For each slottable in slottables, set slottable's
+ assigned slot to slot.
+ To assign slottables for a tree, given a
+node root, run assign slottables for each slot slot
+in root's inclusive descendants, in tree order.
+
+ To assign a slot, given a slottable slottable, run these
+steps:
+
+ Let slot be the result of finding a slot with slottable.
+
+ If slot is non-null, then run assign slottables for slot.
+ Each similar-origin window agent has signal slots
+(a set of slots), which is initially empty. [[!HTML]]
+
+ To signal a slot change, for a slot slot, run these steps:
+
+ Append slot to slot's relevant agent's
+ signal slots.
+
+ To
+ensure pre-insertion validity
+of a node into a parent before a child, run these steps:
+
+ If parent is not a {{Document}}, {{DocumentFragment}}, or {{Element}}
+ node, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If node is a host-including inclusive ancestor of parent, then
+ throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If child is non-null and its parent is not parent,
+ then throw a "{{NotFoundError!!exception}}" {{DOMException}}.
+
+ If node is not a {{DocumentFragment}}, {{DocumentType}}, {{Element}}, {{Text}},
+ {{ProcessingInstruction}}, or {{Comment}} node, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If either node is a {{Text}} node and parent is a
+ document, or node is a doctype and parent is not a
+ document, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If parent is a document, and any of the statements below, switched on
+ node, are true, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If node has more than one element child or has a
+ {{Text}} node child.
+
+ Otherwise, if node has one element child and either
+ parent has an element child, child is a
+ doctype, or child is non-null and a doctype is following
+ child.
+
+
+ parent has an element child, child is
+ a doctype, or child is non-null and a doctype is following
+ child.
+
+
+ parent has a doctype child, child is non-null
+ and an element is preceding child, or child is null
+ and parent has an element child.
+ To pre-insert a node into a
+parent before a child, run these steps:
+
+ Ensure pre-insertion validity of node into parent before
+ child.
+
+ Let referenceChild be child.
+
+ If referenceChild is node, then set referenceChild to
+ node's next sibling.
+
+ Insert node into parent before referenceChild.
+
+ Return node.
+
+ Specifications may define
+insertion steps for all or some nodes. The
+algorithm is passed insertedNode, as indicated in the insert
+algorithm below.
+
+
+ Specifications may define
+children changed steps for all or some
+nodes. The algorithm is passed no argument and is called from insert,
+remove, and replace data.
+
+ To insert a node into a parent
+before a child, with an optional suppress observers flag, run these steps:
+
+ Let nodes be node's children, if node is a
+ {{DocumentFragment}} node; otherwise « node ».
+
+ Let count be nodes's size.
+
+ If count is 0, then return.
+
+ If node is a {{DocumentFragment}} node, then:
+
+ Remove its children with the suppress observers flag set.
+
+ Queue a tree mutation record for node with « », nodes, null, and
+ null.
+
+ This step intentionally does not pay attention to the
+ suppress observers flag.
+ If child is non-null, then:
+
+ For each live range whose start node is parent and
+ start offset is greater than child's index, increase
+ its start offset by count.
+
+ For each live range whose end node is parent and
+ end offset is greater than child's index, increase
+ its end offset by count.
+ Let previousSibling be child's previous sibling or
+ parent's last child if child is null.
+
+ For each node in nodes, in tree order:
+
+ Adopt node into parent's node document.
+
+ If child is null, then append node to
+ parent's children.
+
+ Otherwise, insert node into parent's
+ children before child's index.
+
+ If parent is a shadow host and node is a
+ slottable, then assign a slot for node.
+
+ If parent's root is a shadow root, and
+ parent is a slot whose assigned nodes is the empty list,
+ then run signal a slot change for parent.
+
+ Run assign slottables for a tree with node's root.
+
+ For each shadow-including inclusive descendant inclusiveDescendant of
+ node, in shadow-including tree order:
+
+ Run the insertion steps with inclusiveDescendant.
+
+ If inclusiveDescendant is connected, then:
+
+ If inclusiveDescendant is custom, then
+ enqueue a custom element callback reaction with inclusiveDescendant,
+ callback name " Otherwise, try to upgrade
+ inclusiveDescendant.
+
+ If this successfully upgrades inclusiveDescendant, its
+ If suppress observers flag is unset, then queue a tree mutation record for
+ parent with nodes, « », previousSibling, and child.
+
+ Run the children changed steps for parent.
+ To append a node to a parent,
+pre-insert node into parent before null.
+
+
+ To replace a child with node
+within a parent, run these steps:
+
+
+
+ If parent is not a {{Document}}, {{DocumentFragment}}, or {{Element}}
+ node, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If node is a host-including inclusive ancestor of parent, then
+ throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If child's parent is not parent, then throw a
+ "{{NotFoundError!!exception}}" {{DOMException}}.
+
+ If node is not a {{DocumentFragment}}, {{DocumentType}}, {{Element}}, {{Text}},
+ {{ProcessingInstruction}}, or {{Comment}} node, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If either node is a {{Text}} node and parent is a
+ document, or node is a doctype and parent is not a
+ document, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If parent is a document, and any of the statements below, switched on
+ node, are true, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If node has more than one element child or has a
+ {{Text}} node child.
+
+ Otherwise, if node has one element child and either
+ parent has an element child that is not
+ child or a doctype is following child.
+
+ parent has an element child that is not
+ child or a doctype is following child.
+
+ parent has a doctype child that is not child,
+ or an element is preceding child.
+ The above statements differ from the pre-insert algorithm.
+
+ Let referenceChild be child's next sibling.
+
+ If referenceChild is node, then set referenceChild to
+ node's next sibling.
+
+ Let previousSibling be child's previous sibling.
+
+ Let removedNodes be the empty set.
+
+ If child's parent is non-null, then:
+
+ Set removedNodes to « child ».
+
+ Remove child with the suppress observers flag set.
+ The above can only be false if child is node.
+
+ Let nodes be node's children if node is a
+ {{DocumentFragment}} node; otherwise « node ».
+
+
+ Insert node into parent before referenceChild
+ with the suppress observers flag set.
+
+ Queue a tree mutation record for parent with nodes,
+ removedNodes, previousSibling, and referenceChild.
+
+ Return child.
+ To replace all with a node
+within a parent, run these steps:
+
+ Let removedNodes be parent's children.
+
+ Let addedNodes be the empty set.
+
+ If node is a {{DocumentFragment}} node, then set addedNodes to
+ node's children.
+
+ Otherwise, if node is non-null, set addedNodes to « node ».
+
+ Remove all parent's children, in tree order, with the
+ suppress observers flag set.
+
+ If node is non-null, then insert node into
+ parent before null with the suppress observers flag set.
+
+ If either addedNodes or removedNodes is not empty,
+ then queue a tree mutation record for parent with addedNodes,
+ removedNodes, null, and null.
+ This algorithm does not make any checks with regards to the
+node tree constraints. Specification authors need to use it wisely.
+
+
+ To pre-remove a child from a
+parent, run these steps:
+
+ If child's parent is not parent, then throw a
+ "{{NotFoundError!!exception}}" {{DOMException}}.
+
+ Remove child.
+
+ Return child.
+
+ Specifications may define
+removing steps for all or some nodes. The
+algorithm is passed removedNode, and optionally oldParent, as
+indicated in the remove algorithm below.
+
+ To remove a node, with an optional
+suppress observers flag, run these steps:
+
+ Let parent be node's parent
+
+ Assert: parent is non-null.
+
+ Let index be node's index.
+
+ For each live range whose start node is an
+ inclusive descendant of node, set its start to
+ (parent, index).
+
+ For each live range whose end node is an inclusive descendant
+ of node, set its end to (parent, index).
+
+ For each live range whose start node is parent and
+ start offset is greater than index, decrease its
+ start offset by 1.
+
+ For each live range whose end node is parent and
+ end offset is greater than index, decrease its
+ end offset by 1.
+
+ For each {{NodeIterator}} object iterator whose
+ root's node document is node's
+ node document, run the Let oldPreviousSibling be node's previous sibling.
+
+ Let oldNextSibling be node's next sibling.
+
+ If node is assigned, then run assign slottables for
+ node's assigned slot.
+
+ If parent's root is a shadow root, and
+ parent is a slot whose assigned nodes is the empty list,
+ then run signal a slot change for parent.
+
+ If node has an inclusive descendant that is a slot, then:
+
+ Run assign slottables for a tree with parent's root.
+
+ Run assign slottables for a tree with node.
+ Run the removing steps with node and parent.
+
+ Let isParentConnected be parent's connected.
+
+ If node is custom and isParentConnected is true, then
+ enqueue a custom element callback reaction with node, callback name
+ " It is intentional for now that custom elements do
+ not get parent passed. This might change in the future if there is a need.
+
+ For each shadow-including descendant descendant of node, in
+ shadow-including tree order, then:
+
+ Run the removing steps with descendant.
+
+ If descendant is custom and isParentConnected
+ is true, then enqueue a custom element callback reaction with descendant,
+ callback name " For each inclusive ancestor inclusiveAncestor of
+ parent, and then for each registered of
+ inclusiveAncestor's registered observer list, if registered's
+ options's {{MutationObserverInit/subtree}} is true, then
+ append a new transient registered observer whose
+ observer is registered's
+ observer, options is
+ registered's options, and
+ source is registered to node's
+ registered observer list.
+
+ If suppress observers flag is unset, then queue a tree mutation record for
+ parent with « », « node », oldPreviousSibling, and
+ oldNextSibling.
+
+ Run the children changed steps for parent.
+ Web compatibility prevents the {{NonElementParentNode/getElementById()}}
+method from being exposed on elements (and therefore on {{ParentNode}}).
+
+ Returns the first element within node's descendants whose
+ ID is elementId.
+ The The {{DocumentOrShadowRoot}} mixin is expected to be used by other
+standards that want to define APIs shared between documents and
+shadow roots.
+
+
+ To convert nodes into a node, given
+nodes and document, run these steps:
+
+ Let node be null.
+
+ Replace each string in nodes with a new {{Text}} node whose
+ data is the string and node document is
+ document.
+
+ Otherwise, set node to a new {{DocumentFragment}} whose
+ node document is document, and then append each node in
+ nodes, if any, to it.
+
+ Return node.
+ Inserts nodes before the first child of node, while
+ replacing strings in nodes with equivalent {{Text}} nodes.
+
+ Throws a "{{HierarchyRequestError!!exception}}" {{DOMException}} if the constraints of
+ the node tree are violated.
+
+
+ Inserts nodes after the last child of node, while replacing
+ strings in nodes with equivalent {{Text}} nodes.
+
+ Throws a "{{HierarchyRequestError!!exception}}" {{DOMException}} if the constraints of
+ the node tree are violated.
+
+
+ Replace all children of node with nodes,
+ while replacing strings in nodes with equivalent {{Text}} nodes.
+
+ Throws a "{{HierarchyRequestError!!exception}}" {{DOMException}} if the constraints of
+ the node tree are violated.
+
+
+ The The The The The Let node be the result of converting nodes into a node given
+ nodes and this's node document.
+
+ Pre-insert node into this before this's
+ first child.
+ The Let node be the result of converting nodes into a node given
+ nodes and this's node document.
+
+ The Let node be the result of converting nodes into a node given
+ nodes and this's node document.
+
+ Ensure pre-insertion validity of node into this before
+ null.
+
+ Replace all with node within this.
+ The The Web compatibility prevents the {{previousElementSibling}} and
+{{nextElementSibling}} attributes from being exposed on doctypes (and therefore on
+{{ChildNode}}).
+
+ The The Inserts nodes just before node, while replacing strings in
+ nodes with equivalent {{Text}} nodes.
+
+ Throws a "{{HierarchyRequestError!!exception}}" {{DOMException}} if the constraints of
+ the node tree are violated.
+
+ Inserts nodes just after node, while replacing strings in
+ nodes with equivalent {{Text}} nodes.
+
+ Throws a "{{HierarchyRequestError!!exception}}" {{DOMException}} if the constraints of
+ the node tree are violated.
+
+ Replaces node with nodes, while replacing strings in nodes
+ with equivalent {{Text}} nodes.
+
+ Throws a "{{HierarchyRequestError!!exception}}" {{DOMException}} if the constraints of
+ the node tree are violated.
+
+ The If parent is null, then return.
+
+ Let viablePreviousSibling be this's first preceding
+ sibling not in nodes, and null otherwise.
+
+ Let node be the result of converting nodes into a node, given
+ nodes and this's node document.
+
+ If viablePreviousSibling is null, set it to parent's
+ first child, and to viablePreviousSibling's next sibling
+ otherwise.
+
+ Pre-insert node into parent before
+ viablePreviousSibling.
+ The If parent is null, then return.
+
+ Let viableNextSibling be this's first following
+ sibling not in nodes, and null otherwise.
+
+ Let node be the result of converting nodes into a node, given
+ nodes and this's node document.
+
+ Pre-insert node into parent before
+ viableNextSibling.
+ The If parent is null, then return.
+
+ Let viableNextSibling be this's first following
+ sibling not in nodes, and null otherwise.
+
+ Let node be the result of converting nodes into a node, given
+ nodes and this's node document.
+
+ If this's parent is parent, replace this with
+ node within parent.
+
+ This could have been inserted into node.
+
+ Otherwise, pre-insert node into parent before
+ viableNextSibling.
+ The The A {{NodeList}} object is a collection of nodes.
+
+ The object's supported property indices are the numbers in the range zero to one less than
+the number of nodes represented by the collection. If there are no such
+elements, then there are no supported property indices.
+
+ The length attribute must return the number of nodes
+represented by the collection.
+
+ The An {{HTMLCollection}} object is a collection of elements.
+
+ {{HTMLCollection}} is a historical artifact we cannot rid the web of.
+While developers are of course welcome to keep using it, new API standard designers ought not to use
+it (use The object's supported property indices are the numbers in the range zero to one less than
+the number of elements represented by the collection. If there are no such
+elements, then there are no supported property indices.
+
+ The The The supported property names are the values from the list returned by these steps:
+
+ Let result be an empty list.
+
+ For each element represented by the collection, in
+ tree order:
+
+ If element has an ID which is not in result,
+ append element's ID to result.
+
+ If element is in the HTML namespace and has
+ a Return result.
+ The If key is the empty string, return null.
+
+ Return the first element in the collection for which at least one of
+ the following is true:
+
+ or null if there is no such element.
+ Each similar-origin window agent has a
+mutation observer microtask queued
+(a boolean), which is initially false. [[!HTML]]
+
+ Each similar-origin window agent also has
+mutation observers (a set of zero or more
+{{MutationObserver}} objects), which is initially empty.
+
+ To
+queue a mutation observer microtask,
+run these steps:
+
+ If the surrounding agent's mutation observer microtask queued is true, then
+ return.
+
+ Set the surrounding agent's mutation observer microtask queued to true.
+
+ Queue a microtask to notify mutation observers.
+ To notify mutation observers, run these steps:
+
+ Set the surrounding agent's mutation observer microtask queued to false.
+
+ Let notifySet be a clone of the surrounding agent's
+ mutation observers.
+
+ Let signalSet be a clone of the surrounding agent's
+ signal slots.
+
+ Empty the surrounding agent's signal slots.
+
+ For each mo of notifySet:
+
+ Let records be a clone of mo's
+ record queue.
+
+ Empty mo's record queue.
+
+ For each node of mo's
+ node list, remove all
+ transient registered observers whose observer is
+ mo from node's registered observer list.
+
+ If records is not empty, then invoke
+ mo's callback with « records, mo »,
+ and mo. If this throws an exception, then report the exception.
+ For each slot of signalSet, fire an event
+ named {{HTMLSlotElement/slotchange}}, with its {{Event/bubbles}} attribute set to true, at
+ slot.
+ Each node has a registered observer list (a list of
+zero or more registered observers), which is initially empty.
+
+ A registered observer consists of an
+observer (a {{MutationObserver}} object) and
+options (a {{MutationObserverInit}} dictionary).
+
+ A transient registered observer is a
+registered observer that also consists of a
+source (a registered observer).
+
+ Transient registered observers are used to track mutations within
+a given node's descendants after node has been removed so
+they do not get lost when {{MutationObserverInit/subtree}} is set to true on node's
+parent.
+
+
+ A {{MutationObserver}} object can be used to observe mutations to the tree of
+nodes.
+
+ Each {{MutationObserver}} object has these associated concepts:
+
+ The
+ Let mo be a new {{MutationObserver}} object whose
+ callback is callback.
+
+ Append mo to mo's relevant agent's
+ mutation observers.
+
+ Return mo.
+ The
+ If either options's {{MutationObserverInit/attributeOldValue}} or
+ {{MutationObserverInit/attributeFilter}} is present and options's
+ {{MutationObserverInit/attributes}} is omitted, then set options's
+ {{MutationObserverInit/attributes}} to true.
+
+ If options's {{MutationObserverInit/characterDataOldValue}} is present and
+ options's {{MutationObserverInit/characterData}} is omitted, then set
+ options's {{MutationObserverInit/characterData}} to true.
+
+ If none of options's {{MutationObserverInit/childList}},
+ {{MutationObserverInit/attributes}}, and {{MutationObserverInit/characterData}} is true, then
+ throw a If options's {{MutationObserverInit/attributeOldValue}} is true and
+ options's {{MutationObserverInit/attributes}} is false, then throw a
+ If options's {{MutationObserverInit/attributeFilter}} is present and
+ options's {{MutationObserverInit/attributes}} is false, then throw a
+ If options's {{MutationObserverInit/characterDataOldValue}} is true and
+ options's {{MutationObserverInit/characterData}} is false, then throw a
+ For each registered of target's
+ registered observer list, if registered's
+ observer is this:
+
+ For each node of this's
+ node list, remove all
+ transient registered observers whose source is
+ registered from node's registered observer list.
+
+ Set registered's options to
+ options.
+ Otherwise:
+
+ Append a new registered observer whose
+ observer is this and
+ options is options to target's
+ registered observer list.
+
+ The For each node of this's
+ node list, remove any registered observer from
+ node's registered observer list for which this is the
+ observer.
+
+ Empty this's record queue.
+ The Let records be a clone of this's
+ record queue.
+
+ Empty this's record queue.
+
+ Return records.
+ To queue a mutation record of type for target with
+name, namespace, oldValue, addedNodes,
+removedNodes, previousSibling, and nextSibling, run these steps:
+
+ Let interestedObservers be an empty map.
+
+ Let nodes be the inclusive ancestors of target.
+
+ For each node in nodes, and then for each
+ registered of node's registered observer list:
+
+ Let options be registered's
+ options.
+
+ If none of the following are true
+
+ then:
+
+ Let mo be registered's observer.
+
+ If interestedObservers[mo] does not exist, then
+ set interestedObservers[mo] to null.
+
+ If either type is " For each observer → mappedOldValue of
+ interestedObservers:
+
+ Let record be a new {{MutationRecord}} object with its {{MutationRecord/type}}
+ set to type, {{MutationRecord/target}} set to target,
+ {{MutationRecord/attributeName}} set to name, {{MutationRecord/attributeNamespace}}
+ set to namespace, {{MutationRecord/oldValue}} set to mappedOldValue,
+ {{MutationRecord/addedNodes}} set to addedNodes,
+ {{MutationRecord/removedNodes}} set to removedNodes,
+ {{MutationRecord/previousSibling}} set to previousSibling, and
+ {{MutationRecord/nextSibling}} set to nextSibling.
+
+ Enqueue record to observer's
+ record queue.
+ To queue a tree mutation record for target with
+addedNodes, removedNodes, previousSibling, and
+nextSibling, run these steps:
+
+ Assert: either addedNodes or removedNodes is not empty.
+
+ Queue a mutation record of " The type, target,
+addedNodes,
+removedNodes,
+previousSibling,
+nextSibling,
+attributeName,
+attributeNamespace, and
+oldValue attributes must return the values they were
+initialized to.
+
+
+ Nodes have a strong reference to registered observers in their
+registered observer list.
+
+ Registered observers in a node's registered observer list have a weak
+reference to the node.
+
+
+ {{Node}} is an abstract interface and does not exist as node. It
+is used by all nodes ({{Document}}, {{DocumentType}}, {{DocumentFragment}}, {{Element}},
+{{Text}}, {{ProcessingInstruction}}, and {{Comment}}).
+
+ Each node has an associated
+node document, set upon creation, that is a
+document.
+
+ A node's node document can be changed by the
+adopt algorithm.
+
+ A node's get the parent algorithm, given an event, returns the
+node's assigned slot, if node is assigned, and node's
+parent otherwise.
+
+ Each node also has a registered observer list.
+
+ The nodeName attribute's getter, when invoked, must return the
+first matching statement, switching on this:
+
+ Returns true if node is connected and false otherwise.
+
+ The The The node document of a document is that document itself. All
+nodes have a node document at all times.
+
+ The The An {{Attr}} node has no parent.
+
+ The The The The The The An {{Attr}} node has no siblings.
+
+ The Set an existing attribute value with this and new value.
+
+ Replace data with node this, offset 0, count this's
+ length, and data new value.
+
+ Do nothing.
+ The To string replace all with a string string within a
+node parent, run these steps:
+
+ Let node be null.
+
+ If string is not the empty string, then set node to a new {{Text}}
+ node whose data is string and
+ node document is parent's node document.
+
+ Replace all with node within parent.
+ The {{Node/textContent}} attribute's setter must, if the given value is null, act as if it was
+the empty string instead, and then do as described below, switching on this:
+
+ String replace all with the given value within this.
+
+ Set an existing attribute value with this and new value.
+
+ Replace data with node this, offset 0, count this's
+ length, and data the given value.
+
+ Do nothing.
+ The While currentNode is an exclusive For each live range whose start node is currentNode,
+ add length to its start offset and set its
+ start node to node.
+
+ For each live range whose end node is currentNode, add
+ length to its end offset and set its end node to
+ node.
+
+ For each live range whose start node is currentNode's
+ parent and start offset is currentNode's
+ index, set its start node to node and its
+ start offset to length.
+
+ For each live range whose end node is currentNode's
+ parent and end offset is currentNode's
+ index, set its end node to node and its
+ end offset to length.
+
+ Add currentNode's length to length.
+
+ Set currentNode to its next sibling.
+ HTML defines cloning steps for <{script}> and <{input}>
+elements. SVG ought to do the same for its <{script}> elements, but does not call this out
+at the moment.
+
+ To clone a
+node, with an optional document and clone children flag, run these
+steps:
+
+
+ If document is not given, let document be node's
+ node document.
+
+ If node is an element, then:
+
+ Let copy be the result of creating an element, given
+ document, node's local name, node's
+ namespace, node's namespace prefix, and
+ node's For each attribute in node's
+ attribute list:
+
+ Otherwise, let copy be a node that implements the same interfaces as
+ node, and fulfills these additional requirements, switching on
+ node:
+
+ Set copy's encoding, content type,
+ URL, origin, type, and
+ mode, to those of node.
+
+ Set copy's name, public ID, and
+ system ID, to those of node.
+
+ Set copy's namespace, namespace prefix,
+ local name, and value, to those of node.
+
+ Set copy's node document and document to
+ copy, if copy is a document, and set copy's
+ node document to document otherwise.
+
+ The If this is a shadow root, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ Return a clone of this, with the
+ clone children flag set if deep is true.
+ The The The If this is other, then return zero.
+
+ Let node1 be other and node2 be this.
+
+ Let attr1 and attr2 be null.
+
+ If node1 is an attribute, then set attr1 to node1
+ and node1 to attr1's element.
+
+ If node2 is an attribute, then:
+
+ Set attr2 to node2 and node2 to attr2's
+ element.
+
+ If attr1 and node1 are non-null, and node2 is
+ node1, then:
+
+ For each attr in node2's
+ attribute list:
+
+ If attr equals attr1, then return the result of
+ adding {{Node/DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC}} and
+ {{Node/DOCUMENT_POSITION_PRECEDING}}.
+
+ If attr equals attr2, then return the result of
+ adding {{Node/DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC}} and
+ {{Node/DOCUMENT_POSITION_FOLLOWING}}.
+ If node1 or node2 is null, or node1's root is
+ not node2's root, then return the result of adding
+ {{Node/DOCUMENT_POSITION_DISCONNECTED}}, {{Node/DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC}}, and
+ either {{Node/DOCUMENT_POSITION_PRECEDING}} or {{Node/DOCUMENT_POSITION_FOLLOWING}}, with the
+ constraint that this is to be consistent, together.
+
+ Whether to return {{Node/DOCUMENT_POSITION_PRECEDING}} or
+ {{Node/DOCUMENT_POSITION_FOLLOWING}} is typically implemented via pointer comparison. In
+ JavaScript implementations a cached If node1 is an ancestor of node2 and attr1 is null,
+ or node1 is node2 and attr2 is non-null, then return the result of
+ adding {{Node/DOCUMENT_POSITION_CONTAINS}} to {{Node/DOCUMENT_POSITION_PRECEDING}}.
+
+ If node1 is a descendant of node2 and attr2 is null,
+ or node1 is node2 and attr1 is non-null, then return the result of
+ adding {{Node/DOCUMENT_POSITION_CONTAINED_BY}} to {{Node/DOCUMENT_POSITION_FOLLOWING}}.
+
+ If node1 is preceding node2, then return
+ {{Node/DOCUMENT_POSITION_PRECEDING}}.
+
+ Due to the way attributes are handled in this algorithm this results in a
+ node's attributes counting as preceding that node's children,
+ despite attributes not participating in a tree.
+
+ Return {{Node/DOCUMENT_POSITION_FOLLOWING}}.
+ The To
+locate a namespace prefix
+for an element using namespace, run these steps:
+
+ If element's namespace is namespace and its
+ namespace prefix is non-null, then return its
+ namespace prefix.
+
+ If element has an attribute whose
+ namespace prefix is " If element's parent element is not null, then return the result of running
+ locate a namespace prefix on that element using namespace.
+
+ Return null.
+ To locate a namespace for a node using prefix, switch on
+node:
+
+ If its namespace is non-null and its
+ namespace prefix is prefix, then return
+ namespace.
+
+ If it has an attribute whose namespace
+ is the XMLNS namespace, namespace prefix is " If its parent element is null, then return null.
+
+ Return the result of running locate a namespace on its parent element using
+ prefix.
+ If its document element is null, then return null.
+
+ Return the result of running locate a namespace on its document element
+ using prefix.
+ Return null.
+
+ If its element is null, then return null.
+
+ Return the result of running locate a namespace on its element
+ using prefix.
+ If its parent element is null, then return null.
+
+ Return the result of running locate a namespace on its parent element using
+ prefix.
+ The If namespace is null or the empty string, then return null.
+
+ Switch on this:
+
+ Return the result of locating a namespace prefix for it using namespace.
+
+ Return the result of locating a namespace prefix for its document element,
+ if its document element is non-null, and null otherwise.
+
+ Return null.
+
+ Return the result of locating a namespace prefix for its element,
+ if its element is non-null, and null otherwise.
+
+ Return the result of locating a namespace prefix for its parent element, if
+ its parent element is non-null, and null otherwise.
+ The If prefix is the empty string, then set it to null.
+
+ Return the result of running locate a namespace for this using
+ prefix.
+ The If namespace is the empty string, then set it to null.
+
+ Let defaultNamespace be the result of running locate a namespace for
+ this using null.
+
+ Return true if defaultNamespace is the same as namespace, and false
+ otherwise.
+ The The The The The
+list of elements with qualified name qualifiedName
+for a node root is the {{HTMLCollection}} returned by the following algorithm:
+
+ If qualifiedName is " Otherwise, if root's node document is an HTML document,
+ return a {{HTMLCollection}} rooted at root, whose filter matches the following
+ descendant elements:
+
+ Whose namespace is the HTML namespace and whose
+ qualified name is qualifiedName, in ASCII lowercase.
+
+ Whose namespace is not the HTML namespace and whose
+ qualified name is qualifiedName.
+ Otherwise, return a {{HTMLCollection}} rooted at root, whose filter matches
+ descendant elements whose qualified name is
+ qualifiedName.
+ When invoked with the same argument, and as long as root's
+node document's type has not changed, the same
+{{HTMLCollection}} object may be returned as returned by an earlier call.
+
+The
+list of elements with namespace
+namespace and local name localName
+for a node root is the
+{{HTMLCollection}} returned by the following algorithm:
+
+ Return a {{HTMLCollection}} rooted at root,
+ whose filter matches descendant
+ elements that have all their
+ classes in classes.
+
+ The comparisons for the classes must be done in an
+ ASCII case-insensitive manner if root's node document's
+ mode is " The mode is only ever changed from the default for documents created
+ by the HTML parser based on the presence, absence, or value of the DOCTYPE string, and by a
+ new browsing context (initial " No-quirks mode was originally known as "standards mode" and limited-quirks mode
+ was once known as "almost standards mode". They have been renamed because their details are now
+ defined by standards. (And because Ian Hickson vetoed their original names on the basis that they
+ are nonsensical.)
+ A document's get the parent algorithm, given an event, returns
+null if event's {{Event/type}} attribute value is " The Unlike {{DOMImplementation/createDocument()}}, this constructor does not
+return an {{XMLDocument}} object, but a document ({{Document}} object).
+
+The
+ If qualifiedName is " Otherwise, returns a {{HTMLCollection}} of all descendant elements whose
+ qualified name is qualifiedName. (Matches case-insensitively against
+ elements in the HTML namespace within an HTML document.)
+
+ Thus, in an HTML document,
+ Returns an element with localName as local name
+ (if document is an HTML document, localName gets lowercased). The
+ element's namespace is the HTML namespace when
+ document is an HTML document or document's
+ content type is " If localName does not match the When supplied, options's {{ElementCreationOptions/is}} can be used to create a
+ customized built-in element.
+
+ Returns an element with namespace namespace. Its
+ namespace prefix will be everything before " If localName does not match the If one of the following conditions is true a "{{NamespaceError!!exception}}" {{DOMException}}
+ will be thrown:
+
+ When supplied, options's {{ElementCreationOptions/is}} can be used to create a
+ customized built-in element.
+
+ The HTML Standard will e.g. define that for If localName does not match the If this is an HTML document, then set localName to
+ localName in ASCII lowercase.
+
+ Let is be null.
+
+ If options is a dictionary and options's
+ {{ElementCreationOptions/is}} is present, then set is to it.
+
+ Let namespace be the HTML namespace, if this is an
+ HTML document or this's content type is
+ " Return the result of creating an element given this, localName,
+ namespace, null, is, and with the synchronous custom elements flag
+ set.
+ The internal Let namespace, prefix, and localName be the result of
+ passing namespace and qualifiedName to validate and extract.
+
+ Let is be null.
+
+ If options is a dictionary and options's
+ {{ElementCreationOptions/is}} is present, then set is to it.
+
+ Return the result of creating an element given document,
+ localName, namespace, prefix, is, and with the
+ synchronous custom elements flag set.
+ The
+ {{Document/createElement()}} and {{Document/createElementNS()}}'s options
+parameter is allowed to be a string for web compatibility.
+
+The No check is performed that data consists of
+characters that match the The If this is an HTML document, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If data contains the string " Return a new {{CDATASection}} node with its data set to
+ data and node document set to this.
+ No check is performed that data consists of
+characters that match the No check is performed that target contains
+" If node is a document or shadow root, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ Return a clone of node, with this and the
+ clone children flag set if deep is true.
+ Specifications may define
+adopting steps for all or some nodes. The
+algorithm is passed node and oldDocument, as indicated in the adopt
+algorithm.
+
+ To adopt a node into a document, run
+these steps:
+
+ Let oldDocument be node's node document.
+
+ If document is not oldDocument, then:
+
+ For each inclusiveDescendant in node's
+ shadow-including inclusive descendants:
+
+ Set inclusiveDescendant's node document to document.
+
+ If inclusiveDescendant is an element, then set the
+ node document of each attribute in inclusiveDescendant's
+ attribute list to document.
+ For each inclusiveDescendant in node's
+ shadow-including inclusive descendants that is custom,
+ enqueue a custom element callback reaction with inclusiveDescendant, callback
+ name " For each inclusiveDescendant in node's
+ shadow-including inclusive descendants, in shadow-including tree order, run the
+ adopting steps with inclusiveDescendant and oldDocument.
+ If node is a document, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If node is a shadow root, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If node is a {{DocumentFragment}} node whose
+ host is non-null, then return.
+
+ Return node.
+ If localName does not match the Let namespace, prefix, and localName be the result of
+ passing namespace and qualifiedName to validate and extract.
+
+ Return a new attribute whose namespace is namespace,
+ namespace prefix is prefix, local name is
+ localName, and node document is this.
+ The Let constructor be null.
+
+ If interface is an ASCII case-insensitive match for any of the strings in the
+ first column in the following table, then set constructor to the interface in the
+ second column on the same row as the matching string:
+
+ If constructor is null, then throw a "{{NotSupportedError!!exception}}"
+ {{DOMException}}.
+
+ If the interface indicated by constructor is not exposed on the
+ relevant global object of this, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ Typically user agents disable support for touch events in some configurations, in
+ which case this clause would be triggered for the interface {{TouchEvent}}.
+
+ Let event be the result of creating an event given constructor.
+
+ Initialize event's {{Event/type}} attribute to the empty string.
+
+ Initialize event's {{Event/timeStamp}} attribute to a {{DOMHighResTimeStamp}}
+ representing the high resolution time from the time origin to now.
+
+ Initialize event's {{Event/isTrusted}} attribute to false.
+
+ Unset event's initialized flag.
+
+ Return event.
+ Event constructors ought to be used instead.
+
+ The The {{Range/Range()}} constructor can be used instead.
+
+ The
+ Let iterator be a new {{NodeIterator}} object.
+
+ Set iterator's pointer before reference to true.
+
+ Set iterator's whatToShow to whatToShow.
+
+ Set iterator's filter to filter.
+
+ Return iterator.
+ The
+ Let walker be a new {{TreeWalker}} object.
+
+ Set walker's whatToShow to whatToShow.
+
+ Set walker's filter to filter.
+
+ Validate qualifiedName.
+
+ Return a new doctype, with qualifiedName as its
+ name, publicId as its public ID, and systemId
+ as its system ID, and with its node document set to the associated
+ document of this.
+ No check is performed that publicId code points match the
+ The
+ Let document be a new {{XMLDocument}}.
+
+ Let element be null.
+
+ If qualifiedName is not the empty string, then set element to the
+ result of running the internal If doctype is non-null, append doctype to document.
+
+ If element is non-null, append element to document.
+
+ document's origin is this's associated
+ document's origin.
+
+ document's content type is determined by namespace:
+
+ Return document.
+ Let doc be a new document that is an HTML document.
+
+ Set doc's content type to " Append a new doctype, with " Append the result of creating an element given doc, <{html}>, and
+ the HTML namespace, to doc.
+
+ Append the result of creating an element given doc, <{head}>, and
+ the HTML namespace, to the <{html}> element created earlier.
+
+ If title is given:
+
+ Append the result of creating an element given doc, <{title}>,
+ and the HTML namespace, to the <{head}> element created earlier.
+
+ Append a new {{Text}} node, with its data set to
+ title (which could be the empty string) and its node document set to
+ doc, to the <{title}> element created earlier.
+ Append the result of creating an element given doc, <{body}>, and
+ the HTML namespace, to the <{html}> element created earlier. Return doc.
+ {{hasFeature()}} originally would report whether the user agent
+claimed to support a given DOM feature, but experience proved it was not nearly as
+reliable or granular as simply checking whether the desired objects, attributes, or
+methods existed. As such, it is no longer to be used, but continues to exist (and simply
+returns true) so that old pages don't stop working.
+
+ {{DocumentType}} nodes are simply known as
+doctypes.
+
+ Doctypes have an associated
+name,
+public ID, and
+system ID.
+
+ When a doctype is created, its name is always given. Unless
+explicitly given when a doctype is created, its public ID and system ID are the
+empty string.
+
+ The The The A {{DocumentFragment}} node has an associated
+host (null or an
+element in a different node tree). It is null unless otherwise stated.
+
+ An object A is a
+host-including inclusive ancestor
+of an object B, if either A is an inclusive ancestor of B,
+or if B's root has a non-null host and
+A is a host-including inclusive ancestor of B's root's
+host.
+
+ The {{DocumentFragment}} node's host
+concept is useful for HTML's <{template}> element and for shadow roots, and impacts the
+pre-insert and replace algorithms.
+
+ The {{ShadowRoot}} nodes are simply known as
+shadow roots.
+
+ Shadow roots have an associated mode (" Shadow roots have an associated delegates focus.
+It is initially set to false. Shadow roots's associated host is never null. A shadow root's get the parent algorithm, given an event, returns
+null if event's composed flag is unset and shadow root is the
+root of event's path's first struct's
+invocation target, and shadow root's
+host otherwise.
+
+ The The The In shadow-including tree order is
+shadow-including preorder, depth-first traversal of a node tree.
+Shadow-including preorder, depth-first traversal of a node tree
+tree is preorder, depth-first traversal of tree, with for each
+shadow host encountered in tree,
+shadow-including preorder, depth-first traversal of that element's
+shadow root's node tree just after it is encountered.
+
+ The shadow-including root of an object is its
+root's host's shadow-including root, if the
+object's root is a shadow root, and its root
+otherwise. An object A is a
+shadow-including descendant of an object
+B, if A is a descendant of B, or A's
+root is a shadow root and A's root's
+host is a shadow-including inclusive descendant of B.
+
+ A
+shadow-including inclusive descendant
+is an object or one of its shadow-including descendants.
+
+ An object A is a
+shadow-including ancestor of an object
+B, if and only if B is a shadow-including descendant of A.
+
+ A
+shadow-including inclusive ancestor
+is an object or one of its shadow-including ancestors.
+
+ A node A is
+closed-shadow-hidden from a node
+B if all of the following conditions are true:
+
+ A's root is a shadow root.
+
+ A's root is not a shadow-including inclusive ancestor of
+ B.
+
+ A's root is a shadow root whose
+ mode is " To retarget an object A against an object
+B, repeat these steps until they return an object: If one of the following is true
+
+ then return A.
+
+ The retargeting algorithm is used by event dispatch as well
+as other specifications, such as Fullscreen. [[FULLSCREEN]]
+
+
+ {{Element}} nodes are simply known as
+elements.
+
+ Elements have an associated
+namespace,
+namespace prefix,
+local name,
+custom element state,
+custom element definition,
+ An element's custom element state is one of
+" Whether or not an element is defined is used to determine the
+behavior of the '':defined'' pseudo-class. Whether or not an element is custom is
+used to determine the behavior of the mutation algorithms. The
+" The following code illustrates elements in each of these four states: Elements also have an associated
+shadow root (null or a
+shadow root). It is null unless otherwise stated. An element is a
+shadow host if its shadow root is non-null.
+
+ An element's
+qualified name is its
+local name if its namespace prefix is null, and its
+namespace prefix, followed by " An element's HTML-uppercased qualified name is the return
+value of these steps:
+
+ Let qualifiedName be this's qualified name.
+
+ If this is in the HTML namespace and its node document is an
+ HTML document, then set qualifiedName to qualifiedName in
+ ASCII uppercase.
+
+ User agents could optimize qualified name and
+HTML-uppercased qualified name by storing them in internal slots.
+
+ To
+create an element,
+given a document, localName, namespace, and optional
+prefix, is, and synchronous custom elements flag, run these steps:
+
+ If prefix was not given, let prefix be null.
+
+ If is was not given, let is be null.
+
+ Let result be null.
+
+ Let definition be the result of
+ looking up a custom element definition given
+ document, namespace, localName, and is.
+
+ If definition is non-null, and definition's
+ name is not equal to its
+ local name (i.e., definition represents a
+ customized built-in element), then:
+
+ Let interface be the element interface for localName and the
+ HTML namespace.
+
+ Set result to a new element that implements interface,
+ with no attributes, namespace set to the HTML namespace,
+ namespace prefix set to prefix, local name set
+ to localName, custom element state set to " If the synchronous custom elements flag is set, then run this step while
+ catching any exceptions:
+
+ Upgrade element using definition.
+ If this step threw an exception, then: Report the exception.
+
+ Set result's custom element state to
+ " Otherwise, enqueue a custom element upgrade reaction given result and
+ definition.
+ Otherwise, if definition is non-null, then:
+
+ If the synchronous custom elements flag is set, then run these steps while
+ catching any exceptions:
+
+ Let C be definition's
+ constructor.
+
+ Set result to the result of constructing C, with no
+ arguments.
+
+ Assert: result's custom element state and
+ custom element definition are initialized.
+
+ Assert: result's namespace is the HTML namespace.
+
+ IDL enforces that result is an {{HTMLElement}} object, which all use
+ the HTML namespace.
+
+ If result's attribute list is not empty,
+ then throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If result has children, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If result's parent is not null, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If result's node document is not document, then
+ throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If result's local name is not equal to
+ localName, then throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ Set result's namespace prefix to prefix.
+
+ Set result's If any of these steps threw an exception, then: Report the exception.
+
+ Set result to a new element that implements the
+ {{HTMLUnknownElement}} interface, with no attributes, namespace set to the
+ HTML namespace, namespace prefix set to prefix,
+ local name set to localName,
+ custom element state set to " Otherwise:
+
+ Set result to a new element that implements the {{HTMLElement}}
+ interface, with no attributes, namespace set to the HTML namespace,
+ namespace prefix set to prefix, local name set
+ to localName, custom element state set to
+ " Enqueue a custom element upgrade reaction given result and
+ definition.
+ Otherwise:
+
+ Let interface be the element interface for localName and
+ namespace.
+
+ Set result to a new element that implements interface,
+ with no attributes, namespace set to namespace,
+ namespace prefix set to prefix, local name set
+ to localName, custom element state set to
+ " If namespace is the HTML namespace, and either localName is a
+ valid custom element name or is is non-null, then set result's
+ custom element state to " Return result.
+ Elements also have an
+attribute list, which is a list
+exposed through a {{NamedNodeMap}}. Unless explicitly given when an element is created,
+its attribute list is empty.
+
+ An element
+has an attribute
+A if its attribute list contains A.
+
+ This and other specifications may define
+attribute change steps for
+elements. The algorithm is passed element, localName,
+oldValue, value, and namespace.
+
+ To handle attribute changes for an attribute attribute with
+element, oldValue, and newValue, run these steps:
+
+ Queue a mutation record of " If element is custom, then
+ enqueue a custom element callback reaction with element, callback name
+ " Run the attribute change steps with element, attribute's
+ local name, oldValue, newValue, and attribute's
+ namespace.
+ To change an
+attribute attribute to value, run these steps:
+
+ Handle attribute changes for attribute with attribute's
+ element, attribute's value, and value.
+
+ Set attribute's value to value.
+ To append an
+attribute attribute to an element element, run these
+steps:
+
+ Handle attribute changes for attribute with element, null, and
+ attribute's value.
+
+ Append attribute to element's
+ attribute list.
+
+ Set attribute's element to element.
+ To remove an
+attribute attribute, run these steps:
+
+ Handle attribute changes for attribute with attribute's
+ element, attribute's value, and null.
+
+ Set attribute's element to null.
+ To replace an
+attribute oldAttr with an attribute newAttr, run these steps:
+
+ Handle attribute changes for oldAttr with oldAttr's
+ element, oldAttr's value, and newAttr's
+ value.
+
+ Replace oldAttr by newAttr in oldAttr's
+ element's attribute list.
+
+ Set oldAttr's element to null.
+ To get an attribute by name given a
+qualifiedName and element element, run these steps:
+
+ If element is in the HTML namespace and its node document
+ is an HTML document, then set qualifiedName to qualifiedName in
+ ASCII lowercase.
+
+ Return the first attribute in element's attribute list
+ whose qualified name is qualifiedName, and null otherwise.
+ To
+get an attribute by namespace and local name
+given a namespace, localName, and element element,
+run these steps:
+
+ To get an attribute value given an
+element element, localName, and optionally a namespace
+(null unless stated otherwise), run these steps: Let attr be the result of
+ getting an attribute given
+ namespace, localName, and element. If attr is null, then return the empty string. Return attr's value. To set an attribute given an
+attr and element, run these steps:
+
+ If attr's element is neither null nor element,
+ throw an "{{InUseAttributeError!!exception}}" {{DOMException}}.
+
+ Let oldAttr be the result of
+ getting an attribute given
+ attr's namespace, attr's local name, and
+ element.
+
+ If oldAttr is attr, return attr.
+
+ If oldAttr is non-null, then replace
+ oldAttr with attr.
+
+ Otherwise, append attr to element.
+
+ Return oldAttr.
+ To set an attribute value for an
+element element, using a localName and value, and an
+optional prefix, and namespace, run these steps:
+
+ Change attribute to value.
+ To remove an attribute by name
+given a qualifiedName and element element, run these steps:
+
+ Let attr be the result of
+ getting an attribute given qualifiedName and
+ element.
+
+ If attr is non-null, then remove attr.
+
+ Return attr.
+ To
+remove an attribute by namespace and local name
+given a namespace, localName, and element element,
+run these steps:
+
+ Let attr be the result of
+ getting an attribute given
+ namespace, localName, and element.
+
+ If attr is non-null, then remove attr.
+
+ Return attr.
+ An element can have an associated
+unique identifier (ID)
+
+ Historically elements could have multiple identifiers e.g., by using
+the HTML Use these attribute change steps to update an element's
+ID:
+
+ If localName is Otherwise, if localName is While this specification defines requirements for The The The The Returns the value of element's Returns the value of element's Allows for manipulation of element's Returns the value of element's IDL attributes that are defined to reflect a
+content attribute of a given name, must have a getter and setter that follow these
+steps: Return the result of running get an attribute value given this and
+ name. Set an attribute value for this using name and the given value.
+ The The The The Returns true if element has attributes, and false otherwise.
+
+ Returns the qualified names of all element's attributes.
+ Can contain duplicates.
+
+ Returns element's first attribute whose qualified name is
+ qualifiedName, and null if there is no such attribute otherwise.
+
+ Returns element's attribute whose namespace is
+ namespace and local name is localName, and null if there is
+ no such attribute otherwise.
+
+ Sets the value of element's first attribute whose
+ qualified name is qualifiedName to value.
+
+ Sets the value of element's attribute whose
+ namespace is namespace and local name is
+ localName to value.
+
+ Removes element's first attribute whose qualified name is
+ qualifiedName.
+
+ Removes element's attribute whose namespace is
+ namespace and local name is localName.
+
+ 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.
+
+ Returns true if element has an attribute whose
+ qualified name is qualifiedName, and false otherwise.
+
+ Returns true if element has an attribute whose namespace
+ is namespace and local name is localName.
+ The The The These are not guaranteed to be unique.
+
+ The Let attr be the result of
+ getting an attribute given qualifiedName and
+ this.
+
+ If attr is null, return null.
+
+ Return attr's value.
+ The
+ Let attr be the result of
+ getting an attribute given
+ namespace, localName, and this.
+
+ If attr is null, return null.
+
+ Return attr's value.
+ The
+ If qualifiedName does not match the If this is in the HTML namespace and its node document is an
+ HTML document, then set qualifiedName to qualifiedName in
+ ASCII lowercase.
+
+ Let attribute be the first attribute in this's
+ attribute list whose qualified name is qualifiedName,
+ and null otherwise.
+
+
+ If attribute is null, create an attribute whose
+ local name is qualifiedName, value is
+ value, and node document is this's node document,
+ then append this attribute to this, and then return.
+
+ Change attribute to value.
+ The
+ Let namespace, prefix, and localName be the result of
+ passing namespace and qualifiedName to validate and extract.
+
+ Set an attribute value for this using localName, value,
+ and also prefix and namespace.
+ The
+ The
+ The If this is in the HTML namespace and its node document is an
+ HTML document, then set qualifiedName to qualifiedName in
+ ASCII lowercase.
+
+ Return true if this has an attribute whose
+ qualified name is qualifiedName, and false otherwise.
+ The If qualifiedName does not match the If this is in the HTML namespace and its node document is an
+ HTML document, then set qualifiedName to qualifiedName in
+ ASCII lowercase.
+
+ Let attribute be the first attribute in this's
+ attribute list whose qualified name is qualifiedName,
+ and null otherwise.
+
+
+ If attribute is null, then:
+
+ If force is not given or is true, create an attribute whose
+ local name is qualifiedName, value is the empty
+ string, and node document is this's node document, then
+ append this attribute to this, and then return
+ true.
+
+ Return false.
+ Otherwise, if force is not given or is false,
+ remove an attribute given qualifiedName and
+ this, and then return false.
+
+ Return true.
+ The
+ The The
+ The The If this's attribute list does not contain
+ attr, then throw a "{{NotFoundError!!exception}}" {{DOMException}}.
+
+ Remove attr.
+
+ Return attr.
+ Creates a shadow root for element and returns it.
+
+ Returns element's shadow root, if any, and if
+ shadow root's mode is " The If this's namespace is not the HTML namespace,
+ then throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If this's local name is not one of the following:
+
+ then throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
+ If this's local name is a valid custom element name, or
+ this's Let definition be the result of
+ looking up a custom element definition given
+ this's node document, its namespace, its
+ local name, and its If definition is not null and definition's
+ disable shadow is true, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+ If this is a shadow host, then throw an
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ Let shadow be a new shadow root whose node document
+ is this's node document, host is this,
+ and mode is init's {{ShadowRootInit/mode}}.
+
+ Set shadow's delegates focus to init's
+ {{ShadowRootInit/delegatesFocus}}.
+
+ Set this's shadow root to shadow.
+
+ Return shadow.
+ The Let shadow be this's shadow root.
+
+ If shadow is null or its mode is " Return shadow.
+ The The
+ The To insert adjacent, given an element element, string
+where, and a node node, run the steps associated with the first
+ASCII case-insensitive match for where:
+
+ If element's parent is null, return null.
+
+ Return the result of pre-inserting node into element's
+ parent before element.
+
+ Return the result of pre-inserting node into element before
+ element's first child.
+
+ Return the result of pre-inserting node into element before
+ null.
+
+ If element's parent is null, return null.
+
+ Return the result of pre-inserting node into element's
+ parent before element's next sibling.
+
+ Throw a "{{SyntaxError!!exception}}" {{DOMException}}.
+ The
+ The
+ Let text be a new {{Text}} node whose data is
+ data and node document is this's node document.
+
+ Run insert adjacent, given this, where, and text.
+ This method returns nothing because it existed before we had a chance to design it.
+
+
+ A {{NamedNodeMap}} object's supported property indices are the numbers in the
+range zero to its attribute list's size minus one, unless
+the attribute list is empty, in which case there are no
+supported property indices.
+
+ The The If index is equal to or greater than this's
+ attribute list's size, then return null.
+
+ Otherwise, return this's attribute list[index].
+ A {{NamedNodeMap}} object's supported property names are the return value of running these
+steps:
+
+ Let names be the qualified names of the attributes in this
+ {{NamedNodeMap}} object's attribute list, with duplicates omitted, in
+ order.
+
+
+ If this {{NamedNodeMap}} object's element is in the
+ HTML namespace and its node document is an HTML document, then
+ for each name in names:
+
+ Let lowercaseName be name, in ASCII lowercase.
+
+ If lowercaseName is not equal to name, remove name from
+ names.
+ Return names.
+ The The
+ The The Let attr be the result of
+ removing an attribute given
+ qualifiedName and element.
+
+ If attr is null, then throw a "{{NotFoundError!!exception}}"
+ {{DOMException}}.
+
+ Return attr.
+ The
+ Let attr be the result of
+ removing an attribute given
+ namespace, localName, and element.
+
+ If attr is null, then throw a "{{NotFoundError!!exception}}"
+ {{DOMException}}.
+
+ Return attr.
+ {{Attr}} nodes are simply known as
+attributes. They are sometimes referred
+to as content attributes to avoid confusion with IDL attributes.
+
+Attributes have a
+namespace (null or a non-empty string),
+namespace prefix (null or a non-empty string),
+local name (a non-empty string),
+value (a string), and
+element (null or an
+element).
+
+ If designed today they would just have a name and value. ☹
+
+ An attribute's
+qualified name is its
+local name if its namespace prefix is null, and its
+namespace prefix, followed by " User agents could have this as an internal slot as an optimization.
+
+When an attribute is created, its
+local name is given. Unless explicitly
+given when an attribute is created, its
+namespace,
+namespace prefix, and
+element are set to null, and its
+value is set to the empty string.
+
+An
+ The The The The The To set an existing attribute value, given an attribute attribute and
+string value, run these steps:
+
+ If attribute's element is null, then set attribute's
+ value to value.
+
+ Otherwise, change attribute to value.
+ The {{Attr/value}} attribute's setter must set an existing attribute value with
+this and the given value.
+
+ The The {{CharacterData}} is an abstract interface and does not exist as
+node. It is used by {{Text}}, {{ProcessingInstruction}}, and {{Comment}} nodes.
+
+Each node inheriting from the
+{{CharacterData}} interface has an associated mutable string
+called data.
+
+To replace data of node node with offset
+offset, count count, and data data, run these steps:
+
+ Queue a mutation record of " For each live range whose start node is node and
+ start offset is greater than offset but less than or equal to
+ offset plus count, set its start offset to
+ offset.
+
+ For each live range whose end node is node and
+ end offset is greater than offset but less than or equal to
+ offset plus count, set its end offset to offset.
+
+ For each live range whose start node is node and
+ start offset is greater than offset plus count, increase its
+ start offset by data's length and decrease it by
+ count.
+
+ For each live range whose end node is node and
+ end offset is greater than offset plus count, increase its
+ end offset by data's length and decrease it by
+ count.
+
+ The The The
+ The The
+ The
+ The
+ An exclusive {{Text}} node is a {{Text}} node that is not a
+{{CDATASection}} node.
+
+ The contiguous {{Text}} nodes of a node node are
+node, node's previous sibling {{Text}} node, if any, and its
+contiguous The contiguous exclusive {{Text}} nodes of a node node are
+node, node's previous sibling exclusive The child text content of a node
+node is the concatenation of the data of all
+the {{Text}} node children of node, in tree order.
+
+ The descendant text content of a
+node node is the concatenation of the
+data of all the {{Text}} node descendants of
+node, in tree order.
+
+ The If parent is not null, then:
+
+ Insert new node into parent before node's
+ next sibling.
+
+
+ For each live range whose start node is node and
+ start offset is greater than offset, set its
+ start node to new node and decrease its start offset
+ by offset.
+
+ For each live range whose end node is node and
+ end offset is greater than offset, set its end node
+ to new node and decrease its end offset by offset.
+
+
+ For each live range whose start node is parent and
+ start offset is equal to the index of node plus 1,
+ increase its start offset by 1.
+
+ For each live range whose end node is parent and
+ end offset is equal to the index of node plus 1,
+ increase its end offset by 1.
+ The The The {{StaticRange}} and {{Range}} objects (ranges) represent a sequence of content within a
+node tree. Each range has a start and an end which
+are boundary points. A boundary point is a tuple consisting of a
+node and an offset. So in other words, a
+range represents a piece of content within a node tree between two
+boundary points.
+
+ Ranges are frequently used in editing for selecting and copying content.
+
+ In the node tree above, a
+range can be used to represent the sequence
+“syndata is awes”. Assuming p is assigned to the
+ Attributes such as {{Range}} objects, unlike {{StaticRange}} objects, are affected by mutations to the
+node tree. Therefore they are also known as live ranges. Such mutations will not
+invalidate them and will try to ensure that it still represents the same piece of content.
+Necessarily, a live range might itself be modified as part of the mutation to the
+node tree when, e.g., part of the content it represents is mutated.
+
+ See the insert and remove algorithms, the
+{{Node/normalize()}} method, and the replace data and split
+algorithms for details.
+
+ Updating live ranges in response to node tree mutations can be expensive. For every
+node tree change, all affected {{Range}} objects need to be updated. Even if the application
+is uninterested in some live ranges, it still has to pay the cost of keeping them up-to-date
+when a mutation occurs.
+
+ A {{StaticRange}} object is a lightweight range that does not update when the
+node tree mutates. It is therefore not subject to the same maintenance cost as
+live ranges.
+
+
+ A boundary point is a tuple consisting of a
+node (a node) and an
+offset (a non-negative integer).
+
+ A correct boundary point's offset will
+be between 0 and the boundary point's node's
+length, inclusive.
+
+ The position of a
+boundary point (nodeA, offsetA) relative to a boundary point
+(nodeB, offsetB) is
+before,
+equal, or
+after, as returned by these steps:
+
+ Assert: nodeA and nodeB have the same root.
+
+ If nodeA is following nodeB, then if the
+ position of (nodeB, offsetB) relative to
+ (nodeA, offsetA) is before, return
+ after, and if it is after, return
+ before.
+
+ If nodeA is an ancestor of nodeB:
+
+ Return before.
+ Objects implementing the {{AbstractRange}} interface are known as
+ranges.
+
+ A range has two associated boundary points — a
+start and
+end.
+
+ For convenience, a range's
+start node is its start's
+node, its
+start offset is its
+start's offset, its
+end node is its end's
+node, and its
+end offset is its end's
+offset.
+
+ A range is collapsed if its start node is its
+end node and its start offset is its end offset.
+
+ The
+ The The The The Returns a new range object that does not update when the node tree mutates.
+ The If init's {{StaticRangeInit/startContainer}} or {{StaticRangeInit/endContainer}}
+ is a {{DocumentType}} or {{Attr}} node, then throw an
+ "{{InvalidNodeTypeError!!exception}}" {{DOMException}}.
+
+ Let staticRange be a new {{StaticRange}} object.
+
+ Set staticRange's start to (init's
+ {{StaticRangeInit/startContainer}}, init's {{StaticRangeInit/startOffset}}) and
+ end to (init's {{StaticRangeInit/endContainer}}, init's
+ {{StaticRangeInit/endOffset}}).
+
+ Return staticRange.
+ Objects implementing the {{Range}} interface are known as
+live ranges.
+
+ Algorithms that modify a tree (in particular the insert,
+remove, replace data, and split algorithms) modify
+live ranges associated with that tree.
+
+ The root of a live range is the
+root of its start node.
+
+
+ A node node is contained
+in a live range range if node's root is
+range's root, and (node, 0) is
+after range's start, and
+(node, node's length) is before
+range's end.
+
+ A node is
+partially contained in a live range
+if it's an inclusive ancestor of the live range's start node
+but not its end node, or vice versa.
+
+ Some facts to better understand these definitions:
+
+ The content that one would think of as being within the live range consists of all
+ contained nodes, plus possibly some of the contents of the
+ start node and end node if those are {{Text}},
+ {{ProcessingInstruction}}, or {{Comment}} nodes.
+
+ The nodes that are contained in a live range will generally not be
+ contiguous, because the parent of a contained
+ node will not always be contained.
+
+ However, the descendants of a contained node
+ are contained, and if two siblings are
+ contained, so are any siblings that lie between them.
+
+ The start node and end node of a live range are
+ never contained within it.
+
+ The first contained node (if there are any) will
+ always be after the start node, and the last contained
+ node will always be equal to or before the end node's last
+ descendant.
+
+ There exists a partially contained node if and only if
+ the start node and end node are different.
+
+ The {{Range/commonAncestorContainer}} attribute value is neither
+ contained nor partially contained.
+
+ If the start node is an ancestor of the end node,
+ the common inclusive ancestor will be the start node. Exactly one
+ of its children will be partially contained, and a
+ child will be contained if and only if it
+ precedes the partially contained
+ child. If the end node is an ancestor of the
+ start node, the opposite holds.
+
+ If the start node is not an inclusive ancestor of the
+ end node, nor vice versa, the common inclusive ancestor will be
+ distinct from both of them. Exactly two of its children will be
+ partially contained, and a child will be contained if and
+ only if it lies between those two.
+ The The To
+set the start or end
+of a range to a boundary point (node, offset), run these
+steps:
+
+ The The The The Let parent be node's parent.
+
+ If parent is null, then throw an "{{InvalidNodeTypeError!!exception}}"
+ {{DOMException}}.
+
+ Set the start of this to boundary point
+ (parent, node's index plus 1).
+ The The Let parent be node's parent.
+
+ If parent is null, then throw an "{{InvalidNodeTypeError!!exception}}"
+ {{DOMException}}.
+
+ Set the end of this to boundary point
+ (parent, node's index plus 1).
+ The To select a node node
+within a range range, run these steps:
+
+ Let parent be node's parent.
+
+ If parent is null, then throw an "{{InvalidNodeTypeError!!exception}}"
+ {{DOMException}}.
+
+ Let index be node's index.
+
+ Set range's start to boundary point
+ (parent, index).
+
+ Set range's end to boundary point
+ (parent, index plus 1).
+ The The The
+ If how is not one of
+
+ then throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+
+ If the position of this point relative to
+ other point is
+
+ The If reference node's
+ parent were null, it would be the
+ root of
+ this, so would be an
+ inclusive ancestor of
+ original end node, and we could not reach this point.
+ For each node in nodes to remove, in tree order,
+ remove node.
+
+ To extract a live range
+range, run these steps:
+
+ Let fragment be a new {{DocumentFragment}} node whose
+ node document is range's start node's
+ node document.
+
+ If range is collapsed, then return fragment.
+
+
+ These variable assignments do actually always make sense.
+ For instance, if original start node is not an
+ inclusive ancestor of
+ original end node, original start node is itself
+ partially contained in range, and so are all its
+ ancestors up until a
+ child of common ancestor.
+ common ancestor cannot be original start node, because
+ it has to be an inclusive ancestor of
+ original end node. The other case is similar. Also, notice that the two
+ children will never be equal if both are defined.
+
+ If any member of contained children is a doctype, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+
+ We do not have to worry about the first or last partially
+ contained node, because a doctype can never be
+ partially contained. It cannot be a boundary point of a range, and it
+ cannot be the ancestor of anything.
+
+ If reference node's
+ parent is null, it would be the
+ root of range, so would be an
+ inclusive ancestor of
+ original end node, and we could not reach this point.
+ In this case, first partially contained child is
+ original start node.
+
+ Let subfragment be the result of extracting
+ subrange.
+
+ In this case, last partially contained child is
+ original end node.
+
+ Let subfragment be the result of extracting
+ subrange.
+
+ The To
+clone the contents
+of a live range range, run these steps:
+
+ Let fragment be a new {{DocumentFragment}} node whose
+ node document is range's start node's
+ node document.
+
+ If range is collapsed, then return fragment.
+
+
+ These variable assignments do actually always make sense.
+ For instance, if original start node is not an
+ inclusive ancestor of
+ original end node, original start node is itself
+ partially contained in range, and so are all its
+ ancestors up until a
+ child of common ancestor.
+ common ancestor cannot be original start node, because
+ it has to be an inclusive ancestor of
+ original end node. The other case is similar. Also, notice that the two
+ children will never be equal if both are defined.
+
+ If any member of contained children is a doctype, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ We do not have to worry about the first or last partially
+ contained node, because a doctype can never be
+ partially contained. It cannot be a boundary point of a range, and it
+ cannot be the ancestor of anything.
+
+ In this case, first partially contained child is
+ original start node.
+
+ Let subfragment be the result of cloning the contents
+ of subrange.
+
+ In this case, last partially contained child is
+ original end node.
+
+ Let subfragment be the result of cloning the contents
+ of subrange.
+
+ The To insert a node
+node into a live range range, run these steps:
+
+ If range is collapsed, then set range's
+ end to (parent, newOffset).
+ The The If a non-{{Text}} node is partially contained in
+ this, then throw an "{{InvalidStateError!!exception}}" {{DOMException}}.
+
+
+ If newParent is a {{Document}}, {{DocumentType}}, or {{DocumentFragment}}
+ node, then throw an "{{InvalidNodeTypeError!!exception}}" {{DOMException}}.
+
+ For historical reasons {{Text}}, {{ProcessingInstruction}}, and {{Comment}}
+ nodes are not checked here and end up throwing later on as a side effect.
+
+ Let fragment be the result of extracting this.
+
+
+ If newParent has children, then replace all with null
+ within newParent.
+
+ Append fragment to newParent.
+
+ The The The The The The stringification behavior must run
+these steps:
+
+ Let s be the empty string.
+
+ If this's start node is this's end node and
+ it is a {{Text}} node, then return the substring of that {{Text}} node's
+ data beginning at this's start offset and ending
+ at this's end offset.
+
+ If this's start node is a {{Text}} node, then append the
+ substring of that node's data from this's
+ start offset until the end to s.
+
+ Append the concatenation of the data of all
+ {{Text}} nodes that are contained in this, in
+ tree order, to s.
+
+ If this's end node is a {{Text}} node, then
+ append the substring of that node's data from its start until
+ this's end offset to s.
+
+ Return s.
+ The {{createContextualFragment()}}, {{Range/getClientRects()}},
+and {{Range/getBoundingClientRect()}} methods are defined in other specifications.
+[[DOM-Parsing]]
+[[CSSOM-VIEW]]
+
+
+
+ {{NodeIterator}} and {{TreeWalker}} objects can be used to filter and traverse node
+trees.
+
+ Each {{NodeIterator}} and {{TreeWalker}} object has an associated
+active flag to avoid recursive
+invocations. It is initially unset.
+
+ Each {{NodeIterator}} and {{TreeWalker}} object also has an associated
+root (a node), a
+whatToShow (a bitmask), and a
+filter (a callback).
+
+ To filter a node node within
+a {{NodeIterator}} or {{TreeWalker}} object traverser, run these steps:
+
+ If traverser's active flag is set, then throw an
+ "{{InvalidStateError!!exception}}" {{DOMException}}.
+
+ Let n be node's {{Node/nodeType}} attribute value − 1.
+
+ If the nth bit (where 0 is the least significant bit) of
+ traverser's whatToShow is not set, then return
+ {{NodeFilter/FILTER_SKIP}}.
+
+
+ If traverser's filter is null, then return
+ {{NodeFilter/FILTER_ACCEPT}}.
+
+ Set traverser's active flag.
+
+ Let result be the return value of call a user object's operation with
+ traverser's filter, " Unset traverser's active flag.
+
+ Return result.
+ {{NodeIterator}} objects can be created using the
+{{createNodeIterator()}} method on {{Document}} objects.
+
+ Each {{NodeIterator}} object has an associated
+iterator collection, which is a
+collection rooted at the {{NodeIterator}} object's root, whose
+filter matches any node.
+
+ Each {{NodeIterator}} object also has an associated reference (a
+node) and pointer before reference (a boolean).
+
+ As mentioned earlier, {{NodeIterator}} objects have an associated
+active flag, root, whatToShow, and
+filter as well.
+
+ The If toBeRemovedNode is not an inclusive ancestor of
+ nodeIterator's reference, or toBeRemovedNode is
+ nodeIterator's root, then return.
+
+ If nodeIterator's pointer before reference is true, then:
+
+ Let next be toBeRemovedNode's first following
+ node that is an inclusive descendant of nodeIterator's
+ root and is not an inclusive descendant of
+ toBeRemovedNode, and null if there is no such node.
+
+ If next is non-null, then set nodeIterator's
+ reference to next and return.
+
+ Otherwise, set nodeIterator's pointer before reference to
+ false.
+
+ Steps are not terminated here.
+ Set nodeIterator's reference to
+ toBeRemovedNode's parent, if toBeRemovedNode's
+ previous sibling is null, and to the inclusive descendant of
+ toBeRemovedNode's previous sibling that appears last in tree order
+ otherwise.
+ The The The The The To traverse, given a
+{{NodeIterator}} object iterator and a direction direction, run these steps:
+
+ Let node be iterator's reference.
+
+ Let beforeNode be iterator's
+ pointer before reference.
+
+ While true:
+
+ Branch on direction:
+
+ If beforeNode is false, then set node to the first node
+ following node in iterator's
+ iterator collection. If there is no such node, then
+ return null.
+
+ If beforeNode is true, then set it to false.
+
+ If beforeNode is true, then set node to the first node
+ preceding node in iterator's
+ iterator collection. If there is no such node, then
+ return null.
+
+ If beforeNode is false, then set it to true.
+ Let result be the result of filtering node within
+ iterator.
+
+ If result is {{NodeFilter/FILTER_ACCEPT}}, then break.
+ Set iterator's reference to node.
+
+ Set iterator's pointer before reference to
+ beforeNode.
+
+ Return node.
+ The The The {{TreeWalker}} objects can be created using the {{createTreeWalker()}}
+method on {{Document}} objects.
+
+ Each {{TreeWalker}} object has an associated current (a
+node).
+
+ As mentioned earlier {{TreeWalker}} objects have an associated
+root, whatToShow, and filter as well.
+
+ The The The The The {{TreeWalker/currentNode}} attribute's setter, when invoked, must set this's
+current to the given value.
+
+ The Return null.
+ To traverse children, given a
+walker and type, run these steps:
+
+ Let node be walker's current.
+
+ Set node to node's first child if type is
+ first, and node's last child if type is last.
+
+ While node is non-null:
+
+ Let result be the result of filtering node within
+ walker.
+
+ If result is {{NodeFilter/FILTER_ACCEPT}}, then set walker's
+ current to node and return node.
+
+ If result is {{NodeFilter/FILTER_SKIP}}, then:
+
+ Let child be node's first child if type
+ is first, and node's last child if type is last.
+
+ If child is non-null, then set node to child and
+ continue.
+ While node is non-null:
+
+ Let sibling be node's next sibling if
+ type is first, and node's previous sibling if
+ type is last.
+
+ If sibling is non-null, then set node to sibling and
+ break.
+
+ Let parent be node's parent.
+
+ If parent is null, walker's root, or
+ walker's current, then return null.
+
+ Set node to parent.
+ Return null.
+ The The To traverse siblings, given a walker
+and type, run these steps:
+
+ Let node be walker's current.
+
+ If node is root, then return null.
+
+ While true:
+
+ Let sibling be node's next sibling if
+ type is next, and node's previous sibling if
+ type is previous.
+
+ While sibling is non-null:
+
+ Set node to sibling.
+
+ Let result be the result of filtering node within
+ walker.
+
+ If result is {{NodeFilter/FILTER_ACCEPT}}, then set walker's
+ current to node and return node.
+
+ Set sibling to node's first child if
+ type is next, and node's last child if type is
+ previous.
+
+ If result is {{NodeFilter/FILTER_REJECT}} or sibling is null, then
+ set sibling to node's next sibling if type is
+ next, and node's previous sibling if type is previous.
+ Set node to node's parent.
+
+ If node is null or walker's root, then return
+ null.
+
+ If the return value of filtering node within walker is
+ {{NodeFilter/FILTER_ACCEPT}}, then return null.
+ The The The While node is not this's root:
+
+ Let sibling be node's previous sibling.
+
+ While sibling is non-null:
+
+ Set node to sibling.
+
+ Let result be the result of filtering node within
+ this.
+
+ While result is not {{NodeFilter/FILTER_REJECT}} and node has a
+ child:
+
+ Set node to node's last child.
+
+ If result is {{NodeFilter/FILTER_ACCEPT}}, then set this's
+ current to node and return node.
+
+ Set sibling to node's previous sibling.
+ If node is this's root or node's
+ parent is null, then return null.
+
+ Set node to node's parent.
+
+ If the return value of filtering node within this is
+ {{NodeFilter/FILTER_ACCEPT}}, then set this's current to
+ node and return node.
+ Return null.
+ The Let result be {{NodeFilter/FILTER_ACCEPT}}.
+
+ While true:
+
+ While result is not {{NodeFilter/FILTER_REJECT}} and node has a
+ child:
+
+ Set node to its first child.
+
+ Set result to the result of filtering node within
+ this.
+
+ If result is {{NodeFilter/FILTER_ACCEPT}}, then set this's
+ current to node and return node.
+ Let sibling be null.
+
+ Let temporary be node.
+
+ While temporary is non-null:
+
+ Set sibling to temporary's next sibling.
+
+ If sibling is non-null, then set node to sibling and
+ break.
+
+ Set temporary to temporary's parent.
+ Set result to the result of filtering node within
+ this.
+
+ If result is {{NodeFilter/FILTER_ACCEPT}}, then set this's
+ current to node and return node.
+ {{NodeFilter}} objects can be used as filter for
+{{NodeIterator}} and {{TreeWalker}} objects and also provide constants for their
+whatToShow bitmask. A {{NodeFilter}} object is typically implemented as a
+JavaScript function.
+
+ These constants can be used as filter return value:
+
+ These constants can be used for whatToShow:
+
+ Yes, the name {{DOMTokenList}} is an unfortunate legacy mishap.
+
+ A {{DOMTokenList}} object has an associated
+token set (a set), which is
+initially empty.
+
+ A {{DOMTokenList}} object also has an associated element and an attribute's
+local name.
+
+Specifications may define
+supported tokens for a {{DOMTokenList}}'s
+associated attribute's local name.
+
+ A {{DOMTokenList}} object's
+validation steps for a given
+token are:
+
+ If the associated attribute's local name does not define
+ supported tokens, throw a Let lowercase token be a copy of token, in ASCII lowercase.
+
+ If lowercase token is present in supported tokens, return true.
+
+ Return false.
+ A {{DOMTokenList}} object's update steps are:
+
+ If the associated element does not have an associated attribute and
+ token set is empty, then return.
+
+ Set an attribute value for the associated element using associated
+ attribute's local name and the result of running the ordered set
+ serializer for token set.
+ A {{DOMTokenList}} object's serialize steps
+are to return the result of running get an attribute value given the associated
+element and the associated attribute's local name. A {{DOMTokenList}} object has these attribute change steps for its associated
+element:
+
+ If localName is associated attribute's local name,
+ namespace is null, and value is null, then empty
+ token set.
+
+ Otherwise, if localName is associated attribute's local name,
+ namespace is null, then set token set to value,
+ parsed.
+ When a {{DOMTokenList}} object is created, then:
+
+ Let element be associated element.
+
+ Let localName be associated attribute's local name.
+
+ Let value be the result of
+ getting an attribute value given element and
+ localName.
+
+ Run the attribute change steps for element, localName,
+ value, value, and null.
+ Returns the number of tokens.
+
+ Returns the token with index index.
+
+ Returns true if token is present, and false otherwise.
+
+ Adds all arguments passed, except those already present.
+ Throws a "{{SyntaxError!!exception}}" {{DOMException}} if one of the arguments is the empty
+ string.
+ Throws an "{{InvalidCharacterError!!exception}}" {{DOMException}} if one of the arguments
+ contains any ASCII whitespace.
+
+ Removes arguments passed, if they are present.
+ Throws a "{{SyntaxError!!exception}}" {{DOMException}} if one of the arguments is the empty
+ string.
+ Throws an "{{InvalidCharacterError!!exception}}" {{DOMException}} if one of the arguments
+ contains any ASCII whitespace.
+
+ If force is not given, "toggles" token, removing it if it's present and
+ adding it if it's not present. If force is true, adds token
+ (same as {{add()}}). If force is false, removes token (same
+ as {{DOMTokenList/remove()}}).
+ Returns true if token is now present, and false otherwise.
+ Throws a "{{SyntaxError!!exception}}" {{DOMException}} if token is empty.
+ Throws an "{{InvalidCharacterError!!exception}}" {{DOMException}} if token contains
+ any spaces.
+
+ Replaces token with newToken.
+ Returns true if token was replaced with newToken, and false otherwise.
+ Throws a "{{SyntaxError!!exception}}" {{DOMException}} if one of the arguments is the empty
+ string.
+ Throws an "{{InvalidCharacterError!!exception}}" {{DOMException}} if one of the arguments
+ contains any ASCII whitespace.
+
+ Returns true if token is in the associated attribute's supported tokens. Returns
+ false otherwise.
+ Throws a Returns the associated set as string.
+ Can be set, to change the associated attribute.
+ The The object's supported property indices are the numbers in the range zero to object's
+token set's size minus one, unless token set is empty,
+in which case there are no supported property indices.
+
+ The The The
+ For each token in tokens:
+
+ If token is the empty string, then throw a "{{SyntaxError!!exception}}"
+ {{DOMException}}.
+
+ If token contains any ASCII whitespace, then throw an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+ For each token in tokens, append
+ token to this's token set.
+
+ Run the update steps.
+ The
+ For each token in tokens:
+
+ If token is the empty string, then throw a "{{SyntaxError!!exception}}"
+ {{DOMException}}.
+
+ If token contains any ASCII whitespace, then throw an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+ For each token in tokens, remove token from
+ this's token set.
+
+ Run the update steps.
+ The If token is the empty string, then throw a "{{SyntaxError!!exception}}"
+ {{DOMException}}.
+
+ If token contains any ASCII whitespace, then throw an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ If this's token set[token] exists, then:
+
+ If force is either not given or is false, then remove
+ token from this's token set, run the update steps and return
+ false.
+
+ Return true.
+ Otherwise, if force not given or is true, append token
+ to this's token set, run the update steps, and return true.
+
+ Return false.
+ The update steps are not always run for {{DOMTokenList/toggle()}}
+for web compatibility.
+
+ The
+ If either token or newToken is the empty string, then throw a
+ "{{SyntaxError!!exception}}" {{DOMException}}.
+
+ If either token or newToken contains any ASCII whitespace, then
+ throw an "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ If this's token set does not contain token, then
+ return false. Run the update steps.
+
+ Return true.
+ The update steps are not always run for {{DOMTokenList/replace()}}
+for web compatibility.
+
+ The
+ Let result be the return value of validation steps called with
+ token.
+
+ Return result.
+ The Setting the {{DOMTokenList/value}} attribute must set an attribute value for the
+associated element using associated attribute's local name and
+the given value.
+
+
+
+ DOM Level 3 XPath defined an API for evaluating XPath 1.0
+expressions. These APIs are widely implemented, but have not been maintained. The interface
+definitions are maintained here so that they can be updated when Web IDL changes.
+Complete definitions of these APIs remain necessary and such work is tracked and can be contributed
+to in whatwg/dom#67. [[DOM-Level-3-XPath]]
+[[XPath]] [[WEBIDL]]
+
+
+ For historical reasons you can both construct {{XPathEvaluator}} and access the same
+methods on {{Document}}.
+
+
+
+ As explained in goals this standard is a significant revision of various
+obsolete DOM specifications. This section enumerates the incompatible changes.
+
+
+ These are the changes made to the features described in the "DOM Event Architecture",
+"Basic Event Interfaces", "Mutation Events", and "Mutation Name Event Types" chapters of
+DOM Level 3 Events. The other chapters are defined by the UI Events
+specification. [[!UIEVENTS]]
+
+ These are the changes made to the features described in DOM Level 3 Core.
+
+ {{DOMString}}, {{DOMException}}, and {{DOMTimeStamp}} are now defined in Web IDL.
+
+ {{DOMStringList}} is now defined in HTML.
+
+ The remainder of interfaces and interface members listed in this section were removed to simplify
+the web platform. Implementations conforming to this specification will not support them.
+
+ Interfaces:
+
+ Interface members:
+
+ These are the changes made to the features described in the "Document Object Model Range" chapter
+of DOM Level 2 Traversal and Range.
+
+ These are the changes made to the features described in the "Document Object Model Traversal"
+chapter of DOM Level 2 Traversal and Range.
+
+ There have been a lot of people that have helped make DOM more interoperable over the years and
+thereby furthered the goals of this standard. Likewise many people have helped making this standard
+what it is today.
+
+ With that, many thanks to
+Adam Klein,
+Adrian Bateman,
+Ahmid snuggs,
+Alex Komoroske,
+Alex Russell,
+Alexey Shvayka,
+Andreu Botella,
+Anthony Ramine,
+Arkadiusz Michalski,
+Arnaud Le Hors,
+Arun Ranganathan,
+Björn Höhrmann,
+Boris Zbarsky,
+Brandon Payton,
+Brandon Slade,
+Brandon Wallace,
+Brian Kardell,
+Cameron McCormack,
+Chris Dumez,
+Chris Paris,
+Chris Rebert,
+Cyrille Tuzi,
+Daniel Glazman,
+Darin Fisher,
+David Bruant,
+David Flanagan,
+David Håsäther,
+David Hyatt,
+Deepak Sherveghar,
+Dethe Elza,
+Dimitri Glazkov,
+Domenic Denicola,
+Dominic Cooney,
+Dominique Hazaël-Massieux,
+Don Jordan,
+Doug Schepers,
+Edgar Chen,
+Elisée Maurer,
+Elliott Sprehn,
+Emilio Cobos Álvarez,
+Eric Bidelman,
+Erik Arvidsson,
+Gary Kacmarcik,
+Gavin Nicol,
+Giorgio Liscio,
+Glen Huang,
+Glenn Adams,
+Glenn Maynard,
+Hajime Morrita,
+Harald Alvestrand,
+Hayato Ito,
+Henri Sivonen,
+Hongchan Choi,
+Hunan Rostomyan,
+Ian Hickson,
+Igor Bukanov,
+Jacob Rossi,
+Jake Archibald,
+Jake Verbaten,
+James Graham,
+James Greene,
+James Robinson,
+Jeffrey Yasskin,
+Jens Lindström,
+Jesse McCarthy,
+Jinho Bang,
+João Eiras,
+Joe Kesselman,
+John Atkins,
+John Dai,
+Jonas Sicking,
+Jonathan Kingston,
+Jonathan Robie,
+Joris van der Wel,
+Joshua Bell,
+J. S. Choi,
+Jungkee Song,
+Justin Summerlin,
+Kagami Sascha Rosylight,
+呂康豪 (Kang-Hao Lu),
+田村健人 (Kent TAMURA),
+Kevin Sweeney,
+Kirill Topolyan,
+Koji Ishii,
+Lachlan Hunt,
+Lauren Wood,
+Luke Zielinski,
+Magne Andersson,
+Majid Valipour,
+Malte Ubl,
+Manish Goregaokar,
+Manish Tripathi,
+Marcos Caceres,
+Mark Miller,
+Martijn van der Ven,
+Mats Palmgren,
+Mounir Lamouri,
+Michael Stramel,
+Michael™ Smith,
+Mike Champion,
+Mike Taylor,
+Mike West,
+Ojan Vafai,
+Oliver Nightingale,
+Olli Pettay,
+Ondřej Žára,
+Peter Sharpe,
+Philip Jägenstedt,
+Philippe Le Hégaret,
+Piers Wombwell,
+Pierre-Marie Dartus,
+prosody—Gab Vereable Context(,
+Rafael Weinstein,
+Rakina Zata Amni,
+Richard Bradshaw,
+Rick Byers,
+Rick Waldron,
+Robbert Broersma,
+Robin Berjon,
+Roland Steiner,
+Rune F. Halvorsen,
+Russell Bicknell,
+Ruud Steltenpool,
+Ryosuke Niwa,
+Sam Dutton,
+Sam Sneddon,
+Samuel Giles,
+Sanket Joshi,
+Sebastian Mayr,
+Seo Sanghyeon,
+Sergey G. Grekhov,
+Shiki Okasaka,
+Shinya Kawanaka,
+Simon Pieters,
+Stef Busking,
+Steve Byrne,
+Stig Halvorsen,
+Tab Atkins,
+Takashi Sakamoto,
+Takayoshi Kochi,
+Theresa O'Connor,
+Theodore Dubois,
+timeless,
+Timo Tijhof,
+Tobie Langel,
+Tom Pixley,
+Travis Leithead,
+Trevor Rowbotham,
+triple-underscore,
+Veli Şenol,
+Vidur Apparao,
+Warren He,
+Xidorn Quan,
+Yash Handa,
+Yehuda Katz,
+Yoav Weiss,
+Yoichi Osato,
+Yoshinori Sano, and
+Zack Weinberg
+for being awesome!
+
+ This standard is written by Anne van Kesteren
+(Mozilla, annevk@annevk.nl)
+with substantial contributions from Aryeh Gregor (ayg@aryeh.name)
+and Ms2ger (ms2ger@gmail.com).
+
+ Part of the revision history of the integration points related to custom
+elements can be found in
+the w3c/webcomponents repository, which is
+available under the
+W3C Permissive Document License.
+
+
diff --git a/review-drafts/2020-12.bs b/review-drafts/2020-12.bs
new file mode 100644
index 000000000..71dec4973
--- /dev/null
+++ b/review-drafts/2020-12.bs
@@ -0,0 +1,10154 @@
+ This specification depends on the Infra Standard. [[!INFRA]]
+
+ Some of the terms used in this specification are defined in Encoding,
+Selectors, Web IDL, XML, and Namespaces in XML.
+[[!ENCODING]]
+[[!SELECTORS4]]
+[[!WEBIDL]]
+[[!XML]]
+[[!XML-NAMES]]
+
+ The term context object is an alias for this.
+
+ Usage of context object is deprecated in favor of this.
+
+ When extensions are needed, the DOM Standard can be updated accordingly, or a new standard
+can be written that hooks into the provided extensibility hooks for
+applicable specifications.
+
+
+
+ A tree is a finite hierarchical tree structure. In
+tree order is preorder, depth-first traversal of a
+tree.
+
+
+ An object that
+participates
+in a tree has a parent, which is either
+null or an object, and has
+children, which is an
+ordered set of objects. An object A whose parent is object
+B is a child of B.
+
+ The root of an object is itself, if its
+parent is null, or else it is the root of its
+parent. The root of a tree is any object
+participating in that tree whose parent is null.
+
+An object A is called a
+descendant of an object
+B, if either A is a
+child of B or
+A is a child of an
+object C that is a
+descendant of B.
+
+An
+inclusive descendant is
+an object or one of its
+descendants.
+
+An object A is called an
+ancestor of an object
+B if and only if B is a
+descendant of
+A.
+
+An inclusive ancestor is
+an object or one of its ancestors.
+
+An object A is called a
+sibling of an object
+B, if and only if B and A
+share the same non-null parent.
+
+An inclusive sibling is an
+object or one of its siblings.
+
+An object A is
+preceding an object
+B if A and B are in the
+same tree and A comes
+before B in
+tree order.
+
+An object A is
+following an object
+B if A and B are in the
+same tree and A comes
+after B in
+tree order.
+
+The first child of an object is its
+first child or null if it has no children.
+
+The last child of an object is its
+last child or null if it has no children.
+
+The previous sibling of an
+object is its first preceding
+sibling or null if it has no
+preceding
+sibling.
+
+The next sibling of an
+object is its first following
+sibling or null if it has no
+following
+sibling.
+
+ The index of an object is its number of
+preceding siblings, or 0 if it has none.
+
+
+ The ordered set parser takes a string
+input and then runs these steps:
+
+ Let inputTokens be the result of
+ splitting input on ASCII whitespace.
+
+ Let tokens be a new ordered set.
+
+ For each token in inputTokens, append
+ token to tokens.
+
+ The ordered set serializer takes a
+set and returns the concatenation of set using U+0020 SPACE.
+
+
+ To scope-match a selectors string selectors against a
+node, run these steps:
+
+ Let s be the result of parse a selector selectors.
+ [[!SELECTORS4]]
+
+ If s is failure, then throw a "{{SyntaxError!!exception}}"
+ {{DOMException}}.
+
+ Return the result of match a selector against a tree with s and
+ node's root using scoping root node. [[!SELECTORS4]].
+ Support for namespaces within selectors is not planned and will not be
+added.
+
+
+ To validate a qualifiedName, throw an
+"{{InvalidCharacterError!!exception}}" {{DOMException}} if qualifiedName does not match
+the Although events are typically dispatched by the user agent
+as the result of user interaction or the completion of some task, applications can dispatch
+events themselves by using what are commonly known as synthetic events:
+
+ When an event is dispatched to an object that participates in a tree
+(e.g., an element), it can reach event listeners on that object's
+ancestors too. Effectively, all the object's inclusive ancestor event listeners
+whose capture is true are invoked, in tree order. And then, if
+event's {{Event/bubbles}} is true, all the object's inclusive ancestor
+event listeners whose capture is false are invoked, now in
+reverse tree order.
+
+ Let's look at an example of how events work in a tree:
+
+ The An {{Event}} object is simply named an event. It allows for
+signaling that something has occurred, e.g., that an image has completed downloading. A potential event target is null or an {{EventTarget}} object.
+
+ An event has an associated target (a
+potential event target). Unless stated otherwise it is null.
+
+ An event has an associated relatedTarget (a
+potential event target). Unless stated otherwise it is null.
+
+ Other specifications use relatedTarget to define a
+ An event has an associated touch target list (a
+list of zero or more potential event targets). Unless stated otherwise it is the
+empty list.
+
+ The touch target list is for the exclusive use of defining the
+{{TouchEvent}} interface and related interfaces. [[TOUCH-EVENTS]]
+
+ An event has an associated path. A path is a
+list of structs. Each struct consists of an
+invocation target (an {{EventTarget}} object), an
+invocation-target-in-shadow-tree (a boolean), a
+shadow-adjusted target (a potential event target), a
+relatedTarget (a
+potential event target), a touch target list (a list
+of potential event targets), a root-of-closed-tree (a boolean), and
+a slot-in-closed-tree (a boolean). A path is initially
+the empty list. The The The The The Let composedPath be an empty list.
+
+ If path is empty, then return composedPath.
+
+ Let currentTarget be this's {{Event/currentTarget}} attribute value.
+
+ Append currentTarget to composedPath.
+
+ Let currentTargetIndex be 0.
+
+ Let currentTargetHiddenSubtreeLevel be 0.
+
+ Let index be path's size − 1.
+
+ While index is greater than or equal to 0:
+
+ If path[index]'s root-of-closed-tree is true,
+ then increase currentTargetHiddenSubtreeLevel by 1.
+
+ If path[index]'s invocation target is
+ currentTarget, then set currentTargetIndex to index and
+ break.
+
+ If path[index]'s slot-in-closed-tree is true,
+ then decrease currentTargetHiddenSubtreeLevel by 1.
+
+ Decrease index by 1.
+ Let currentHiddenLevel and maxHiddenLevel be
+ currentTargetHiddenSubtreeLevel.
+
+ Set index to currentTargetIndex − 1.
+
+ While index is greater than or equal to 0:
+
+ If path[index]'s root-of-closed-tree is true,
+ then increase currentHiddenLevel by 1.
+
+ If currentHiddenLevel is less than or equal to maxHiddenLevel, then
+ prepend path[index]'s
+ invocation target to composedPath.
+
+ If path[index]'s slot-in-closed-tree is true,
+ then:
+
+ Decrease currentHiddenLevel by 1.
+
+ If currentHiddenLevel is less than maxHiddenLevel, then set
+ maxHiddenLevel to currentHiddenLevel.
+ Decrease index by 1.
+ Set currentHiddenLevel and maxHiddenLevel to
+ currentTargetHiddenSubtreeLevel.
+
+ Set index to currentTargetIndex + 1.
+
+ While index is less than path's size:
+
+ If path[index]'s slot-in-closed-tree is true,
+ then increase currentHiddenLevel by 1.
+
+ If currentHiddenLevel is less than or equal to maxHiddenLevel, then
+ append path[index]'s
+ invocation target to composedPath.
+
+ If path[index]'s root-of-closed-tree is true,
+ then:
+
+ Decrease currentHiddenLevel by 1.
+
+ If currentHiddenLevel is less than maxHiddenLevel, then set
+ maxHiddenLevel to currentHiddenLevel.
+ Increase index by 1.
+ Return composedPath.
+ The Initially the attribute must be initialized to {{Event/NONE}}.
+
+ Each event has the following associated flags that are all initially unset:
+
+ The The The {{Event/cancelBubble}} attribute's setter, when invoked, must set this's
+stop propagation flag if the given value is true, and do nothing otherwise.
+
+ The The To set the canceled flag, given an event event, if
+event's {{Event/cancelable}} attribute value is true and event's
+in passive listener flag is unset, then set event's canceled flag, and do
+nothing otherwise.
+
+ The The {{Event/returnValue}} attribute's setter, when invoked, must set the canceled flag
+with this if the given value is false, and do nothing otherwise.
+
+ The There are scenarios where invoking {{Event/preventDefault()}} has no
+effect. User agents are encouraged to log the precise cause in a developer console, to aid
+debugging.
+
+ The The The {{Event/isTrusted}} is a convenience that indicates whether an
+event is dispatched by the user agent (as opposed to using
+{{EventTarget/dispatchEvent()}}). The sole legacy exception is {{HTMLElement/click()}}, which causes
+the user agent to dispatch an event whose {{Event/isTrusted}} attribute is initialized to
+false.
+
+ The To initialize an event, with
+type, bubbles, and cancelable, run these steps:
+
+ Set event's initialized flag.
+
+ Unset event's stop propagation flag,
+ stop immediate propagation flag, and canceled flag.
+
+ Set event's {{Event/isTrusted}} attribute to false.
+
+ Set event's target to null.
+
+ Set event's {{Event/type}} attribute to type.
+
+ Set event's {{Event/bubbles}} attribute to bubbles.
+
+ Set event's {{Event/cancelable}} attribute to cancelable.
+ The
+ If this's dispatch flag is set, then return.
+
+ Initialize this with type, bubbles, and
+ cancelable.
+ {{Event/initEvent()}} is redundant with event constructors and
+incapable of setting {{Event/composed}}. It has to be supported for legacy content.
+
+
+ Each {{Window}} object has an associated current event (undefined or an
+{{Event}} object). Unless stated otherwise it is undefined.
+
+ The Web developers are strongly encouraged to instead rely on the {{Event}} object passed
+to event listeners, as that will result in more portable code. This attribute is not available in
+workers or worklets, and is inaccurate for events dispatched in shadow trees.
+
+
+ The The
+ If this's dispatch flag is set, then return.
+
+ Initialize this with type, bubbles, and
+ cancelable.
+
+ Set this's {{CustomEvent/detail}} attribute to detail.
+ This construct can be used by {{Event}} subclasses that have a more complex structure
+than a simple 1:1 mapping between their initializing dictionary members and IDL attributes.
+
+ When a constructor of the {{Event}}
+interface, or of an interface that inherits from the {{Event}} interface, is invoked, these steps
+must be run, given the arguments type and eventInitDict:
+
+ Let event be the result of running the inner event creation steps with
+ this interface, null, now, and eventInitDict.
+
+ Initialize event's {{Event/type}} attribute to type.
+
+ Return event.
+ To
+create an event
+using eventInterface, which must be either {{Event}} or an interface that inherits from
+it, and optionally given a Realm realm, run these steps: If realm is not given, then set it to null.
+
+ Let dictionary be the result of converting
+ the JavaScript value undefined to the dictionary type accepted by eventInterface's
+ constructor. (This dictionary type will either be {{EventInit}} or a dictionary that inherits from
+ it.)
+
+ This does not work if members are required; see
+ whatwg/dom#600.
+
+ Let event be the result of running the inner event creation steps with
+ eventInterface, realm, the time of the occurrence that the event is
+ signaling, and dictionary.
+
+ In macOS the time of the occurrence for input
+ actions is available via the Initialize event's {{Event/isTrusted}} attribute to true.
+
+ Return event.
+ Create an event is meant to be used by other specifications which need to
+separately create and dispatch events, instead of simply
+firing them. It ensures the event's attributes are initialized to the
+correct defaults. The inner event creation steps, given an interface,
+realm, time, and dictionary, are as follows: Let event be the result of creating a new object using eventInterface. If
+ realm is non-null, then use that Realm; otherwise, use the default behavior defined in
+ Web IDL.
+
+ As of the time of this writing Web IDL does not yet define any default behavior;
+ see heycam/webidl#135.
+
+ Set event's initialized flag.
+
+ Initialize event's {{Event/timeStamp}} attribute to a {{DOMHighResTimeStamp}}
+ representing the high resolution time from the time origin to time.
+
+ User agents should set a minimum resolution of event's
+ {{Event/timeStamp}} attribute to 5 microseconds following the existing clock resolution
+ recommendation. [[!HR-TIME]]
+
+ For each member → value in dictionary, if
+ event has an attribute whose identifier is member, then
+ initialize that attribute to value.
+
+ Run the event constructing steps with event.
+
+ Return event.
+ An {{EventTarget}} object represents a target to which an event can be dispatched
+when something has occurred.
+
+ Each {{EventTarget}} object has an associated event listener list (a
+list of zero or more event listeners). It is initially the empty list.
+
+
+ An event listener can be used to observe a specific
+event and consists of:
+
+ Although callback is an {{EventListener}}
+object, an event listener is a broader concept as can be seen above.
+
+ Each {{EventTarget}} object also has an associated get the parent algorithm,
+which takes an event event, and returns an {{EventTarget}} object. Unless
+specified otherwise it returns null.
+
+ Nodes, shadow roots, and documents
+override the get the parent algorithm.
+
+ Each {{EventTarget}} object can have an associated
+activation behavior algorithm. The
+activation behavior algorithm is passed an event, as indicated in the
+dispatch algorithm. This exists because user agents perform certain actions for certain
+{{EventTarget}} objects, e.g., the <{area}> element, in response to synthetic {{MouseEvent}}
+events whose {{Event/type}} attribute is Each {{EventTarget}} object that has activation behavior, can additionally
+have both (not either) a legacy-pre-activation behavior algorithm
+and a legacy-canceled-activation behavior algorithm.
+
+ These algorithms only exist for checkbox and radio <{input}> elements and
+are not to be used for anything else. [[!HTML]]
+
+ Creates a new {{EventTarget}} object, which can be used by developers to dispatch and
+ listen for events.
+
+ Appends an event listener for events whose {{Event/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 {{EventListenerOptions/capture}}.
+
+ When set to true, options's {{EventListenerOptions/capture}} prevents
+ callback from being invoked when the event's
+ {{Event/eventPhase}} attribute value is {{Event/BUBBLING_PHASE}}. When false (or not present),
+ callback will not be invoked when event's {{Event/eventPhase}}
+ attribute value is {{Event/CAPTURING_PHASE}}. Either way, callback
+ will be invoked if event's {{Event/eventPhase}} attribute value is {{Event/AT_TARGET}}.
+
+ When set to true, options's {{AddEventListenerOptions/passive}} indicates that the
+ callback will not cancel the event by invoking
+ {{Event/preventDefault()}}. This is used to enable performance optimizations described in
+ [[#observing-event-listeners]].
+
+ When set to true, options's {{AddEventListenerOptions/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 {{AddEventListenerOptions/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.
+
+ Removes the event listener in target's
+ event listener list with the same type, callback, and
+ options.
+
+ Dispatches a synthetic event event to target and returns true
+ if either event's {{Event/cancelable}} attribute value is false or its
+ {{Event/preventDefault()}} method was not invoked, and false otherwise.
+ To flatten options, run these
+steps:
+
+ If options is a boolean, then return options.
+
+ Return |options|["{{EventListenerOptions/capture}}"].
+ To flatten more options, run these
+steps:
+
+ Let capture be the result of flattening options.
+
+ Let once and passive be false.
+
+ Let |signal| be null.
+
+ If |options| is a dictionary, then:
+
+ Set |passive| to |options|["{{AddEventListenerOptions/passive}}"] and |once| to
+ |options|["{{AddEventListenerOptions/once}}"].
+
+ If |options|["{{AddEventListenerOptions/signal}}"] [=map/exists=], then set |signal| to
+ |options|["{{AddEventListenerOptions/signal}}"].
+ Return capture, passive, once, and signal.
+ The Because of the defaults stated elsewhere, the returned {{EventTarget}}'s
+get the parent algorithm will return null, and it will have no activation behavior,
+legacy-pre-activation behavior, or legacy-canceled-activation behavior.
+
+ In the future we could allow custom get the parent algorithms. Let us know
+if this would be useful for your programs. For now, all author-created {{EventTarget}}s do not
+participate in a tree structure. To add an event listener, given an {{EventTarget}} object
+eventTarget and an event listener listener, run these steps:
+
+ If eventTarget is a {{ServiceWorkerGlobalScope}} object, its
+ service worker's
+ script resource's
+ has ever been evaluated flag is set, and listener's
+ type matches the {{Event/type}} attribute value of any of the
+ service worker events, then report a warning to the console that this might not give
+ the expected results. [[!SERVICE-WORKERS]]
+
+ If signal is not null and its [=AbortSignal/aborted flag=] is
+ set, then return.
+
+ If listener's callback is null, then return.
+
+ If eventTarget's event listener list does not contain an
+ event listener whose type is listener's
+ type, callback is listener's
+ callback, and capture is
+ listener's capture, then append
+ listener to eventTarget's event listener list.
+
+ If listener's signal is not null, then
+ add the following abort steps to it:
+
+ The add an event listener concept exists to ensure event handlers use
+the same code path. [[HTML]]
+
+ The
+ Let capture, passive, and once be the result of
+ flattening more options.
+
+ Add an event listener with this and an event listener whose
+ type is type, callback is
+ callback, capture is capture,
+ passive is passive, once is
+ once, and signal is signal.
+ To remove an event listener, given an {{EventTarget}} object
+eventTarget and an event listener listener, run these steps:
+
+ If eventTarget is a {{ServiceWorkerGlobalScope}} object and its
+ service worker's
+ set of event types to handle contains type, then
+ report a warning to the console that this might not give the expected results.
+ [[!SERVICE-WORKERS]]
+
+ Set listener's removed to true and
+ remove listener from eventTarget's
+ event listener list.
+ HTML needs this to define event handlers. [[HTML]]
+
+ To remove all event listeners, given an {{EventTarget}} object
+eventTarget, for each listener of eventTarget's
+event listener list, remove an event listener with
+eventTarget and listener.
+
+ HTML needs this to define The
+ Let capture be the result of flattening options.
+
+ If this's event listener list contains an
+ event listener whose type is type,
+ callback is callback, and
+ capture is capture, then remove an event listener
+ with this and that event listener.
+ The event listener list will not contain multiple event listeners with equal
+type, callback, and capture, as add an event listener
+prevents that.
+
+ The If event's dispatch flag is set, or if its initialized flag is not
+ set, then throw an "{{InvalidStateError!!exception}}" {{DOMException}}.
+
+ Initialize event's {{Event/isTrusted}} attribute to false.
+
+ Return the result of dispatching event to this.
+ In general, developers do not expect the presence of an event listener to be observable.
+The impact of an event listener is determined by its callback. That is, a developer
+adding a no-op event listener would not expect it to have any side effects.
+
+ Unfortunately, some event APIs have been designed such that implementing them efficiently
+requires observing event listeners. This can make the presence of listeners observable in
+that even empty listeners can have a dramatic performance impact on the behavior of the application.
+For example, touch and wheel events which can be used to block asynchronous scrolling. In some cases
+this problem can be mitigated by specifying the event to be {{Event/cancelable}} only when there is
+at least one non-{{AddEventListenerOptions/passive}} listener. For example,
+non-{{AddEventListenerOptions/passive}} {{TouchEvent}} listeners must block scrolling, but if all
+listeners are {{AddEventListenerOptions/passive}} then scrolling can be allowed to start
+in parallel by making the {{TouchEvent}} uncancelable (so that calls to
+{{Event/preventDefault()}} are ignored). So code dispatching an event is able to observe the absence
+of non-{{AddEventListenerOptions/passive}} listeners, and use that to clear the {{Event/cancelable}}
+property of the event being dispatched.
+
+ Ideally, any new event APIs are defined such that they do not need this property (use
+public-script-coord@w3.org
+for discussion).
+
+
+ To dispatch an event to a
+target, with an optional legacy target override flag and an optional
+legacyOutputDidListenersThrowFlag, run these steps:
+
+ Set event's dispatch flag.
+
+ Let targetOverride be target, if legacy target override flag
+ is not given, and target's associated legacy target override flag is only used by HTML and only when
+ target is a {{Window}} object.
+
+ Let activationTarget be null.
+
+ Let relatedTarget be the result of retargeting event's
+ relatedTarget against target.
+
+ If target is not relatedTarget or target is event's
+ relatedTarget, then:
+
+ Let touchTargets be a new list.
+
+ For each touchTarget of event's
+ touch target list, append the result of retargeting
+ touchTarget against target to touchTargets.
+
+ Append to an event path with event, target,
+ targetOverride, relatedTarget, touchTargets, and false.
+
+ Let isActivationEvent be true, if event is a {{MouseEvent}} object
+ and event's {{Event/type}} attribute is " If isActivationEvent is true and target has
+ activation behavior, then set activationTarget to
+ target.
+
+ Let slottable be target, if target is a slottable
+ and is assigned, and null otherwise.
+
+ Let slot-in-closed-tree be false.
+
+ Let parent be the result of invoking target's get the parent
+ with event.
+
+ While parent is non-null: If slottable is non-null:
+
+ Assert: parent is a slot.
+
+ Set slottable to null.
+
+ If parent's root is a shadow root whose
+ mode is " If parent is a slottable and is assigned, then
+ set slottable to parent.
+
+ Let relatedTarget be the result of retargeting event's
+ relatedTarget against parent.
+
+ Let touchTargets be a new list.
+
+ For each touchTarget of event's
+ touch target list, append the result of retargeting
+ touchTarget against parent to touchTargets.
+
+ If parent is a {{Window}} object, or parent is a node and
+ target's root is a shadow-including inclusive ancestor of
+ parent, then:
+
+ If isActivationEvent is true, event's {{Event/bubbles}}
+ attribute is true, activationTarget is null, and parent has
+ activation behavior, then set activationTarget to
+ parent.
+
+ Append to an event path with event, parent, null,
+ relatedTarget, touchTargets, and slot-in-closed-tree.
+ Otherwise, if parent is relatedTarget, then set parent
+ to null.
+
+ Otherwise, set target to parent and then:
+
+ If isActivationEvent is true, activationTarget is null, and
+ target has activation behavior, then set
+ activationTarget to target.
+
+ Append to an event path with event, parent,
+ target, relatedTarget, touchTargets, and
+ slot-in-closed-tree.
+ If parent is non-null, then set parent to the result of invoking
+ parent's get the parent with event.
+
+ Set slot-in-closed-tree to false.
+ Let clearTargetsStruct be the last struct in event's
+ path whose shadow-adjusted target is non-null.
+
+ Let clearTargets be true if clearTargetsStruct's
+ shadow-adjusted target, clearTargetsStruct's
+ relatedTarget, or an {{EventTarget}} object in
+ clearTargetsStruct's touch target list is a node
+ and its root is a shadow root, and false otherwise.
+
+ If activationTarget is non-null and activationTarget has
+ legacy-pre-activation behavior, then run activationTarget's
+ legacy-pre-activation behavior.
+
+ For each struct in event's path, in
+ reverse order:
+
+ If struct's shadow-adjusted target is non-null, then
+ set event's {{Event/eventPhase}} attribute to {{Event/AT_TARGET}}.
+
+ Otherwise, set event's {{Event/eventPhase}} attribute to
+ {{Event/CAPTURING_PHASE}}.
+
+ Invoke with struct, event, " For each struct in event's path:
+
+ If struct's shadow-adjusted target is non-null, then
+ set event's {{Event/eventPhase}} attribute to {{Event/AT_TARGET}}.
+
+ Otherwise:
+
+ If event's {{Event/bubbles}} attribute is false, then
+ continue.
+
+ Set event's {{Event/eventPhase}} attribute to {{Event/BUBBLING_PHASE}}.
+ Invoke with struct, event, " Set event's {{Event/eventPhase}} attribute to {{Event/NONE}}.
+
+ Set event's {{Event/currentTarget}} attribute to null.
+
+ Set event's path to the empty list.
+
+ Unset event's dispatch flag, stop propagation flag, and
+ stop immediate propagation flag.
+
+ If clearTargets, then:
+
+ Set event's target to null.
+
+ Set event's relatedTarget to null.
+
+ Set event's touch target list to the empty list.
+ If activationTarget is non-null, then:
+
+ If event's canceled flag is unset, then run
+ activationTarget's activation behavior with event.
+
+ Otherwise, if activationTarget has
+ legacy-canceled-activation behavior, then run
+ activationTarget's legacy-canceled-activation behavior.
+ Return false if event's canceled flag is set, and true otherwise.
+ To append to an event path, given an
+event, invocationTarget, shadowAdjustedTarget,
+relatedTarget, touchTargets, and a slot-in-closed-tree, run these
+steps: Let invocationTargetInShadowTree be false.
+
+ If invocationTarget is a node and its root is a
+ shadow root, then set invocationTargetInShadowTree to true.
+
+ Let root-of-closed-tree be false.
+
+ If invocationTarget is a shadow root whose mode
+ is " Append a new struct to event's path
+ whose invocation target is invocationTarget,
+ invocation-target-in-shadow-tree is invocationTargetInShadowTree,
+ shadow-adjusted target is shadowAdjustedTarget,
+ relatedTarget is relatedTarget,
+ touch target list is touchTargets,
+ root-of-closed-tree is root-of-closed-tree, and
+ slot-in-closed-tree is slot-in-closed-tree.
+ To invoke, given a struct,
+event, phase, and an optional legacyOutputDidListenersThrowFlag,
+run these steps:
+
+ Set event's target to the
+ shadow-adjusted target of the last struct in event's
+ path, that is either struct or preceding struct, whose
+ shadow-adjusted target is non-null.
+
+ Set event's relatedTarget to struct's
+ relatedTarget.
+
+ Set event's touch target list to struct's
+ touch target list.
+
+ If event's stop propagation flag is set, then return.
+
+ Initialize event's {{Event/currentTarget}} attribute to struct's
+ invocation target.
+
+ Let listeners be a clone of event's
+ {{Event/currentTarget}} attribute value's event listener list.
+
+ This avoids event listeners added after this point from being
+ run. Note that removal still has an effect due to the removed field.
+
+ Let invocationTargetInShadowTree be struct's
+ invocation-target-in-shadow-tree.
+
+ Let found be the result of running inner invoke with event,
+ listeners, phase, invocationTargetInShadowTree, and
+ legacyOutputDidListenersThrowFlag if given.
+
+ If found is false and event's {{Event/isTrusted}} attribute is true,
+ then:
+
+ Let originalEventType be event's {{Event/type}} attribute value.
+
+ If event's {{Event/type}} attribute value is a match for any of the strings in the
+ first column in the following table, set event's {{Event/type}} attribute value to
+ the string in the second column on the same row as the matching string, and return otherwise.
+
+ Inner invoke with event, listeners, phase,
+ invocationTargetInShadowTree, and legacyOutputDidListenersThrowFlag
+ if given.
+
+ Set event's {{Event/type}} attribute value to originalEventType.
+ To inner invoke, given an
+event, listeners, phase, invocationTargetInShadowTree,
+and an optional legacyOutputDidListenersThrowFlag, run these steps:
+
+ Let found be false.
+
+ For each listener in listeners, whose
+ removed is false:
+
+ If event's {{Event/type}} attribute value is not listener's
+ type, then continue.
+
+ Set found to true.
+
+ If phase is " If phase is " If listener's once is true, then
+ remove listener from event's {{Event/currentTarget}}
+ attribute value's event listener list.
+
+
+ Let global be listener callback's
+ associated Realm's global object.
+
+ Let currentEvent be undefined.
+
+ If global is a {{Window}} object, then:
+
+ Set currentEvent to global's current event.
+
+ If invocationTargetInShadowTree is false, then set global's
+ current event to event.
+ If listener's passive is true, then set
+ event's in passive listener flag.
+
+ Call a user object's operation with listener's
+ callback, " Report the exception.
+
+ Set legacyOutputDidListenersThrowFlag if given.
+
+ The legacyOutputDidListenersThrowFlag is only used by Indexed
+ Database API. [[INDEXEDDB]]
+ Unset event's in passive listener flag.
+
+ If global is a {{Window}} object, then set global's
+ current event to currentEvent.
+
+ If event's stop immediate propagation flag is set, then return
+ found.
+ Return found.
+ To fire an event named e at target,
+optionally using an eventConstructor, with a description of how IDL attributes are to be
+initialized, and a legacy target override flag, run these steps:
+
+ If eventConstructor is not given, then let eventConstructor be
+ {{Event}}.
+
+ Let event be the result of creating an event given
+ eventConstructor, in the relevant Realm of target.
+
+ Initialize event's {{Event/type}} attribute to e.
+
+ Initialize any other IDL attributes of event as described in the invocation of this
+ algorithm.
+
+ This also allows for the {{Event/isTrusted}} attribute to be set to false.
+
+ Return the result of dispatching event at target, with
+ legacy target override flag set if set.
+ Fire in the context of DOM is short for
+creating, initializing, and dispatching an event.
+Fire an event makes that process easier to write down.
+
+ If the event needs its {{Event/bubbles}} or {{Event/cancelable}} attribute initialized,
+ one could write "fire an event named Or, when a custom constructor is needed, "fire an event named Occasionally the return value is important:
+
+ Let doAction be the result of firing an event named
+ If doAction is true, then …
+ An event signifies an occurrence, not an action. Phrased differently, it
+represents a notification from an algorithm and can be used to influence the future course
+of that algorithm (e.g., through invoking {{Event/preventDefault()}}). Events must not be
+used as actions or initiators that cause some algorithm to start running. That is not what
+they are for.
+
+ This is called out here specifically because previous
+iterations of the DOM had a concept of "default actions" associated with events
+that gave folks all the wrong ideas. Events do not represent or cause actions, they
+can only be used to influence an ongoing one.
+
+
+
+ Though promises do not have a built-in aborting mechanism, many APIs using them require abort
+semantics. {{AbortController}} is meant to support these requirements by providing an
+{{AbortController/abort()}} method that toggles the state of a corresponding {{AbortSignal}} object.
+The API which wishes to support aborting can accept an {{AbortSignal}} object, and use its state to
+determine how to proceed.
+
+ APIs that rely upon {{AbortController}} are encouraged to respond to {{AbortController/abort()}}
+by rejecting any unsettled promise with a new "{{AbortError!!exception}}" {{DOMException}}.
+
+ A hypothetical APIs that require more granular control could extend both {{AbortController}} and
+ {{AbortSignal}} objects according to their needs.
+ An {{AbortController}} object has an associated signal (an
+{{AbortSignal}} object).
+
+ The
+ The The An {{AbortSignal}} object has an associated aborted flag. It is
+unset unless specified otherwise.
+
+ An {{AbortSignal}} object has associated abort algorithms, which is a
+set of algorithms which are to be executed when its [=AbortSignal/aborted flag=] is
+set. Unless specified otherwise, its value is the empty set.
+
+ To add an algorithm algorithm to an {{AbortSignal}}
+object signal, run these steps:
+
+ If signal's aborted flag is set, then return.
+
+ Append algorithm to signal's
+ abort algorithms.
+ To remove an algorithm algorithm from an
+{{AbortSignal}} signal, remove algorithm from
+signal's abort algorithms.
+
+ The [=AbortSignal/abort algorithms=] enable APIs with complex
+requirements to react in a reasonable way to {{AbortController/abort()}}. For example, a given API's
+[=AbortSignal/aborted flag=] might need to be propagated to a cross-thread environment, such as a
+service worker.
+
+ The aborted getter steps are to return true if this's
+[=AbortSignal/aborted flag=] is set; otherwise false.
+
+ The Changes to an {{AbortSignal}} object represent the wishes of the corresponding
+{{AbortController}} object, but an API observing the {{AbortSignal}} object can chose to ignore
+them. For instance, if the operation has already completed.
+
+ To signal abort, given a {{AbortSignal}} object
+signal, run these steps:
+
+ If signal's [=AbortSignal/aborted flag=] is set, then return.
+
+ Set signal's [=AbortSignal/aborted flag=].
+
+ For each algorithm in signal's
+ [=AbortSignal/abort algorithms=]: run algorithm.
+
+ Empty signal's abort algorithms.
+
+ [=Fire an event=] named {{AbortSignal/abort}} at signal.
+ A followingSignal (an {{AbortSignal}}) is made to
+follow a parentSignal (an {{AbortSignal}}) by running
+these steps:
+
+ If followingSignal's [=AbortSignal/aborted flag=] is set, then return.
+
+ If parentSignal's [=AbortSignal/aborted flag=] is set, then
+ signal abort on followingSignal.
+
+ Otherwise, add the following abort steps to
+ parentSignal:
+
+ Signal abort on followingSignal.
+ Any web platform API using promises to represent operations that can be aborted must adhere to
+the following:
+
+ The steps for a promise-returning method Let |p| be [=a new promise=].
+
+ If |options|' If |options|' [=AbortSignal/Add|Add the following abort steps=] to |options|' Stop doing amazing things.
+
+ [=Reject=] |p| with an "{{AbortError!!exception}}" {{DOMException}}.
+ Run these steps [=in parallel=]:
+
+ Let |amazingResult| be the result of doing some amazing things.
+
+ [=/Resolve=] |p| with |amazingResult|.
+ Return |p|.
+ APIs not using promises should still adhere to the above as much as possible.
+
+
+
+ Each such document is represented as a node tree. Some of the nodes in a
+tree can have children, while others are always leaves.
+
+To illustrate, consider this HTML document:
+
+ Note that, due to the magic that is HTML parsing, not all
+ASCII whitespace were turned into {{Text}} nodes, but the general concept is
+clear. Markup goes in, a tree of nodes comes out.
+
+
+ The most excellent
+Live DOM Viewer
+can be used to explore this matter in more detail.
+
+
+ {{Document}}, {{DocumentType}}, {{DocumentFragment}}, {{Element}}, {{Text}},
+{{ProcessingInstruction}}, and {{Comment}} objects (simply called
+nodes) participate in a tree, simply named the
+node tree.
+
+ A node tree is constrained as follows, expressed as a relationship between the type of
+node and its allowed children:
+
+ In tree order:
+ Zero or more nodes each of which is {{ProcessingInstruction}} or {{Comment}}.
+ Optionally one {{DocumentType}} node.
+ Zero or more nodes each of which is {{ProcessingInstruction}} or {{Comment}}.
+ Optionally one {{Element}} node.
+ Zero or more nodes each of which is {{ProcessingInstruction}} or {{Comment}}.
+ Zero or more nodes each of which is {{Element}}, {{Text}}, {{ProcessingInstruction}}, or
+ {{Comment}}.
+ None.
+ To determine the length of a node
+node, switch on node:
+
+ Zero.
+
+ Its number of children.
+ A node is considered empty if its
+length is zero.
+
+
+ A document tree is a node tree whose
+root is a document.
+
+ The document element of a document is the element whose
+parent is that document, if it exists, and null otherwise.
+
+ Per the node tree constraints, there can be only one such
+element.
+
+ An element is in a document tree if its root is a
+document.
+
+ An element is in a document if it is in a document tree.
+The term in a document is no longer supposed to be used. It indicates that
+the standard using it has not been updated to account for shadow trees.
+
+
+ A shadow tree is a node tree whose
+root is a shadow root.
+
+ A shadow root is always attached to another node tree through its
+host. A shadow tree is therefore never alone. The
+node tree of a shadow root's host is sometimes
+referred to as the light tree. A shadow tree's corresponding light tree can be a shadow tree
+itself. An element is connected if its
+shadow-including root is a document.
+
+ A shadow tree contains zero or more elements that are
+slots. A slot can only be created through HTML's <{slot}> element. A slot has an associated name (a string). Unless stated
+otherwise it is the empty string. Use these attribute change steps to update a slot's name:
+
+ If element is a slot, localName is If value is oldValue, then return.
+
+ If value is null and oldValue is the empty string, then return.
+
+ If value is the empty string and oldValue is null, then return.
+
+ If value is null or the empty string, then set element's
+ name to the empty string.
+
+ Otherwise, set element's name to value.
+
+ Run assign slottables for a tree with element's root.
+ The first slot in a shadow tree, in tree order, whose
+name is the empty string, is sometimes known as the "default slot". A slot has an associated assigned nodes (a list of
+slottables). Unless stated otherwise it is empty. {{Element}} and {{Text}} nodes are
+slottables. A slot can be a slottable.
+
+ A slottable has an associated name (a
+string). Unless stated otherwise it is the empty string. Use these attribute change steps to update a slottable's name:
+
+ If localName is If value is oldValue, then return.
+
+ If value is null and oldValue is the empty string, then return.
+
+ If value is the empty string and oldValue is null, then return.
+
+ If value is null or the empty string, then set element's
+ name to the empty string.
+
+ Otherwise, set element's name to value.
+
+ If element is assigned, then run assign slottables
+ for element's assigned slot.
+
+ Run assign a slot for element.
+ A slottable has an associated
+assigned slot (null or a slot).
+Unless stated otherwise it is null. A slottable is
+assigned if its assigned slot is
+non-null. To find a slot for a given slottable
+slottable and an optional open flag (unset unless stated otherwise), run these
+steps: If slottable's parent is null, then return null. Let shadow be slottable's parent's
+ shadow root. If shadow is null, then return null. If the open flag is set and shadow's mode is
+ not " Return the first slot in tree order in shadow's
+ descendants whose name is slottable's
+ name, if any, and null otherwise. To find slottables
+for a given slot slot, run these steps: Let result be an empty list. If slot's root is not a shadow root, then return
+ result. For each slottable child of host, slottable, in
+ tree order: Let foundSlot be the result of finding a slot given
+ slottable. If foundSlot is slot, then append slottable to
+ result. Return result. To
+find flattened slottables
+for a given slot slot, run these steps: Let result be an empty list. If slot's root is not a shadow root, then return
+ result. Let slottables be the result of finding slottables given
+ slot. If slottables is the empty list, then append each slottable
+ child of slot, in tree order, to slottables. For each node in slottables:
+
+ If node is a slot whose root is a shadow root,
+ then:
+
+ Let temporaryResult be the result of finding flattened slottables given
+ node. Append each slottable in temporaryResult, in order, to
+ result. Otherwise, append node to result. Return result. To assign slottables for a slot slot,
+run these steps:
+
+ Let slottables be the result of finding slottables for slot.
+
+ If slottables and slot's assigned nodes are not
+ identical, then run signal a slot change for slot.
+
+ Set slot's assigned nodes to slottables.
+
+ For each slottable in slottables, set slottable's
+ assigned slot to slot.
+ To assign slottables for a tree, given a
+node root, run assign slottables for each slot slot
+in root's inclusive descendants, in tree order.
+
+ To assign a slot, given a slottable slottable, run these
+steps:
+
+ Let slot be the result of finding a slot with slottable.
+
+ If slot is non-null, then run assign slottables for slot.
+ Each similar-origin window agent has signal slots
+(a set of slots), which is initially empty. [[!HTML]]
+
+ To signal a slot change, for a slot slot, run these steps:
+
+ Append slot to slot's relevant agent's
+ signal slots.
+
+ To
+ensure pre-insertion validity
+of a node into a parent before a child, run these steps:
+
+ If parent is not a {{Document}}, {{DocumentFragment}}, or {{Element}}
+ node, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If node is a host-including inclusive ancestor of parent, then
+ throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If child is non-null and its parent is not parent,
+ then throw a "{{NotFoundError!!exception}}" {{DOMException}}.
+
+ If node is not a {{DocumentFragment}}, {{DocumentType}}, {{Element}}, {{Text}},
+ {{ProcessingInstruction}}, or {{Comment}} node, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If either node is a {{Text}} node and parent is a
+ document, or node is a doctype and parent is not a
+ document, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If parent is a document, and any of the statements below, switched on
+ node, are true, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If node has more than one element child or has a
+ {{Text}} node child.
+
+ Otherwise, if node has one element child and either
+ parent has an element child, child is a
+ doctype, or child is non-null and a doctype is following
+ child.
+
+
+ parent has an element child, child is
+ a doctype, or child is non-null and a doctype is following
+ child.
+
+
+ parent has a doctype child, child is non-null
+ and an element is preceding child, or child is null
+ and parent has an element child.
+ To pre-insert a node into a
+parent before a child, run these steps:
+
+ Ensure pre-insertion validity of node into parent before
+ child.
+
+ Let referenceChild be child.
+
+ If referenceChild is node, then set referenceChild to
+ node's next sibling.
+
+ Insert node into parent before referenceChild.
+
+ Return node.
+
+ Specifications may define
+insertion steps for all or some nodes. The
+algorithm is passed insertedNode, as indicated in the insert
+algorithm below.
+
+
+ Specifications may define
+children changed steps for all or some
+nodes. The algorithm is passed no argument and is called from insert,
+remove, and replace data.
+
+ To insert a node into a parent
+before a child, with an optional suppress observers flag, run these steps:
+
+ Let nodes be node's children, if node is a
+ {{DocumentFragment}} node; otherwise « node ».
+
+ Let count be nodes's size.
+
+ If count is 0, then return.
+
+ If node is a {{DocumentFragment}} node, then:
+
+ Remove its children with the suppress observers flag set.
+
+ Queue a tree mutation record for node with « », nodes, null, and
+ null.
+
+ This step intentionally does not pay attention to the
+ suppress observers flag.
+ If child is non-null, then:
+
+ For each live range whose start node is parent and
+ start offset is greater than child's index, increase
+ its start offset by count.
+
+ For each live range whose end node is parent and
+ end offset is greater than child's index, increase
+ its end offset by count.
+ Let previousSibling be child's previous sibling or
+ parent's last child if child is null.
+
+ For each node in nodes, in tree order:
+
+ Adopt node into parent's node document.
+
+ If child is null, then append node to
+ parent's children.
+
+ Otherwise, insert node into parent's
+ children before child's index.
+
+ If parent is a shadow host and node is a
+ slottable, then assign a slot for node.
+
+ If parent's root is a shadow root, and
+ parent is a slot whose assigned nodes is the empty list,
+ then run signal a slot change for parent.
+
+ Run assign slottables for a tree with node's root.
+
+ For each shadow-including inclusive descendant inclusiveDescendant of
+ node, in shadow-including tree order:
+
+ Run the insertion steps with inclusiveDescendant.
+
+ If inclusiveDescendant is connected, then:
+
+ If inclusiveDescendant is custom, then
+ enqueue a custom element callback reaction with inclusiveDescendant,
+ callback name " Otherwise, try to upgrade
+ inclusiveDescendant.
+
+ If this successfully upgrades inclusiveDescendant, its
+ If suppress observers flag is unset, then queue a tree mutation record for
+ parent with nodes, « », previousSibling, and child.
+
+ Run the children changed steps for parent.
+ To append a node to a parent,
+pre-insert node into parent before null.
+
+
+ To replace a child with node
+within a parent, run these steps:
+
+
+
+ If parent is not a {{Document}}, {{DocumentFragment}}, or {{Element}}
+ node, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If node is a host-including inclusive ancestor of parent, then
+ throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If child's parent is not parent, then throw a
+ "{{NotFoundError!!exception}}" {{DOMException}}.
+
+ If node is not a {{DocumentFragment}}, {{DocumentType}}, {{Element}}, {{Text}},
+ {{ProcessingInstruction}}, or {{Comment}} node, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If either node is a {{Text}} node and parent is a
+ document, or node is a doctype and parent is not a
+ document, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If parent is a document, and any of the statements below, switched on
+ node, are true, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If node has more than one element child or has a
+ {{Text}} node child.
+
+ Otherwise, if node has one element child and either
+ parent has an element child that is not
+ child or a doctype is following child.
+
+ parent has an element child that is not
+ child or a doctype is following child.
+
+ parent has a doctype child that is not child,
+ or an element is preceding child.
+ The above statements differ from the pre-insert algorithm.
+
+ Let referenceChild be child's next sibling.
+
+ If referenceChild is node, then set referenceChild to
+ node's next sibling.
+
+ Let previousSibling be child's previous sibling.
+
+ Let removedNodes be the empty set.
+
+ If child's parent is non-null, then:
+
+ Set removedNodes to « child ».
+
+ Remove child with the suppress observers flag set.
+ The above can only be false if child is node.
+
+ Let nodes be node's children if node is a
+ {{DocumentFragment}} node; otherwise « node ».
+
+
+ Insert node into parent before referenceChild
+ with the suppress observers flag set.
+
+ Queue a tree mutation record for parent with nodes,
+ removedNodes, previousSibling, and referenceChild.
+
+ Return child.
+ To replace all with a node
+within a parent, run these steps:
+
+ Let removedNodes be parent's children.
+
+ Let addedNodes be the empty set.
+
+ If node is a {{DocumentFragment}} node, then set addedNodes to
+ node's children.
+
+ Otherwise, if node is non-null, set addedNodes to « node ».
+
+ Remove all parent's children, in tree order, with the
+ suppress observers flag set.
+
+ If node is non-null, then insert node into
+ parent before null with the suppress observers flag set.
+
+ If either addedNodes or removedNodes is not empty,
+ then queue a tree mutation record for parent with addedNodes,
+ removedNodes, null, and null.
+ This algorithm does not make any checks with regards to the
+node tree constraints. Specification authors need to use it wisely.
+
+
+ To pre-remove a child from a
+parent, run these steps:
+
+ If child's parent is not parent, then throw a
+ "{{NotFoundError!!exception}}" {{DOMException}}.
+
+ Remove child.
+
+ Return child.
+
+ Specifications may define
+removing steps for all or some nodes. The
+algorithm is passed removedNode, and optionally oldParent, as
+indicated in the remove algorithm below.
+
+ To remove a node, with an optional
+suppress observers flag, run these steps:
+
+ Let parent be node's parent
+
+ Assert: parent is non-null.
+
+ Let index be node's index.
+
+ For each live range whose start node is an
+ inclusive descendant of node, set its start to
+ (parent, index).
+
+ For each live range whose end node is an inclusive descendant
+ of node, set its end to (parent, index).
+
+ For each live range whose start node is parent and
+ start offset is greater than index, decrease its
+ start offset by 1.
+
+ For each live range whose end node is parent and
+ end offset is greater than index, decrease its
+ end offset by 1.
+
+ For each {{NodeIterator}} object iterator whose
+ root's node document is node's
+ node document, run the Let oldPreviousSibling be node's previous sibling.
+
+ Let oldNextSibling be node's next sibling.
+
+ If node is assigned, then run assign slottables for
+ node's assigned slot.
+
+ If parent's root is a shadow root, and
+ parent is a slot whose assigned nodes is the empty list,
+ then run signal a slot change for parent.
+
+ If node has an inclusive descendant that is a slot, then:
+
+ Run assign slottables for a tree with parent's root.
+
+ Run assign slottables for a tree with node.
+ Run the removing steps with node and parent.
+
+ Let isParentConnected be parent's connected.
+
+ If node is custom and isParentConnected is true, then
+ enqueue a custom element callback reaction with node, callback name
+ " It is intentional for now that custom elements do
+ not get parent passed. This might change in the future if there is a need.
+
+ For each shadow-including descendant descendant of node, in
+ shadow-including tree order, then:
+
+ Run the removing steps with descendant.
+
+ If descendant is custom and isParentConnected
+ is true, then enqueue a custom element callback reaction with descendant,
+ callback name " For each inclusive ancestor inclusiveAncestor of
+ parent, and then for each registered of
+ inclusiveAncestor's registered observer list, if registered's
+ options's {{MutationObserverInit/subtree}} is true, then
+ append a new transient registered observer whose
+ observer is registered's
+ observer, options is
+ registered's options, and
+ source is registered to node's
+ registered observer list.
+
+ If suppress observers flag is unset, then queue a tree mutation record for
+ parent with « », « node », oldPreviousSibling, and
+ oldNextSibling.
+
+ Run the children changed steps for parent.
+ Web compatibility prevents the {{NonElementParentNode/getElementById()}}
+method from being exposed on elements (and therefore on {{ParentNode}}).
+
+ Returns the first element within node's descendants whose
+ ID is elementId.
+ The The {{DocumentOrShadowRoot}} mixin is expected to be used by other
+standards that want to define APIs shared between documents and
+shadow roots.
+
+
+ To convert nodes into a node, given
+nodes and document, run these steps:
+
+ Let node be null.
+
+ Replace each string in nodes with a new {{Text}} node whose
+ data is the string and node document is
+ document.
+
+ Otherwise, set node to a new {{DocumentFragment}} whose
+ node document is document, and then append each node in
+ nodes, if any, to it.
+
+ Return node.
+ Inserts nodes before the first child of node, while
+ replacing strings in nodes with equivalent {{Text}} nodes.
+
+ Throws a "{{HierarchyRequestError!!exception}}" {{DOMException}} if the constraints of
+ the node tree are violated.
+
+
+ Inserts nodes after the last child of node, while replacing
+ strings in nodes with equivalent {{Text}} nodes.
+
+ Throws a "{{HierarchyRequestError!!exception}}" {{DOMException}} if the constraints of
+ the node tree are violated.
+
+
+ Replace all children of node with nodes,
+ while replacing strings in nodes with equivalent {{Text}} nodes.
+
+ Throws a "{{HierarchyRequestError!!exception}}" {{DOMException}} if the constraints of
+ the node tree are violated.
+
+
+ The The The The The Let node be the result of converting nodes into a node given
+ nodes and this's node document.
+
+ Pre-insert node into this before this's
+ first child.
+ The Let node be the result of converting nodes into a node given
+ nodes and this's node document.
+
+ The Let node be the result of converting nodes into a node given
+ nodes and this's node document.
+
+ Ensure pre-insertion validity of node into this before
+ null.
+
+ Replace all with node within this.
+ The The Web compatibility prevents the {{previousElementSibling}} and
+{{nextElementSibling}} attributes from being exposed on doctypes (and therefore on
+{{ChildNode}}).
+
+ The The Inserts nodes just before node, while replacing strings in
+ nodes with equivalent {{Text}} nodes.
+
+ Throws a "{{HierarchyRequestError!!exception}}" {{DOMException}} if the constraints of
+ the node tree are violated.
+
+ Inserts nodes just after node, while replacing strings in
+ nodes with equivalent {{Text}} nodes.
+
+ Throws a "{{HierarchyRequestError!!exception}}" {{DOMException}} if the constraints of
+ the node tree are violated.
+
+ Replaces node with nodes, while replacing strings in nodes
+ with equivalent {{Text}} nodes.
+
+ Throws a "{{HierarchyRequestError!!exception}}" {{DOMException}} if the constraints of
+ the node tree are violated.
+
+ The If parent is null, then return.
+
+ Let viablePreviousSibling be this's first preceding
+ sibling not in nodes, and null otherwise.
+
+ Let node be the result of converting nodes into a node, given
+ nodes and this's node document.
+
+ If viablePreviousSibling is null, set it to parent's
+ first child, and to viablePreviousSibling's next sibling
+ otherwise.
+
+ Pre-insert node into parent before
+ viablePreviousSibling.
+ The If parent is null, then return.
+
+ Let viableNextSibling be this's first following
+ sibling not in nodes, and null otherwise.
+
+ Let node be the result of converting nodes into a node, given
+ nodes and this's node document.
+
+ Pre-insert node into parent before
+ viableNextSibling.
+ The If parent is null, then return.
+
+ Let viableNextSibling be this's first following
+ sibling not in nodes, and null otherwise.
+
+ Let node be the result of converting nodes into a node, given
+ nodes and this's node document.
+
+ If this's parent is parent, replace this with
+ node within parent.
+
+ This could have been inserted into node.
+
+ Otherwise, pre-insert node into parent before
+ viableNextSibling.
+ The The A {{NodeList}} object is a collection of nodes.
+
+ The object's supported property indices are the numbers in the range zero to one less than
+the number of nodes represented by the collection. If there are no such
+elements, then there are no supported property indices.
+
+ The length attribute must return the number of nodes
+represented by the collection.
+
+ The An {{HTMLCollection}} object is a collection of elements.
+
+ {{HTMLCollection}} is a historical artifact we cannot rid the web of.
+While developers are of course welcome to keep using it, new API standard designers ought not to use
+it (use The object's supported property indices are the numbers in the range zero to one less than
+the number of elements represented by the collection. If there are no such
+elements, then there are no supported property indices.
+
+ The The The supported property names are the values from the list returned by these steps:
+
+ Let result be an empty list.
+
+ For each element represented by the collection, in
+ tree order:
+
+ If element has an ID which is not in result,
+ append element's ID to result.
+
+ If element is in the HTML namespace and has
+ a Return result.
+ The If key is the empty string, return null.
+
+ Return the first element in the collection for which at least one of
+ the following is true:
+
+ or null if there is no such element.
+ Each similar-origin window agent has a
+mutation observer microtask queued
+(a boolean), which is initially false. [[!HTML]]
+
+ Each similar-origin window agent also has
+mutation observers (a set of zero or more
+{{MutationObserver}} objects), which is initially empty.
+
+ To
+queue a mutation observer microtask,
+run these steps:
+
+ If the surrounding agent's mutation observer microtask queued is true, then
+ return.
+
+ Set the surrounding agent's mutation observer microtask queued to true.
+
+ Queue a microtask to notify mutation observers.
+ To notify mutation observers, run these steps:
+
+ Set the surrounding agent's mutation observer microtask queued to false.
+
+ Let notifySet be a clone of the surrounding agent's
+ mutation observers.
+
+ Let signalSet be a clone of the surrounding agent's
+ signal slots.
+
+ Empty the surrounding agent's signal slots.
+
+ For each mo of notifySet:
+
+ Let records be a clone of mo's
+ record queue.
+
+ Empty mo's record queue.
+
+ For each node of mo's
+ node list, remove all
+ transient registered observers whose observer is
+ mo from node's registered observer list.
+
+ If records is not empty, then invoke
+ mo's callback with « records, mo »,
+ and mo. If this throws an exception, catch it, and report the exception.
+ For each slot of signalSet, fire an event
+ named {{HTMLSlotElement/slotchange}}, with its {{Event/bubbles}} attribute set to true, at
+ slot.
+ Each node has a registered observer list (a list of
+zero or more registered observers), which is initially empty.
+
+ A registered observer consists of an
+observer (a {{MutationObserver}} object) and
+options (a {{MutationObserverInit}} dictionary).
+
+ A transient registered observer is a
+registered observer that also consists of a
+source (a registered observer).
+
+ Transient registered observers are used to track mutations within
+a given node's descendants after node has been removed so
+they do not get lost when {{MutationObserverInit/subtree}} is set to true on node's
+parent.
+
+
+ A {{MutationObserver}} object can be used to observe mutations to the tree of
+nodes.
+
+ Each {{MutationObserver}} object has these associated concepts:
+
+ The
+ Let mo be a new {{MutationObserver}} object whose
+ callback is callback.
+
+ Append mo to mo's relevant agent's
+ mutation observers.
+
+ Return mo.
+ The
+ If either options's {{MutationObserverInit/attributeOldValue}} or
+ {{MutationObserverInit/attributeFilter}} is present and options's
+ {{MutationObserverInit/attributes}} is omitted, then set options's
+ {{MutationObserverInit/attributes}} to true.
+
+ If options's {{MutationObserverInit/characterDataOldValue}} is present and
+ options's {{MutationObserverInit/characterData}} is omitted, then set
+ options's {{MutationObserverInit/characterData}} to true.
+
+ If none of options's {{MutationObserverInit/childList}},
+ {{MutationObserverInit/attributes}}, and {{MutationObserverInit/characterData}} is true, then
+ throw a If options's {{MutationObserverInit/attributeOldValue}} is true and
+ options's {{MutationObserverInit/attributes}} is false, then throw a
+ If options's {{MutationObserverInit/attributeFilter}} is present and
+ options's {{MutationObserverInit/attributes}} is false, then throw a
+ If options's {{MutationObserverInit/characterDataOldValue}} is true and
+ options's {{MutationObserverInit/characterData}} is false, then throw a
+ For each registered of target's
+ registered observer list, if registered's
+ observer is this:
+
+ For each node of this's
+ node list, remove all
+ transient registered observers whose source is
+ registered from node's registered observer list.
+
+ Set registered's options to
+ options.
+ Otherwise:
+
+ Append a new registered observer whose
+ observer is this and
+ options is options to target's
+ registered observer list.
+
+ The For each node of this's
+ node list, remove any registered observer from
+ node's registered observer list for which this is the
+ observer.
+
+ Empty this's record queue.
+ The Let records be a clone of this's
+ record queue.
+
+ Empty this's record queue.
+
+ Return records.
+ To queue a mutation record of type for target with
+name, namespace, oldValue, addedNodes,
+removedNodes, previousSibling, and nextSibling, run these steps:
+
+ Let interestedObservers be an empty map.
+
+ Let nodes be the inclusive ancestors of target.
+
+ For each node in nodes, and then for each
+ registered of node's registered observer list:
+
+ Let options be registered's
+ options.
+
+ If none of the following are true
+
+ then:
+
+ Let mo be registered's observer.
+
+ If interestedObservers[mo] does not exist, then
+ set interestedObservers[mo] to null.
+
+ If either type is " For each observer → mappedOldValue of
+ interestedObservers:
+
+ Let record be a new {{MutationRecord}} object with its {{MutationRecord/type}}
+ set to type, {{MutationRecord/target}} set to target,
+ {{MutationRecord/attributeName}} set to name, {{MutationRecord/attributeNamespace}}
+ set to namespace, {{MutationRecord/oldValue}} set to mappedOldValue,
+ {{MutationRecord/addedNodes}} set to addedNodes,
+ {{MutationRecord/removedNodes}} set to removedNodes,
+ {{MutationRecord/previousSibling}} set to previousSibling, and
+ {{MutationRecord/nextSibling}} set to nextSibling.
+
+ Enqueue record to observer's
+ record queue.
+ To queue a tree mutation record for target with
+addedNodes, removedNodes, previousSibling, and
+nextSibling, run these steps:
+
+ Assert: either addedNodes or removedNodes is not empty.
+
+ Queue a mutation record of " The type, target,
+addedNodes,
+removedNodes,
+previousSibling,
+nextSibling,
+attributeName,
+attributeNamespace, and
+oldValue attributes must return the values they were
+initialized to.
+
+
+ Nodes have a strong reference to registered observers in their
+registered observer list.
+
+ Registered observers in a node's registered observer list have a weak
+reference to the node.
+
+
+ {{Node}} is an abstract interface and does not exist as node. It
+is used by all nodes ({{Document}}, {{DocumentType}}, {{DocumentFragment}}, {{Element}},
+{{Text}}, {{ProcessingInstruction}}, and {{Comment}}).
+
+ Each node has an associated
+node document, set upon creation, that is a
+document.
+
+ A node's node document can be changed by the
+adopt algorithm.
+
+ A node's get the parent algorithm, given an event, returns the
+node's assigned slot, if node is assigned, and node's
+parent otherwise.
+
+ Each node also has a registered observer list.
+
+ The nodeName attribute's getter, when invoked, must return the
+first matching statement, switching on this:
+
+ Returns true if node is connected and false otherwise.
+
+ The The The node document of a document is that document itself. All
+nodes have a node document at all times.
+
+ The The An {{Attr}} node has no parent.
+
+ The The The The The The An {{Attr}} node has no siblings.
+
+ The Set an existing attribute value with this and new value.
+
+ Replace data with node this, offset 0, count this's
+ length, and data new value.
+
+ Do nothing.
+ The To string replace all with a string string within a
+node parent, run these steps:
+
+ Let node be null.
+
+ If string is not the empty string, then set node to a new {{Text}}
+ node whose data is string and
+ node document is parent's node document.
+
+ Replace all with node within parent.
+ The {{Node/textContent}} attribute's setter must, if the given value is null, act as if it was
+the empty string instead, and then do as described below, switching on this:
+
+ String replace all with the given value within this.
+
+ Set an existing attribute value with this and new value.
+
+ Replace data with node this, offset 0, count this's
+ length, and data the given value.
+
+ Do nothing.
+ The While currentNode is an exclusive For each live range whose start node is currentNode,
+ add length to its start offset and set its
+ start node to node.
+
+ For each live range whose end node is currentNode, add
+ length to its end offset and set its end node to
+ node.
+
+ For each live range whose start node is currentNode's
+ parent and start offset is currentNode's
+ index, set its start node to node and its
+ start offset to length.
+
+ For each live range whose end node is currentNode's
+ parent and end offset is currentNode's
+ index, set its end node to node and its
+ end offset to length.
+
+ Add currentNode's length to length.
+
+ Set currentNode to its next sibling.
+ HTML defines cloning steps for <{script}> and <{input}>
+elements. SVG ought to do the same for its <{script}> elements, but does not call this out
+at the moment.
+
+ To clone a
+node, with an optional document and clone children flag, run these
+steps:
+
+
+ If document is not given, let document be node's
+ node document.
+
+ If node is an element, then:
+
+ Let copy be the result of creating an element, given
+ document, node's local name, node's
+ namespace, node's namespace prefix, and
+ node's For each attribute in node's
+ attribute list:
+
+ Otherwise, let copy be a node that implements the same interfaces as
+ node, and fulfills these additional requirements, switching on
+ node:
+
+ Set copy's encoding, content type,
+ URL, origin, type, and
+ mode, to those of node.
+
+ Set copy's name, public ID, and
+ system ID, to those of node.
+
+ Set copy's namespace, namespace prefix,
+ local name, and value, to those of node.
+
+ Set copy's node document and document to
+ copy, if copy is a document, and set copy's
+ node document to document otherwise.
+
+ The If this is a shadow root, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ Return a clone of this, with the
+ clone children flag set if deep is true.
+ The The The If this is other, then return zero.
+
+ Let node1 be other and node2 be this.
+
+ Let attr1 and attr2 be null.
+
+ If node1 is an attribute, then set attr1 to node1
+ and node1 to attr1's element.
+
+ If node2 is an attribute, then:
+
+ Set attr2 to node2 and node2 to attr2's
+ element.
+
+ If attr1 and node1 are non-null, and node2 is
+ node1, then:
+
+ For each attr in node2's
+ attribute list:
+
+ If attr equals attr1, then return the result of
+ adding {{Node/DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC}} and
+ {{Node/DOCUMENT_POSITION_PRECEDING}}.
+
+ If attr equals attr2, then return the result of
+ adding {{Node/DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC}} and
+ {{Node/DOCUMENT_POSITION_FOLLOWING}}.
+ If node1 or node2 is null, or node1's root is
+ not node2's root, then return the result of adding
+ {{Node/DOCUMENT_POSITION_DISCONNECTED}}, {{Node/DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC}}, and
+ either {{Node/DOCUMENT_POSITION_PRECEDING}} or {{Node/DOCUMENT_POSITION_FOLLOWING}}, with the
+ constraint that this is to be consistent, together.
+
+ Whether to return {{Node/DOCUMENT_POSITION_PRECEDING}} or
+ {{Node/DOCUMENT_POSITION_FOLLOWING}} is typically implemented via pointer comparison. In
+ JavaScript implementations a cached If node1 is an ancestor of node2 and attr1 is null,
+ or node1 is node2 and attr2 is non-null, then return the result of
+ adding {{Node/DOCUMENT_POSITION_CONTAINS}} to {{Node/DOCUMENT_POSITION_PRECEDING}}.
+
+ If node1 is a descendant of node2 and attr2 is null,
+ or node1 is node2 and attr1 is non-null, then return the result of
+ adding {{Node/DOCUMENT_POSITION_CONTAINED_BY}} to {{Node/DOCUMENT_POSITION_FOLLOWING}}.
+
+ If node1 is preceding node2, then return
+ {{Node/DOCUMENT_POSITION_PRECEDING}}.
+
+ Due to the way attributes are handled in this algorithm this results in a
+ node's attributes counting as preceding that node's children,
+ despite attributes not participating in a tree.
+
+ Return {{Node/DOCUMENT_POSITION_FOLLOWING}}.
+ The To
+locate a namespace prefix
+for an element using namespace, run these steps:
+
+ If element's namespace is namespace and its
+ namespace prefix is non-null, then return its
+ namespace prefix.
+
+ If element has an attribute whose
+ namespace prefix is " If element's parent element is not null, then return the result of running
+ locate a namespace prefix on that element using namespace.
+
+ Return null.
+ To locate a namespace for a node using prefix, switch on
+node:
+
+ If its namespace is non-null and its
+ namespace prefix is prefix, then return
+ namespace.
+
+ If it has an attribute whose namespace
+ is the XMLNS namespace, namespace prefix is " If its parent element is null, then return null.
+
+ Return the result of running locate a namespace on its parent element using
+ prefix.
+ If its document element is null, then return null.
+
+ Return the result of running locate a namespace on its document element
+ using prefix.
+ Return null.
+
+ If its element is null, then return null.
+
+ Return the result of running locate a namespace on its element
+ using prefix.
+ If its parent element is null, then return null.
+
+ Return the result of running locate a namespace on its parent element using
+ prefix.
+ The If namespace is null or the empty string, then return null.
+
+ Switch on this:
+
+ Return the result of locating a namespace prefix for it using namespace.
+
+ Return the result of locating a namespace prefix for its document element,
+ if its document element is non-null, and null otherwise.
+
+ Return null.
+
+ Return the result of locating a namespace prefix for its element,
+ if its element is non-null, and null otherwise.
+
+ Return the result of locating a namespace prefix for its parent element, if
+ its parent element is non-null, and null otherwise.
+ The If prefix is the empty string, then set it to null.
+
+ Return the result of running locate a namespace for this using
+ prefix.
+ The If namespace is the empty string, then set it to null.
+
+ Let defaultNamespace be the result of running locate a namespace for
+ this using null.
+
+ Return true if defaultNamespace is the same as namespace, and false
+ otherwise.
+ The The The The The
+list of elements with qualified name qualifiedName
+for a node root is the {{HTMLCollection}} returned by the following algorithm:
+
+ If qualifiedName is " Otherwise, if root's node document is an HTML document,
+ return a {{HTMLCollection}} rooted at root, whose filter matches the following
+ descendant elements:
+
+ Whose namespace is the HTML namespace and whose
+ qualified name is qualifiedName, in ASCII lowercase.
+
+ Whose namespace is not the HTML namespace and whose
+ qualified name is qualifiedName.
+ Otherwise, return a {{HTMLCollection}} rooted at root, whose filter matches
+ descendant elements whose qualified name is
+ qualifiedName.
+ When invoked with the same argument, and as long as root's
+node document's type has not changed, the same
+{{HTMLCollection}} object may be returned as returned by an earlier call.
+
+The
+list of elements with namespace
+namespace and local name localName
+for a node root is the
+{{HTMLCollection}} returned by the following algorithm:
+
+ Return a {{HTMLCollection}} rooted at root,
+ whose filter matches descendant
+ elements that have all their
+ classes in classes.
+
+ The comparisons for the classes must be done in an
+ ASCII case-insensitive manner if root's node document's
+ mode is " The mode is only ever changed from the default for documents created
+ by the HTML parser based on the presence, absence, or value of the DOCTYPE string, and by a
+ new browsing context (initial " No-quirks mode was originally known as "standards mode" and limited-quirks mode
+ was once known as "almost standards mode". They have been renamed because their details are now
+ defined by standards. (And because Ian Hickson vetoed their original names on the basis that they
+ are nonsensical.)
+ A document's get the parent algorithm, given an event, returns
+null if event's {{Event/type}} attribute value is " The Unlike {{DOMImplementation/createDocument()}}, this constructor does not
+return an {{XMLDocument}} object, but a document ({{Document}} object).
+
+The
+ If qualifiedName is " Otherwise, returns a {{HTMLCollection}} of all descendant elements whose
+ qualified name is qualifiedName. (Matches case-insensitively against
+ elements in the HTML namespace within an HTML document.)
+
+ Thus, in an HTML document,
+ Returns an element with localName as local name
+ (if document is an HTML document, localName gets lowercased). The
+ element's namespace is the HTML namespace when
+ document is an HTML document or document's
+ content type is " If localName does not match the When supplied, options's {{ElementCreationOptions/is}} can be used to create a
+ customized built-in element.
+
+ Returns an element with namespace namespace. Its
+ namespace prefix will be everything before " If localName does not match the If one of the following conditions is true a "{{NamespaceError!!exception}}" {{DOMException}}
+ will be thrown:
+
+ When supplied, options's {{ElementCreationOptions/is}} can be used to create a
+ customized built-in element.
+
+ The HTML Standard will e.g. define that for If localName does not match the If this is an HTML document, then set localName to
+ localName in ASCII lowercase.
+
+ Let is be null.
+
+ If options is a dictionary and options's
+ {{ElementCreationOptions/is}} is present, then set is to it.
+
+ Let namespace be the HTML namespace, if this is an
+ HTML document or this's content type is
+ " Return the result of creating an element given this, localName,
+ namespace, null, is, and with the synchronous custom elements flag
+ set.
+ The internal Let namespace, prefix, and localName be the result of
+ passing namespace and qualifiedName to validate and extract.
+
+ Let is be null.
+
+ If options is a dictionary and options's
+ {{ElementCreationOptions/is}} is present, then set is to it.
+
+ Return the result of creating an element given document,
+ localName, namespace, prefix, is, and with the
+ synchronous custom elements flag set.
+ The
+ {{Document/createElement()}} and {{Document/createElementNS()}}'s options
+parameter is allowed to be a string for web compatibility.
+
+The No check is performed that data consists of
+characters that match the The If this is an HTML document, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If data contains the string " Return a new {{CDATASection}} node with its data set to
+ data and node document set to this.
+ No check is performed that data consists of
+characters that match the No check is performed that target contains
+" If node is a document or shadow root, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ Return a clone of node, with this and the
+ clone children flag set if deep is true.
+ Specifications may define
+adopting steps for all or some nodes. The
+algorithm is passed node and oldDocument, as indicated in the adopt
+algorithm.
+
+ To adopt a node into a document, run
+these steps:
+
+ Let oldDocument be node's node document.
+
+ If document is not oldDocument, then:
+
+ For each inclusiveDescendant in node's
+ shadow-including inclusive descendants:
+
+ Set inclusiveDescendant's node document to document.
+
+ If inclusiveDescendant is an element, then set the
+ node document of each attribute in inclusiveDescendant's
+ attribute list to document.
+ For each inclusiveDescendant in node's
+ shadow-including inclusive descendants that is custom,
+ enqueue a custom element callback reaction with inclusiveDescendant, callback
+ name " For each inclusiveDescendant in node's
+ shadow-including inclusive descendants, in shadow-including tree order, run the
+ adopting steps with inclusiveDescendant and oldDocument.
+ If node is a document, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If node is a shadow root, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If node is a {{DocumentFragment}} node whose
+ host is non-null, then return.
+
+ Return node.
+ If localName does not match the Let namespace, prefix, and localName be the result of
+ passing namespace and qualifiedName to validate and extract.
+
+ Return a new attribute whose namespace is namespace,
+ namespace prefix is prefix, local name is
+ localName, and node document is this.
+ The Let constructor be null.
+
+ If interface is an ASCII case-insensitive match for any of the strings in the
+ first column in the following table, then set constructor to the interface in the
+ second column on the same row as the matching string:
+
+ If constructor is null, then throw a "{{NotSupportedError!!exception}}"
+ {{DOMException}}.
+
+ If the interface indicated by constructor is not exposed on the
+ relevant global object of this, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ Typically user agents disable support for touch events in some configurations, in
+ which case this clause would be triggered for the interface {{TouchEvent}}.
+
+ Let event be the result of creating an event given constructor.
+
+ Initialize event's {{Event/type}} attribute to the empty string.
+
+ Initialize event's {{Event/timeStamp}} attribute to a {{DOMHighResTimeStamp}}
+ representing the high resolution time from the time origin to now.
+
+ Initialize event's {{Event/isTrusted}} attribute to false.
+
+ Unset event's initialized flag.
+
+ Return event.
+ Event constructors ought to be used instead.
+
+ The The {{Range/Range()}} constructor can be used instead.
+
+ The
+ Let iterator be a new {{NodeIterator}} object.
+
+ Set iterator's pointer before reference to true.
+
+ Set iterator's whatToShow to whatToShow.
+
+ Set iterator's filter to filter.
+
+ Return iterator.
+ The
+ Let walker be a new {{TreeWalker}} object.
+
+ Set walker's whatToShow to whatToShow.
+
+ Set walker's filter to filter.
+
+ Validate qualifiedName.
+
+ Return a new doctype, with qualifiedName as its
+ name, publicId as its public ID, and systemId
+ as its system ID, and with its node document set to the associated
+ document of this.
+ No check is performed that publicId code points match the
+ The
+ Let document be a new {{XMLDocument}}.
+
+ Let element be null.
+
+ If qualifiedName is not the empty string, then set element to the
+ result of running the internal If doctype is non-null, append doctype to document.
+
+ If element is non-null, append element to document.
+
+ document's origin is this's associated
+ document's origin.
+
+ document's content type is determined by namespace:
+
+ Return document.
+ Let doc be a new document that is an HTML document.
+
+ Set doc's content type to " Append a new doctype, with " Append the result of creating an element given doc, <{html}>, and
+ the HTML namespace, to doc.
+
+ Append the result of creating an element given doc, <{head}>, and
+ the HTML namespace, to the <{html}> element created earlier.
+
+ If title is given:
+
+ Append the result of creating an element given doc, <{title}>,
+ and the HTML namespace, to the <{head}> element created earlier.
+
+ Append a new {{Text}} node, with its data set to
+ title (which could be the empty string) and its node document set to
+ doc, to the <{title}> element created earlier.
+ Append the result of creating an element given doc, <{body}>, and
+ the HTML namespace, to the <{html}> element created earlier. Return doc.
+ {{hasFeature()}} originally would report whether the user agent
+claimed to support a given DOM feature, but experience proved it was not nearly as
+reliable or granular as simply checking whether the desired objects, attributes, or
+methods existed. As such, it is no longer to be used, but continues to exist (and simply
+returns true) so that old pages don't stop working.
+
+ {{DocumentType}} nodes are simply known as
+doctypes.
+
+ Doctypes have an associated
+name,
+public ID, and
+system ID.
+
+ When a doctype is created, its name is always given. Unless
+explicitly given when a doctype is created, its public ID and system ID are the
+empty string.
+
+ The The The A {{DocumentFragment}} node has an associated
+host (null or an
+element in a different node tree). It is null unless otherwise stated.
+
+ An object A is a
+host-including inclusive ancestor
+of an object B, if either A is an inclusive ancestor of B,
+or if B's root has a non-null host and
+A is a host-including inclusive ancestor of B's root's
+host.
+
+ The {{DocumentFragment}} node's host
+concept is useful for HTML's <{template}> element and for shadow roots, and impacts the
+pre-insert and replace algorithms.
+
+ The {{ShadowRoot}} nodes are simply known as
+shadow roots.
+
+ Shadow roots have an associated mode (" Shadow roots have an associated delegates focus.
+It is initially set to false. Shadow roots have an associated
+available to element internals. It is initially set to false. Shadow roots's associated host is never null. A shadow root's get the parent algorithm, given an event, returns
+null if event's composed flag is unset and shadow root is the
+root of event's path's first struct's
+invocation target, and shadow root's
+host otherwise.
+
+ The The The In shadow-including tree order is
+shadow-including preorder, depth-first traversal of a node tree.
+Shadow-including preorder, depth-first traversal of a node tree
+tree is preorder, depth-first traversal of tree, with for each
+shadow host encountered in tree,
+shadow-including preorder, depth-first traversal of that element's
+shadow root's node tree just after it is encountered.
+
+ The shadow-including root of an object is its
+root's host's shadow-including root, if the
+object's root is a shadow root, and its root
+otherwise. An object A is a
+shadow-including descendant of an object
+B, if A is a descendant of B, or A's
+root is a shadow root and A's root's
+host is a shadow-including inclusive descendant of B.
+
+ A
+shadow-including inclusive descendant
+is an object or one of its shadow-including descendants.
+
+ An object A is a
+shadow-including ancestor of an object
+B, if and only if B is a shadow-including descendant of A.
+
+ A
+shadow-including inclusive ancestor
+is an object or one of its shadow-including ancestors.
+
+ A node A is
+closed-shadow-hidden from a node
+B if all of the following conditions are true:
+
+ A's root is a shadow root.
+
+ A's root is not a shadow-including inclusive ancestor of
+ B.
+
+ A's root is a shadow root whose
+ mode is " To retarget an object A against an object
+B, repeat these steps until they return an object: If one of the following is true
+
+ then return A.
+
+ The retargeting algorithm is used by event dispatch as well
+as other specifications, such as Fullscreen. [[FULLSCREEN]]
+
+
+ {{Element}} nodes are simply known as
+elements.
+
+ Elements have an associated
+namespace,
+namespace prefix,
+local name,
+custom element state,
+custom element definition,
+ An element's custom element state is one of
+" Whether or not an element is defined is used to determine the
+behavior of the '':defined'' pseudo-class. Whether or not an element is custom is
+used to determine the behavior of the mutation algorithms. The
+" The following code illustrates elements in each of these four states: Elements also have an associated
+shadow root (null or a
+shadow root). It is null unless otherwise stated. An element is a
+shadow host if its shadow root is non-null.
+
+ An element's
+qualified name is its
+local name if its namespace prefix is null, and its
+namespace prefix, followed by " An element's HTML-uppercased qualified name is the return
+value of these steps:
+
+ Let qualifiedName be this's qualified name.
+
+ If this is in the HTML namespace and its node document is an
+ HTML document, then set qualifiedName to qualifiedName in
+ ASCII uppercase.
+
+ User agents could optimize qualified name and
+HTML-uppercased qualified name by storing them in internal slots.
+
+ To
+create an element,
+given a document, localName, namespace, and optional
+prefix, is, and synchronous custom elements flag, run these steps:
+
+ If prefix was not given, let prefix be null.
+
+ If is was not given, let is be null.
+
+ Let result be null.
+
+ Let definition be the result of
+ looking up a custom element definition given
+ document, namespace, localName, and is.
+
+ If definition is non-null, and definition's
+ name is not equal to its
+ local name (i.e., definition represents a
+ customized built-in element), then:
+
+ Let interface be the element interface for localName and the
+ HTML namespace.
+
+ Set result to a new element that implements interface,
+ with no attributes, namespace set to the HTML namespace,
+ namespace prefix set to prefix, local name set
+ to localName, custom element state set to " If the synchronous custom elements flag is set, then run this step while
+ catching any exceptions:
+
+ Upgrade element using definition.
+ If this step threw an exception, then: Report the exception.
+
+ Set result's custom element state to
+ " Otherwise, enqueue a custom element upgrade reaction given result and
+ definition.
+ Otherwise, if definition is non-null, then:
+
+ If the synchronous custom elements flag is set, then run these steps while
+ catching any exceptions:
+
+ Let C be definition's
+ constructor.
+
+ Set result to the result of constructing C, with no
+ arguments.
+
+ Assert: result's custom element state and
+ custom element definition are initialized.
+
+ Assert: result's namespace is the HTML namespace.
+
+ IDL enforces that result is an {{HTMLElement}} object, which all use
+ the HTML namespace.
+
+ If result's attribute list is not empty,
+ then throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If result has children, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If result's parent is not null, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If result's node document is not document, then
+ throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If result's local name is not equal to
+ localName, then throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ Set result's namespace prefix to prefix.
+
+ Set result's If any of these steps threw an exception, then: Report the exception.
+
+ Set result to a new element that implements the
+ {{HTMLUnknownElement}} interface, with no attributes, namespace set to the
+ HTML namespace, namespace prefix set to prefix,
+ local name set to localName,
+ custom element state set to " Otherwise:
+
+ Set result to a new element that implements the {{HTMLElement}}
+ interface, with no attributes, namespace set to the HTML namespace,
+ namespace prefix set to prefix, local name set
+ to localName, custom element state set to
+ " Enqueue a custom element upgrade reaction given result and
+ definition.
+ Otherwise:
+
+ Let interface be the element interface for localName and
+ namespace.
+
+ Set result to a new element that implements interface,
+ with no attributes, namespace set to namespace,
+ namespace prefix set to prefix, local name set
+ to localName, custom element state set to
+ " If namespace is the HTML namespace, and either localName is a
+ valid custom element name or is is non-null, then set result's
+ custom element state to " Return result.
+ Elements also have an
+attribute list, which is a
+list exposed through a {{NamedNodeMap}}. Unless explicitly given when an
+element is created, its attribute list is empty.
+
+ An element
+has an attribute
+A if its attribute list contains A.
+
+ This and other specifications may define
+attribute change steps for
+elements. The algorithm is passed element, localName,
+oldValue, value, and namespace.
+
+ To handle attribute changes for an attribute attribute with
+element, oldValue, and newValue, run these steps:
+
+ Queue a mutation record of " If element is custom, then
+ enqueue a custom element callback reaction with element, callback name
+ " Run the attribute change steps with element, attribute's
+ local name, oldValue, newValue, and attribute's
+ namespace.
+ To change an
+attribute attribute to value, run these steps:
+
+ Handle attribute changes for attribute with attribute's
+ element, attribute's value, and value.
+
+ Set attribute's value to value.
+ To append an
+attribute attribute to an element element, run these
+steps:
+
+ Handle attribute changes for attribute with element, null, and
+ attribute's value.
+
+ Append attribute to element's
+ attribute list.
+
+ Set attribute's element to element.
+ To remove an
+attribute attribute, run these steps:
+
+ Handle attribute changes for attribute with attribute's
+ element, attribute's value, and null.
+
+ Set attribute's element to null.
+ To replace an
+attribute oldAttr with an attribute newAttr, run these steps:
+
+ Handle attribute changes for oldAttr with oldAttr's
+ element, oldAttr's value, and newAttr's
+ value.
+
+ Replace oldAttr by newAttr in oldAttr's
+ element's attribute list.
+
+ Set oldAttr's element to null.
+ To get an attribute by name given a
+qualifiedName and element element, run these steps:
+
+ If element is in the HTML namespace and its node document
+ is an HTML document, then set qualifiedName to qualifiedName in
+ ASCII lowercase.
+
+ Return the first attribute in element's attribute list
+ whose qualified name is qualifiedName, and null otherwise.
+ To
+get an attribute by namespace and local name
+given a namespace, localName, and element element,
+run these steps:
+
+ To get an attribute value given an
+element element, localName, and optionally a namespace
+(null unless stated otherwise), run these steps: Let attr be the result of
+ getting an attribute given
+ namespace, localName, and element. If attr is null, then return the empty string. Return attr's value. To set an attribute given an
+attr and element, run these steps:
+
+ If attr's element is neither null nor element,
+ throw an "{{InUseAttributeError!!exception}}" {{DOMException}}.
+
+ Let oldAttr be the result of
+ getting an attribute given
+ attr's namespace, attr's local name, and
+ element.
+
+ If oldAttr is attr, return attr.
+
+ If oldAttr is non-null, then replace
+ oldAttr with attr.
+
+ Otherwise, append attr to element.
+
+ Return oldAttr.
+ To set an attribute value for an
+element element, using a localName and value, and an
+optional prefix, and namespace, run these steps:
+
+ Change attribute to value.
+ To remove an attribute by name
+given a qualifiedName and element element, run these steps:
+
+ Let attr be the result of
+ getting an attribute given qualifiedName and
+ element.
+
+ If attr is non-null, then remove attr.
+
+ Return attr.
+ To
+remove an attribute by namespace and local name
+given a namespace, localName, and element element,
+run these steps:
+
+ Let attr be the result of
+ getting an attribute given
+ namespace, localName, and element.
+
+ If attr is non-null, then remove attr.
+
+ Return attr.
+ An element can have an associated
+unique identifier (ID)
+
+ Historically elements could have multiple identifiers e.g., by using
+the HTML Use these attribute change steps to update an element's
+ID:
+
+ If localName is Otherwise, if localName is While this specification defines requirements for The The The The Returns the value of element's Returns the value of element's Allows for manipulation of element's Returns the value of element's IDL attributes that are defined to reflect a
+content attribute of a given name, must have a getter and setter that follow these
+steps: Return the result of running get an attribute value given this and
+ name. Set an attribute value for this using name and the given value.
+ The The The The Returns true if element has attributes, and false otherwise.
+
+ Returns the qualified names of all element's attributes.
+ Can contain duplicates.
+
+ Returns element's first attribute whose qualified name is
+ qualifiedName, and null if there is no such attribute otherwise.
+
+ Returns element's attribute whose namespace is
+ namespace and local name is localName, and null if there is
+ no such attribute otherwise.
+
+ Sets the value of element's first attribute whose
+ qualified name is qualifiedName to value.
+
+ Sets the value of element's attribute whose
+ namespace is namespace and local name is
+ localName to value.
+
+ Removes element's first attribute whose qualified name is
+ qualifiedName.
+
+ Removes element's attribute whose namespace is
+ namespace and local name is localName.
+
+ 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.
+
+ Returns true if element has an attribute whose
+ qualified name is qualifiedName, and false otherwise.
+
+ Returns true if element has an attribute whose namespace
+ is namespace and local name is localName.
+ The The The These are not guaranteed to be unique.
+
+ The Let attr be the result of
+ getting an attribute given qualifiedName and
+ this.
+
+ If attr is null, return null.
+
+ Return attr's value.
+ The
+ Let attr be the result of
+ getting an attribute given
+ namespace, localName, and this.
+
+ If attr is null, return null.
+
+ Return attr's value.
+ The
+ If qualifiedName does not match the If this is in the HTML namespace and its node document is an
+ HTML document, then set qualifiedName to qualifiedName in
+ ASCII lowercase.
+
+ Let attribute be the first attribute in this's
+ attribute list whose qualified name is qualifiedName,
+ and null otherwise.
+
+
+ If attribute is null, create an attribute whose
+ local name is qualifiedName, value is
+ value, and node document is this's node document,
+ then append this attribute to this, and then return.
+
+ Change attribute to value.
+ The
+ Let namespace, prefix, and localName be the result of
+ passing namespace and qualifiedName to validate and extract.
+
+ Set an attribute value for this using localName, value,
+ and also prefix and namespace.
+ The
+ The
+ The If this is in the HTML namespace and its node document is an
+ HTML document, then set qualifiedName to qualifiedName in
+ ASCII lowercase.
+
+ Return true if this has an attribute whose
+ qualified name is qualifiedName, and false otherwise.
+ The If qualifiedName does not match the If this is in the HTML namespace and its node document is an
+ HTML document, then set qualifiedName to qualifiedName in
+ ASCII lowercase.
+
+ Let attribute be the first attribute in this's
+ attribute list whose qualified name is qualifiedName,
+ and null otherwise.
+
+
+ If attribute is null, then:
+
+ If force is not given or is true, create an attribute whose
+ local name is qualifiedName, value is the empty
+ string, and node document is this's node document, then
+ append this attribute to this, and then return
+ true.
+
+ Return false.
+ Otherwise, if force is not given or is false,
+ remove an attribute given qualifiedName and
+ this, and then return false.
+
+ Return true.
+ The
+ The The
+ The The If this's attribute list does not contain
+ attr, then throw a "{{NotFoundError!!exception}}" {{DOMException}}.
+
+ Remove attr.
+
+ Return attr.
+ Creates a shadow root for element and returns it.
+
+ Returns element's shadow root, if any, and if
+ shadow root's mode is " The If this's namespace is not the HTML namespace,
+ then throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If this's local name is not one of the following:
+
+ then throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
+ If this's local name is a valid custom element name, or
+ this's Let definition be the result of
+ looking up a custom element definition given
+ this's node document, its namespace, its
+ local name, and its If definition is not null and definition's
+ disable shadow is true, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+ If this is a shadow host, then throw an
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ Let shadow be a new shadow root whose node document
+ is this's node document, host is this,
+ and mode is init's {{ShadowRootInit/mode}}.
+
+ Set shadow's delegates focus to init's
+ {{ShadowRootInit/delegatesFocus}}.
+
+ If this's custom element state is " Set this's shadow root to shadow.
+
+ Return shadow.
+ The Let shadow be this's shadow root.
+
+ If shadow is null or its mode is " Return shadow.
+ The The
+ The To insert adjacent, given an element element, string
+where, and a node node, run the steps associated with the first
+ASCII case-insensitive match for where:
+
+ If element's parent is null, return null.
+
+ Return the result of pre-inserting node into element's
+ parent before element.
+
+ Return the result of pre-inserting node into element before
+ element's first child.
+
+ Return the result of pre-inserting node into element before
+ null.
+
+ If element's parent is null, return null.
+
+ Return the result of pre-inserting node into element's
+ parent before element's next sibling.
+
+ Throw a "{{SyntaxError!!exception}}" {{DOMException}}.
+ The
+ The
+ Let text be a new {{Text}} node whose data is
+ data and node document is this's node document.
+
+ Run insert adjacent, given this, where, and text.
+ This method returns nothing because it existed before we had a chance to design it.
+
+
+ A {{NamedNodeMap}} object's supported property indices are the numbers in the
+range zero to its attribute list's size minus one, unless
+the attribute list is empty, in which case there are no
+supported property indices.
+
+ The The If index is equal to or greater than this's
+ attribute list's size, then return null.
+
+ Otherwise, return this's attribute list[index].
+ A {{NamedNodeMap}} object's supported property names are the return value of running these
+steps:
+
+ Let names be the qualified names of the attributes in this
+ {{NamedNodeMap}} object's attribute list, with duplicates omitted, in
+ order.
+
+
+ If this {{NamedNodeMap}} object's element is in the
+ HTML namespace and its node document is an HTML document, then
+ for each name in names:
+
+ Let lowercaseName be name, in ASCII lowercase.
+
+ If lowercaseName is not equal to name, remove name from
+ names.
+ Return names.
+ The The
+ The The Let attr be the result of
+ removing an attribute given
+ qualifiedName and element.
+
+ If attr is null, then throw a "{{NotFoundError!!exception}}"
+ {{DOMException}}.
+
+ Return attr.
+ The
+ Let attr be the result of
+ removing an attribute given
+ namespace, localName, and element.
+
+ If attr is null, then throw a "{{NotFoundError!!exception}}"
+ {{DOMException}}.
+
+ Return attr.
+ {{Attr}} nodes are simply known as
+attributes. They are sometimes referred
+to as content attributes to avoid confusion with IDL attributes.
+
+Attributes have a
+namespace (null or a non-empty string),
+namespace prefix (null or a non-empty string),
+local name (a non-empty string),
+value (a string), and
+element (null or an
+element).
+
+ If designed today they would just have a name and value. ☹
+
+ An attribute's
+qualified name is its
+local name if its namespace prefix is null, and its
+namespace prefix, followed by " User agents could have this as an internal slot as an optimization.
+
+When an attribute is created, its
+local name is given. Unless explicitly
+given when an attribute is created, its
+namespace,
+namespace prefix, and
+element are set to null, and its
+value is set to the empty string.
+
+An
+ The The The The The To set an existing attribute value, given an attribute attribute and
+string value, run these steps:
+
+ If attribute's element is null, then set attribute's
+ value to value.
+
+ Otherwise, change attribute to value.
+ The {{Attr/value}} attribute's setter must set an existing attribute value with
+this and the given value.
+
+ The The {{CharacterData}} is an abstract interface and does not exist as
+node. It is used by {{Text}}, {{ProcessingInstruction}}, and {{Comment}} nodes.
+
+Each node inheriting from the
+{{CharacterData}} interface has an associated mutable string
+called data.
+
+To replace data of node node with offset
+offset, count count, and data data, run these steps:
+
+ Queue a mutation record of " For each live range whose start node is node and
+ start offset is greater than offset but less than or equal to
+ offset plus count, set its start offset to
+ offset.
+
+ For each live range whose end node is node and
+ end offset is greater than offset but less than or equal to
+ offset plus count, set its end offset to offset.
+
+ For each live range whose start node is node and
+ start offset is greater than offset plus count, increase its
+ start offset by data's length and decrease it by
+ count.
+
+ For each live range whose end node is node and
+ end offset is greater than offset plus count, increase its
+ end offset by data's length and decrease it by
+ count.
+
+ The The The
+ The The
+ The
+ The
+ An exclusive {{Text}} node is a {{Text}} node that is not a
+{{CDATASection}} node.
+
+ The contiguous {{Text}} nodes of a node node are
+node, node's previous sibling {{Text}} node, if any, and its
+contiguous The contiguous exclusive {{Text}} nodes of a node node are
+node, node's previous sibling exclusive The child text content of a node
+node is the concatenation of the data of all
+the {{Text}} node children of node, in tree order.
+
+ The descendant text content of a
+node node is the concatenation of the
+data of all the {{Text}} node descendants of
+node, in tree order.
+
+ The If parent is not null, then:
+
+ Insert new node into parent before node's
+ next sibling.
+
+
+ For each live range whose start node is node and
+ start offset is greater than offset, set its
+ start node to new node and decrease its start offset
+ by offset.
+
+ For each live range whose end node is node and
+ end offset is greater than offset, set its end node
+ to new node and decrease its end offset by offset.
+
+
+ For each live range whose start node is parent and
+ start offset is equal to the index of node plus 1,
+ increase its start offset by 1.
+
+ For each live range whose end node is parent and
+ end offset is equal to the index of node plus 1,
+ increase its end offset by 1.
+ The The The {{StaticRange}} and {{Range}} objects (ranges) represent a sequence of content within a
+node tree. Each range has a start and an end which
+are boundary points. A boundary point is a tuple consisting of a
+node and an offset. So in other words, a
+range represents a piece of content within a node tree between two
+boundary points.
+
+ Ranges are frequently used in editing for selecting and copying content.
+
+ In the node tree above, a
+range can be used to represent the sequence
+“syndata is awes”. Assuming p is assigned to the
+ Attributes such as {{Range}} objects, unlike {{StaticRange}} objects, are affected by mutations to the
+node tree. Therefore they are also known as live ranges. Such mutations will not
+invalidate them and will try to ensure that it still represents the same piece of content.
+Necessarily, a live range might itself be modified as part of the mutation to the
+node tree when, e.g., part of the content it represents is mutated.
+
+ See the insert and remove algorithms, the
+{{Node/normalize()}} method, and the replace data and split
+algorithms for details.
+
+ Updating live ranges in response to node tree mutations can be expensive. For every
+node tree change, all affected {{Range}} objects need to be updated. Even if the application
+is uninterested in some live ranges, it still has to pay the cost of keeping them up-to-date
+when a mutation occurs.
+
+ A {{StaticRange}} object is a lightweight range that does not update when the
+node tree mutates. It is therefore not subject to the same maintenance cost as
+live ranges.
+
+
+ A boundary point is a tuple consisting of a
+node (a node) and an
+offset (a non-negative integer).
+
+ A correct boundary point's offset will
+be between 0 and the boundary point's node's
+length, inclusive.
+
+ The position of a
+boundary point (nodeA, offsetA) relative to a boundary point
+(nodeB, offsetB) is
+before,
+equal, or
+after, as returned by these steps:
+
+ Assert: nodeA and nodeB have the same root.
+
+ If nodeA is following nodeB, then if the
+ position of (nodeB, offsetB) relative to
+ (nodeA, offsetA) is before, return
+ after, and if it is after, return
+ before.
+
+ If nodeA is an ancestor of nodeB:
+
+ Return before.
+ Objects implementing the {{AbstractRange}} interface are known as
+ranges.
+
+ A range has two associated boundary points — a
+start and
+end.
+
+ For convenience, a range's
+start node is its start's
+node, its
+start offset is its
+start's offset, its
+end node is its end's
+node, and its
+end offset is its end's
+offset.
+
+ A range is collapsed if its start node is its
+end node and its start offset is its end offset.
+
+ The
+ The The The The Returns a new range object that does not update when the node tree mutates.
+ The If init's {{StaticRangeInit/startContainer}} or {{StaticRangeInit/endContainer}}
+ is a {{DocumentType}} or {{Attr}} node, then throw an
+ "{{InvalidNodeTypeError!!exception}}" {{DOMException}}.
+
+ Let staticRange be a new {{StaticRange}} object.
+
+ Set staticRange's start to (init's
+ {{StaticRangeInit/startContainer}}, init's {{StaticRangeInit/startOffset}}) and
+ end to (init's {{StaticRangeInit/endContainer}}, init's
+ {{StaticRangeInit/endOffset}}).
+
+ Return staticRange.
+ Objects implementing the {{Range}} interface are known as
+live ranges.
+
+ Algorithms that modify a tree (in particular the insert,
+remove, replace data, and split algorithms) modify
+live ranges associated with that tree.
+
+ The root of a live range is the
+root of its start node.
+
+
+ A node node is contained
+in a live range range if node's root is
+range's root, and (node, 0) is
+after range's start, and
+(node, node's length) is before
+range's end.
+
+ A node is
+partially contained in a live range
+if it's an inclusive ancestor of the live range's start node
+but not its end node, or vice versa.
+
+ Some facts to better understand these definitions:
+
+ The content that one would think of as being within the live range consists of all
+ contained nodes, plus possibly some of the contents of the
+ start node and end node if those are {{Text}},
+ {{ProcessingInstruction}}, or {{Comment}} nodes.
+
+ The nodes that are contained in a live range will generally not be
+ contiguous, because the parent of a contained
+ node will not always be contained.
+
+ However, the descendants of a contained node
+ are contained, and if two siblings are
+ contained, so are any siblings that lie between them.
+
+ The start node and end node of a live range are
+ never contained within it.
+
+ The first contained node (if there are any) will
+ always be after the start node, and the last contained
+ node will always be equal to or before the end node's last
+ descendant.
+
+ There exists a partially contained node if and only if
+ the start node and end node are different.
+
+ The {{Range/commonAncestorContainer}} attribute value is neither
+ contained nor partially contained.
+
+ If the start node is an ancestor of the end node,
+ the common inclusive ancestor will be the start node. Exactly one
+ of its children will be partially contained, and a
+ child will be contained if and only if it
+ precedes the partially contained
+ child. If the end node is an ancestor of the
+ start node, the opposite holds.
+
+ If the start node is not an inclusive ancestor of the
+ end node, nor vice versa, the common inclusive ancestor will be
+ distinct from both of them. Exactly two of its children will be
+ partially contained, and a child will be contained if and
+ only if it lies between those two.
+ The The To
+set the start or end
+of a range to a boundary point (node, offset), run these
+steps:
+
+ The The The The Let parent be node's parent.
+
+ If parent is null, then throw an "{{InvalidNodeTypeError!!exception}}"
+ {{DOMException}}.
+
+ Set the start of this to boundary point
+ (parent, node's index plus 1).
+ The The Let parent be node's parent.
+
+ If parent is null, then throw an "{{InvalidNodeTypeError!!exception}}"
+ {{DOMException}}.
+
+ Set the end of this to boundary point
+ (parent, node's index plus 1).
+ The To select a node node
+within a range range, run these steps:
+
+ Let parent be node's parent.
+
+ If parent is null, then throw an "{{InvalidNodeTypeError!!exception}}"
+ {{DOMException}}.
+
+ Let index be node's index.
+
+ Set range's start to boundary point
+ (parent, index).
+
+ Set range's end to boundary point
+ (parent, index plus 1).
+ The The The
+ If how is not one of
+
+ then throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+
+ If the position of this point relative to
+ other point is
+
+ The If reference node's
+ parent were null, it would be the
+ root of
+ this, so would be an
+ inclusive ancestor of
+ original end node, and we could not reach this point.
+ For each node in nodes to remove, in tree order,
+ remove node.
+
+ To extract a live range
+range, run these steps:
+
+ Let fragment be a new {{DocumentFragment}} node whose
+ node document is range's start node's
+ node document.
+
+ If range is collapsed, then return fragment.
+
+
+ These variable assignments do actually always make sense.
+ For instance, if original start node is not an
+ inclusive ancestor of
+ original end node, original start node is itself
+ partially contained in range, and so are all its
+ ancestors up until a
+ child of common ancestor.
+ common ancestor cannot be original start node, because
+ it has to be an inclusive ancestor of
+ original end node. The other case is similar. Also, notice that the two
+ children will never be equal if both are defined.
+
+ If any member of contained children is a doctype, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+
+ We do not have to worry about the first or last partially
+ contained node, because a doctype can never be
+ partially contained. It cannot be a boundary point of a range, and it
+ cannot be the ancestor of anything.
+
+ If reference node's
+ parent is null, it would be the
+ root of range, so would be an
+ inclusive ancestor of
+ original end node, and we could not reach this point.
+ In this case, first partially contained child is
+ original start node.
+
+ Let subfragment be the result of extracting
+ subrange.
+
+ In this case, last partially contained child is
+ original end node.
+
+ Let subfragment be the result of extracting
+ subrange.
+
+ The To
+clone the contents
+of a live range range, run these steps:
+
+ Let fragment be a new {{DocumentFragment}} node whose
+ node document is range's start node's
+ node document.
+
+ If range is collapsed, then return fragment.
+
+
+ These variable assignments do actually always make sense.
+ For instance, if original start node is not an
+ inclusive ancestor of
+ original end node, original start node is itself
+ partially contained in range, and so are all its
+ ancestors up until a
+ child of common ancestor.
+ common ancestor cannot be original start node, because
+ it has to be an inclusive ancestor of
+ original end node. The other case is similar. Also, notice that the two
+ children will never be equal if both are defined.
+
+ If any member of contained children is a doctype, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ We do not have to worry about the first or last partially
+ contained node, because a doctype can never be
+ partially contained. It cannot be a boundary point of a range, and it
+ cannot be the ancestor of anything.
+
+ In this case, first partially contained child is
+ original start node.
+
+ Let subfragment be the result of cloning the contents
+ of subrange.
+
+ In this case, last partially contained child is
+ original end node.
+
+ Let subfragment be the result of cloning the contents
+ of subrange.
+
+ The To insert a node
+node into a live range range, run these steps:
+
+ If range is collapsed, then set range's
+ end to (parent, newOffset).
+ The The If a non-{{Text}} node is partially contained in
+ this, then throw an "{{InvalidStateError!!exception}}" {{DOMException}}.
+
+
+ If newParent is a {{Document}}, {{DocumentType}}, or {{DocumentFragment}}
+ node, then throw an "{{InvalidNodeTypeError!!exception}}" {{DOMException}}.
+
+ For historical reasons {{Text}}, {{ProcessingInstruction}}, and {{Comment}}
+ nodes are not checked here and end up throwing later on as a side effect.
+
+ Let fragment be the result of extracting this.
+
+
+ If newParent has children, then replace all with null
+ within newParent.
+
+ Append fragment to newParent.
+
+ The The The The The The stringification behavior must run
+these steps:
+
+ Let s be the empty string.
+
+ If this's start node is this's end node and
+ it is a {{Text}} node, then return the substring of that {{Text}} node's
+ data beginning at this's start offset and ending
+ at this's end offset.
+
+ If this's start node is a {{Text}} node, then append the
+ substring of that node's data from this's
+ start offset until the end to s.
+
+ Append the concatenation of the data of all
+ {{Text}} nodes that are contained in this, in
+ tree order, to s.
+
+ If this's end node is a {{Text}} node, then
+ append the substring of that node's data from its start until
+ this's end offset to s.
+
+ Return s.
+ The {{createContextualFragment()}}, {{Range/getClientRects()}},
+and {{Range/getBoundingClientRect()}} methods are defined in other specifications.
+[[DOM-Parsing]]
+[[CSSOM-VIEW]]
+
+
+
+ {{NodeIterator}} and {{TreeWalker}} objects can be used to filter and traverse node
+trees.
+
+ Each {{NodeIterator}} and {{TreeWalker}} object has an associated
+active flag to avoid recursive
+invocations. It is initially unset.
+
+ Each {{NodeIterator}} and {{TreeWalker}} object also has an associated
+root (a node), a
+whatToShow (a bitmask), and a
+filter (a callback).
+
+ To filter a node node within
+a {{NodeIterator}} or {{TreeWalker}} object traverser, run these steps:
+
+ If traverser's active flag is set, then throw an
+ "{{InvalidStateError!!exception}}" {{DOMException}}.
+
+ Let n be node's {{Node/nodeType}} attribute value − 1.
+
+ If the nth bit (where 0 is the least significant bit) of
+ traverser's whatToShow is not set, then return
+ {{NodeFilter/FILTER_SKIP}}.
+
+
+ If traverser's filter is null, then return
+ {{NodeFilter/FILTER_ACCEPT}}.
+
+ Set traverser's active flag.
+
+ Let result be the return value of call a user object's operation with
+ traverser's filter, " Unset traverser's active flag.
+
+ Return result.
+ {{NodeIterator}} objects can be created using the
+{{createNodeIterator()}} method on {{Document}} objects.
+
+ Each {{NodeIterator}} object has an associated
+iterator collection, which is a
+collection rooted at the {{NodeIterator}} object's root, whose
+filter matches any node.
+
+ Each {{NodeIterator}} object also has an associated reference (a
+node) and pointer before reference (a boolean).
+
+ As mentioned earlier, {{NodeIterator}} objects have an associated
+active flag, root, whatToShow, and
+filter as well.
+
+ The If toBeRemovedNode is not an inclusive ancestor of
+ nodeIterator's reference, or toBeRemovedNode is
+ nodeIterator's root, then return.
+
+ If nodeIterator's pointer before reference is true, then:
+
+ Let next be toBeRemovedNode's first following
+ node that is an inclusive descendant of nodeIterator's
+ root and is not an inclusive descendant of
+ toBeRemovedNode, and null if there is no such node.
+
+ If next is non-null, then set nodeIterator's
+ reference to next and return.
+
+ Otherwise, set nodeIterator's pointer before reference to
+ false.
+
+ Steps are not terminated here.
+ Set nodeIterator's reference to
+ toBeRemovedNode's parent, if toBeRemovedNode's
+ previous sibling is null, and to the inclusive descendant of
+ toBeRemovedNode's previous sibling that appears last in tree order
+ otherwise.
+ The The The The The To traverse, given a
+{{NodeIterator}} object iterator and a direction direction, run these steps:
+
+ Let node be iterator's reference.
+
+ Let beforeNode be iterator's
+ pointer before reference.
+
+ While true:
+
+ Branch on direction:
+
+ If beforeNode is false, then set node to the first node
+ following node in iterator's
+ iterator collection. If there is no such node, then
+ return null.
+
+ If beforeNode is true, then set it to false.
+
+ If beforeNode is true, then set node to the first node
+ preceding node in iterator's
+ iterator collection. If there is no such node, then
+ return null.
+
+ If beforeNode is false, then set it to true.
+ Let result be the result of filtering node within
+ iterator.
+
+ If result is {{NodeFilter/FILTER_ACCEPT}}, then break.
+ Set iterator's reference to node.
+
+ Set iterator's pointer before reference to
+ beforeNode.
+
+ Return node.
+ The The The {{TreeWalker}} objects can be created using the {{createTreeWalker()}}
+method on {{Document}} objects.
+
+ Each {{TreeWalker}} object has an associated current (a
+node).
+
+ As mentioned earlier {{TreeWalker}} objects have an associated
+root, whatToShow, and filter as well.
+
+ The The The The The {{TreeWalker/currentNode}} attribute's setter, when invoked, must set this's
+current to the given value.
+
+ The Return null.
+ To traverse children, given a
+walker and type, run these steps:
+
+ Let node be walker's current.
+
+ Set node to node's first child if type is
+ first, and node's last child if type is last.
+
+ While node is non-null:
+
+ Let result be the result of filtering node within
+ walker.
+
+ If result is {{NodeFilter/FILTER_ACCEPT}}, then set walker's
+ current to node and return node.
+
+ If result is {{NodeFilter/FILTER_SKIP}}, then:
+
+ Let child be node's first child if type
+ is first, and node's last child if type is last.
+
+ If child is non-null, then set node to child and
+ continue.
+ While node is non-null:
+
+ Let sibling be node's next sibling if
+ type is first, and node's previous sibling if
+ type is last.
+
+ If sibling is non-null, then set node to sibling and
+ break.
+
+ Let parent be node's parent.
+
+ If parent is null, walker's root, or
+ walker's current, then return null.
+
+ Set node to parent.
+ Return null.
+ The The To traverse siblings, given a walker
+and type, run these steps:
+
+ Let node be walker's current.
+
+ If node is root, then return null.
+
+ While true:
+
+ Let sibling be node's next sibling if
+ type is next, and node's previous sibling if
+ type is previous.
+
+ While sibling is non-null:
+
+ Set node to sibling.
+
+ Let result be the result of filtering node within
+ walker.
+
+ If result is {{NodeFilter/FILTER_ACCEPT}}, then set walker's
+ current to node and return node.
+
+ Set sibling to node's first child if
+ type is next, and node's last child if type is
+ previous.
+
+ If result is {{NodeFilter/FILTER_REJECT}} or sibling is null, then
+ set sibling to node's next sibling if type is
+ next, and node's previous sibling if type is previous.
+ Set node to node's parent.
+
+ If node is null or walker's root, then return
+ null.
+
+ If the return value of filtering node within walker is
+ {{NodeFilter/FILTER_ACCEPT}}, then return null.
+ The The The While node is not this's root:
+
+ Let sibling be node's previous sibling.
+
+ While sibling is non-null:
+
+ Set node to sibling.
+
+ Let result be the result of filtering node within
+ this.
+
+ While result is not {{NodeFilter/FILTER_REJECT}} and node has a
+ child:
+
+ Set node to node's last child.
+
+ If result is {{NodeFilter/FILTER_ACCEPT}}, then set this's
+ current to node and return node.
+
+ Set sibling to node's previous sibling.
+ If node is this's root or node's
+ parent is null, then return null.
+
+ Set node to node's parent.
+
+ If the return value of filtering node within this is
+ {{NodeFilter/FILTER_ACCEPT}}, then set this's current to
+ node and return node.
+ Return null.
+ The Let result be {{NodeFilter/FILTER_ACCEPT}}.
+
+ While true:
+
+ While result is not {{NodeFilter/FILTER_REJECT}} and node has a
+ child:
+
+ Set node to its first child.
+
+ Set result to the result of filtering node within
+ this.
+
+ If result is {{NodeFilter/FILTER_ACCEPT}}, then set this's
+ current to node and return node.
+ Let sibling be null.
+
+ Let temporary be node.
+
+ While temporary is non-null:
+
+ Set sibling to temporary's next sibling.
+
+ If sibling is non-null, then set node to sibling and
+ break.
+
+ Set temporary to temporary's parent.
+ Set result to the result of filtering node within
+ this.
+
+ If result is {{NodeFilter/FILTER_ACCEPT}}, then set this's
+ current to node and return node.
+ {{NodeFilter}} objects can be used as filter for
+{{NodeIterator}} and {{TreeWalker}} objects and also provide constants for their
+whatToShow bitmask. A {{NodeFilter}} object is typically implemented as a
+JavaScript function.
+
+ These constants can be used as filter return value:
+
+ These constants can be used for whatToShow:
+
+ Yes, the name {{DOMTokenList}} is an unfortunate legacy mishap.
+
+ A {{DOMTokenList}} object has an associated
+token set (a set), which is
+initially empty.
+
+ A {{DOMTokenList}} object also has an associated element and an attribute's
+local name.
+
+Specifications may define
+supported tokens for a {{DOMTokenList}}'s
+associated attribute's local name.
+
+ A {{DOMTokenList}} object's
+validation steps for a given
+token are:
+
+ If the associated attribute's local name does not define
+ supported tokens, throw a Let lowercase token be a copy of token, in ASCII lowercase.
+
+ If lowercase token is present in supported tokens, return true.
+
+ Return false.
+ A {{DOMTokenList}} object's update steps are:
+
+ If the associated element does not have an associated attribute and
+ token set is empty, then return.
+
+ Set an attribute value for the associated element using associated
+ attribute's local name and the result of running the ordered set
+ serializer for token set.
+ A {{DOMTokenList}} object's serialize steps
+are to return the result of running get an attribute value given the associated
+element and the associated attribute's local name. A {{DOMTokenList}} object has these attribute change steps for its associated
+element:
+
+ If localName is associated attribute's local name,
+ namespace is null, and value is null, then empty
+ token set.
+
+ Otherwise, if localName is associated attribute's local name,
+ namespace is null, then set token set to value,
+ parsed.
+ When a {{DOMTokenList}} object is created, then:
+
+ Let element be associated element.
+
+ Let localName be associated attribute's local name.
+
+ Let value be the result of
+ getting an attribute value given element and
+ localName.
+
+ Run the attribute change steps for element, localName,
+ value, value, and null.
+ Returns the number of tokens.
+
+ Returns the token with index index.
+
+ Returns true if token is present, and false otherwise.
+
+ Adds all arguments passed, except those already present.
+ Throws a "{{SyntaxError!!exception}}" {{DOMException}} if one of the arguments is the empty
+ string.
+ Throws an "{{InvalidCharacterError!!exception}}" {{DOMException}} if one of the arguments
+ contains any ASCII whitespace.
+
+ Removes arguments passed, if they are present.
+ Throws a "{{SyntaxError!!exception}}" {{DOMException}} if one of the arguments is the empty
+ string.
+ Throws an "{{InvalidCharacterError!!exception}}" {{DOMException}} if one of the arguments
+ contains any ASCII whitespace.
+
+ If force is not given, "toggles" token, removing it if it's present and
+ adding it if it's not present. If force is true, adds token
+ (same as {{add()}}). If force is false, removes token (same
+ as {{DOMTokenList/remove()}}).
+ Returns true if token is now present, and false otherwise.
+ Throws a "{{SyntaxError!!exception}}" {{DOMException}} if token is empty.
+ Throws an "{{InvalidCharacterError!!exception}}" {{DOMException}} if token contains
+ any spaces.
+
+ Replaces token with newToken.
+ Returns true if token was replaced with newToken, and false otherwise.
+ Throws a "{{SyntaxError!!exception}}" {{DOMException}} if one of the arguments is the empty
+ string.
+ Throws an "{{InvalidCharacterError!!exception}}" {{DOMException}} if one of the arguments
+ contains any ASCII whitespace.
+
+ Returns true if token is in the associated attribute's supported tokens. Returns
+ false otherwise.
+ Throws a Returns the associated set as string.
+ Can be set, to change the associated attribute.
+ The The object's supported property indices are the numbers in the range zero to object's
+token set's size minus one, unless token set is empty,
+in which case there are no supported property indices.
+
+ The The The
+ For each token in tokens:
+
+ If token is the empty string, then throw a "{{SyntaxError!!exception}}"
+ {{DOMException}}.
+
+ If token contains any ASCII whitespace, then throw an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+ For each token in tokens, append
+ token to this's token set.
+
+ Run the update steps.
+ The
+ For each token in tokens:
+
+ If token is the empty string, then throw a "{{SyntaxError!!exception}}"
+ {{DOMException}}.
+
+ If token contains any ASCII whitespace, then throw an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+ For each token in tokens, remove token from
+ this's token set.
+
+ Run the update steps.
+ The If token is the empty string, then throw a "{{SyntaxError!!exception}}"
+ {{DOMException}}.
+
+ If token contains any ASCII whitespace, then throw an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ If this's token set[token] exists, then:
+
+ If force is either not given or is false, then remove
+ token from this's token set, run the update steps and return
+ false.
+
+ Return true.
+ Otherwise, if force not given or is true, append token
+ to this's token set, run the update steps, and return true.
+
+ Return false.
+ The update steps are not always run for {{DOMTokenList/toggle()}}
+for web compatibility.
+
+ The
+ If either token or newToken is the empty string, then throw a
+ "{{SyntaxError!!exception}}" {{DOMException}}.
+
+ If either token or newToken contains any ASCII whitespace, then
+ throw an "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ If this's token set does not contain token, then
+ return false. Run the update steps.
+
+ Return true.
+ The update steps are not always run for {{DOMTokenList/replace()}}
+for web compatibility.
+
+ The
+ Let result be the return value of validation steps called with
+ token.
+
+ Return result.
+ The Setting the {{DOMTokenList/value}} attribute must set an attribute value for the
+associated element using associated attribute's local name and
+the given value.
+
+
+
+ DOM Level 3 XPath defined an API for evaluating XPath 1.0
+expressions. These APIs are widely implemented, but have not been maintained. The interface
+definitions are maintained here so that they can be updated when Web IDL changes.
+Complete definitions of these APIs remain necessary and such work is tracked and can be contributed
+to in whatwg/dom#67. [[DOM-Level-3-XPath]]
+[[XPath]] [[WEBIDL]]
+
+
+ For historical reasons you can both construct {{XPathEvaluator}} and access the same
+methods on {{Document}}.
+
+
+
+ This standard used to contain several interfaces and interface members that have been removed.
+
+ These interfaces have been removed:
+
+ And these interface members have been removed:
+
+ There have been a lot of people that have helped make DOM more interoperable over the years and
+thereby furthered the goals of this standard. Likewise many people have helped making this standard
+what it is today.
+
+ With that, many thanks to
+Adam Klein,
+Adrian Bateman,
+Ahmid snuggs,
+Alex Komoroske,
+Alex Russell,
+Alexey Shvayka,
+Andreu Botella,
+Anthony Ramine,
+Arkadiusz Michalski,
+Arnaud Le Hors,
+Arun Ranganathan,
+Benjamin Gruenbaum,
+Björn Höhrmann,
+Boris Zbarsky,
+Brandon Payton,
+Brandon Slade,
+Brandon Wallace,
+Brian Kardell,
+Cameron McCormack,
+Chris Dumez,
+Chris Paris,
+Chris Rebert,
+Cyrille Tuzi,
+Daniel Glazman,
+Darin Fisher,
+David Bruant,
+David Flanagan,
+David Håsäther,
+David Hyatt,
+Deepak Sherveghar,
+Dethe Elza,
+Dimitri Glazkov,
+Domenic Denicola,
+Dominic Cooney,
+Dominique Hazaël-Massieux,
+Don Jordan,
+Doug Schepers,
+Edgar Chen,
+Elisée Maurer,
+Elliott Sprehn,
+Emilio Cobos Álvarez,
+Eric Bidelman,
+Erik Arvidsson,
+Gary Kacmarcik,
+Gavin Nicol,
+Giorgio Liscio,
+Glen Huang,
+Glenn Adams,
+Glenn Maynard,
+Hajime Morrita,
+Harald Alvestrand,
+Hayato Ito,
+Henri Sivonen,
+Hongchan Choi,
+Hunan Rostomyan,
+Ian Hickson,
+Igor Bukanov,
+Jacob Rossi,
+Jake Archibald,
+Jake Verbaten,
+James Graham,
+James Greene,
+James Robinson,
+Jeffrey Yasskin,
+Jens Lindström,
+Jesse McCarthy,
+Jinho Bang,
+João Eiras,
+Joe Kesselman,
+John Atkins,
+John Dai,
+Jonas Sicking,
+Jonathan Kingston,
+Jonathan Robie,
+Joris van der Wel,
+Joshua Bell,
+J. S. Choi,
+Jungkee Song,
+Justin Summerlin,
+Kagami Sascha Rosylight,
+呂康豪 (Kang-Hao Lu),
+田村健人 (Kent TAMURA),
+Kevin J. Sung,
+Kevin Sweeney,
+Kirill Topolyan,
+Koji Ishii,
+Lachlan Hunt,
+Lauren Wood,
+Luke Zielinski,
+Magne Andersson,
+Majid Valipour,
+Malte Ubl,
+Manish Goregaokar,
+Manish Tripathi,
+Marcos Caceres,
+Mark Miller,
+Martijn van der Ven,
+Mats Palmgren,
+Mounir Lamouri,
+Michael Stramel,
+Michael™ Smith,
+Mike Champion,
+Mike Taylor,
+Mike West,
+Ojan Vafai,
+Oliver Nightingale,
+Olli Pettay,
+Ondřej Žára,
+Peter Sharpe,
+Philip Jägenstedt,
+Philippe Le Hégaret,
+Piers Wombwell,
+Pierre-Marie Dartus,
+prosody—Gab Vereable Context(,
+Rafael Weinstein,
+Rakina Zata Amni,
+Richard Bradshaw,
+Rick Byers,
+Rick Waldron,
+Robbert Broersma,
+Robin Berjon,
+Roland Steiner,
+Rune F. Halvorsen,
+Russell Bicknell,
+Ruud Steltenpool,
+Ryosuke Niwa,
+Sam Dutton,
+Sam Sneddon,
+Samuel Giles,
+Sanket Joshi,
+Sebastian Mayr,
+Seo Sanghyeon,
+Sergey G. Grekhov,
+Shiki Okasaka,
+Shinya Kawanaka,
+Simon Pieters,
+Stef Busking,
+Steve Byrne,
+Stig Halvorsen,
+Tab Atkins,
+Takashi Sakamoto,
+Takayoshi Kochi,
+Theresa O'Connor,
+Theodore Dubois,
+timeless,
+Timo Tijhof,
+Tobie Langel,
+Tom Pixley,
+Travis Leithead,
+Trevor Rowbotham,
+triple-underscore,
+Veli Şenol,
+Vidur Apparao,
+Warren He,
+Xidorn Quan,
+Yash Handa,
+Yehuda Katz,
+Yoav Weiss,
+Yoichi Osato,
+Yoshinori Sano,
+Yusuke Abe, and
+Zack Weinberg
+for being awesome!
+
+ This standard is written by Anne van Kesteren
+(Mozilla, annevk@annevk.nl)
+with substantial contributions from Aryeh Gregor (ayg@aryeh.name)
+and Ms2ger (ms2ger@gmail.com).
+
+ Part of the revision history of the integration points related to
+custom elements can be found in
+the w3c/webcomponents repository, which is
+available under the
+W3C Software and Document License.
diff --git a/review-drafts/2021-06.bs b/review-drafts/2021-06.bs
new file mode 100644
index 000000000..dab06c51e
--- /dev/null
+++ b/review-drafts/2021-06.bs
@@ -0,0 +1,10172 @@
+ This specification depends on the Infra Standard. [[!INFRA]]
+
+ Some of the terms used in this specification are defined in Encoding,
+Selectors, Web IDL, XML, and Namespaces in XML.
+[[!ENCODING]]
+[[!SELECTORS4]]
+[[!WEBIDL]]
+[[!XML]]
+[[!XML-NAMES]]
+
+ When extensions are needed, the DOM Standard can be updated accordingly, or a new standard
+can be written that hooks into the provided extensibility hooks for
+applicable specifications.
+
+
+
+ A tree is a finite hierarchical tree structure. In
+tree order is preorder, depth-first traversal of a
+tree.
+
+
+ An object that
+participates
+in a tree has a parent, which is either
+null or an object, and has
+children, which is an
+ordered set of objects. An object A whose parent is object
+B is a child of B.
+
+ The root of an object is itself, if its
+parent is null, or else it is the root of its
+parent. The root of a tree is any object
+participating in that tree whose parent is null.
+
+An object A is called a
+descendant of an object
+B, if either A is a
+child of B or
+A is a child of an
+object C that is a
+descendant of B.
+
+An
+inclusive descendant is
+an object or one of its
+descendants.
+
+An object A is called an
+ancestor of an object
+B if and only if B is a
+descendant of
+A.
+
+An inclusive ancestor is
+an object or one of its ancestors.
+
+An object A is called a
+sibling of an object
+B, if and only if B and A
+share the same non-null parent.
+
+An inclusive sibling is an
+object or one of its siblings.
+
+An object A is
+preceding an object
+B if A and B are in the
+same tree and A comes
+before B in
+tree order.
+
+An object A is
+following an object
+B if A and B are in the
+same tree and A comes
+after B in
+tree order.
+
+The first child of an object is its
+first child or null if it has no children.
+
+The last child of an object is its
+last child or null if it has no children.
+
+The previous sibling of an
+object is its first preceding
+sibling or null if it has no
+preceding
+sibling.
+
+The next sibling of an
+object is its first following
+sibling or null if it has no
+following
+sibling.
+
+ The index of an object is its number of
+preceding siblings, or 0 if it has none.
+
+
+ The ordered set parser takes a string
+input and then runs these steps:
+
+ Let inputTokens be the result of
+ splitting input on ASCII whitespace.
+
+ Let tokens be a new ordered set.
+
+ For each token in inputTokens, append
+ token to tokens.
+
+ The ordered set serializer takes a
+set and returns the concatenation of set using U+0020 SPACE.
+
+
+ To scope-match a selectors string selectors against a
+node, run these steps:
+
+ Let s be the result of parse a selector selectors.
+ [[!SELECTORS4]]
+
+ If s is failure, then throw a "{{SyntaxError!!exception}}"
+ {{DOMException}}.
+
+ Return the result of match a selector against a tree with s and
+ node's root using scoping root node. [[!SELECTORS4]].
+ Support for namespaces within selectors is not planned and will not be
+added.
+
+
+ To validate a qualifiedName, throw an
+"{{InvalidCharacterError!!exception}}" {{DOMException}} if qualifiedName does not match
+the Although events are typically dispatched by the user agent
+as the result of user interaction or the completion of some task, applications can dispatch
+events themselves by using what are commonly known as synthetic events:
+
+ When an event is dispatched to an object that participates in a tree
+(e.g., an element), it can reach event listeners on that object's
+ancestors too. Effectively, all the object's inclusive ancestor event listeners
+whose capture is true are invoked, in tree order. And then, if
+event's {{Event/bubbles}} is true, all the object's inclusive ancestor
+event listeners whose capture is false are invoked, now in
+reverse tree order.
+
+ Let's look at an example of how events work in a tree:
+
+ The An {{Event}} object is simply named an event. It allows for
+signaling that something has occurred, e.g., that an image has completed downloading. A potential event target is null or an {{EventTarget}} object.
+
+ An event has an associated target (a
+potential event target). Unless stated otherwise it is null.
+
+ An event has an associated relatedTarget (a
+potential event target). Unless stated otherwise it is null.
+
+ Other specifications use relatedTarget to define a
+ An event has an associated touch target list (a
+list of zero or more potential event targets). Unless stated otherwise it is the
+empty list.
+
+ The touch target list is for the exclusive use of defining the
+{{TouchEvent}} interface and related interfaces. [[TOUCH-EVENTS]]
+
+ An event has an associated path. A path is a
+list of structs. Each struct consists of an
+invocation target (an {{EventTarget}} object), an
+invocation-target-in-shadow-tree (a boolean), a
+shadow-adjusted target (a potential event target), a
+relatedTarget (a
+potential event target), a touch target list (a list
+of potential event targets), a root-of-closed-tree (a boolean), and
+a slot-in-closed-tree (a boolean). A path is initially
+the empty list. The The The The The Let composedPath be an empty list.
+
+ If path is empty, then return composedPath.
+
+ Let currentTarget be this's {{Event/currentTarget}} attribute value.
+
+ Append currentTarget to composedPath.
+
+ Let currentTargetIndex be 0.
+
+ Let currentTargetHiddenSubtreeLevel be 0.
+
+ Let index be path's size − 1.
+
+ While index is greater than or equal to 0:
+
+ If path[index]'s root-of-closed-tree is true,
+ then increase currentTargetHiddenSubtreeLevel by 1.
+
+ If path[index]'s invocation target is
+ currentTarget, then set currentTargetIndex to index and
+ break.
+
+ If path[index]'s slot-in-closed-tree is true,
+ then decrease currentTargetHiddenSubtreeLevel by 1.
+
+ Decrease index by 1.
+ Let currentHiddenLevel and maxHiddenLevel be
+ currentTargetHiddenSubtreeLevel.
+
+ Set index to currentTargetIndex − 1.
+
+ While index is greater than or equal to 0:
+
+ If path[index]'s root-of-closed-tree is true,
+ then increase currentHiddenLevel by 1.
+
+ If currentHiddenLevel is less than or equal to maxHiddenLevel, then
+ prepend path[index]'s
+ invocation target to composedPath.
+
+ If path[index]'s slot-in-closed-tree is true,
+ then:
+
+ Decrease currentHiddenLevel by 1.
+
+ If currentHiddenLevel is less than maxHiddenLevel, then set
+ maxHiddenLevel to currentHiddenLevel.
+ Decrease index by 1.
+ Set currentHiddenLevel and maxHiddenLevel to
+ currentTargetHiddenSubtreeLevel.
+
+ Set index to currentTargetIndex + 1.
+
+ While index is less than path's size:
+
+ If path[index]'s slot-in-closed-tree is true,
+ then increase currentHiddenLevel by 1.
+
+ If currentHiddenLevel is less than or equal to maxHiddenLevel, then
+ append path[index]'s
+ invocation target to composedPath.
+
+ If path[index]'s root-of-closed-tree is true,
+ then:
+
+ Decrease currentHiddenLevel by 1.
+
+ If currentHiddenLevel is less than maxHiddenLevel, then set
+ maxHiddenLevel to currentHiddenLevel.
+ Increase index by 1.
+ Return composedPath.
+ The Initially the attribute must be initialized to {{Event/NONE}}.
+
+ Each event has the following associated flags that are all initially unset:
+
+ The The The {{Event/cancelBubble}} setter steps are to set this's stop propagation flag if
+the given value is true; otherwise do nothing.
+
+ The The To set the canceled flag, given an event event, if
+event's {{Event/cancelable}} attribute value is true and event's
+in passive listener flag is unset, then set event's canceled flag, and do
+nothing otherwise.
+
+ The The {{Event/returnValue}} setter steps are to set the canceled flag with this if
+the given value is false; otherwise do nothing.
+
+ The There are scenarios where invoking {{Event/preventDefault()}} has no
+effect. User agents are encouraged to log the precise cause in a developer console, to aid
+debugging.
+
+ The The The {{Event/isTrusted}} is a convenience that indicates whether an
+event is dispatched by the user agent (as opposed to using
+{{EventTarget/dispatchEvent()}}). The sole legacy exception is {{HTMLElement/click()}}, which causes
+the user agent to dispatch an event whose {{Event/isTrusted}} attribute is initialized to
+false.
+
+ The To initialize an event, with
+type, bubbles, and cancelable, run these steps:
+
+ Set event's initialized flag.
+
+ Unset event's stop propagation flag,
+ stop immediate propagation flag, and canceled flag.
+
+ Set event's {{Event/isTrusted}} attribute to false.
+
+ Set event's target to null.
+
+ Set event's {{Event/type}} attribute to type.
+
+ Set event's {{Event/bubbles}} attribute to bubbles.
+
+ Set event's {{Event/cancelable}} attribute to cancelable.
+ The
+ If this's dispatch flag is set, then return.
+
+ Initialize this with type, bubbles, and
+ cancelable.
+ {{Event/initEvent()}} is redundant with event constructors and
+incapable of setting {{Event/composed}}. It has to be supported for legacy content.
+
+
+ Each {{Window}} object has an associated current event (undefined or an
+{{Event}} object). Unless stated otherwise it is undefined.
+
+ The Web developers are strongly encouraged to instead rely on the {{Event}} object passed
+to event listeners, as that will result in more portable code. This attribute is not available in
+workers or worklets, and is inaccurate for events dispatched in shadow trees.
+
+
+ The The
+ If this's dispatch flag is set, then return.
+
+ Initialize this with type, bubbles, and
+ cancelable.
+
+ Set this's {{CustomEvent/detail}} attribute to detail.
+ This construct can be used by {{Event}} subclasses that have a more complex structure
+than a simple 1:1 mapping between their initializing dictionary members and IDL attributes.
+
+ When a constructor of the {{Event}}
+interface, or of an interface that inherits from the {{Event}} interface, is invoked, these steps
+must be run, given the arguments type and eventInitDict:
+
+ Let event be the result of running the inner event creation steps with
+ this interface, null, now, and eventInitDict.
+
+ Initialize event's {{Event/type}} attribute to type.
+
+ Return event.
+ To
+create an event
+using eventInterface, which must be either {{Event}} or an interface that inherits from
+it, and optionally given a Realm realm, run these steps: If realm is not given, then set it to null.
+
+ Let dictionary be the result of converting
+ the JavaScript value undefined to the dictionary type accepted by eventInterface's
+ constructor. (This dictionary type will either be {{EventInit}} or a dictionary that inherits from
+ it.)
+
+ This does not work if members are required; see
+ whatwg/dom#600.
+
+ Let event be the result of running the inner event creation steps with
+ eventInterface, realm, the time of the occurrence that the event is
+ signaling, and dictionary.
+
+ In macOS the time of the occurrence for input
+ actions is available via the Initialize event's {{Event/isTrusted}} attribute to true.
+
+ Return event.
+ Create an event is meant to be used by other specifications which need to
+separately create and dispatch events, instead of simply
+firing them. It ensures the event's attributes are initialized to the
+correct defaults. The inner event creation steps, given an interface,
+realm, time, and dictionary, are as follows: Let event be the result of creating a new object using eventInterface. If
+ realm is non-null, then use that Realm; otherwise, use the default behavior defined in
+ Web IDL.
+
+ As of the time of this writing Web IDL does not yet define any default behavior;
+ see heycam/webidl#135.
+
+ Set event's initialized flag.
+
+ Initialize event's {{Event/timeStamp}} attribute to a {{DOMHighResTimeStamp}}
+ representing the high resolution time from the time origin to time.
+
+ User agents should set a minimum resolution of event's
+ {{Event/timeStamp}} attribute to 5 microseconds following the existing clock resolution
+ recommendation. [[!HR-TIME]]
+
+ For each member → value in dictionary, if
+ event has an attribute whose identifier is member, then
+ initialize that attribute to value.
+
+ Run the event constructing steps with event.
+
+ Return event.
+ An {{EventTarget}} object represents a target to which an event can be dispatched
+when something has occurred.
+
+ Each {{EventTarget}} object has an associated event listener list (a
+list of zero or more event listeners). It is initially the empty list.
+
+
+ An event listener can be used to observe a specific
+event and consists of:
+
+ Although callback is an {{EventListener}}
+object, an event listener is a broader concept as can be seen above.
+
+ Each {{EventTarget}} object also has an associated get the parent algorithm,
+which takes an event event, and returns an {{EventTarget}} object. Unless
+specified otherwise it returns null.
+
+ Nodes, shadow roots, and documents
+override the get the parent algorithm.
+
+ Each {{EventTarget}} object can have an associated
+activation behavior algorithm. The
+activation behavior algorithm is passed an event, as indicated in the
+dispatch algorithm. This exists because user agents perform certain actions for certain
+{{EventTarget}} objects, e.g., the <{area}> element, in response to synthetic {{MouseEvent}}
+events whose {{Event/type}} attribute is Each {{EventTarget}} object that has activation behavior, can additionally
+have both (not either) a legacy-pre-activation behavior algorithm
+and a legacy-canceled-activation behavior algorithm.
+
+ These algorithms only exist for checkbox and radio <{input}> elements and
+are not to be used for anything else. [[!HTML]]
+
+ Creates a new {{EventTarget}} object, which can be used by developers to dispatch and
+ listen for events.
+
+ Appends an event listener for events whose {{Event/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 {{EventListenerOptions/capture}}.
+
+ When set to true, options's {{EventListenerOptions/capture}} prevents
+ callback from being invoked when the event's
+ {{Event/eventPhase}} attribute value is {{Event/BUBBLING_PHASE}}. When false (or not present),
+ callback will not be invoked when event's {{Event/eventPhase}}
+ attribute value is {{Event/CAPTURING_PHASE}}. Either way, callback
+ will be invoked if event's {{Event/eventPhase}} attribute value is {{Event/AT_TARGET}}.
+
+ When set to true, options's {{AddEventListenerOptions/passive}} indicates that the
+ callback will not cancel the event by invoking
+ {{Event/preventDefault()}}. This is used to enable performance optimizations described in
+ [[#observing-event-listeners]].
+
+ When set to true, options's {{AddEventListenerOptions/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 {{AddEventListenerOptions/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.
+
+ Removes the event listener in target's
+ event listener list with the same type, callback, and
+ options.
+
+ Dispatches a synthetic event event to target and returns true
+ if either event's {{Event/cancelable}} attribute value is false or its
+ {{Event/preventDefault()}} method was not invoked; otherwise false.
+ To flatten options, run these
+steps:
+
+ If options is a boolean, then return options.
+
+ Return |options|["{{EventListenerOptions/capture}}"].
+ To flatten more options, run these
+steps:
+
+ Let capture be the result of flattening options.
+
+ Let once and passive be false.
+
+ Let |signal| be null.
+
+ If |options| is a dictionary, then:
+
+ Set |passive| to |options|["{{AddEventListenerOptions/passive}}"] and |once| to
+ |options|["{{AddEventListenerOptions/once}}"].
+
+ If |options|["{{AddEventListenerOptions/signal}}"] [=map/exists=], then set |signal| to
+ |options|["{{AddEventListenerOptions/signal}}"].
+ Return capture, passive, once, and signal.
+ The Because of the defaults stated elsewhere, the returned {{EventTarget}}'s
+get the parent algorithm will return null, and it will have no activation behavior,
+legacy-pre-activation behavior, or legacy-canceled-activation behavior.
+
+ In the future we could allow custom get the parent algorithms. Let us know
+if this would be useful for your programs. For now, all author-created {{EventTarget}}s do not
+participate in a tree structure. To add an event listener, given an {{EventTarget}} object
+eventTarget and an event listener listener, run these steps:
+
+ If eventTarget is a {{ServiceWorkerGlobalScope}} object, its
+ service worker's
+ script resource's
+ has ever been evaluated flag is set, and listener's
+ type matches the {{Event/type}} attribute value of any of the
+ service worker events, then report a warning to the console that this might not give
+ the expected results. [[!SERVICE-WORKERS]]
+
+ If signal is not null and its [=AbortSignal/aborted flag=] is
+ set, then return.
+
+ If listener's callback is null, then return.
+
+ If eventTarget's event listener list does not contain an
+ event listener whose type is listener's
+ type, callback is listener's
+ callback, and capture is
+ listener's capture, then append
+ listener to eventTarget's event listener list.
+
+ If listener's signal is not null, then
+ add the following abort steps to it:
+
+ The add an event listener concept exists to ensure event handlers use
+the same code path. [[HTML]]
+
+ The
+ Let capture, passive, and once be the result of
+ flattening more options.
+
+ Add an event listener with this and an event listener whose
+ type is type, callback is
+ callback, capture is capture,
+ passive is passive, once is
+ once, and signal is signal.
+ To remove an event listener, given an {{EventTarget}} object
+eventTarget and an event listener listener, run these steps:
+
+ If eventTarget is a {{ServiceWorkerGlobalScope}} object and its
+ service worker's
+ set of event types to handle contains type, then
+ report a warning to the console that this might not give the expected results.
+ [[!SERVICE-WORKERS]]
+
+ Set listener's removed to true and
+ remove listener from eventTarget's
+ event listener list.
+ HTML needs this to define event handlers. [[HTML]]
+
+ To remove all event listeners, given an {{EventTarget}} object
+eventTarget, for each listener of eventTarget's
+event listener list, remove an event listener with
+eventTarget and listener.
+
+ HTML needs this to define The
+ Let capture be the result of flattening options.
+
+ If this's event listener list contains an
+ event listener whose type is type,
+ callback is callback, and
+ capture is capture, then remove an event listener
+ with this and that event listener.
+ The event listener list will not contain multiple event listeners with equal
+type, callback, and capture, as add an event listener
+prevents that.
+
+ The If event's dispatch flag is set, or if its initialized flag is not
+ set, then throw an "{{InvalidStateError!!exception}}" {{DOMException}}.
+
+ Initialize event's {{Event/isTrusted}} attribute to false.
+
+ Return the result of dispatching event to this.
+ In general, developers do not expect the presence of an event listener to be observable.
+The impact of an event listener is determined by its callback. That is, a developer
+adding a no-op event listener would not expect it to have any side effects.
+
+ Unfortunately, some event APIs have been designed such that implementing them efficiently
+requires observing event listeners. This can make the presence of listeners observable in
+that even empty listeners can have a dramatic performance impact on the behavior of the application.
+For example, touch and wheel events which can be used to block asynchronous scrolling. In some cases
+this problem can be mitigated by specifying the event to be {{Event/cancelable}} only when there is
+at least one non-{{AddEventListenerOptions/passive}} listener. For example,
+non-{{AddEventListenerOptions/passive}} {{TouchEvent}} listeners must block scrolling, but if all
+listeners are {{AddEventListenerOptions/passive}} then scrolling can be allowed to start
+in parallel by making the {{TouchEvent}} uncancelable (so that calls to
+{{Event/preventDefault()}} are ignored). So code dispatching an event is able to observe the absence
+of non-{{AddEventListenerOptions/passive}} listeners, and use that to clear the {{Event/cancelable}}
+property of the event being dispatched.
+
+ Ideally, any new event APIs are defined such that they do not need this property (use
+public-script-coord@w3.org
+for discussion).
+
+
+ To dispatch an event to a
+target, with an optional legacy target override flag and an optional
+legacyOutputDidListenersThrowFlag, run these steps:
+
+ Set event's dispatch flag.
+
+ Let targetOverride be target, if legacy target override flag
+ is not given, and target's associated legacy target override flag is only used by HTML and only when
+ target is a {{Window}} object.
+
+ Let activationTarget be null.
+
+ Let relatedTarget be the result of retargeting event's
+ relatedTarget against target.
+
+ If target is not relatedTarget or target is event's
+ relatedTarget, then:
+
+ Let touchTargets be a new list.
+
+ For each touchTarget of event's
+ touch target list, append the result of retargeting
+ touchTarget against target to touchTargets.
+
+ Append to an event path with event, target,
+ targetOverride, relatedTarget, touchTargets, and false.
+
+ Let isActivationEvent be true, if event is a {{MouseEvent}} object
+ and event's {{Event/type}} attribute is " If isActivationEvent is true and target has
+ activation behavior, then set activationTarget to
+ target.
+
+ Let slottable be target, if target is a slottable
+ and is assigned, and null otherwise.
+
+ Let slot-in-closed-tree be false.
+
+ Let parent be the result of invoking target's get the parent
+ with event.
+
+ While parent is non-null: If slottable is non-null:
+
+ Assert: parent is a slot.
+
+ Set slottable to null.
+
+ If parent's root is a shadow root whose
+ mode is " If parent is a slottable and is assigned, then
+ set slottable to parent.
+
+ Let relatedTarget be the result of retargeting event's
+ relatedTarget against parent.
+
+ Let touchTargets be a new list.
+
+ For each touchTarget of event's
+ touch target list, append the result of retargeting
+ touchTarget against parent to touchTargets.
+
+ If parent is a {{Window}} object, or parent is a node and
+ target's root is a shadow-including inclusive ancestor of
+ parent, then:
+
+ If isActivationEvent is true, event's {{Event/bubbles}}
+ attribute is true, activationTarget is null, and parent has
+ activation behavior, then set activationTarget to
+ parent.
+
+ Append to an event path with event, parent, null,
+ relatedTarget, touchTargets, and slot-in-closed-tree.
+ Otherwise, if parent is relatedTarget, then set parent
+ to null.
+
+ Otherwise, set target to parent and then:
+
+ If isActivationEvent is true, activationTarget is null, and
+ target has activation behavior, then set
+ activationTarget to target.
+
+ Append to an event path with event, parent,
+ target, relatedTarget, touchTargets, and
+ slot-in-closed-tree.
+ If parent is non-null, then set parent to the result of invoking
+ parent's get the parent with event.
+
+ Set slot-in-closed-tree to false.
+ Let clearTargetsStruct be the last struct in event's
+ path whose shadow-adjusted target is non-null.
+
+ Let clearTargets be true if clearTargetsStruct's
+ shadow-adjusted target, clearTargetsStruct's
+ relatedTarget, or an {{EventTarget}} object in
+ clearTargetsStruct's touch target list is a node
+ and its root is a shadow root; otherwise false.
+
+ If activationTarget is non-null and activationTarget has
+ legacy-pre-activation behavior, then run activationTarget's
+ legacy-pre-activation behavior.
+
+ For each struct in event's path, in
+ reverse order:
+
+ If struct's shadow-adjusted target is non-null, then
+ set event's {{Event/eventPhase}} attribute to {{Event/AT_TARGET}}.
+
+ Otherwise, set event's {{Event/eventPhase}} attribute to
+ {{Event/CAPTURING_PHASE}}.
+
+ Invoke with struct, event, " For each struct in event's path:
+
+ If struct's shadow-adjusted target is non-null, then
+ set event's {{Event/eventPhase}} attribute to {{Event/AT_TARGET}}.
+
+ Otherwise:
+
+ If event's {{Event/bubbles}} attribute is false, then
+ continue.
+
+ Set event's {{Event/eventPhase}} attribute to {{Event/BUBBLING_PHASE}}.
+ Invoke with struct, event, " Set event's {{Event/eventPhase}} attribute to {{Event/NONE}}.
+
+ Set event's {{Event/currentTarget}} attribute to null.
+
+ Set event's path to the empty list.
+
+ Unset event's dispatch flag, stop propagation flag, and
+ stop immediate propagation flag.
+
+ If clearTargets, then:
+
+ Set event's target to null.
+
+ Set event's relatedTarget to null.
+
+ Set event's touch target list to the empty list.
+ If activationTarget is non-null, then:
+
+ If event's canceled flag is unset, then run
+ activationTarget's activation behavior with event.
+
+ Otherwise, if activationTarget has
+ legacy-canceled-activation behavior, then run
+ activationTarget's legacy-canceled-activation behavior.
+ Return false if event's canceled flag is set; otherwise true.
+ To append to an event path, given an
+event, invocationTarget, shadowAdjustedTarget,
+relatedTarget, touchTargets, and a slot-in-closed-tree, run these
+steps: Let invocationTargetInShadowTree be false.
+
+ If invocationTarget is a node and its root is a
+ shadow root, then set invocationTargetInShadowTree to true.
+
+ Let root-of-closed-tree be false.
+
+ If invocationTarget is a shadow root whose mode
+ is " Append a new struct to event's path
+ whose invocation target is invocationTarget,
+ invocation-target-in-shadow-tree is invocationTargetInShadowTree,
+ shadow-adjusted target is shadowAdjustedTarget,
+ relatedTarget is relatedTarget,
+ touch target list is touchTargets,
+ root-of-closed-tree is root-of-closed-tree, and
+ slot-in-closed-tree is slot-in-closed-tree.
+ To invoke, given a struct,
+event, phase, and an optional legacyOutputDidListenersThrowFlag,
+run these steps:
+
+ Set event's target to the
+ shadow-adjusted target of the last struct in event's
+ path, that is either struct or preceding struct, whose
+ shadow-adjusted target is non-null.
+
+ Set event's relatedTarget to struct's
+ relatedTarget.
+
+ Set event's touch target list to struct's
+ touch target list.
+
+ If event's stop propagation flag is set, then return.
+
+ Initialize event's {{Event/currentTarget}} attribute to struct's
+ invocation target.
+
+ Let listeners be a clone of event's
+ {{Event/currentTarget}} attribute value's event listener list.
+
+ This avoids event listeners added after this point from being
+ run. Note that removal still has an effect due to the removed field.
+
+ Let invocationTargetInShadowTree be struct's
+ invocation-target-in-shadow-tree.
+
+ Let found be the result of running inner invoke with event,
+ listeners, phase, invocationTargetInShadowTree, and
+ legacyOutputDidListenersThrowFlag if given.
+
+ If found is false and event's {{Event/isTrusted}} attribute is true,
+ then:
+
+ Let originalEventType be event's {{Event/type}} attribute value.
+
+ If event's {{Event/type}} attribute value is a match for any of the strings in the
+ first column in the following table, set event's {{Event/type}} attribute value to
+ the string in the second column on the same row as the matching string, and return otherwise.
+
+ Inner invoke with event, listeners, phase,
+ invocationTargetInShadowTree, and legacyOutputDidListenersThrowFlag
+ if given.
+
+ Set event's {{Event/type}} attribute value to originalEventType.
+ To inner invoke, given an
+event, listeners, phase, invocationTargetInShadowTree,
+and an optional legacyOutputDidListenersThrowFlag, run these steps:
+
+ Let found be false.
+
+ For each listener in listeners, whose
+ removed is false:
+
+ If event's {{Event/type}} attribute value is not listener's
+ type, then continue.
+
+ Set found to true.
+
+ If phase is " If phase is " If listener's once is true, then
+ remove listener from event's {{Event/currentTarget}}
+ attribute value's event listener list.
+
+
+ Let global be listener callback's
+ associated Realm's global object.
+
+ Let currentEvent be undefined.
+
+ If global is a {{Window}} object, then:
+
+ Set currentEvent to global's current event.
+
+ If invocationTargetInShadowTree is false, then set global's
+ current event to event.
+ If listener's passive is true, then set
+ event's in passive listener flag.
+
+ Call a user object's operation with listener's
+ callback, " Report the exception.
+
+ Set legacyOutputDidListenersThrowFlag if given.
+
+ The legacyOutputDidListenersThrowFlag is only used by Indexed
+ Database API. [[INDEXEDDB]]
+ Unset event's in passive listener flag.
+
+ If global is a {{Window}} object, then set global's
+ current event to currentEvent.
+
+ If event's stop immediate propagation flag is set, then return
+ found.
+ Return found.
+ To fire an event named e at target,
+optionally using an eventConstructor, with a description of how IDL attributes are to be
+initialized, and a legacy target override flag, run these steps:
+
+ If eventConstructor is not given, then let eventConstructor be
+ {{Event}}.
+
+ Let event be the result of creating an event given
+ eventConstructor, in the relevant Realm of target.
+
+ Initialize event's {{Event/type}} attribute to e.
+
+ Initialize any other IDL attributes of event as described in the invocation of this
+ algorithm.
+
+ This also allows for the {{Event/isTrusted}} attribute to be set to false.
+
+ Return the result of dispatching event at target, with
+ legacy target override flag set if set.
+ Fire in the context of DOM is short for
+creating, initializing, and dispatching an event.
+Fire an event makes that process easier to write down.
+
+ If the event needs its {{Event/bubbles}} or {{Event/cancelable}} attribute initialized,
+ one could write "fire an event named Or, when a custom constructor is needed, "fire an event named Occasionally the return value is important:
+
+ Let doAction be the result of firing an event named
+ If doAction is true, then …
+ An event signifies an occurrence, not an action. Phrased differently, it
+represents a notification from an algorithm and can be used to influence the future course
+of that algorithm (e.g., through invoking {{Event/preventDefault()}}). Events must not be
+used as actions or initiators that cause some algorithm to start running. That is not what
+they are for.
+
+ This is called out here specifically because previous
+iterations of the DOM had a concept of "default actions" associated with events
+that gave folks all the wrong ideas. Events do not represent or cause actions, they
+can only be used to influence an ongoing one.
+
+
+
+ Though promises do not have a built-in aborting mechanism, many APIs using them require abort
+semantics. {{AbortController}} is meant to support these requirements by providing an
+{{AbortController/abort()}} method that toggles the state of a corresponding {{AbortSignal}} object.
+The API which wishes to support aborting can accept an {{AbortSignal}} object, and use its state to
+determine how to proceed.
+
+ APIs that rely upon {{AbortController}} are encouraged to respond to {{AbortController/abort()}}
+by rejecting any unsettled promise with a new "{{AbortError!!exception}}" {{DOMException}}.
+
+ A hypothetical APIs that require more granular control could extend both {{AbortController}} and
+ {{AbortSignal}} objects according to their needs.
+ An {{AbortController}} object has an associated signal (an
+{{AbortSignal}} object).
+
+ The
+ The The An {{AbortSignal}} object has an associated aborted flag. It is
+unset unless specified otherwise.
+
+ An {{AbortSignal}} object has associated abort algorithms, which is a
+set of algorithms which are to be executed when its [=AbortSignal/aborted flag=] is
+set. Unless specified otherwise, its value is the empty set.
+
+ To add an algorithm algorithm to an {{AbortSignal}}
+object signal, run these steps:
+
+ If signal's aborted flag is set, then return.
+
+ Append algorithm to signal's
+ abort algorithms.
+ To remove an algorithm algorithm from an
+{{AbortSignal}} signal, remove algorithm from
+signal's abort algorithms.
+
+ The [=AbortSignal/abort algorithms=] enable APIs with complex
+requirements to react in a reasonable way to {{AbortController/abort()}}. For example, a given API's
+[=AbortSignal/aborted flag=] might need to be propagated to a cross-thread environment, such as a
+service worker.
+
+ The static Let signal be a new {{AbortSignal}} object.
+
+ Set signal's [=AbortSignal/aborted flag=].
+
+ The aborted getter steps are to return true if this's
+[=AbortSignal/aborted flag=] is set; otherwise false.
+
+ The Changes to an {{AbortSignal}} object represent the wishes of the corresponding
+{{AbortController}} object, but an API observing the {{AbortSignal}} object can chose to ignore
+them. For instance, if the operation has already completed.
+
+ To signal abort, given an {{AbortSignal}} object
+signal, run these steps:
+
+ If signal's [=AbortSignal/aborted flag=] is set, then return.
+
+ Set signal's [=AbortSignal/aborted flag=].
+
+ For each algorithm in signal's
+ [=AbortSignal/abort algorithms=]: run algorithm.
+
+ Empty signal's abort algorithms.
+
+ [=Fire an event=] named {{AbortSignal/abort}} at signal.
+ A followingSignal (an {{AbortSignal}}) is made to
+follow a parentSignal (an {{AbortSignal}}) by running
+these steps:
+
+ If followingSignal's [=AbortSignal/aborted flag=] is set, then return.
+
+ If parentSignal's [=AbortSignal/aborted flag=] is set, then
+ signal abort on followingSignal.
+
+ Otherwise, add the following abort steps to
+ parentSignal:
+
+ Signal abort on followingSignal.
+ Any web platform API using promises to represent operations that can be aborted must adhere to
+the following:
+
+ The steps for a promise-returning method Let |p| be [=a new promise=].
+
+ If |options|' If |options|' [=AbortSignal/Add|Add the following abort steps=] to |options|' Stop doing amazing things.
+
+ [=Reject=] |p| with an "{{AbortError!!exception}}" {{DOMException}}.
+ Run these steps [=in parallel=]:
+
+ Let |amazingResult| be the result of doing some amazing things.
+
+ [=/Resolve=] |p| with |amazingResult|.
+ Return |p|.
+ APIs not using promises should still adhere to the above as much as possible.
+
+
+
+ Each such document is represented as a node tree. Some of the nodes in a
+tree can have children, while others are always leaves.
+
+To illustrate, consider this HTML document:
+
+ Note that, due to the magic that is HTML parsing, not all
+ASCII whitespace were turned into {{Text}} nodes, but the general concept is
+clear. Markup goes in, a tree of nodes comes out.
+
+
+ The most excellent
+Live DOM Viewer
+can be used to explore this matter in more detail.
+
+
+ {{Document}}, {{DocumentType}}, {{DocumentFragment}}, {{Element}}, {{Text}},
+{{ProcessingInstruction}}, and {{Comment}} objects (simply called
+nodes) participate in a tree, simply named the
+node tree.
+
+ A node tree is constrained as follows, expressed as a relationship between the type of
+node and its allowed children:
+
+ In tree order:
+ Zero or more nodes each of which is {{ProcessingInstruction}} or {{Comment}}.
+ Optionally one {{DocumentType}} node.
+ Zero or more nodes each of which is {{ProcessingInstruction}} or {{Comment}}.
+ Optionally one {{Element}} node.
+ Zero or more nodes each of which is {{ProcessingInstruction}} or {{Comment}}.
+ Zero or more nodes each of which is {{Element}}, {{Text}}, {{ProcessingInstruction}}, or
+ {{Comment}}.
+ None.
+ To determine the length of a node
+node, switch on node:
+
+ Zero.
+
+ Its number of children.
+ A node is considered empty if its
+length is zero.
+
+
+ A document tree is a node tree whose
+root is a document.
+
+ The document element of a document is the element whose
+parent is that document, if it exists; otherwise null.
+
+ Per the node tree constraints, there can be only one such
+element.
+
+ An element is in a document tree if its root is a
+document.
+
+ An element is in a document if it is in a document tree.
+The term in a document is no longer supposed to be used. It indicates that
+the standard using it has not been updated to account for shadow trees.
+
+
+ A shadow tree is a node tree whose
+root is a shadow root.
+
+ A shadow root is always attached to another node tree through its
+host. A shadow tree is therefore never alone. The
+node tree of a shadow root's host is sometimes
+referred to as the light tree. A shadow tree's corresponding light tree can be a shadow tree
+itself. An element is connected if its
+shadow-including root is a document.
+
+ A shadow tree contains zero or more elements that are
+slots. A slot can only be created through HTML's <{slot}> element. A slot has an associated name (a string). Unless stated
+otherwise it is the empty string. Use these attribute change steps to update a slot's name:
+
+ If element is a slot, localName is If value is oldValue, then return.
+
+ If value is null and oldValue is the empty string, then return.
+
+ If value is the empty string and oldValue is null, then return.
+
+ If value is null or the empty string, then set element's
+ name to the empty string.
+
+ Otherwise, set element's name to value.
+
+ Run assign slottables for a tree with element's root.
+ The first slot in a shadow tree, in tree order, whose
+name is the empty string, is sometimes known as the "default slot". A slot has an associated assigned nodes (a list of
+slottables). Unless stated otherwise it is empty. {{Element}} and {{Text}} nodes are
+slottables. A slot can be a slottable.
+
+ A slottable has an associated name (a
+string). Unless stated otherwise it is the empty string. Use these attribute change steps to update a slottable's name:
+
+ If localName is If value is oldValue, then return.
+
+ If value is null and oldValue is the empty string, then return.
+
+ If value is the empty string and oldValue is null, then return.
+
+ If value is null or the empty string, then set element's
+ name to the empty string.
+
+ Otherwise, set element's name to value.
+
+ If element is assigned, then run assign slottables
+ for element's assigned slot.
+
+ Run assign a slot for element.
+ A slottable has an associated
+assigned slot (null or a slot).
+Unless stated otherwise it is null. A slottable is
+assigned if its assigned slot is
+non-null. A slottable has an associated manual slot assignment (null
+or a slot). Unless stated otherwise, it is null.
+
+ A slottable's manual slot assignment can be implemented using a weak
+reference to the slot, because this variable is not directly accessible from script.
+
+ To find a slot for a given slottable
+slottable and an optional open flag (unset unless stated otherwise), run these
+steps: If slottable's parent is null, then return null. Let shadow be slottable's parent's
+ shadow root. If shadow is null, then return null. If the open flag is set and shadow's mode is
+ not " If shadow's slot assignment is " Return the first slot in tree order in shadow's
+ descendants whose name is slottable's
+ name, if any; otherwise null.
+ To find slottables
+for a given slot slot, run these steps: Let result be an empty list. Let root be slot's root.
+
+ If root is not a shadow root, then return result.
+
+ Let host be root's host.
+
+ If root's slot assignment is " Let result be « ».
+
+ For each slottable slottable of slot's
+ manually assigned nodes, if slottable's parent is
+ host, append slottable to result.
+ Otherwise, for each slottable child slottable of
+ host, in tree order:
+
+ Let foundSlot be the result of finding a slot given
+ slottable.
+
+ If foundSlot is slot, then append
+ slottable to result.
+ Return result. To
+find flattened slottables
+for a given slot slot, run these steps: Let result be an empty list. If slot's root is not a shadow root, then return
+ result. Let slottables be the result of finding slottables given
+ slot. If slottables is the empty list, then append each slottable
+ child of slot, in tree order, to slottables. For each node in slottables:
+
+ If node is a slot whose root is a shadow root,
+ then:
+
+ Let temporaryResult be the result of finding flattened slottables given
+ node. Append each slottable in temporaryResult, in order, to
+ result. Otherwise, append node to result. Return result. To assign slottables for a slot slot,
+run these steps:
+
+ Let slottables be the result of finding slottables for slot.
+
+ If slottables and slot's assigned nodes are not
+ identical, then run signal a slot change for slot.
+
+ Set slot's assigned nodes to slottables.
+
+ For each slottable in slottables, set slottable's
+ assigned slot to slot.
+ To assign slottables for a tree, given a
+node root, run assign slottables for each slot slot
+in root's inclusive descendants, in tree order.
+
+ To assign a slot, given a slottable slottable, run these
+steps:
+
+ Let slot be the result of finding a slot with slottable.
+
+ If slot is non-null, then run assign slottables for slot.
+ Each similar-origin window agent has signal slots
+(a set of slots), which is initially empty. [[!HTML]]
+
+ To signal a slot change, for a slot slot, run these steps:
+
+ Append slot to slot's relevant agent's
+ signal slots.
+
+ To
+ensure pre-insertion validity
+of a node into a parent before a child, run these steps:
+
+ If parent is not a {{Document}}, {{DocumentFragment}}, or {{Element}}
+ node, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If node is a host-including inclusive ancestor of parent, then
+ throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If child is non-null and its parent is not parent,
+ then throw a "{{NotFoundError!!exception}}" {{DOMException}}.
+
+ If node is not a {{DocumentFragment}}, {{DocumentType}}, {{Element}}, {{Text}},
+ {{ProcessingInstruction}}, or {{Comment}} node, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If either node is a {{Text}} node and parent is a
+ document, or node is a doctype and parent is not a
+ document, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If parent is a document, and any of the statements below, switched on
+ node, are true, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If node has more than one element child or has a
+ {{Text}} node child.
+
+ Otherwise, if node has one element child and either
+ parent has an element child, child is a
+ doctype, or child is non-null and a doctype is following
+ child.
+
+
+ parent has an element child, child is
+ a doctype, or child is non-null and a doctype is following
+ child.
+
+
+ parent has a doctype child, child is non-null
+ and an element is preceding child, or child is null
+ and parent has an element child.
+ To pre-insert a node into a
+parent before a child, run these steps:
+
+ Ensure pre-insertion validity of node into parent before
+ child.
+
+ Let referenceChild be child.
+
+ If referenceChild is node, then set referenceChild to
+ node's next sibling.
+
+ Insert node into parent before referenceChild.
+
+ Return node.
+
+ Specifications may define
+insertion steps for all or some nodes. The
+algorithm is passed insertedNode, as indicated in the insert
+algorithm below.
+
+
+ Specifications may define
+children changed steps for all or some
+nodes. The algorithm is passed no argument and is called from insert,
+remove, and replace data.
+
+ To insert a node into a parent
+before a child, with an optional suppress observers flag, run these steps:
+
+ Let nodes be node's children, if node is a
+ {{DocumentFragment}} node; otherwise « node ».
+
+ Let count be nodes's size.
+
+ If count is 0, then return.
+
+ If node is a {{DocumentFragment}} node, then:
+
+ Remove its children with the suppress observers flag set.
+
+ Queue a tree mutation record for node with « », nodes, null, and
+ null.
+
+ This step intentionally does not pay attention to the
+ suppress observers flag.
+ If child is non-null, then:
+
+ For each live range whose start node is parent and
+ start offset is greater than child's index, increase
+ its start offset by count.
+
+ For each live range whose end node is parent and
+ end offset is greater than child's index, increase
+ its end offset by count.
+ Let previousSibling be child's previous sibling or
+ parent's last child if child is null.
+
+ For each node in nodes, in tree order:
+
+ Adopt node into parent's node document.
+
+ If child is null, then append node to
+ parent's children.
+
+ Otherwise, insert node into parent's
+ children before child's index.
+
+ If parent is a shadow host whose shadow root's
+ slot assignment is " If parent's root is a shadow root, and
+ parent is a slot whose assigned nodes is the empty list,
+ then run signal a slot change for parent.
+
+ Run assign slottables for a tree with node's root.
+
+ For each shadow-including inclusive descendant inclusiveDescendant of
+ node, in shadow-including tree order:
+
+ Run the insertion steps with inclusiveDescendant.
+
+ If inclusiveDescendant is connected, then:
+
+ If inclusiveDescendant is custom, then
+ enqueue a custom element callback reaction with inclusiveDescendant,
+ callback name " Otherwise, try to upgrade
+ inclusiveDescendant.
+
+ If this successfully upgrades inclusiveDescendant, its
+ If suppress observers flag is unset, then queue a tree mutation record for
+ parent with nodes, « », previousSibling, and child.
+
+ Run the children changed steps for parent.
+ To append a node to a parent,
+pre-insert node into parent before null.
+
+
+ To replace a child with node
+within a parent, run these steps:
+
+
+
+ If parent is not a {{Document}}, {{DocumentFragment}}, or {{Element}}
+ node, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If node is a host-including inclusive ancestor of parent, then
+ throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If child's parent is not parent, then throw a
+ "{{NotFoundError!!exception}}" {{DOMException}}.
+
+ If node is not a {{DocumentFragment}}, {{DocumentType}}, {{Element}}, {{Text}},
+ {{ProcessingInstruction}}, or {{Comment}} node, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If either node is a {{Text}} node and parent is a
+ document, or node is a doctype and parent is not a
+ document, then throw a "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If parent is a document, and any of the statements below, switched on
+ node, are true, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If node has more than one element child or has a
+ {{Text}} node child.
+
+ Otherwise, if node has one element child and either
+ parent has an element child that is not
+ child or a doctype is following child.
+
+ parent has an element child that is not
+ child or a doctype is following child.
+
+ parent has a doctype child that is not child,
+ or an element is preceding child.
+ The above statements differ from the pre-insert algorithm.
+
+ Let referenceChild be child's next sibling.
+
+ If referenceChild is node, then set referenceChild to
+ node's next sibling.
+
+ Let previousSibling be child's previous sibling.
+
+ Let removedNodes be the empty set.
+
+ If child's parent is non-null, then:
+
+ Set removedNodes to « child ».
+
+ Remove child with the suppress observers flag set.
+ The above can only be false if child is node.
+
+ Let nodes be node's children if node is a
+ {{DocumentFragment}} node; otherwise « node ».
+
+
+ Insert node into parent before referenceChild
+ with the suppress observers flag set.
+
+ Queue a tree mutation record for parent with nodes,
+ removedNodes, previousSibling, and referenceChild.
+
+ Return child.
+ To replace all with a node
+within a parent, run these steps:
+
+ Let removedNodes be parent's children.
+
+ Let addedNodes be the empty set.
+
+ If node is a {{DocumentFragment}} node, then set addedNodes to
+ node's children.
+
+ Otherwise, if node is non-null, set addedNodes to « node ».
+
+ Remove all parent's children, in tree order, with the
+ suppress observers flag set.
+
+ If node is non-null, then insert node into
+ parent before null with the suppress observers flag set.
+
+ If either addedNodes or removedNodes is not empty,
+ then queue a tree mutation record for parent with addedNodes,
+ removedNodes, null, and null.
+ This algorithm does not make any checks with regards to the
+node tree constraints. Specification authors need to use it wisely.
+
+
+ To pre-remove a child from a
+parent, run these steps:
+
+ If child's parent is not parent, then throw a
+ "{{NotFoundError!!exception}}" {{DOMException}}.
+
+ Remove child.
+
+ Return child.
+
+ Specifications may define
+removing steps for all or some nodes. The
+algorithm is passed removedNode, and optionally oldParent, as
+indicated in the remove algorithm below.
+
+ To remove a node, with an optional
+suppress observers flag, run these steps:
+
+ Let parent be node's parent
+
+ Assert: parent is non-null.
+
+ Let index be node's index.
+
+ For each live range whose start node is an
+ inclusive descendant of node, set its start to
+ (parent, index).
+
+ For each live range whose end node is an inclusive descendant
+ of node, set its end to (parent, index).
+
+ For each live range whose start node is parent and
+ start offset is greater than index, decrease its
+ start offset by 1.
+
+ For each live range whose end node is parent and
+ end offset is greater than index, decrease its
+ end offset by 1.
+
+ For each {{NodeIterator}} object iterator whose
+ root's node document is node's
+ node document, run the Let oldPreviousSibling be node's previous sibling.
+
+ Let oldNextSibling be node's next sibling.
+
+ If node is assigned, then run assign slottables for
+ node's assigned slot.
+
+ If parent's root is a shadow root, and
+ parent is a slot whose assigned nodes is the empty list,
+ then run signal a slot change for parent.
+
+ If node has an inclusive descendant that is a slot, then:
+
+ Run assign slottables for a tree with parent's root.
+
+ Run assign slottables for a tree with node.
+ Run the removing steps with node and parent.
+
+ Let isParentConnected be parent's connected.
+
+ If node is custom and isParentConnected is true, then
+ enqueue a custom element callback reaction with node, callback name
+ " It is intentional for now that custom elements do
+ not get parent passed. This might change in the future if there is a need.
+
+ For each shadow-including descendant descendant of node, in
+ shadow-including tree order, then:
+
+ Run the removing steps with descendant.
+
+ If descendant is custom and isParentConnected
+ is true, then enqueue a custom element callback reaction with descendant,
+ callback name " For each inclusive ancestor inclusiveAncestor of
+ parent, and then for each registered of
+ inclusiveAncestor's registered observer list, if registered's
+ options["{{MutationObserverInit/subtree}}"] is true, then
+ append a new transient registered observer whose
+ observer is registered's
+ observer, options is
+ registered's options, and
+ source is registered to node's
+ registered observer list.
+
+ If suppress observers flag is unset, then queue a tree mutation record for
+ parent with « », « node », oldPreviousSibling, and
+ oldNextSibling.
+
+ Run the children changed steps for parent.
+ Web compatibility prevents the {{NonElementParentNode/getElementById()}}
+method from being exposed on elements (and therefore on {{ParentNode}}).
+
+ Returns the first element within node's descendants whose
+ ID is elementId.
+ The The {{DocumentOrShadowRoot}} mixin is expected to be used by other
+standards that want to define APIs shared between documents and
+shadow roots.
+
+
+ To convert nodes into a node, given
+nodes and document, run these steps:
+
+ Let node be null.
+
+ Replace each string in nodes with a new {{Text}} node whose
+ data is the string and node document is
+ document.
+
+ Otherwise, set node to a new {{DocumentFragment}} whose
+ node document is document, and then append each node in
+ nodes, if any, to it.
+
+ Return node.
+ Inserts nodes before the first child of node, while
+ replacing strings in nodes with equivalent {{Text}} nodes.
+
+ Throws a "{{HierarchyRequestError!!exception}}" {{DOMException}} if the constraints of
+ the node tree are violated.
+
+
+ Inserts nodes after the last child of node, while replacing
+ strings in nodes with equivalent {{Text}} nodes.
+
+ Throws a "{{HierarchyRequestError!!exception}}" {{DOMException}} if the constraints of
+ the node tree are violated.
+
+
+ Replace all children of node with nodes,
+ while replacing strings in nodes with equivalent {{Text}} nodes.
+
+ Throws a "{{HierarchyRequestError!!exception}}" {{DOMException}} if the constraints of
+ the node tree are violated.
+
+
+ The The The The The Let node be the result of converting nodes into a node given
+ nodes and this's node document.
+
+ Pre-insert node into this before this's
+ first child.
+ The Let node be the result of converting nodes into a node given
+ nodes and this's node document.
+
+ The Let node be the result of converting nodes into a node given
+ nodes and this's node document.
+
+ Ensure pre-insertion validity of node into this before
+ null.
+
+ Replace all with node within this.
+ The The Web compatibility prevents the {{previousElementSibling}} and
+{{nextElementSibling}} attributes from being exposed on doctypes (and therefore on
+{{ChildNode}}).
+
+ The The Inserts nodes just before node, while replacing strings in
+ nodes with equivalent {{Text}} nodes.
+
+ Throws a "{{HierarchyRequestError!!exception}}" {{DOMException}} if the constraints of
+ the node tree are violated.
+
+ Inserts nodes just after node, while replacing strings in
+ nodes with equivalent {{Text}} nodes.
+
+ Throws a "{{HierarchyRequestError!!exception}}" {{DOMException}} if the constraints of
+ the node tree are violated.
+
+ Replaces node with nodes, while replacing strings in nodes
+ with equivalent {{Text}} nodes.
+
+ Throws a "{{HierarchyRequestError!!exception}}" {{DOMException}} if the constraints of
+ the node tree are violated.
+
+ The If parent is null, then return.
+
+ Let viablePreviousSibling be this's first preceding
+ sibling not in nodes; otherwise null.
+
+ Let node be the result of converting nodes into a node, given
+ nodes and this's node document.
+
+ If viablePreviousSibling is null, then set it to parent's
+ first child; otherwise to viablePreviousSibling's
+ next sibling.
+
+ Pre-insert node into parent before
+ viablePreviousSibling.
+ The If parent is null, then return.
+
+ Let viableNextSibling be this's first following
+ sibling not in nodes; otherwise null.
+
+ Let node be the result of converting nodes into a node, given
+ nodes and this's node document.
+
+ Pre-insert node into parent before
+ viableNextSibling.
+ The If parent is null, then return.
+
+ Let viableNextSibling be this's first following
+ sibling not in nodes; otherwise null.
+
+ Let node be the result of converting nodes into a node, given
+ nodes and this's node document.
+
+ If this's parent is parent, replace this with
+ node within parent.
+
+ This could have been inserted into node.
+
+ Otherwise, pre-insert node into parent before
+ viableNextSibling.
+ The The A {{NodeList}} object is a collection of nodes.
+
+ The object's supported property indices are the numbers in the range zero to one less than
+the number of nodes represented by the collection. If there are no such
+elements, then there are no supported property indices.
+
+ The length attribute must return the number of nodes
+represented by the collection.
+
+ The An {{HTMLCollection}} object is a collection of elements.
+
+ {{HTMLCollection}} is a historical artifact we cannot rid the web of.
+While developers are of course welcome to keep using it, new API standard designers ought not to use
+it (use The object's supported property indices are the numbers in the range zero to one less than
+the number of elements represented by the collection. If there are no such
+elements, then there are no supported property indices.
+
+ The The The supported property names are the values from the list returned by these steps:
+
+ Let result be an empty list.
+
+ For each element represented by the collection, in
+ tree order:
+
+ If element has an ID which is not in result,
+ append element's ID to result.
+
+ If element is in the HTML namespace and has
+ a Return result.
+ The If key is the empty string, return null.
+
+ Return the first element in the collection for which at least one of
+ the following is true:
+
+ or null if there is no such element.
+ Each similar-origin window agent has a
+mutation observer microtask queued
+(a boolean), which is initially false. [[!HTML]]
+
+ Each similar-origin window agent also has
+mutation observers (a set of zero or more
+{{MutationObserver}} objects), which is initially empty.
+
+ To
+queue a mutation observer microtask,
+run these steps:
+
+ If the surrounding agent's mutation observer microtask queued is true, then
+ return.
+
+ Set the surrounding agent's mutation observer microtask queued to true.
+
+ Queue a microtask to notify mutation observers.
+ To notify mutation observers, run these steps:
+
+ Set the surrounding agent's mutation observer microtask queued to false.
+
+ Let notifySet be a clone of the surrounding agent's
+ mutation observers.
+
+ Let signalSet be a clone of the surrounding agent's
+ signal slots.
+
+ Empty the surrounding agent's signal slots.
+
+ For each mo of notifySet:
+
+ Let records be a clone of mo's
+ record queue.
+
+ Empty mo's record queue.
+
+ For each node of mo's
+ node list, remove all
+ transient registered observers whose observer is
+ mo from node's registered observer list.
+
+ If records is not empty, then invoke
+ mo's callback with « records, mo »,
+ and mo. If this throws an exception, catch it, and report the exception.
+ For each slot of signalSet, fire an event
+ named {{HTMLSlotElement/slotchange}}, with its {{Event/bubbles}} attribute set to true, at
+ slot.
+ Each node has a registered observer list (a list of
+zero or more registered observers), which is initially empty.
+
+ A registered observer consists of an
+observer (a {{MutationObserver}} object) and
+options (a {{MutationObserverInit}} dictionary).
+
+ A transient registered observer is a
+registered observer that also consists of a
+source (a registered observer).
+
+ Transient registered observers are used to track mutations within
+a given node's descendants after node has been removed so
+they do not get lost when {{MutationObserverInit/subtree}} is set to true on node's
+parent.
+
+
+ A {{MutationObserver}} object can be used to observe mutations to the tree of
+nodes.
+
+ Each {{MutationObserver}} object has these associated concepts:
+
+ The
+ Append this to this's relevant agent's
+ mutation observers.
+ The
+ If either options["{{MutationObserverInit/attributeOldValue}}"] or
+ options["{{MutationObserverInit/attributeFilter}}"] exists, and
+ options["{{MutationObserverInit/attributes}}"] does not exist, then set
+ options["{{MutationObserverInit/attributes}}"] to true.
+
+ If options["{{MutationObserverInit/characterDataOldValue}}"]
+ exists and options["{{MutationObserverInit/characterData}}"] does not
+ exist, then set options["{{MutationObserverInit/characterData}}"] to
+ true.
+
+ If none of options["{{MutationObserverInit/childList}}"],
+ options["{{MutationObserverInit/attributes}}"], and
+ options["{{MutationObserverInit/characterData}}"] is true, then throw a
+ If options["{{MutationObserverInit/attributeOldValue}}"] is true and
+ options["{{MutationObserverInit/attributes}}"] is false, then throw a
+ If options["{{MutationObserverInit/attributeFilter}}"] is present and
+ options["{{MutationObserverInit/attributes}}"] is false, then throw a
+ If options["{{MutationObserverInit/characterDataOldValue}}"] is true and
+ options["{{MutationObserverInit/characterData}}"] is false, then throw a
+ For each registered of target's
+ registered observer list, if registered's
+ observer is this:
+
+ For each node of this's
+ node list, remove all
+ transient registered observers whose source is
+ registered from node's registered observer list.
+
+ Set registered's options to
+ options.
+ Otherwise:
+
+ Append a new registered observer whose
+ observer is this and
+ options is options to target's
+ registered observer list.
+
+ The For each node of this's
+ node list, remove any registered observer from
+ node's registered observer list for which this is the
+ observer.
+
+ Empty this's record queue.
+ The Let records be a clone of this's
+ record queue.
+
+ Empty this's record queue.
+
+ Return records.
+ To queue a mutation record of type for target with
+name, namespace, oldValue, addedNodes,
+removedNodes, previousSibling, and nextSibling, run these steps:
+
+ Let interestedObservers be an empty map.
+
+ Let nodes be the inclusive ancestors of target.
+
+ For each node in nodes, and then for each
+ registered of node's registered observer list:
+
+ Let options be registered's
+ options.
+
+ If none of the following are true
+
+ then:
+
+ Let mo be registered's observer.
+
+ If interestedObservers[mo] does not exist, then
+ set interestedObservers[mo] to null.
+
+ If either type is " For each observer → mappedOldValue of
+ interestedObservers:
+
+ Let record be a new {{MutationRecord}} object with its {{MutationRecord/type}}
+ set to type, {{MutationRecord/target}} set to target,
+ {{MutationRecord/attributeName}} set to name, {{MutationRecord/attributeNamespace}}
+ set to namespace, {{MutationRecord/oldValue}} set to mappedOldValue,
+ {{MutationRecord/addedNodes}} set to addedNodes,
+ {{MutationRecord/removedNodes}} set to removedNodes,
+ {{MutationRecord/previousSibling}} set to previousSibling, and
+ {{MutationRecord/nextSibling}} set to nextSibling.
+
+ Enqueue record to observer's
+ record queue.
+ To queue a tree mutation record for target with
+addedNodes, removedNodes, previousSibling, and
+nextSibling, run these steps:
+
+ Assert: either addedNodes or removedNodes is not empty.
+
+ Queue a mutation record of " The type, target,
+addedNodes,
+removedNodes,
+previousSibling,
+nextSibling,
+attributeName,
+attributeNamespace, and
+oldValue attributes must return the values they were
+initialized to.
+
+
+ Nodes have a strong reference to registered observers in their
+registered observer list.
+
+ Registered observers in a node's registered observer list have a weak
+reference to the node.
+
+
+ {{Node}} is an abstract interface and does not exist as node. It
+is used by all nodes ({{Document}}, {{DocumentType}}, {{DocumentFragment}}, {{Element}},
+{{Text}}, {{ProcessingInstruction}}, and {{Comment}}).
+
+ Each node has an associated
+node document, set upon creation, that is a
+document.
+
+ A node's node document can be changed by the
+adopt algorithm.
+
+ A node's get the parent algorithm, given an event, returns the
+node's assigned slot, if node is assigned; otherwise node's
+parent.
+
+ Each node also has a registered observer list.
+
+ The nodeType getter steps are to return the first matching
+statement, switching on this:
+
+ The nodeName getter steps are to return the
+first matching statement, switching on this:
+
+ The Returns true if node is connected; otherwise false.
+
+ The The The node document of a document is that document itself.
+All nodes have a node document at all times.
+
+ The The An {{Attr}} node has no parent.
+
+ The The The The The The An {{Attr}} node has no siblings.
+
+ The Set an existing attribute value with this and new value.
+
+ Replace data with node this, offset 0, count this's
+ length, and data new value.
+
+ Do nothing.
+ The To string replace all with a string string within a
+node parent, run these steps:
+
+ Let node be null.
+
+ If string is not the empty string, then set node to a new {{Text}}
+ node whose data is string and
+ node document is parent's node document.
+
+ Replace all with node within parent.
+ The {{Node/textContent}} setter steps are to, if the given value is null, act as if it was the
+empty string instead, and then do as described below, switching on this:
+
+ String replace all with the given value within this.
+
+ Set an existing attribute value with this and new value.
+
+ Replace data with node this, offset 0, count this's
+ length, and data the given value.
+
+ Do nothing.
+ The While currentNode is an exclusive For each live range whose start node is currentNode,
+ add length to its start offset and set its
+ start node to node.
+
+ For each live range whose end node is currentNode, add
+ length to its end offset and set its end node to
+ node.
+
+ For each live range whose start node is currentNode's
+ parent and start offset is currentNode's
+ index, set its start node to node and its
+ start offset to length.
+
+ For each live range whose end node is currentNode's
+ parent and end offset is currentNode's
+ index, set its end node to node and its
+ end offset to length.
+
+ Add currentNode's length to length.
+
+ Set currentNode to its next sibling.
+ HTML defines cloning steps for <{script}> and <{input}>
+elements. SVG ought to do the same for its <{script}> elements, but does not call this out
+at the moment.
+
+ To clone a
+node, with an optional document and clone children flag, run these
+steps:
+
+
+ If document is not given, let document be node's
+ node document.
+
+ If node is an element, then:
+
+ Let copy be the result of creating an element, given
+ document, node's local name, node's
+ namespace, node's namespace prefix, and
+ node's For each attribute in node's
+ attribute list:
+
+ Otherwise, let copy be a node that implements the same interfaces as
+ node, and fulfills these additional requirements, switching on
+ node:
+
+ Set copy's encoding, content type,
+ URL, origin, type, and
+ mode, to those of node.
+
+ Set copy's name, public ID, and
+ system ID, to those of node.
+
+ Set copy's namespace, namespace prefix,
+ local name, and value, to those of node.
+
+ Set copy's node document and document to
+ copy, if copy is a document, and set copy's
+ node document to document otherwise.
+
+ The If this is a shadow root, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ Return a clone of this, with the
+ clone children flag set if deep is true.
+ The The These are the constants {{compareDocumentPosition()}} returns as mask:
+
+ The If this is other, then return zero.
+
+ Let node1 be other and node2 be this.
+
+ Let attr1 and attr2 be null.
+
+ If node1 is an attribute, then set attr1 to node1
+ and node1 to attr1's element.
+
+ If node2 is an attribute, then:
+
+ Set attr2 to node2 and node2 to attr2's
+ element.
+
+ If attr1 and node1 are non-null, and node2 is
+ node1, then:
+
+ For each attr in node2's
+ attribute list:
+
+ If attr equals attr1, then return the result of
+ adding {{Node/DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC}} and
+ {{Node/DOCUMENT_POSITION_PRECEDING}}.
+
+ If attr equals attr2, then return the result of
+ adding {{Node/DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC}} and
+ {{Node/DOCUMENT_POSITION_FOLLOWING}}.
+ If node1 or node2 is null, or node1's root is
+ not node2's root, then return the result of adding
+ {{Node/DOCUMENT_POSITION_DISCONNECTED}}, {{Node/DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC}}, and
+ either {{Node/DOCUMENT_POSITION_PRECEDING}} or {{Node/DOCUMENT_POSITION_FOLLOWING}}, with the
+ constraint that this is to be consistent, together.
+
+ Whether to return {{Node/DOCUMENT_POSITION_PRECEDING}} or
+ {{Node/DOCUMENT_POSITION_FOLLOWING}} is typically implemented via pointer comparison. In
+ JavaScript implementations a cached If node1 is an ancestor of node2 and attr1 is null,
+ or node1 is node2 and attr2 is non-null, then return the result of
+ adding {{Node/DOCUMENT_POSITION_CONTAINS}} to {{Node/DOCUMENT_POSITION_PRECEDING}}.
+
+ If node1 is a descendant of node2 and attr2 is null,
+ or node1 is node2 and attr1 is non-null, then return the result of
+ adding {{Node/DOCUMENT_POSITION_CONTAINED_BY}} to {{Node/DOCUMENT_POSITION_FOLLOWING}}.
+
+ If node1 is preceding node2, then return
+ {{Node/DOCUMENT_POSITION_PRECEDING}}.
+
+ Due to the way attributes are handled in this algorithm this results in a
+ node's attributes counting as preceding that node's children,
+ despite attributes not participating in a tree.
+
+ Return {{Node/DOCUMENT_POSITION_FOLLOWING}}.
+ The To
+locate a namespace prefix
+for an element using namespace, run these steps:
+
+ If element's namespace is namespace and its
+ namespace prefix is non-null, then return its
+ namespace prefix.
+
+ If element has an attribute whose
+ namespace prefix is " If element's parent element is not null, then return the result of running
+ locate a namespace prefix on that element using namespace.
+
+ Return null.
+ To locate a namespace for a node using prefix, switch on
+node:
+
+ If its namespace is non-null and its
+ namespace prefix is prefix, then return
+ namespace.
+
+ If it has an attribute whose namespace
+ is the XMLNS namespace, namespace prefix is " If its parent element is null, then return null.
+
+ Return the result of running locate a namespace on its parent element using
+ prefix.
+ If its document element is null, then return null.
+
+ Return the result of running locate a namespace on its document element
+ using prefix.
+ Return null.
+
+ If its element is null, then return null.
+
+ Return the result of running locate a namespace on its element
+ using prefix.
+ If its parent element is null, then return null.
+
+ Return the result of running locate a namespace on its parent element using
+ prefix.
+ The If namespace is null or the empty string, then return null.
+
+ Switch on this:
+
+ Return the result of locating a namespace prefix for it using namespace.
+
+ Return the result of locating a namespace prefix for its document element,
+ if its document element is non-null; otherwise null.
+
+ Return null.
+
+ Return the result of locating a namespace prefix for its element,
+ if its element is non-null; otherwise null.
+
+ Return the result of locating a namespace prefix for its parent element, if
+ its parent element is non-null; otherwise null.
+ The If prefix is the empty string, then set it to null.
+
+ Return the result of running locate a namespace for this using
+ prefix.
+ The If namespace is the empty string, then set it to null.
+
+ Let defaultNamespace be the result of running locate a namespace for
+ this using null.
+
+ Return true if defaultNamespace is the same as namespace; otherwise
+ false.
+ The The The The The
+list of elements with qualified name qualifiedName
+for a node root is the {{HTMLCollection}} returned by the following algorithm:
+
+ If qualifiedName is " Otherwise, if root's node document is an HTML document,
+ return a {{HTMLCollection}} rooted at root, whose filter matches the following
+ descendant elements:
+
+ Whose namespace is the HTML namespace and whose
+ qualified name is qualifiedName, in ASCII lowercase.
+
+ Whose namespace is not the HTML namespace and whose
+ qualified name is qualifiedName.
+ Otherwise, return a {{HTMLCollection}} rooted at root, whose filter matches
+ descendant elements whose qualified name is
+ qualifiedName.
+ When invoked with the same argument, and as long as root's
+node document's type has not changed, the same
+{{HTMLCollection}} object may be returned as returned by an earlier call.
+
+The
+list of elements with namespace
+namespace and local name localName
+for a node root is the
+{{HTMLCollection}} returned by the following algorithm:
+
+ Return a {{HTMLCollection}} rooted at root,
+ whose filter matches descendant
+ elements that have all their
+ classes in classes.
+
+ The comparisons for the classes must be done in an
+ ASCII case-insensitive manner if root's node document's
+ mode is " {{Document}} nodes are simply
+known as documents.
+
+ Each document has an associated
+encoding (an encoding),
+content type (a string),
+URL (a URL),
+origin (an origin),
+type (" Unless stated otherwise, a document's encoding is the utf-8
+encoding, content type is
+" A document is said to be an XML document if its type
+is " A document is said to be in
+no-quirks mode if its
+mode is " The mode is only ever changed from the default for documents created
+ by the HTML parser based on the presence, absence, or value of the DOCTYPE string, and by a
+ new browsing context (initial " No-quirks mode was originally known as "standards mode" and limited-quirks mode
+ was once known as "almost standards mode". They have been renamed because their details are now
+ defined by standards. (And because Ian Hickson vetoed their original names on the basis that they
+ are nonsensical.)
+ A document's get the parent algorithm, given an event, returns
+null if event's {{Event/type}} attribute value is " The Unlike {{DOMImplementation/createDocument()}}, this constructor does not
+return an {{XMLDocument}} object, but a document ({{Document}} object).
+
+ The
+ The The The The If qualifiedName is " Otherwise, returns a {{HTMLCollection}} of all descendant elements whose
+ qualified name is qualifiedName. (Matches case-insensitively against
+ elements in the HTML namespace within an HTML document.)
+
+ The The The Thus, in an HTML document,
+ The
+ The Returns an element with localName as local name
+ (if document is an HTML document, localName gets lowercased). The
+ element's namespace is the HTML namespace when
+ document is an HTML document or document's
+ content type is " If localName does not match the When supplied, options's {{ElementCreationOptions/is}} can be used to create a
+ customized built-in element.
+
+ Returns an element with namespace namespace. Its
+ namespace prefix will be everything before " If qualifiedName does not match the If one of the following conditions is true a "{{NamespaceError!!exception}}" {{DOMException}}
+ will be thrown:
+
+ When supplied, options's {{ElementCreationOptions/is}} can be used to create a
+ customized built-in element.
+
+ The element interface for any name and
+namespace is {{Element}}, unless stated otherwise.
+
+ The HTML Standard will, e.g., define that for The
+ If localName does not match the If this is an HTML document, then set localName to
+ localName in ASCII lowercase.
+
+ Let is be null.
+
+ If options is a dictionary and
+ options["{{ElementCreationOptions/is}}"] exists, then set is
+ to it.
+
+ Let namespace be the HTML namespace, if this is an
+ HTML document or this's content type is
+ " Return the result of creating an element given this, localName,
+ namespace, null, is, and with the synchronous custom elements flag
+ set.
+ The internal Let namespace, prefix, and localName be the result of
+ passing namespace and qualifiedName to validate and extract.
+
+ Let is be null.
+
+ If options is a dictionary and
+ options["{{ElementCreationOptions/is}}"] exists, then set is
+ to it.
+
+ Return the result of creating an element given document,
+ localName, namespace, prefix, is, and with the
+ synchronous custom elements flag set.
+ The
+ {{Document/createElement()}} and {{Document/createElementNS()}}'s options
+parameter is allowed to be a string for web compatibility.
+
+ The The No check is performed that data consists of
+characters that match the The If this is an HTML document, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If data contains the string " Return a new {{CDATASection}} node with its data set to
+ data and node document set to this.
+ The No check is performed that data consists of
+characters that match the The
+ No check is performed that target contains
+" The If node is a document or shadow root, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ Return a clone of node, with this and the
+ clone children flag set if deep is true.
+ Specifications may define
+adopting steps for all or some nodes. The
+algorithm is passed node and oldDocument, as indicated in the adopt
+algorithm.
+
+ To adopt a node into a document, run
+these steps:
+
+ Let oldDocument be node's node document.
+
+ If document is not oldDocument, then:
+
+ For each inclusiveDescendant in node's
+ shadow-including inclusive descendants:
+
+ Set inclusiveDescendant's node document to document.
+
+ If inclusiveDescendant is an element, then set the
+ node document of each attribute in inclusiveDescendant's
+ attribute list to document.
+ For each inclusiveDescendant in node's
+ shadow-including inclusive descendants that is custom,
+ enqueue a custom element callback reaction with inclusiveDescendant, callback
+ name " For each inclusiveDescendant in node's
+ shadow-including inclusive descendants, in shadow-including tree order, run the
+ adopting steps with inclusiveDescendant and oldDocument.
+ The If node is a document, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If node is a shadow root, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ If node is a {{DocumentFragment}} node whose
+ host is non-null, then return.
+
+ Return node.
+ The If localName does not match the The
+ Let namespace, prefix, and localName be the result of
+ passing namespace and qualifiedName to validate and extract.
+
+ Return a new attribute whose namespace is namespace,
+ namespace prefix is prefix, local name is
+ localName, and node document is this.
+ The Let constructor be null.
+
+ If interface is an ASCII case-insensitive match for any of the strings in the
+ first column in the following table, then set constructor to the interface in the
+ second column on the same row as the matching string:
+
+ If constructor is null, then throw a "{{NotSupportedError!!exception}}"
+ {{DOMException}}.
+
+ If the interface indicated by constructor is not exposed on the
+ relevant global object of this, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ Typically user agents disable support for touch events in some configurations, in
+ which case this clause would be triggered for the interface {{TouchEvent}}.
+
+ Let event be the result of creating an event given constructor.
+
+ Initialize event's {{Event/type}} attribute to the empty string.
+
+ Initialize event's {{Event/timeStamp}} attribute to a {{DOMHighResTimeStamp}}
+ representing the high resolution time from the time origin to now.
+
+ Initialize event's {{Event/isTrusted}} attribute to false.
+
+ Unset event's initialized flag.
+
+ Return event.
+ Event constructors ought to be used instead.
+
+ The The {{Range/Range()}} constructor can be used instead.
+
+ The
+ Let iterator be a new {{NodeIterator}} object.
+
+ Set iterator's pointer before reference to true.
+
+ Set iterator's whatToShow to whatToShow.
+
+ Set iterator's filter to filter.
+
+ Return iterator.
+ The
+ Let walker be a new {{TreeWalker}} object.
+
+ Set walker's whatToShow to whatToShow.
+
+ Set walker's filter to filter.
+
+ The
+ Validate qualifiedName.
+
+ Return a new doctype, with qualifiedName as its
+ name, publicId as its public ID, and systemId
+ as its system ID, and with its node document set to the associated
+ document of this.
+ No check is performed that publicId code points match the
+ The
+ Let document be a new {{XMLDocument}}.
+
+ Let element be null.
+
+ If qualifiedName is not the empty string, then set element to the
+ result of running the internal If doctype is non-null, append doctype to document.
+
+ If element is non-null, append element to document.
+
+ document's origin is this's associated
+ document's origin.
+
+ document's content type is determined by namespace:
+
+ Return document.
+ The
+ Let doc be a new document that is an HTML document.
+
+ Set doc's content type to " Append a new doctype, with " Append the result of creating an element given doc, <{html}>, and
+ the HTML namespace, to doc.
+
+ Append the result of creating an element given doc, <{head}>, and
+ the HTML namespace, to the <{html}> element created earlier.
+
+ If title is given:
+
+ Append the result of creating an element given doc, <{title}>,
+ and the HTML namespace, to the <{head}> element created earlier.
+
+ Append a new {{Text}} node, with its data set to
+ title (which could be the empty string) and its node document set to
+ doc, to the <{title}> element created earlier.
+ Append the result of creating an element given doc, <{body}>, and
+ the HTML namespace, to the <{html}> element created earlier. Return doc.
+ The {{hasFeature()}} originally would report whether the user agent
+claimed to support a given DOM feature, but experience proved it was not nearly as
+reliable or granular as simply checking whether the desired objects, attributes, or
+methods existed. As such, it is no longer to be used, but continues to exist (and simply
+returns true) so that old pages don't stop working.
+
+ {{DocumentType}} nodes are simply known as
+doctypes.
+
+ Doctypes have an associated
+name,
+public ID, and
+system ID.
+
+ When a doctype is created, its name is always given. Unless
+explicitly given when a doctype is created, its public ID and system ID are the
+empty string.
+
+ The The The A {{DocumentFragment}} node has an associated
+host (null or an
+element in a different node tree). It is null unless otherwise stated.
+
+ An object A is a
+host-including inclusive ancestor
+of an object B, if either A is an inclusive ancestor of B,
+or if B's root has a non-null host and
+A is a host-including inclusive ancestor of B's root's
+host.
+
+ The {{DocumentFragment}} node's host
+concept is useful for HTML's <{template}> element and for shadow roots, and impacts the
+pre-insert and replace algorithms.
+
+ The
+ {{ShadowRoot}} nodes are simply known as
+shadow roots.
+
+ Shadow roots have an associated mode (" Shadow roots have an associated delegates focus.
+It is initially set to false. Shadow roots have an associated
+available to element internals. It is initially set to false. Shadow roots's associated host is never null. Shadow roots have an associated slot assignment
+(" A shadow root's get the parent algorithm, given an event, returns
+null if event's composed flag is unset and shadow root is the
+root of event's path's first struct's
+invocation target; otherwise shadow root's
+host.
+
+ The The The The The In shadow-including tree order is
+shadow-including preorder, depth-first traversal of a node tree.
+Shadow-including preorder, depth-first traversal of a node tree
+tree is preorder, depth-first traversal of tree, with for each
+shadow host encountered in tree,
+shadow-including preorder, depth-first traversal of that element's
+shadow root's node tree just after it is encountered.
+
+ The shadow-including root of an object is its
+root's host's shadow-including root, if the
+object's root is a shadow root; otherwise its root.
+
+ An object A is a
+shadow-including descendant of an object
+B, if A is a descendant of B, or A's
+root is a shadow root and A's root's
+host is a shadow-including inclusive descendant of B.
+
+ A
+shadow-including inclusive descendant
+is an object or one of its shadow-including descendants.
+
+ An object A is a
+shadow-including ancestor of an object
+B, if and only if B is a shadow-including descendant of A.
+
+ A
+shadow-including inclusive ancestor
+is an object or one of its shadow-including ancestors.
+
+ A node A is
+closed-shadow-hidden from a node
+B if all of the following conditions are true:
+
+ A's root is a shadow root.
+
+ A's root is not a shadow-including inclusive ancestor of
+ B.
+
+ A's root is a shadow root whose
+ mode is " To retarget an object A against an object
+B, repeat these steps until they return an object: If one of the following is true
+
+ then return A.
+
+ The retargeting algorithm is used by event dispatch as well
+as other specifications, such as Fullscreen. [[FULLSCREEN]]
+
+
+ {{Element}} nodes are simply known as
+elements.
+
+ Elements have an associated
+namespace,
+namespace prefix,
+local name,
+custom element state,
+custom element definition,
+ An element's custom element state is one of
+" Whether or not an element is defined is used to determine the
+behavior of the '':defined'' pseudo-class. Whether or not an element is custom is
+used to determine the behavior of the mutation algorithms. The
+" The following code illustrates elements in each of these four states: Elements also have an associated
+shadow root (null or a
+shadow root). It is null unless otherwise stated. An element is a
+shadow host if its shadow root is non-null.
+
+ An element's
+qualified name is its
+local name if its namespace prefix is null; otherwise its
+namespace prefix, followed by " An element's HTML-uppercased qualified name is the return
+value of these steps:
+
+ Let qualifiedName be this's qualified name.
+
+ If this is in the HTML namespace and its node document is an
+ HTML document, then set qualifiedName to qualifiedName in
+ ASCII uppercase.
+
+ User agents could optimize qualified name and
+HTML-uppercased qualified name by storing them in internal slots.
+
+ To
+create an element,
+given a document, localName, namespace, and optional
+prefix, is, and synchronous custom elements flag, run these steps:
+
+ If prefix was not given, let prefix be null.
+
+ If is was not given, let is be null.
+
+ Let result be null.
+
+ Let definition be the result of
+ looking up a custom element definition given
+ document, namespace, localName, and is.
+
+ If definition is non-null, and definition's
+ name is not equal to its
+ local name (i.e., definition represents a
+ customized built-in element), then:
+
+ Let interface be the element interface for localName and the
+ HTML namespace.
+
+ Set result to a new element that implements interface,
+ with no attributes, namespace set to the HTML namespace,
+ namespace prefix set to prefix, local name set
+ to localName, custom element state set to " If the synchronous custom elements flag is set, then run this step while
+ catching any exceptions:
+
+ Upgrade element using definition.
+ If this step threw an exception, then: Report the exception.
+
+ Set result's custom element state to
+ " Otherwise, enqueue a custom element upgrade reaction given result and
+ definition.
+ Otherwise, if definition is non-null, then:
+
+ If the synchronous custom elements flag is set, then run these steps while
+ catching any exceptions:
+
+ Let C be definition's
+ constructor.
+
+ Set result to the result of constructing C, with no
+ arguments.
+
+ Assert: result's custom element state and
+ custom element definition are initialized.
+
+ Assert: result's namespace is the HTML namespace.
+
+ IDL enforces that result is an {{HTMLElement}} object, which all use
+ the HTML namespace.
+
+ If result's attribute list is not empty,
+ then throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If result has children, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If result's parent is not null, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If result's node document is not document, then
+ throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If result's local name is not equal to
+ localName, then throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ Set result's namespace prefix to prefix.
+
+ Set result's If any of these steps threw an exception, then: Report the exception.
+
+ Set result to a new element that implements the
+ {{HTMLUnknownElement}} interface, with no attributes, namespace set to the
+ HTML namespace, namespace prefix set to prefix,
+ local name set to localName,
+ custom element state set to " Otherwise:
+
+ Set result to a new element that implements the {{HTMLElement}}
+ interface, with no attributes, namespace set to the HTML namespace,
+ namespace prefix set to prefix, local name set
+ to localName, custom element state set to
+ " Enqueue a custom element upgrade reaction given result and
+ definition.
+ Otherwise:
+
+ Let interface be the element interface for localName and
+ namespace.
+
+ Set result to a new element that implements interface,
+ with no attributes, namespace set to namespace,
+ namespace prefix set to prefix, local name set
+ to localName, custom element state set to
+ " If namespace is the HTML namespace, and either localName is a
+ valid custom element name or is is non-null, then set result's
+ custom element state to " Return result.
+ Elements also have an
+attribute list, which is a
+list exposed through a {{NamedNodeMap}}. Unless explicitly given when an
+element is created, its attribute list is empty.
+
+ An element
+has an attribute
+A if its attribute list contains A.
+
+ This and other specifications may define
+attribute change steps for
+elements. The algorithm is passed element, localName,
+oldValue, value, and namespace.
+
+ To handle attribute changes for an attribute attribute with
+element, oldValue, and newValue, run these steps:
+
+ Queue a mutation record of " If element is custom, then
+ enqueue a custom element callback reaction with element, callback name
+ " Run the attribute change steps with element, attribute's
+ local name, oldValue, newValue, and attribute's
+ namespace.
+ To change an
+attribute attribute to value, run these steps:
+
+ Handle attribute changes for attribute with attribute's
+ element, attribute's value, and value.
+
+ Set attribute's value to value.
+ To append an
+attribute attribute to an element element, run these
+steps:
+
+ Handle attribute changes for attribute with element, null, and
+ attribute's value.
+
+ Append attribute to element's
+ attribute list.
+
+ Set attribute's element to element.
+ To remove an
+attribute attribute, run these steps:
+
+ Handle attribute changes for attribute with attribute's
+ element, attribute's value, and null.
+
+ Set attribute's element to null.
+ To replace an
+attribute oldAttr with an attribute newAttr, run these steps:
+
+ Handle attribute changes for oldAttr with oldAttr's
+ element, oldAttr's value, and newAttr's
+ value.
+
+ Replace oldAttr by newAttr in oldAttr's
+ element's attribute list.
+
+ Set oldAttr's element to null.
+ To get an attribute by name given a
+qualifiedName and element element, run these steps:
+
+ If element is in the HTML namespace and its node document
+ is an HTML document, then set qualifiedName to qualifiedName in
+ ASCII lowercase.
+
+ Return the first attribute in element's attribute list
+ whose qualified name is qualifiedName; otherwise null.
+ To
+get an attribute by namespace and local name
+given a namespace, localName, and element element,
+run these steps:
+
+ If namespace is the empty string, then set it to null.
+
+ Return the attribute in element's attribute list whose
+ namespace is namespace and local name is
+ localName, if any; otherwise null.
+ To get an attribute value given an
+element element, localName, and optionally a namespace
+(null unless stated otherwise), run these steps: Let attr be the result of
+ getting an attribute given
+ namespace, localName, and element. If attr is null, then return the empty string. Return attr's value. To set an attribute given an
+attr and element, run these steps:
+
+ If attr's element is neither null nor element,
+ throw an "{{InUseAttributeError!!exception}}" {{DOMException}}.
+
+ Let oldAttr be the result of
+ getting an attribute given
+ attr's namespace, attr's local name, and
+ element.
+
+ If oldAttr is attr, return attr.
+
+ If oldAttr is non-null, then replace
+ oldAttr with attr.
+
+ Otherwise, append attr to element.
+
+ Return oldAttr.
+ To set an attribute value for an
+element element, using a localName and value, and an
+optional prefix, and namespace, run these steps:
+
+ Change attribute to value.
+ To remove an attribute by name
+given a qualifiedName and element element, run these steps:
+
+ Let attr be the result of
+ getting an attribute given qualifiedName and
+ element.
+
+ If attr is non-null, then remove attr.
+
+ Return attr.
+ To
+remove an attribute by namespace and local name
+given a namespace, localName, and element element,
+run these steps:
+
+ Let attr be the result of
+ getting an attribute given
+ namespace, localName, and element.
+
+ If attr is non-null, then remove attr.
+
+ Return attr.
+ An element can have an associated
+unique identifier (ID)
+
+ Historically elements could have multiple identifiers e.g., by using
+the HTML Use these attribute change steps to update an element's
+ID:
+
+ If localName is Otherwise, if localName is While this specification defines requirements for The The The The Returns the value of element's Returns the value of element's Allows for manipulation of element's Returns the value of element's IDL attributes that are defined to reflect a
+content attribute of a given name, must have a getter and setter that follow these
+steps: Return the result of running get an attribute value given this and
+ name. Set an attribute value for this using name and the given value.
+ The The The The Returns true if element has attributes; otherwise false.
+
+ Returns the qualified names of all element's attributes.
+ Can contain duplicates.
+
+ Returns element's first attribute whose qualified name is
+ qualifiedName, and null if there is no such attribute otherwise.
+
+ Returns element's attribute whose namespace is
+ namespace and local name is localName, and null if there is
+ no such attribute otherwise.
+
+ Sets the value of element's first attribute whose
+ qualified name is qualifiedName to value.
+
+ Sets the value of element's attribute whose
+ namespace is namespace and local name is
+ localName to value.
+
+ Removes element's first attribute whose qualified name is
+ qualifiedName.
+
+ Removes element's attribute whose namespace is
+ namespace and local name is localName.
+
+ 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; otherwise false.
+
+ Returns true if element has an attribute whose
+ qualified name is qualifiedName; otherwise false.
+
+ Returns true if element has an attribute whose namespace
+ is namespace and local name is localName.
+ The The The These are not guaranteed to be unique.
+
+ The Let attr be the result of
+ getting an attribute given qualifiedName and
+ this.
+
+ If attr is null, return null.
+
+ Return attr's value.
+ The
+ Let attr be the result of
+ getting an attribute given
+ namespace, localName, and this.
+
+ If attr is null, return null.
+
+ Return attr's value.
+ The
+ If qualifiedName does not match the If this is in the HTML namespace and its node document is an
+ HTML document, then set qualifiedName to qualifiedName in
+ ASCII lowercase.
+
+ Let attribute be the first attribute in this's
+ attribute list whose qualified name is qualifiedName,
+ and null otherwise.
+
+
+ If attribute is null, create an attribute whose
+ local name is qualifiedName, value is
+ value, and node document is this's node document,
+ then append this attribute to this, and then return.
+
+ Change attribute to value.
+ The
+ Let namespace, prefix, and localName be the result of
+ passing namespace and qualifiedName to validate and extract.
+
+ Set an attribute value for this using localName, value,
+ and also prefix and namespace.
+ The
+ The
+ The If this is in the HTML namespace and its node document is an
+ HTML document, then set qualifiedName to qualifiedName in
+ ASCII lowercase.
+
+ Return true if this has an attribute whose
+ qualified name is qualifiedName; otherwise false.
+ The
+ If qualifiedName does not match the If this is in the HTML namespace and its node document is an
+ HTML document, then set qualifiedName to qualifiedName in
+ ASCII lowercase.
+
+ Let attribute be the first attribute in this's
+ attribute list whose qualified name is qualifiedName,
+ and null otherwise.
+
+
+ If attribute is null, then:
+
+ If force is not given or is true, create an attribute whose
+ local name is qualifiedName, value is the empty
+ string, and node document is this's node document, then
+ append this attribute to this, and then return
+ true.
+
+ Return false.
+ Otherwise, if force is not given or is false,
+ remove an attribute given qualifiedName and
+ this, and then return false.
+
+ Return true.
+ The
+ If namespace is the empty string, then set it to null.
+
+ The The
+ The The If this's attribute list does not contain
+ attr, then throw a "{{NotFoundError!!exception}}" {{DOMException}}.
+
+ Remove attr.
+
+ Return attr.
+ Creates a shadow root for element and returns it.
+
+ Returns element's shadow root, if any, and if
+ shadow root's mode is " The If this's namespace is not the HTML namespace,
+ then throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ If this's local name is not one of the following:
+
+ then throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
+ If this's local name is a valid custom element name, or
+ this's Let definition be the result of
+ looking up a custom element definition given
+ this's node document, its namespace, its
+ local name, and its If definition is not null and definition's
+ disable shadow is true, then throw a
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+ If this is a shadow host, then throw an
+ "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+ Let shadow be a new shadow root whose node document
+ is this's node document, host is this,
+ and mode is init["{{ShadowRootInit/mode}}"].
+
+ Set shadow's delegates focus to
+ init["{{ShadowRootInit/delegatesFocus}}"].
+
+ If this's custom element state is " Set shadow's slot assignment to
+ init["{{ShadowRootInit/slotAssignment}}"].
+
+ Set this's shadow root to shadow.
+
+ Return shadow.
+ The Let shadow be this's shadow root.
+
+ If shadow is null or its mode is " Return shadow.
+ The The Let s be the result of parse a selector from selectors.
+ [[!SELECTORS4]]
+
+ If s is failure, then throw a "{{SyntaxError!!exception}}"
+ {{DOMException}}.
+
+ If the result of match a selector against an element, using s,
+ this, and :scope element this, returns success, then return true; otherwise,
+ return false. [[!SELECTORS4]]
+ The The
+ The To insert adjacent, given an element element, string
+where, and a node node, run the steps associated with the first
+ASCII case-insensitive match for where:
+
+ If element's parent is null, return null.
+
+ Return the result of pre-inserting node into element's
+ parent before element.
+
+ Return the result of pre-inserting node into element before
+ element's first child.
+
+ Return the result of pre-inserting node into element before
+ null.
+
+ If element's parent is null, return null.
+
+ Return the result of pre-inserting node into element's
+ parent before element's next sibling.
+
+ Throw a "{{SyntaxError!!exception}}" {{DOMException}}.
+ The
+ The
+ Let text be a new {{Text}} node whose data is
+ data and node document is this's node document.
+
+ Run insert adjacent, given this, where, and text.
+ This method returns nothing because it existed before we had a chance to design it.
+
+
+ A {{NamedNodeMap}} object's supported property indices are the numbers in the
+range zero to its attribute list's size minus one, unless
+the attribute list is empty, in which case there are no
+supported property indices.
+
+ The The If index is equal to or greater than this's
+ attribute list's size, then return null.
+
+ Otherwise, return this's attribute list[index].
+ A {{NamedNodeMap}} object's supported property names are the return value of running these
+steps:
+
+ Let names be the qualified names of the attributes in this
+ {{NamedNodeMap}} object's attribute list, with duplicates omitted, in
+ order.
+
+
+ If this {{NamedNodeMap}} object's element is in the
+ HTML namespace and its node document is an HTML document, then
+ for each name in names:
+
+ Let lowercaseName be name, in ASCII lowercase.
+
+ If lowercaseName is not equal to name, remove name from
+ names.
+ Return names.
+ The The
+ The The Let attr be the result of
+ removing an attribute given
+ qualifiedName and element.
+
+ If attr is null, then throw a "{{NotFoundError!!exception}}"
+ {{DOMException}}.
+
+ Return attr.
+ The
+ Let attr be the result of
+ removing an attribute given
+ namespace, localName, and element.
+
+ If attr is null, then throw a "{{NotFoundError!!exception}}"
+ {{DOMException}}.
+
+ Return attr.
+ {{Attr}} nodes are simply known as
+attributes. They are sometimes referred
+to as content attributes to avoid confusion with IDL attributes.
+
+Attributes have a
+namespace (null or a non-empty string),
+namespace prefix (null or a non-empty string),
+local name (a non-empty string),
+value (a string), and
+element (null or an
+element).
+
+ If designed today they would just have a name and value. ☹
+
+ An attribute's
+qualified name is its
+local name if its namespace prefix is null, and its
+namespace prefix, followed by " User agents could have this as an internal slot as an optimization.
+
+When an attribute is created, its
+local name is given. Unless explicitly
+given when an attribute is created, its
+namespace,
+namespace prefix, and
+element are set to null, and its
+value is set to the empty string.
+
+An
+ The The The The The To set an existing attribute value, given an attribute attribute and
+string value, run these steps:
+
+ If attribute's element is null, then set attribute's
+ value to value.
+
+ Otherwise, change attribute to value.
+ The {{Attr/value}} setter steps are to set an existing attribute value with this
+and the given value.
+
+ The The {{CharacterData}} is an abstract interface and does not exist as
+node. It is used by {{Text}}, {{ProcessingInstruction}}, and {{Comment}} nodes.
+
+Each node inheriting from the
+{{CharacterData}} interface has an associated mutable string
+called data.
+
+To replace data of node node with offset
+offset, count count, and data data, run these steps:
+
+ Queue a mutation record of " For each live range whose start node is node and
+ start offset is greater than offset but less than or equal to
+ offset plus count, set its start offset to
+ offset.
+
+ For each live range whose end node is node and
+ end offset is greater than offset but less than or equal to
+ offset plus count, set its end offset to offset.
+
+ For each live range whose start node is node and
+ start offset is greater than offset plus count, increase its
+ start offset by data's length and decrease it by
+ count.
+
+ For each live range whose end node is node and
+ end offset is greater than offset plus count, increase its
+ end offset by data's length and decrease it by
+ count.
+
+ The The The
+ The The
+ The
+ The
+ An exclusive {{Text}} node is a {{Text}} node that is not a
+{{CDATASection}} node.
+
+ The contiguous {{Text}} nodes of a node node are
+node, node's previous sibling {{Text}} node, if any, and its
+contiguous The contiguous exclusive {{Text}} nodes of a node node are
+node, node's previous sibling exclusive The child text content of a node
+node is the concatenation of the data of all
+the {{Text}} node children of node, in tree order.
+
+ The descendant text content of a
+node node is the concatenation of the
+data of all the {{Text}} node descendants of
+node, in tree order.
+
+ The If parent is not null, then:
+
+ Insert new node into parent before node's
+ next sibling.
+
+
+ For each live range whose start node is node and
+ start offset is greater than offset, set its
+ start node to new node and decrease its start offset
+ by offset.
+
+ For each live range whose end node is node and
+ end offset is greater than offset, set its end node
+ to new node and decrease its end offset by offset.
+
+
+ For each live range whose start node is parent and
+ start offset is equal to the index of node plus 1,
+ increase its start offset by 1.
+
+ For each live range whose end node is parent and
+ end offset is equal to the index of node plus 1,
+ increase its end offset by 1.
+ The The The {{StaticRange}} and {{Range}} objects (ranges) represent a sequence of content within a
+node tree. Each range has a start and an end which
+are boundary points. A boundary point is a tuple consisting of a
+node and an offset. So in other words, a
+range represents a piece of content within a node tree between two
+boundary points.
+
+ Ranges are frequently used in editing for selecting and copying content.
+
+ In the node tree above, a
+range can be used to represent the sequence
+“syndata is awes”. Assuming p is assigned to the
+ Attributes such as {{Range}} objects, unlike {{StaticRange}} objects, are affected by mutations to the
+node tree. Therefore they are also known as live ranges. Such mutations will not
+invalidate them and will try to ensure that it still represents the same piece of content.
+Necessarily, a live range might itself be modified as part of the mutation to the
+node tree when, e.g., part of the content it represents is mutated.
+
+ See the insert and remove algorithms, the
+{{Node/normalize()}} method, and the replace data and split
+algorithms for details.
+
+ Updating live ranges in response to node tree mutations can be expensive. For every
+node tree change, all affected {{Range}} objects need to be updated. Even if the application
+is uninterested in some live ranges, it still has to pay the cost of keeping them up-to-date
+when a mutation occurs.
+
+ A {{StaticRange}} object is a lightweight range that does not update when the
+node tree mutates. It is therefore not subject to the same maintenance cost as
+live ranges.
+
+
+ A boundary point is a tuple consisting of a
+node (a node) and an
+offset (a non-negative integer).
+
+ A correct boundary point's offset will
+be between 0 and the boundary point's node's
+length, inclusive.
+
+ The position of a
+boundary point (nodeA, offsetA) relative to a boundary point
+(nodeB, offsetB) is
+before,
+equal, or
+after, as returned by these steps:
+
+ Assert: nodeA and nodeB have the same root.
+
+ If nodeA is following nodeB, then if the
+ position of (nodeB, offsetB) relative to
+ (nodeA, offsetA) is before, return
+ after, and if it is after, return
+ before.
+
+ If nodeA is an ancestor of nodeB:
+
+ Return before.
+ Objects implementing the {{AbstractRange}} interface are known as
+ranges.
+
+ A range has two associated boundary points — a
+start and
+end.
+
+ For convenience, a range's
+start node is its start's
+node, its
+start offset is its
+start's offset, its
+end node is its end's
+node, and its
+end offset is its end's
+offset.
+
+ A range is collapsed if its start node is its
+end node and its start offset is its end offset.
+
+ The
+ The The The The Returns a new range object that does not update when the node tree mutates.
+ The
+ If init["{{StaticRangeInit/startContainer}}"] or
+ init["{{StaticRangeInit/endContainer}}"] is a {{DocumentType}} or {{Attr}}
+ node, then throw an "{{InvalidNodeTypeError!!exception}}" {{DOMException}}.
+
+ Set this's start to
+ (init["{{StaticRangeInit/startContainer}}"],
+ init["{{StaticRangeInit/startOffset}}"]) and end to
+ (init["{{StaticRangeInit/endContainer}}"],
+ init["{{StaticRangeInit/endOffset}}"]).
+ Objects implementing the {{Range}} interface are known as
+live ranges.
+
+ Algorithms that modify a tree (in particular the insert,
+remove, replace data, and split algorithms) modify
+live ranges associated with that tree.
+
+ The root of a live range is the
+root of its start node.
+
+
+ A node node is contained
+in a live range range if node's root is
+range's root, and (node, 0) is
+after range's start, and
+(node, node's length) is before
+range's end.
+
+ A node is
+partially contained in a live range
+if it's an inclusive ancestor of the live range's start node
+but not its end node, or vice versa.
+
+ Some facts to better understand these definitions:
+
+ The content that one would think of as being within the live range consists of all
+ contained nodes, plus possibly some of the contents of the
+ start node and end node if those are {{Text}},
+ {{ProcessingInstruction}}, or {{Comment}} nodes.
+
+ The nodes that are contained in a live range will generally not be
+ contiguous, because the parent of a contained
+ node will not always be contained.
+
+ However, the descendants of a contained node
+ are contained, and if two siblings are
+ contained, so are any siblings that lie between them.
+
+ The start node and end node of a live range are
+ never contained within it.
+
+ The first contained node (if there are any) will
+ always be after the start node, and the last contained
+ node will always be equal to or before the end node's last
+ descendant.
+
+ There exists a partially contained node if and only if
+ the start node and end node are different.
+
+ The {{Range/commonAncestorContainer}} attribute value is neither
+ contained nor partially contained.
+
+ If the start node is an ancestor of the end node,
+ the common inclusive ancestor will be the start node. Exactly one
+ of its children will be partially contained, and a
+ child will be contained if and only if it
+ precedes the partially contained
+ child. If the end node is an ancestor of the
+ start node, the opposite holds.
+
+ If the start node is not an inclusive ancestor of the
+ end node, nor vice versa, the common inclusive ancestor will be
+ distinct from both of them. Exactly two of its children will be
+ partially contained, and a child will be contained if and
+ only if it lies between those two.
+ The The To
+set the start or end
+of a range to a boundary point (node, offset), run these
+steps:
+
+ The The The The Let parent be node's parent.
+
+ If parent is null, then throw an "{{InvalidNodeTypeError!!exception}}"
+ {{DOMException}}.
+
+ Set the start of this to boundary point
+ (parent, node's index plus 1).
+ The The Let parent be node's parent.
+
+ If parent is null, then throw an "{{InvalidNodeTypeError!!exception}}"
+ {{DOMException}}.
+
+ Set the end of this to boundary point
+ (parent, node's index plus 1).
+ The To select a node node
+within a range range, run these steps:
+
+ Let parent be node's parent.
+
+ If parent is null, then throw an "{{InvalidNodeTypeError!!exception}}"
+ {{DOMException}}.
+
+ Let index be node's index.
+
+ Set range's start to boundary point
+ (parent, index).
+
+ Set range's end to boundary point
+ (parent, index plus 1).
+ The The The
+ If how is not one of
+
+ then throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+
+ If the position of this point relative to
+ other point is
+
+ The If reference node's
+ parent were null, it would be the
+ root of
+ this, so would be an
+ inclusive ancestor of
+ original end node, and we could not reach this point.
+ For each node in nodes to remove, in tree order,
+ remove node.
+
+ To extract a live range
+range, run these steps:
+
+ Let fragment be a new {{DocumentFragment}} node whose
+ node document is range's start node's
+ node document.
+
+ If range is collapsed, then return fragment.
+
+
+ These variable assignments do actually always make sense.
+ For instance, if original start node is not an
+ inclusive ancestor of
+ original end node, original start node is itself
+ partially contained in range, and so are all its
+ ancestors up until a
+ child of common ancestor.
+ common ancestor cannot be original start node, because
+ it has to be an inclusive ancestor of
+ original end node. The other case is similar. Also, notice that the two
+ children will never be equal if both are defined.
+
+ If any member of contained children is a doctype, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+
+ We do not have to worry about the first or last partially
+ contained node, because a doctype can never be
+ partially contained. It cannot be a boundary point of a range, and it
+ cannot be the ancestor of anything.
+
+ If reference node's
+ parent is null, it would be the
+ root of range, so would be an
+ inclusive ancestor of
+ original end node, and we could not reach this point.
+ In this case, first partially contained child is
+ original start node.
+
+ Let subfragment be the result of extracting
+ subrange.
+
+ In this case, last partially contained child is
+ original end node.
+
+ Let subfragment be the result of extracting
+ subrange.
+
+ The To
+clone the contents
+of a live range range, run these steps:
+
+ Let fragment be a new {{DocumentFragment}} node whose
+ node document is range's start node's
+ node document.
+
+ If range is collapsed, then return fragment.
+
+
+ These variable assignments do actually always make sense.
+ For instance, if original start node is not an
+ inclusive ancestor of
+ original end node, original start node is itself
+ partially contained in range, and so are all its
+ ancestors up until a
+ child of common ancestor.
+ common ancestor cannot be original start node, because
+ it has to be an inclusive ancestor of
+ original end node. The other case is similar. Also, notice that the two
+ children will never be equal if both are defined.
+
+ If any member of contained children is a doctype, then throw a
+ "{{HierarchyRequestError!!exception}}" {{DOMException}}.
+
+ We do not have to worry about the first or last partially
+ contained node, because a doctype can never be
+ partially contained. It cannot be a boundary point of a range, and it
+ cannot be the ancestor of anything.
+
+ In this case, first partially contained child is
+ original start node.
+
+ Let subfragment be the result of cloning the contents
+ of subrange.
+
+ In this case, last partially contained child is
+ original end node.
+
+ Let subfragment be the result of cloning the contents
+ of subrange.
+
+ The To insert a node
+node into a live range range, run these steps:
+
+ If range is collapsed, then set range's
+ end to (parent, newOffset).
+ The The If a non-{{Text}} node is partially contained in
+ this, then throw an "{{InvalidStateError!!exception}}" {{DOMException}}.
+
+
+ If newParent is a {{Document}}, {{DocumentType}}, or {{DocumentFragment}}
+ node, then throw an "{{InvalidNodeTypeError!!exception}}" {{DOMException}}.
+
+ For historical reasons {{Text}}, {{ProcessingInstruction}}, and {{Comment}}
+ nodes are not checked here and end up throwing later on as a side effect.
+
+ Let fragment be the result of extracting this.
+
+
+ If newParent has children, then replace all with null
+ within newParent.
+
+ Append fragment to newParent.
+
+ The The The The The The stringification behavior must run
+these steps:
+
+ Let s be the empty string.
+
+ If this's start node is this's end node and
+ it is a {{Text}} node, then return the substring of that {{Text}} node's
+ data beginning at this's start offset and ending
+ at this's end offset.
+
+ If this's start node is a {{Text}} node, then append the
+ substring of that node's data from this's
+ start offset until the end to s.
+
+ Append the concatenation of the data of all
+ {{Text}} nodes that are contained in this, in
+ tree order, to s.
+
+ If this's end node is a {{Text}} node, then
+ append the substring of that node's data from its start until
+ this's end offset to s.
+
+ Return s.
+ The {{createContextualFragment()}}, {{Range/getClientRects()}},
+and {{Range/getBoundingClientRect()}} methods are defined in other specifications.
+[[DOM-Parsing]]
+[[CSSOM-VIEW]]
+
+
+
+ {{NodeIterator}} and {{TreeWalker}} objects can be used to filter and traverse node
+trees.
+
+ Each {{NodeIterator}} and {{TreeWalker}} object has an associated
+active flag to avoid recursive
+invocations. It is initially unset.
+
+ Each {{NodeIterator}} and {{TreeWalker}} object also has an associated
+root (a node), a
+whatToShow (a bitmask), and a
+filter (a callback).
+
+ To filter a node node within
+a {{NodeIterator}} or {{TreeWalker}} object traverser, run these steps:
+
+ If traverser's active flag is set, then throw an
+ "{{InvalidStateError!!exception}}" {{DOMException}}.
+
+ Let n be node's {{Node/nodeType}} attribute value − 1.
+
+ If the nth bit (where 0 is the least significant bit) of
+ traverser's whatToShow is not set, then return
+ {{NodeFilter/FILTER_SKIP}}.
+
+
+ If traverser's filter is null, then return
+ {{NodeFilter/FILTER_ACCEPT}}.
+
+ Set traverser's active flag.
+
+ Let result be the return value of call a user object's operation with
+ traverser's filter, " Unset traverser's active flag.
+
+ Return result.
+ {{NodeIterator}} objects can be created using the
+{{createNodeIterator()}} method on {{Document}} objects.
+
+ Each {{NodeIterator}} object has an associated
+iterator collection, which is a
+collection rooted at the {{NodeIterator}} object's root, whose
+filter matches any node.
+
+ Each {{NodeIterator}} object also has an associated reference (a
+node) and pointer before reference (a boolean).
+
+ As mentioned earlier, {{NodeIterator}} objects have an associated
+active flag, root, whatToShow, and
+filter as well.
+
+ The If toBeRemovedNode is not an inclusive ancestor of
+ nodeIterator's reference, or toBeRemovedNode is
+ nodeIterator's root, then return.
+
+ If nodeIterator's pointer before reference is true, then:
+
+ Let next be toBeRemovedNode's first following
+ node that is an inclusive descendant of nodeIterator's
+ root and is not an inclusive descendant of
+ toBeRemovedNode, and null if there is no such node.
+
+ If next is non-null, then set nodeIterator's
+ reference to next and return.
+
+ Otherwise, set nodeIterator's pointer before reference to
+ false.
+
+ Steps are not terminated here.
+ Set nodeIterator's reference to
+ toBeRemovedNode's parent, if toBeRemovedNode's
+ previous sibling is null, and to the inclusive descendant of
+ toBeRemovedNode's previous sibling that appears last in tree order
+ otherwise.
+ The The The The The To traverse, given a
+{{NodeIterator}} object iterator and a direction direction, run these steps:
+
+ Let node be iterator's reference.
+
+ Let beforeNode be iterator's
+ pointer before reference.
+
+ While true:
+
+ Branch on direction:
+
+ If beforeNode is false, then set node to the first node
+ following node in iterator's
+ iterator collection. If there is no such node, then
+ return null.
+
+ If beforeNode is true, then set it to false.
+
+ If beforeNode is true, then set node to the first node
+ preceding node in iterator's
+ iterator collection. If there is no such node, then
+ return null.
+
+ If beforeNode is false, then set it to true.
+ Let result be the result of filtering node within
+ iterator.
+
+ If result is {{NodeFilter/FILTER_ACCEPT}}, then break.
+ Set iterator's reference to node.
+
+ Set iterator's pointer before reference to
+ beforeNode.
+
+ Return node.
+ The The The {{TreeWalker}} objects can be created using the {{createTreeWalker()}}
+method on {{Document}} objects.
+
+ Each {{TreeWalker}} object has an associated current (a
+node).
+
+ As mentioned earlier {{TreeWalker}} objects have an associated
+root, whatToShow, and filter as well.
+
+ The The The The The {{TreeWalker/currentNode}} setter steps are to set this's
+current to the given value.
+
+ The Return null.
+ To traverse children, given a
+walker and type, run these steps:
+
+ Let node be walker's current.
+
+ Set node to node's first child if type is
+ first, and node's last child if type is last.
+
+ While node is non-null:
+
+ Let result be the result of filtering node within
+ walker.
+
+ If result is {{NodeFilter/FILTER_ACCEPT}}, then set walker's
+ current to node and return node.
+
+ If result is {{NodeFilter/FILTER_SKIP}}, then:
+
+ Let child be node's first child if type
+ is first, and node's last child if type is last.
+
+ If child is non-null, then set node to child and
+ continue.
+ While node is non-null:
+
+ Let sibling be node's next sibling if
+ type is first, and node's previous sibling if
+ type is last.
+
+ If sibling is non-null, then set node to sibling and
+ break.
+
+ Let parent be node's parent.
+
+ If parent is null, walker's root, or
+ walker's current, then return null.
+
+ Set node to parent.
+ Return null.
+ The The To traverse siblings, given a walker
+and type, run these steps:
+
+ Let node be walker's current.
+
+ If node is root, then return null.
+
+ While true:
+
+ Let sibling be node's next sibling if
+ type is next, and node's previous sibling if
+ type is previous.
+
+ While sibling is non-null:
+
+ Set node to sibling.
+
+ Let result be the result of filtering node within
+ walker.
+
+ If result is {{NodeFilter/FILTER_ACCEPT}}, then set walker's
+ current to node and return node.
+
+ Set sibling to node's first child if
+ type is next, and node's last child if type is
+ previous.
+
+ If result is {{NodeFilter/FILTER_REJECT}} or sibling is null, then
+ set sibling to node's next sibling if type is
+ next, and node's previous sibling if type is previous.
+ Set node to node's parent.
+
+ If node is null or walker's root, then return
+ null.
+
+ If the return value of filtering node within walker is
+ {{NodeFilter/FILTER_ACCEPT}}, then return null.
+ The The The While node is not this's root:
+
+ Let sibling be node's previous sibling.
+
+ While sibling is non-null:
+
+ Set node to sibling.
+
+ Let result be the result of filtering node within
+ this.
+
+ While result is not {{NodeFilter/FILTER_REJECT}} and node has a
+ child:
+
+ Set node to node's last child.
+
+ If result is {{NodeFilter/FILTER_ACCEPT}}, then set this's
+ current to node and return node.
+
+ Set sibling to node's previous sibling.
+ If node is this's root or node's
+ parent is null, then return null.
+
+ Set node to node's parent.
+
+ If the return value of filtering node within this is
+ {{NodeFilter/FILTER_ACCEPT}}, then set this's current to
+ node and return node.
+ Return null.
+ The Let result be {{NodeFilter/FILTER_ACCEPT}}.
+
+ While true:
+
+ While result is not {{NodeFilter/FILTER_REJECT}} and node has a
+ child:
+
+ Set node to its first child.
+
+ Set result to the result of filtering node within
+ this.
+
+ If result is {{NodeFilter/FILTER_ACCEPT}}, then set this's
+ current to node and return node.
+ Let sibling be null.
+
+ Let temporary be node.
+
+ While temporary is non-null:
+
+ Set sibling to temporary's next sibling.
+
+ If sibling is non-null, then set node to sibling and
+ break.
+
+ Set temporary to temporary's parent.
+ Set result to the result of filtering node within
+ this.
+
+ If result is {{NodeFilter/FILTER_ACCEPT}}, then set this's
+ current to node and return node.
+ {{NodeFilter}} objects can be used as filter for
+{{NodeIterator}} and {{TreeWalker}} objects and also provide constants for their
+whatToShow bitmask. A {{NodeFilter}} object is typically implemented as a
+JavaScript function.
+
+ These constants can be used as filter return value:
+
+ These constants can be used for whatToShow:
+
+ Yes, the name {{DOMTokenList}} is an unfortunate legacy mishap.
+
+ A {{DOMTokenList}} object has an associated
+token set (a set), which is
+initially empty.
+
+ A {{DOMTokenList}} object also has an associated element and an attribute's
+local name.
+
+Specifications may define
+supported tokens for a {{DOMTokenList}}'s
+associated attribute's local name.
+
+ A {{DOMTokenList}} object's
+validation steps for a given
+token are:
+
+ If the associated attribute's local name does not define
+ supported tokens, throw a Let lowercase token be a copy of token, in ASCII lowercase.
+
+ If lowercase token is present in supported tokens, return true.
+
+ Return false.
+ A {{DOMTokenList}} object's update steps are:
+
+ If the associated element does not have an associated attribute and
+ token set is empty, then return.
+
+ Set an attribute value for the associated element using associated
+ attribute's local name and the result of running the ordered set
+ serializer for token set.
+ A {{DOMTokenList}} object's serialize steps
+are to return the result of running get an attribute value given the associated
+element and the associated attribute's local name. A {{DOMTokenList}} object has these attribute change steps for its associated
+element:
+
+ If localName is associated attribute's local name,
+ namespace is null, and value is null, then empty
+ token set.
+
+ Otherwise, if localName is associated attribute's local name,
+ namespace is null, then set token set to value,
+ parsed.
+ When a {{DOMTokenList}} object is created, then:
+
+ Let element be associated element.
+
+ Let localName be associated attribute's local name.
+
+ Let value be the result of
+ getting an attribute value given element and
+ localName.
+
+ Run the attribute change steps for element, localName,
+ value, value, and null.
+ Returns the number of tokens.
+
+ Returns the token with index index.
+
+ Returns true if token is present; otherwise false.
+
+ Adds all arguments passed, except those already present.
+ Throws a "{{SyntaxError!!exception}}" {{DOMException}} if one of the arguments is the empty
+ string.
+ Throws an "{{InvalidCharacterError!!exception}}" {{DOMException}} if one of the arguments
+ contains any ASCII whitespace.
+
+ Removes arguments passed, if they are present.
+ Throws a "{{SyntaxError!!exception}}" {{DOMException}} if one of the arguments is the empty
+ string.
+ Throws an "{{InvalidCharacterError!!exception}}" {{DOMException}} if one of the arguments
+ contains any ASCII whitespace.
+
+ If force is not given, "toggles" token, removing it if it's present and
+ adding it if it's not present. If force is true, adds token
+ (same as {{add()}}). If force is false, removes token (same
+ as {{DOMTokenList/remove()}}).
+ Returns true if token is now present; otherwise false.
+ Throws a "{{SyntaxError!!exception}}" {{DOMException}} if token is empty.
+ Throws an "{{InvalidCharacterError!!exception}}" {{DOMException}} if token contains
+ any spaces.
+
+ Replaces token with newToken.
+ Returns true if token was replaced with newToken; otherwise false.
+ Throws a "{{SyntaxError!!exception}}" {{DOMException}} if one of the arguments is the empty
+ string.
+ Throws an "{{InvalidCharacterError!!exception}}" {{DOMException}} if one of the arguments
+ contains any ASCII whitespace.
+
+ Returns true if token is in the associated attribute's supported tokens. Returns
+ false otherwise.
+ Throws a Returns the associated set as string.
+ Can be set, to change the associated attribute.
+ The The object's supported property indices are the numbers in the range zero to object's
+token set's size minus one, unless token set is empty,
+in which case there are no supported property indices.
+
+ The The The
+ For each token in tokens:
+
+ If token is the empty string, then throw a "{{SyntaxError!!exception}}"
+ {{DOMException}}.
+
+ If token contains any ASCII whitespace, then throw an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+ For each token in tokens, append
+ token to this's token set.
+
+ Run the update steps.
+ The
+ For each token in tokens:
+
+ If token is the empty string, then throw a "{{SyntaxError!!exception}}"
+ {{DOMException}}.
+
+ If token contains any ASCII whitespace, then throw an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+ For each token in tokens, remove token from
+ this's token set.
+
+ Run the update steps.
+ The If token is the empty string, then throw a "{{SyntaxError!!exception}}"
+ {{DOMException}}.
+
+ If token contains any ASCII whitespace, then throw an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ If this's token set[token] exists, then:
+
+ If force is either not given or is false, then remove
+ token from this's token set, run the update steps and return
+ false.
+
+ Return true.
+ Otherwise, if force not given or is true, append token
+ to this's token set, run the update steps, and return true.
+
+ Return false.
+ The update steps are not always run for {{DOMTokenList/toggle()}}
+for web compatibility.
+
+ The
+ If either token or newToken is the empty string, then throw a
+ "{{SyntaxError!!exception}}" {{DOMException}}.
+
+ If either token or newToken contains any ASCII whitespace, then
+ throw an "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ If this's token set does not contain token, then
+ return false. Run the update steps.
+
+ Return true.
+ The update steps are not always run for {{DOMTokenList/replace()}}
+for web compatibility.
+
+ The
+ Let result be the return value of validation steps called with
+ token.
+
+ Return result.
+ The Setting the {{DOMTokenList/value}} attribute must set an attribute value for the
+associated element using associated attribute's local name and
+the given value.
+
+
+
+ DOM Level 3 XPath defined an API for evaluating XPath 1.0
+expressions. These APIs are widely implemented, but have not been maintained. The interface
+definitions are maintained here so that they can be updated when Web IDL changes.
+Complete definitions of these APIs remain necessary and such work is tracked and can be contributed
+to in whatwg/dom#67. [[DOM-Level-3-XPath]]
+[[XPath]] [[WEBIDL]]
+
+
+ For historical reasons you can both construct {{XPathEvaluator}} and access the same
+methods on {{Document}}.
+
+
+
+ XSL Transformations (XSLT) is a language for transforming XML documents
+into other XML documents. The APIs defined in this section have been widely implemented, and are
+maintained here so that they can be updated when Web IDL changes. Complete definitions
+of these APIs remain necessary and such work is tracked and can be contributed to in
+whatwg/dom#181. [[XSLT]]
+
+
+ This standard used to contain several interfaces and interface members that have been removed.
+
+ These interfaces have been removed:
+
+ And these interface members have been removed:
+
+ There have been a lot of people that have helped make DOM more interoperable over the years and
+thereby furthered the goals of this standard. Likewise many people have helped making this standard
+what it is today.
+
+ With that, many thanks to
+Adam Klein,
+Adrian Bateman,
+Ahmid snuggs,
+Alex Komoroske,
+Alex Russell,
+Alexey Shvayka,
+Andreu Botella,
+Anthony Ramine,
+Arkadiusz Michalski,
+Arnaud Le Hors,
+Arun Ranganathan,
+Benjamin Gruenbaum,
+Björn Höhrmann,
+Boris Zbarsky,
+Brandon Payton,
+Brandon Slade,
+Brandon Wallace,
+Brian Kardell,
+C. Scott Ananian,
+Cameron McCormack,
+Chris Dumez,
+Chris Paris,
+Chris Rebert,
+Cyrille Tuzi,
+Dan Burzo,
+Daniel Glazman,
+Darin Fisher,
+David Bruant,
+David Flanagan,
+David Håsäther,
+David Hyatt,
+Deepak Sherveghar,
+Dethe Elza,
+Dimitri Glazkov,
+Domenic Denicola,
+Dominic Cooney,
+Dominique Hazaël-Massieux,
+Don Jordan,
+Doug Schepers,
+Edgar Chen,
+Elisée Maurer,
+Elliott Sprehn,
+Emilio Cobos Álvarez,
+Eric Bidelman,
+Erik Arvidsson,
+Gary Kacmarcik,
+Gavin Nicol,
+Giorgio Liscio,
+Glen Huang,
+Glenn Adams,
+Glenn Maynard,
+Hajime Morrita,
+Harald Alvestrand,
+Hayato Ito,
+Henri Sivonen,
+Hongchan Choi,
+Hunan Rostomyan,
+Ian Hickson,
+Igor Bukanov,
+Jacob Rossi,
+Jake Archibald,
+Jake Verbaten,
+James Graham,
+James Greene,
+James M Snell,
+James Robinson,
+Jeffrey Yasskin,
+Jens Lindström,
+Jesse McCarthy,
+Jinho Bang,
+João Eiras,
+Joe Kesselman,
+John Atkins,
+John Dai,
+Jonas Sicking,
+Jonathan Kingston,
+Jonathan Robie,
+Joris van der Wel,
+Joshua Bell,
+J. S. Choi,
+Jungkee Song,
+Justin Summerlin,
+Kagami Sascha Rosylight,
+呂康豪 (Kang-Hao Lu),
+田村健人 (Kent TAMURA),
+Kevin J. Sung,
+Kevin Sweeney,
+Kirill Topolyan,
+Koji Ishii,
+Lachlan Hunt,
+Lauren Wood,
+Luke Zielinski,
+Magne Andersson,
+Majid Valipour,
+Malte Ubl,
+Manish Goregaokar,
+Manish Tripathi,
+Marcos Caceres,
+Mark Miller,
+Martijn van der Ven,
+Mason Freed,
+Mats Palmgren,
+Mounir Lamouri,
+Michael Stramel,
+Michael™ Smith,
+Mike Champion,
+Mike Taylor,
+Mike West,
+Ojan Vafai,
+Oliver Nightingale,
+Olli Pettay,
+Ondřej Žára,
+Peter Sharpe,
+Philip Jägenstedt,
+Philippe Le Hégaret,
+Piers Wombwell,
+Pierre-Marie Dartus,
+prosody—Gab Vereable Context(,
+Rafael Weinstein,
+Rakina Zata Amni,
+Richard Bradshaw,
+Rick Byers,
+Rick Waldron,
+Robbert Broersma,
+Robin Berjon,
+Roland Steiner,
+Rune F. Halvorsen,
+Russell Bicknell,
+Ruud Steltenpool,
+Ryosuke Niwa,
+Sam Dutton,
+Sam Sneddon,
+Samuel Giles,
+Sanket Joshi,
+Sebastian Mayr,
+Seo Sanghyeon,
+Sergey G. Grekhov,
+Shiki Okasaka,
+Shinya Kawanaka,
+Simon Pieters,
+Stef Busking,
+Steve Byrne,
+Stig Halvorsen,
+Tab Atkins,
+Takashi Sakamoto,
+Takayoshi Kochi,
+Theresa O'Connor,
+Theodore Dubois,
+timeless,
+Timo Tijhof,
+Tobie Langel,
+Tom Pixley,
+Travis Leithead,
+Trevor Rowbotham,
+triple-underscore,
+Veli Şenol,
+Vidur Apparao,
+Warren He,
+Xidorn Quan,
+Yash Handa,
+Yehuda Katz,
+Yoav Weiss,
+Yoichi Osato,
+Yoshinori Sano,
+Yu Han,
+Yusuke Abe, and
+Zack Weinberg
+for being awesome!
+
+ This standard is written by Anne van Kesteren
+(Mozilla, annevk@annevk.nl)
+with substantial contributions from Aryeh Gregor (ayg@aryeh.name)
+and Ms2ger (ms2ger@gmail.com).
+
+ Part of the revision history of the integration points related to
+custom elements can be found in
+the w3c/webcomponents repository, which is
+available under the
+W3C Software and Document License.
createNodeIterator(root, whatToShow, filter)
-method, when invoked, must run these steps:
+method steps are:
createTreeWalker(root, whatToShow, filter)
-method, when invoked, must run these steps:
+method steps are:
createDocumentType(qualifiedName, publicId, systemId)
-method, when invoked, must run these steps:
+method steps are:
-The createDocument(namespace, qualifiedName, doctype)
-method, when invoked, must run these steps:
+method steps are:
-The
+createHTMLDocument(title)
-method, when invoked, must run these steps:
+method steps are:
hasFeature() method, when
-invoked, must return true.
+hasFeature() method steps are to
+return true.
-name attribute's getter must return
+name getter steps are to return
this's name.
-publicId attribute's getter must return
+publicId getter steps are to return
this's public ID.
-systemId attribute's getter must return
+systemId getter steps are to return
this's system ID.
@@ -5657,9 +5731,9 @@ interface DocumentFragment : Node {
};
-
-tree = new {{DocumentFragment()}}
- DocumentFragment() constructor, when
-invoked, must return a new {{DocumentFragment}} node whose node document is
+new DocumentFragment()
+constructor steps are to set this's node document to
current global object's associated Document.
@@ -5688,11 +5763,14 @@ invoked, must return a new {{DocumentFragment}} node whose no
[Exposed=Window]
interface ShadowRoot : DocumentFragment {
readonly attribute ShadowRootMode mode;
+ readonly attribute boolean delegatesFocus;
+ readonly attribute SlotAssignmentMode slotAssignment;
readonly attribute Element host;
attribute EventHandler onslotchange;
};
enum ShadowRootMode { "open", "closed" };
+enum SlotAssignmentMode { "manual", "named" };
closed").manual" or "named").
+
mode attribute's getter must return
+mode getter steps are to return
this's mode.host attribute's getter must return
+delegatesFocus getter steps are to return
+this's delegates focus.slotAssignment getter steps are to return
+this's slot assignment.
+
+host getter steps are to return
this's host.
onslotchange attribute is an
@@ -5737,8 +5827,7 @@ null if event's composed flag is unset and shadow roo
@@ -5781,9 +5870,9 @@ is an object or one of its shadow-including ancestors.
-
@@ -5816,10 +5905,10 @@ interface Element : Node {
sequence<DOMString> getAttributeNames();
DOMString? getAttribute(DOMString qualifiedName);
DOMString? getAttributeNS(DOMString? namespace, DOMString localName);
- [CEReactions] void setAttribute(DOMString qualifiedName, DOMString value);
- [CEReactions] void setAttributeNS(DOMString? namespace, DOMString qualifiedName, DOMString value);
- [CEReactions] void removeAttribute(DOMString qualifiedName);
- [CEReactions] void removeAttributeNS(DOMString? namespace, DOMString localName);
+ [CEReactions] undefined setAttribute(DOMString qualifiedName, DOMString value);
+ [CEReactions] undefined setAttributeNS(DOMString? namespace, DOMString qualifiedName, DOMString value);
+ [CEReactions] undefined removeAttribute(DOMString qualifiedName);
+ [CEReactions] undefined removeAttributeNS(DOMString? namespace, DOMString localName);
[CEReactions] boolean toggleAttribute(DOMString qualifiedName, optional boolean force);
boolean hasAttribute(DOMString qualifiedName);
boolean hasAttributeNS(DOMString? namespace, DOMString localName);
@@ -5835,19 +5924,20 @@ interface Element : Node {
Element? closest(DOMString selectors);
boolean matches(DOMString selectors);
- boolean webkitMatchesSelector(DOMString selectors); // historical alias of .matches
+ boolean webkitMatchesSelector(DOMString selectors); // legacy alias of .matches
HTMLCollection getElementsByTagName(DOMString qualifiedName);
HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);
HTMLCollection getElementsByClassName(DOMString classNames);
- [CEReactions] Element? insertAdjacentElement(DOMString where, Element element); // historical
- void insertAdjacentText(DOMString where, DOMString data); // historical
+ [CEReactions] Element? insertAdjacentElement(DOMString where, Element element); // legacy
+ undefined insertAdjacentText(DOMString where, DOMString data); // legacy
};
dictionary ShadowRootInit {
required ShadowRootMode mode;
boolean delegatesFocus = false;
+ SlotAssignmentMode slotAssignment = "named";
};
@@ -5861,28 +5951,28 @@ dictionary ShadowRootInit {
custom element state,
custom element definition,
is value. When an
-element is created, all of these values are
+element is created, all of these values are
initialized.
undefined", "failed", "uncustomized", or
-"custom". An element whose custom element state is
-"uncustomized" or "custom" is said to be
-defined. An element whose
-custom element state is "custom" is said to be
+"undefined", "failed", "uncustomized",
+"precustomized", or "custom". An element whose
+custom element state is "uncustomized" or "custom" is
+said to be defined. An element
+whose custom element state is "custom" is said to be
custom.
failed" state is used to ensure that if a custom element constructor fails to
-execute correctly the first time, it is not executed again by an
-upgrade.failed" and "precustomized" states are used to ensure that if a
+custom element constructor fails to execute correctly the first time, it is not executed
+again by an upgrade.
+
+
-A {{NamedNodeMap}} has an associated
+
<!DOCTYPE html>
<script>
window.customElements.define("sw-rey", class extends HTMLElement {})
@@ -5919,9 +6009,9 @@ execute correctly the first time, it is not executed again by an
:", followed by its
-local name, otherwise.
+local name.
is value set to is, and node document set to
document.
-
+
+
+
+
+ failed".
+
@@ -6174,7 +6279,7 @@ steps:
-
@@ -6261,7 +6363,7 @@ optional prefix, and namespace, run these steps:
@@ -6293,9 +6395,9 @@ run these steps:
-id attribute and a DTD. This specification makes ID
-a concept of the DOM and allows for only one per element, given by an
+a concept of the DOM and allows for only one per element, given by an
id attribute.
class,
-id, and slot attributes on any element, it makes no
+class,
+id, and slot attributes on any element, it makes no
claims as to whether using them is conforming or not.
-A node's
-parent of type
-{{Element}} is known as a parent element. If the
-node has a
+namespaceURI attribute's getter must return
+namespaceURI getter steps are to return
this's namespace.
-prefix attribute's getter must return
+prefix getter steps are to return
this's namespace prefix.
-localName attribute's getter must return
+localName getter steps are to return
this's local name.
-tagName attribute's getter must return
+tagName getter steps are to return
this's HTML-uppercased qualified name.
@@ -6393,16 +6493,16 @@ steps:
className attribute must
reflect the "class" content attribute.
-classList attribute's getter must return a
+classList getter steps are to return a
{{DOMTokenList}} object whose associated element is this and whose associated
attribute's local name is class. The token set of this
-particular {{DOMTokenList}} object are also known as the element's
+particular {{DOMTokenList}} object are also known as the element's
classes.
slot attribute must reflect the
"slot" content attribute.
-id, class, and slot are effectively
+id, class, and slot are effectively
superglobal attributes as they can appear on any element, regardless of that element's
namespace.
-element . hasAttributes()
- element . getAttributeNames()
element . hasAttribute(qualifiedName)
element . hasAttributeNS(namespace, localName)
hasAttributes() method, when invoked, must return
-false if this's attribute list is empty, and true
-otherwise.
+hasAttributes() method steps are to return false
+if this's attribute list is empty; otherwise true.
-attributes attribute's getter must return the
+attributes getter steps are to return the
associated {{NamedNodeMap}}.
-getAttributeNames() method, when invoked, must
-return the qualified names of the attributes in this's
-attribute list, in order, and a new list otherwise.
+getAttributeNames() method steps are to return the
+qualified names of the attributes in this's
+attribute list, in order; otherwise a new list.
getAttribute(qualifiedName) method,
-when invoked, must run these steps:
+getAttribute(qualifiedName) method
+steps are:
getAttributeNS(namespace, localName)
-method, when invoked, must these steps:
+method steps are:
setAttribute(qualifiedName, value)
-method, when invoked, must run these steps:
+method steps are:
Name production in
@@ -6518,7 +6617,7 @@ method, when invoked, must run these steps:
setAttributeNS(namespace, qualifiedName, value)
-method, when invoked, must run these steps:
+method steps are:
removeAttribute(qualifiedName)
-method, when invoked, must remove an attribute given
+method steps are to remove an attribute given
qualifiedName and this, and then return undefined.
removeAttributeNS(namespace, localName)
-method, when invoked, must
-remove an attribute given
-namespace, localName, and this, and then return undefined.
+method steps are to remove an attribute
+given namespace, localName, and this, and then return undefined.
-hasAttribute(qualifiedName) method,
-when invoked, must run these steps:
+hasAttribute(qualifiedName) method
+steps are:
-toggleAttribute(qualifiedName, force)
-method, when invoked, must run these steps:
+toggleAttribute(qualifiedName, force)
+method steps are:
Name production in
@@ -6581,7 +6680,7 @@ method, when invoked, must run these steps:
hasAttributeNS(namespace, localName)
-method, when invoked, must run these steps:
+method steps are:
-
-getAttributeNode(qualifiedName)
-method, when invoked, must return the result of
-getting an attribute given qualifiedName and
-this.
+getAttributeNode(qualifiedName) method
+steps are to return the result of getting an attribute given
+qualifiedName and this.
getAttributeNodeNS(namespace, localName)
-method, when invoked, must return the result of
+method steps are to return the result of
getting an attribute given
namespace, localName, and this.
setAttributeNode(attr) and
-setAttributeNodeNS(attr) methods, when
-invoked, must return the result of setting an attribute given
-attr and this.
+setAttributeNodeNS(attr) methods steps are to
+return the result of setting an attribute given attr and
+this.
-removeAttributeNode(attr) method,
-when invoked, must run these steps:
+removeAttributeNode(attr) method steps
+are:
open", and null otherwise.
-attachShadow(init) method, when
-invoked, must run these steps:
+attachShadow(init) method steps are:
-
-article",
- "aside",
- "blockquote",
- "body",
- "div",
- "footer",
- "h1",
- "h2",
- "h3",
- "h4",
- "h5",
- "h6",
- "header",
- "main",
- "nav",
- "p",
- "section", or
- "span", then throw a "{{NotSupportedError!!exception}}" {{DOMException}}.
+
+
+
+ article",
+ "aside",
+ "blockquote",
+ "body",
+ "div",
+ "footer",
+ "h1",
+ "h2",
+ "h3",
+ "h4",
+ "h5",
+ "h6",
+ "header",
+ "main",
+ "nav",
+ "p",
+ "section", or
+ "span"
+ precustomized" or
+ "custom", then set shadow's
+ available to element internals to true.
+
+ shadowRoot attribute's getter must run these
-steps:
+shadowRoot getter steps are:
element . {{matches(selectors)}}
- closest(selectors)
-method, when invoked, must run these steps:
+closest(selectors) method steps are:
-The matches(selectors) and
-webkitMatchesSelector(selectors) methods, when
-invoked, must run these steps:
+matches(selectors) and
+webkitMatchesSelector(selectors) method steps
+are:
-
getElementsByTagName(qualifiedName)
-method, when invoked, must return the
-list of elements with qualified name qualifiedName for this.
+method steps are to return the list of elements with qualified name qualifiedName
+for this.
getElementsByTagNameNS(namespace, localName)
-method, when invoked, must return the
-list of elements with namespace namespace and local name localName for
-this.
+method steps are to return the list of elements with namespace namespace and local
+name localName for this.
getElementsByClassName(classNames)
-method, when invoked, must return the list of elements with class names classNames
-for this.
+method steps are to return the list of elements with class names classNames for
+this.
@@ -6832,21 +6933,22 @@ for this.
insertAdjacentElement(where, element)
-method, when invoked, must return the result of running insert adjacent, give this,
+method steps are to return the result of running insert adjacent, give this,
where, and element.
insertAdjacentText(where, data)
-method, when invoked, must run these steps:
+method steps are:
-
-Interface {{NamedNodeMap}}
@@ -6866,11 +6968,11 @@ interface NamedNodeMap {
};
length attribute's getter must return
+length getter steps are to return
the attribute list's size.
-item(index) method, when
-invoked, must run these steps:
+item(index) method steps are:
-getNamedItem(qualifiedName)
-method, when invoked, must return the result of
-getting an attribute given qualifiedName and
-element.
+getNamedItem(qualifiedName)
+method steps are to return the result of getting an attribute
+given qualifiedName and element.
getNamedItemNS(namespace, localName)
-method, when invoked, must return the result of
+getNamedItemNS(namespace, localName)
+method steps are to return the result of
getting an attribute given
-namespace, localName, and
-element.
+namespace, localName, and element.
-setNamedItem(attr) and
-setNamedItemNS(attr)
-methods, when invoked, must return the result of setting an attribute
-given attr and element.
+setNamedItem(attr) and
+setNamedItemNS(attr) method steps are
+to return the result of setting an attribute given attr and
+element.
-removeNamedItem(qualifiedName)
-method, when invoked, must run these steps:
+removeNamedItem(qualifiedName)
+method steps are:
removeNamedItemNS(namespace, localName)
-method, when invoked, must run these steps:
+removeNamedItemNS(namespace, localName)
+method steps are:
-
-namespaceURI attribute's getter must return the
-namespace.
+namespaceURI getter steps are to return
+this's namespace.
-prefix attribute's getter must return the
+prefix getter steps are to return this's
namespace prefix.
-localName attribute's getter must return the
-local name.
+localName getter steps are to return
+this's local name.
-name attribute's getter must return the
+name getter steps are to return this's
qualified name.
-value attribute's getter must return the
+value getter steps are to return this's
value.
-ownerElement attribute's getter must return
+ownerElement getter steps are to return
this's element.
-specified attribute's getter must return true.
+specified getter steps are to return true.
Interface {{CharacterData}}
@@ -7068,24 +7167,23 @@ string value, run these steps:
[Exposed=Window]
interface CharacterData : Node {
- attribute [TreatNullAs=EmptyString] DOMString data;
+ attribute [LegacyNullToEmptyString] DOMString data;
readonly attribute unsigned long length;
DOMString substringData(unsigned long offset, unsigned long count);
- void appendData(DOMString data);
- void insertData(unsigned long offset, DOMString data);
- void deleteData(unsigned long offset, unsigned long count);
- void replaceData(unsigned long offset, unsigned long count, DOMString data);
+ undefined appendData(DOMString data);
+ undefined insertData(unsigned long offset, DOMString data);
+ undefined deleteData(unsigned long offset, unsigned long count);
+ undefined replaceData(unsigned long offset, unsigned long count, DOMString data);
};
-
@@ -7189,36 +7287,36 @@ To data.
-data attribute's getter must return
+data getter steps are to return
this's data. Its setter must replace data with node
this, offset 0, count this's length, and data new value.
-length attribute's getter must return
+length getter steps are to return
this's length.
substringData(offset, count)
-method, when invoked, must return the result of running substring data with node this,
+method steps are to return the result of running substring data with node this,
offset offset, and count count.
-appendData(data) method, when
-invoked, must replace data with node this, offset this's
-length, count 0, and data data.
+appendData(data) method steps are
+to replace data with node this, offset this's length, count 0,
+and data data.
insertData(offset, data)
-method, when invoked, must replace data with node this, offset offset,
-count 0, and data data.
+method steps are to replace data with node this, offset offset, count 0,
+and data data.
deleteData(offset, count)
-method, when invoked, must replace data with node this, offset offset,
-count count, and data the empty string.
+method steps are to replace data with node this, offset offset, count
+count, and data the empty string.
replaceData(offset, count, data)
-method, when invoked, must replace data with node this, offset offset,
-count count, and data data.
+method steps are to replace data with node this, offset offset, count
+count, and data data.
Interface {{Text}}
@@ -7235,39 +7333,41 @@ interface Text : CharacterData {
text = new Text([data = ""])
- text . {{Text/splitText(offset)}}
text . {{Text/wholeText}}
-Text nodes, and node's next sibling {{Text}}
-node, if any, and its contiguous Text nodes, avoiding any duplicates.
+Text nodes, and node's next sibling
+{{Text}} node, if any, and its contiguous Text nodes, avoiding any
+duplicates.
-Text node,
-if any, and its contiguous exclusive Text nodes, and node's
+Text node, if any, and its
+contiguous exclusive Text nodes, and node's
next sibling exclusive Text node, if any, and its
contiguous exclusive Text nodes, avoiding any duplicates.
-Text(data) constructor, when invoked,
-must return a new {{Text}} node whose data is data and
-node document is current global object's
+new Text(data)
+constructor steps are to set this's data to data and
+this's node document to current global object's
associated Document.
-To split a {{Text}}
-node node with offset
-offset, run these steps:
+
-splitText(offset) method, when invoked,
-must split this with offset offset.
+splitText(offset) method steps are to
+split this with offset offset.
-wholeText attribute's getter must return the
+wholeText getter steps are to return the
concatenation of the data of the
contiguous Text nodes of this, in tree order.
@@ -7369,12 +7468,11 @@ interface ProcessingInstruction : CharacterData {
readonly attribute DOMString target;
};Interface {{Comment}}
@@ -7388,18 +7486,17 @@ interface Comment : CharacterData {
-comment = new Comment([data = ""])
- Comment(data) constructor, when
-invoked, must return a new {{Comment}} node whose data is
-data and node document is current global object's
+new Comment(data)
+constructor steps are to set this's data to data and
+this's node document to current global object's
associated Document.
-
Ranges
Introduction to "DOM Ranges"
@@ -7413,16 +7510,16 @@ are boundary points. A boundary point is a tuple cons
-
p
+
+
@@ -7430,11 +7527,11 @@ are boundary points. A boundary point is a tuple cons
p
-
<img src="insanity-wolf" alt="Little-endian BOM; decode as big-endian!">
- <em>
+ <img src="insanity-wolf" alt="Little-endian BOM; decode as big-endian!">
+ <em>
-
- p element, and
+p element, and
em to the em
-element, this would be done as follows:
+element, this would be done as follows:
-
+
-
var range = new Range(),
firstText = p.childNodes[1],
secondText = em.firstChild
@@ -7443,7 +7540,7 @@ range.setEnd(secondText, 4)
// range now stringifies to the aforementioned quote
src and alt in the
+src and alt in the
node tree above cannot be represented by a range. Ranges are only useful for
nodes.
@@ -7453,7 +7550,7 @@ invalidate them and will try to ensure that it still represents the same piece o
Necessarily, a live range might itself be modified as part of the mutation to the
node tree when, e.g., part of the content it represents is mutated.
-collapsed = range . collapsed
- startContainer
-attribute's getter must return this's start node.
+getter steps are to return this's start node.
startOffset
-attribute's getter must return this's start offset.
+getter steps are to return this's start offset.
endContainer
-attribute's getter must return this's end node.
+getter steps are to return this's end node.
endOffset
-attribute's getter must return this's end offset.
+getter steps are to return this's end offset.
collapsed
-attribute's getter must return true if this is collapsed, and false
-otherwise.
+getter steps are to return true if this is collapsed; otherwise false.
Interface {{StaticRange}}
@@ -7600,27 +7696,40 @@ interface StaticRange : AbstractRange {
-
-staticRange = new StaticRange(init)
+ staticRange = new StaticRange(init)
StaticRange(init) constructor,
-when invoked, must run these steps:
+new StaticRange(init)
+constructor steps are:
-
-
+
Interface {{Range}}
@@ -7632,15 +7741,15 @@ interface Range : AbstractRange {
readonly attribute Node commonAncestorContainer;
- void setStart(Node node, unsigned long offset);
- void setEnd(Node node, unsigned long offset);
- void setStartBefore(Node node);
- void setStartAfter(Node node);
- void setEndBefore(Node node);
- void setEndAfter(Node node);
- void collapse(optional boolean toStart = false);
- void selectNode(Node node);
- void selectNodeContents(Node node);
+ undefined setStart(Node node, unsigned long offset);
+ undefined setEnd(Node node, unsigned long offset);
+ undefined setStartBefore(Node node);
+ undefined setStartAfter(Node node);
+ undefined setEndBefore(Node node);
+ undefined setEndAfter(Node node);
+ undefined collapse(optional boolean toStart = false);
+ undefined selectNode(Node node);
+ undefined selectNodeContents(Node node);
const unsigned short START_TO_START = 0;
const unsigned short START_TO_END = 1;
@@ -7648,14 +7757,14 @@ interface Range : AbstractRange {
const unsigned short END_TO_START = 3;
short compareBoundaryPoints(unsigned short how, Range sourceRange);
- [CEReactions] void deleteContents();
+ [CEReactions] undefined deleteContents();
[CEReactions, NewObject] DocumentFragment extractContents();
[CEReactions, NewObject] DocumentFragment cloneContents();
- [CEReactions] void insertNode(Node node);
- [CEReactions] void surroundContents(Node newParent);
+ [CEReactions] undefined insertNode(Node node);
+ [CEReactions] undefined surroundContents(Node newParent);
[NewObject] Range cloneRange();
- void detach();
+ undefined detach();
boolean isPointInRange(Node node, unsigned long offset);
short comparePoint(Node node, unsigned long offset);
@@ -7669,7 +7778,7 @@ interface Range : AbstractRange {
@@ -7743,16 +7852,15 @@ but not its end node, or vice versa.
Range() constructor, when invoked, must return
-a new live range with
-(current global object's associated Document, 0) as its
-start and end.
+new Range() constructor steps are
+to set this's start and end to
+(current global object's associated Document, 0).
-commonAncestorContainer attribute's getter must
-run these steps:
+commonAncestorContainer getter steps are:
-
-
-
-setStart(node, offset) method,
-when invoked, must set the start of this to boundary point
+setStart(node, offset) method
+steps are to set the start of this to boundary point
(node, offset).
-setEnd(node, offset) method,
-when invoked, must set the end of this to boundary point
+setEnd(node, offset) method
+steps are to set the end of this to boundary point
(node, offset).
-setStartBefore(node) method, when
-invoked, must run these steps:
+setStartBefore(node) method steps are:
-setStartAfter(node) method, when invoked,
-must run these steps:
+setStartAfter(node) method steps are:
-setEndBefore(node), when invoked, method
-must run these steps:
+setEndBefore(node) method steps are:
-setEndAfter(node) method, when invoked,
-must run these steps:
+setEndAfter(node) method steps are:
-collapse(toStart) method, when invoked,
-must if toStart is true, set end to start, and set
-start to end otherwise.
+collapse(toStart) method steps are to, if
+toStart is true, set end to start; otherwise set
+start to end.
selectNode(node) method, when invoked,
-must select node within this.
+selectNode(node) method steps are to
+select node within this.
-selectNodeContents(node) method, when
-invoked, must run these steps:
+selectNodeContents(node) method steps
+are:
compareBoundaryPoints(how, sourceRange)
-method, when invoked, must run these steps:
+method steps are:
-deleteContents() method, when invoked, must
-run these steps:
+deleteContents() method steps are:
-
@@ -8332,11 +8426,9 @@ run these steps:
fragment.
@@ -8389,8 +8481,8 @@ run these steps:
-extractContents() method, when invoked, must return
-the result of extracting this.
+extractContents() method steps are to return the
+result of extracting this.
@@ -8556,11 +8646,9 @@ of a live range range, run these steps:
@@ -8605,16 +8693,16 @@ of a live range range, run these steps:
-cloneContents() method, when invoked, must return
-the result of cloning the contents of this.
+cloneContents() method steps are to return the
+result of cloning the contents of this.
-insertNode(node) method, when invoked,
-must insert node into this.
+insertNode(node) method steps are to
+insert node into this.
-surroundContents(newParent) method, when
-invoked, must run these steps:
+surroundContents(newParent) method steps
+are:
-
-cloneRange() method, when invoked, must return a new
+cloneRange() method steps are to return a new
live range with the same start and end as this.
-detach() method, when invoked, must do nothing.
+detach() method steps are to do nothing.
Its functionality (disabling a {{Range}} object) was removed, but the method itself
is preserved for compatibility.
@@ -8784,7 +8872,7 @@ is preserved for compatibility.
isPointInRange(node, offset)
-method, when invoked, must run these steps:
+method steps are:
@@ -8821,7 +8909,7 @@ method, when invoked, must run these steps:
comparePoint(node, offset)
-method, when invoked, must run these steps:
+method steps are:
@@ -8855,8 +8943,7 @@ and Opera Next 12.00 alpha all do. -->
-intersectsNode(node) method, when
-invoked, must run these steps:
+intersectsNode(node) method steps are:
@@ -8899,20 +8986,20 @@ these steps:
-
-root attribute's getter, when invoked,
-must return this's root.
+root getter steps are to return
+this's root.
-referenceNode attribute's getter, when
-invoked, must return this's reference.
+referenceNode getter steps are to return
+this's reference.
-pointerBeforeReferenceNode attribute's
-getter, when invoked, must return this's pointer before reference.
+pointerBeforeReferenceNode getter steps
+are to return this's pointer before reference.
-whatToShow attribute's getter, when
-invoked, must return this's whatToShow.
+whatToShow getter steps are to return
+this's whatToShow.
-filter attribute's getter, when invoked,
-must return this's filter.
+filter getter steps are to return
+this's filter.
nextNode() method, when invoked, must return
-the result of traversing with this and next.
+nextNode() method steps are to return the
+result of traversing with this and next.
-previousNode() method, when invoked, must
-return the result of traversing with this and previous.
+previousNode() method steps are to return the
+result of traversing with this and previous.
-detach() method, when invoked, must do
-nothing. Its functionality (disabling a {{NodeIterator}} object) was removed, but
-the method itself is preserved for compatibility.
+detach() method steps are to do nothing.
+Its functionality (disabling a {{NodeIterator}} object) was removed, but the method
+itself is preserved for compatibility.
Interface {{TreeWalker}}
@@ -9135,34 +9222,33 @@ interface TreeWalker {
Node? nextNode();
};
-root attribute's getter, when invoked, must
-return this's root.
+root getter steps are to return
+this's root.
-whatToShow attribute's getter, when invoked,
-must return this's whatToShow.
+whatToShow getter steps are to return
+this's whatToShow.
-filter attribute's getter, when invoked,
-must return this's filter.
+filter getter steps are to return
+this's filter.
-currentNode attribute's getter, when
-invoked, must return this's current.
+currentNode getter steps are to return
+this's current.
-
-parentNode() method, when invoked, must run
-these steps:
+parentNode() method steps are:
firstChild() method, when invoked, must
+firstChild() method steps are to
traverse children with this and first.
-lastChild() method, when invoked, must
+lastChild() method steps are to
traverse children with this and last.
nextSibling() method, when invoked, must
+nextSibling() method steps are to
traverse siblings with this and next.
-previousSibling() method, when invoked, must
+previousSibling() method steps are to
traverse siblings with this and previous.
-previousNode() method, when invoked, must run
-these steps:
+previousNode() method steps are:
nextNode() method, when invoked, must run these
-steps:
+nextNode() method steps are:
-
+
FILTER_ACCEPT (1);
FILTER_REJECT (2);
FILTER_SKIP (3).
@@ -9442,7 +9526,7 @@ JavaScript function.
+
SHOW_ALL (4294967295, FFFFFFFF in hexadecimal);
SHOW_ELEMENT (1);
SHOW_ATTRIBUTE (2);
@@ -9459,18 +9543,18 @@ JavaScript function.
Sets
-Interface {{DOMTokenList}}
-
+
[Exposed=Window]
interface DOMTokenList {
readonly attribute unsigned long length;
getter DOMString? item(unsigned long index);
boolean contains(DOMString token);
- [CEReactions] void add(DOMString... tokens);
- [CEReactions] void remove(DOMString... tokens);
+ [CEReactions] undefined add(DOMString... tokens);
+ [CEReactions] undefined remove(DOMString... tokens);
[CEReactions] boolean toggle(DOMString token, optional boolean force);
[CEReactions] boolean replace(DOMString token, DOMString newToken);
boolean supports(DOMString token);
@@ -9483,7 +9567,7 @@ interface DOMTokenList {
token set (a set), which is
initially empty.
-
-
@@ -9550,7 +9634,7 @@ are to return the result of running get an attribute value given the asso
value, value, and null.
+
-tokenlist . {{DOMTokenList/length}}
tokenlist . {{DOMTokenList/contains(token)}}
- tokenlist . add(tokens…)
tokenlist . replace(token, newToken)
item(index) method, when
-invoked, must run these steps:
+item(index) method steps are:
-contains(token) method, when
-invoked, must return true if this's token set[token] exists,
-and false otherwise.contains(token) method steps are
+to return true if this's token set[token] exists; otherwise
+false.
add(tokens…)
-method, when invoked, must run these steps:
+method steps are:
remove(tokens…)
-method, when invoked, must run these steps:
+method steps are:
toggle(token, force)
-method, when invoked, must run these steps:
+method steps are:
-replace(token, newToken)
-method, when invoked, must run these steps:
+method steps are:
@@ -9727,12 +9810,12 @@ method, when invoked, must run these steps:
-supports(token)
-method, when invoked, must run these steps:
+method steps are:
Historical
-
-XSLT
+DOM Events
-Interface {{XSLTProcessor}}
-
-
-
-
-DOM Core
-
-
+[Exposed=Window]
+interface XSLTProcessor {
+ constructor();
+ undefined importStylesheet(Node style);
+ [CEReactions] DocumentFragment transformToFragment(Node source, Document output);
+ [CEReactions] Document transformToDocument(Node source);
+ undefined setParameter([LegacyNullToEmptyString] DOMString namespaceURI, DOMString localName, any value);
+ any getParameter([LegacyNullToEmptyString] DOMString namespaceURI, DOMString localName);
+ undefined removeParameter([LegacyNullToEmptyString] DOMString namespaceURI, DOMString localName);
+ undefined clearParameters();
+ undefined reset();
+};
+
-hasAttributes() and
-attributes moved from {{Node}} to {{Element}}.
-namespaceURI,
-prefix, and
-localName moved from {{Node}} to {{Element}} and
-{{Attr}}.
+Historical
-
-DOMConfiguration
@@ -9889,22 +9962,23 @@ the web platform. Implementations conforming to this specification will not supp
DOMUserData
Entity
EntityReference
+ MutationEvent
+ MutationNameEvent
NameList
Notation
+ RangeException
TypeInfo
UserDataHandler
-
-
-
-
isSupported
- getFeature()
- getUserData()
- setUserData()
+ schemaTypeInfo
+ isId
renameNode()
-
-
- getFeature()
+ entities
+ notations
+ internalSubset
-
schemaTypeInfo
- isId
+ getFeature()
setIdAttributeNode()
-
-
+
+ entities
- notations
- internalSubset
+ isSupported
+ getFeature()
+ getUserData()
+ setUserData()
+
+
isElementContentWhitespace
replaceWholeText()
-DOM Ranges
-
-
-
-
-
-DOM Traversal
-
-
+
+
-
Acknowledgments
@@ -10004,17 +10066,21 @@ Anthony Ramine,
Arkadiusz Michalski,
Arnaud Le Hors,
Arun Ranganathan,
+Benjamin Gruenbaum,
Björn Höhrmann,
Boris Zbarsky,
Brandon Payton,
Brandon Slade,
Brandon Wallace,
Brian Kardell,
+C. Scott Ananian,
Cameron McCormack,
Chris Dumez,
Chris Paris,
Chris Rebert,
Cyrille Tuzi,
+Dan Burzo,
+Daniel Clark,
Daniel Glazman,
Darin Fisher,
David Bruant,
@@ -10054,6 +10120,7 @@ Jake Archibald,
Jake Verbaten,
James Graham,
James Greene,
+James M Snell,
James Robinson,
Jeffrey Yasskin,
Jens Lindström,
@@ -10071,13 +10138,16 @@ Joshua Bell,
J. S. Choi,
Jungkee Song,
Justin Summerlin,
+Kagami Sascha Rosylight,
呂康豪 (Kang-Hao Lu),
田村健人 (Kent TAMURA),
+Kevin J. Sung,
Kevin Sweeney,
Kirill Topolyan,
Koji Ishii,
Lachlan Hunt,
Lauren Wood,
+Luca Casonato,
Luke Zielinski,
Magne Andersson,
Majid Valipour,
@@ -10087,6 +10157,7 @@ Manish Tripathi,
Marcos Caceres,
Mark Miller,
Martijn van der Ven,
+Mason Freed,
Mats Palmgren,
Mounir Lamouri,
Michael Stramel,
@@ -10094,6 +10165,7 @@ Michael™ Smith,
Mike Champion,
Mike Taylor,
Mike West,
+Nicolás Peña Moreno,
Ojan Vafai,
Oliver Nightingale,
Olli Pettay,
@@ -10145,10 +10217,13 @@ Veli Şenol,
Vidur Apparao,
Warren He,
Xidorn Quan,
+Yash Handa,
Yehuda Katz,
Yoav Weiss,
Yoichi Osato,
-Yoshinori Sano, and
+Yoshinori Sano,
+Yu Han,
+Yusuke Abe, and
Zack Weinberg
for being awesome!
@@ -10157,10 +10232,8 @@ for being awesome!
with substantial contributions from Aryeh Gregor (ayg@aryeh.name)
and Ms2ger (ms2ger@gmail.com).
-
+Group: WHATWG
+Date: 2020-06-15
+H1: DOM
+Shortname: dom
+Text Macro: TWITTER thedomstandard
+Abstract: DOM defines a platform-neutral model for events, aborting activities, and node trees.
+Translation: ja https://triple-underscore.github.io/DOM4-ja.html
+Translate IDs: slottable slotable
+Ignored Terms: EmptyString, Array, Document
+Indent: 1
+
+
+
+urlPrefix: https://www.w3.org/TR/xml/#NT-
+ type: type
+ text: Name; url: Name
+ text: Char; url: Char
+ text: PubidChar; url: PubidChar
+urlPrefix: https://www.w3.org/TR/xml-names/#NT-
+ type: type
+ text: QName; url: QName
+url: https://w3c.github.io/DOM-Parsing/#dfn-createcontextualfragment-fragment
+ type: method; text: createContextualFragment(); for: Range
+type: interface
+ url: https://w3c.github.io/touch-events/#idl-def-touchevent
+ text: TouchEvent
+ url: https://w3c.github.io/deviceorientation/spec-source-orientation.html#devicemotion
+ text: DeviceMotionEvent
+ text: DeviceOrientationEvent
+ url: https://www.khronos.org/registry/webgl/specs/latest/1.0/#5.15
+ text: WebGLContextEvent
+urlPrefix: https://tc39.github.io/ecma262/#; spec: ECMASCRIPT
+ text: Construct; url: sec-construct; type: abstract-op
+ type: dfn
+ text: Realm; url: realm
+ text: surrounding agent; url: surrounding-agent
+urlPrefix: https://w3c.github.io/hr-time/#; spec: HR-TIME
+ type:typedef; urlPrefix: dom-; text: DOMHighResTimeStamp
+ type:dfn; text: time origin; url: dfn-time-origin
+ type:dfn; text: clock resolution
+
+
+
+spec:html; type:element
+ text: title
+ text: script
+spec:infra; type:dfn; text:list
+
+
+Goals
+
+This specification standardizes the DOM. It does so as follows:
+
+
+
+
+
+
+
+
+ Infrastructure
+
+Trees
+
+Ordered sets
+
+
+
+
+Selectors
+
+
+
+
+
+
+Namespaces
+
+Name or QName production.
+
+To validate and extract a namespace and qualifiedName,
+run these steps:
+
+
+
+
+
+
+:" (U+003E), then split the
+ string on it and set prefix to the part before and localName to
+ the part after.
+
+ xml" and namespace is not the
+ XML namespace, then throw a "{{NamespaceError!!exception}}" {{DOMException}}.
+
+ xmlns" and namespace is not the
+ XMLNS namespace, then throw a
+ "{{NamespaceError!!exception}}" {{DOMException}}.
+
+ xmlns", then throw a "{{NamespaceError!!exception}}"
+ {{DOMException}}.
+
+ Events
+
+Introduction to "DOM Events"
+
+Throughout the web platform events are dispatched to objects to signal an
+occurrence, such as network activity or user interaction. These objects implement the
+{{EventTarget}} interface and can therefore add event listeners to observe
+events by calling {{EventTarget/addEventListener()}}:
+
+
+obj.addEventListener("load", imgFetched)
+
+function imgFetched(ev) {
+ // great success
+ …
+}
+
+
+Event listeners can be removed
+by utilizing the
+{{EventTarget/removeEventListener()}}
+method, passing the same arguments.
+
+Events are objects too and implement the
+{{Event}} interface (or a derived interface). In the example above
+ev is the event. ev is
+passed as an argument to the
+event listener's callback
+(typically a JavaScript Function as shown above).
+Event listeners key off the
+event's
+{{Event/type}} attribute value
+("load" in the above example). The
+event's
+{{Event/target}} attribute value returns the
+object to which the event was
+dispatched
+(obj above).
+
+
+// add an appropriate event listener
+obj.addEventListener("cat", function(e) { process(e.detail) })
+
+// create and dispatch the event
+var event = new CustomEvent("cat", {"detail":{"hazcheeseburger":true}})
+obj.dispatchEvent(event)
+
+
+Apart from signaling, events are
+sometimes also used to let an application control what happens next in an
+operation. For instance as part of form submission an
+event whose
+{{Event/type}} attribute value is
+"submit" is
+dispatched. If this
+event's
+{{Event/preventDefault()}} method is
+invoked, form submission will be terminated. Applications who wish to make
+use of this functionality through events
+dispatched by the application
+(synthetic events) can make use of the return value of the
+{{EventTarget/dispatchEvent()}} method:
+
+
+if(obj.dispatchEvent(event)) {
+ // event was not canceled, time for some magic
+ …
+}
+
+
+When an event is
+dispatched to an object that
+participates in a
+tree (e.g. an
+element), it can reach
+event listeners on that object's
+ancestors too. First all object's
+ancestor
+event listeners whose
+capture variable is set to true are invoked, in
+tree order. Second, object's own
+event listeners are invoked. And
+finally, and only if event's
+{{Event/bubbles}} attribute value is true,
+object's ancestor
+event listeners are invoked again,
+but now in reverse tree order.
+
+Let's look at an example of how events work in a tree:
+
+
+<!doctype html>
+<html>
+ <head>
+ <title>Boring example</title>
+ </head>
+ <body>
+ <p>Hello <span id=x>world</span>!</p>
+ <script>
+ function test(e) {
+ debug(e.target, e.currentTarget, e.eventPhase)
+ }
+ document.addEventListener("hey", test, {capture: true})
+ document.body.addEventListener("hey", test)
+ var ev = new Event("hey", {bubbles:true})
+ document.getElementById("x").dispatchEvent(ev)
+ </script>
+ </body>
+</html>
+
+
+The debug function will be invoked twice. Each time the event's
+{{Event/target}} attribute value will be the
+span element. The
+first time {{Event/currentTarget}} attribute's
+value will be the document, the second
+time the body element.
+{{Event/eventPhase}} attribute's value
+switches from {{Event/CAPTURING_PHASE}}
+to {{Event/BUBBLING_PHASE}}. If an
+event listener was registered for
+the span element,
+{{Event/eventPhase}} attribute's value
+would have been {{Event/AT_TARGET}}.
+
+
+Interface {{Event}}
+
+
+[Exposed=(Window,Worker,AudioWorklet)]
+interface Event {
+ constructor(DOMString type, optional EventInit eventInitDict = {});
+
+ readonly attribute DOMString type;
+ readonly attribute EventTarget? target;
+ readonly attribute EventTarget? srcElement; // historical
+ readonly attribute EventTarget? currentTarget;
+ sequence<EventTarget> composedPath();
+
+ const unsigned short NONE = 0;
+ const unsigned short CAPTURING_PHASE = 1;
+ const unsigned short AT_TARGET = 2;
+ const unsigned short BUBBLING_PHASE = 3;
+ readonly attribute unsigned short eventPhase;
+
+ void stopPropagation();
+ attribute boolean cancelBubble; // historical alias of .stopPropagation
+ void stopImmediatePropagation();
+
+ readonly attribute boolean bubbles;
+ readonly attribute boolean cancelable;
+ attribute boolean returnValue; // historical
+ void preventDefault();
+ readonly attribute boolean defaultPrevented;
+ readonly attribute boolean composed;
+
+ [LegacyUnforgeable] readonly attribute boolean isTrusted;
+ readonly attribute DOMHighResTimeStamp timeStamp;
+
+ void initEvent(DOMString type, optional boolean bubbles = false, optional boolean cancelable = false); // historical
+};
+
+dictionary EventInit {
+ boolean bubbles = false;
+ boolean cancelable = false;
+ boolean composed = false;
+};
+
+
+relatedTarget attribute. [[UIEVENTS]]
+
+
+
+
+event = new Event(type [, eventInitDict])
+ event . {{Event/type}}
+ click", "hashchange", or
+ "submit".
+
+ event . {{Event/target}}
+ event . {{Event/currentTarget}}
+ event . {{Event/composedPath()}}
+ closed" that are not reachable from event's
+ {{Event/currentTarget}}.
+
+ event . {{Event/eventPhase}}
+ event . stopPropagation()
+ event . stopImmediatePropagation()
+ event . {{Event/bubbles}}
+ event . {{Event/cancelable}}
+ event . preventDefault()
+ event . {{Event/defaultPrevented}}
+ event . {{Event/composed}}
+ event . {{Event/isTrusted}}
+ event . {{Event/timeStamp}}
+ type attribute must return the value it was
+initialized to. When an event is created the attribute must be initialized to the empty
+string.
+
+target attribute's getter, when invoked, must
+return this's target.
+
+srcElement attribute's getter, when invoked, must
+return this's target.
+
+currentTarget attribute must return the value it
+was initialized to. When an event is created the attribute must be initialized to null.
+
+composedPath() method, when invoked, must run these
+steps:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ eventPhase attribute must return the value it was
+initialized to, which must be one of the following:
+
+
+
+
+
+
+
+
+
+stopPropagation() method, when invoked, must set
+this's stop propagation flag.cancelBubble attribute's getter, when invoked,
+must return true if this's stop propagation flag is set, and false otherwise.
+
+stopImmediatePropagation() method, when invoked,
+must set this's stop propagation flag and this's
+stop immediate propagation flag.bubbles and
+cancelable attributes must return the values they were
+initialized to.
+
+returnValue attribute's getter, when invoked,
+must return false if this's canceled flag is set, and true otherwise.
+
+preventDefault() method, when invoked, must
+set the canceled flag with this.
+
+defaultPrevented attribute's getter, when
+invoked, must return true if this's canceled flag is set, and false otherwise.composed attribute's getter, when invoked, must
+return true if this's composed flag is set, and false otherwise.
+
+isTrusted attribute must return the value it was
+initialized to. When an event is created the attribute must be initialized to false.
+
+timeStamp attribute must return the value it was
+initialized to.
+
+
+
+
+
+
+initEvent(type, bubbles, cancelable)
+method, when invoked, must run these steps:
+
+
+Legacy extensions to the {{Window}} interface
+
+
+partial interface Window {
+ [Replaceable] readonly attribute any event; // historical
+};
+
+
+event attribute's getter, when invoked, must
+return this's current event.
+
+Interface {{CustomEvent}}
+
+
+[Exposed=(Window,Worker)]
+interface CustomEvent : Event {
+ constructor(DOMString type, optional CustomEventInit eventInitDict = {});
+
+ readonly attribute any detail;
+
+ void initCustomEvent(DOMString type, optional boolean bubbles = false, optional boolean cancelable = false, optional any detail = null); // historical
+};
+
+dictionary CustomEventInit : EventInit {
+ any detail = null;
+};
+
+
+Events using the
+{{CustomEvent}} interface can be used to carry custom data.
+
+
+
+
+event = new CustomEvent(type [, eventInitDict])
+ event . {{CustomEvent/detail}}
+ detail attribute must return the value it
+was initialized to.
+
+initCustomEvent(type, bubbles, cancelable, detail)
+method must, when invoked, run these steps:
+
+
+
+
+
+Constructing events
+
+Specifications may define
+event constructing steps for all or some
+events. The algorithm is passed an event as indicated in the
+inner event creation steps.
+
+
+
+
+
+
+
+timestamp property of NSEvent objects.
+
+
+
+
+
+Defining event interfaces
+
+In general, when defining a new interface that inherits from {{Event}} please always ask
+feedback from the WHATWG or the
+W3C WebApps WG community.
+
+The {{CustomEvent}} interface can be used as starting point.
+However, do not introduce any init*Event()
+methods as they are redundant with constructors. Interfaces that inherit
+from the {{Event}} interface that have such a method only have it
+for historical reasons.
+
+
+Interface {{EventTarget}}
+
+
+[Exposed=(Window,Worker,AudioWorklet)]
+interface EventTarget {
+ constructor();
+
+ void addEventListener(DOMString type, EventListener? callback, optional (AddEventListenerOptions or boolean) options = {});
+ void removeEventListener(DOMString type, EventListener? callback, optional (EventListenerOptions or boolean) options = {});
+ boolean dispatchEvent(Event event);
+};
+
+callback interface EventListener {
+ void handleEvent(Event event);
+};
+
+dictionary EventListenerOptions {
+ boolean capture = false;
+};
+
+dictionary AddEventListenerOptions : EventListenerOptions {
+ boolean passive = false;
+ boolean once = false;
+};
+
+
+
+
+
+click. Web compatibility prevented it
+from being removed and it is now the enshrined way of defining an activation of something. [[!HTML]]
+
+
+
+
+target = new EventTarget();
+ target . addEventListener(type, callback [, options])
+ target . removeEventListener(type, callback [, options])
+ target . dispatchEvent(event)
+
+
+
+{{EventListenerOptions/capture}}.
+
+
+
+{{AddEventListenerOptions/passive}} and once to options's
+ {{AddEventListenerOptions/once}}.
+
+ EventTarget() constructor, when invoked,
+must return a new {{EventTarget}}.
+
+
+
+
+addEventListener(type, callback, options)
+method, when invoked, must run these steps:
+
+
+
+
+
+
+
+document.open(). [[HTML]]
+
+removeEventListener(type, callback, options)
+method, when invoked, must run these steps:
+
+
+
+
+dispatchEvent(event) method, when
+invoked, must run these steps:
+
+
+
+
+
+Observing event listeners
+
+Dispatching events
+
+
+
+
+Document otherwise.
+ [[!HTML]]
+
+
+
+
+ click", and false otherwise.
+
+
+
+
+
+
+
+ closed", then set slot-in-closed-tree
+ to true.
+
+
+
+
+
+
+
+
+
+ capturing", and
+ legacyOutputDidListenersThrowFlag if given.
+
+
+
+
+
+ bubbling", and
+ legacyOutputDidListenersThrowFlag if given.
+
+
+
+
+
+
+
+
+
+closed", then set root-of-closed-tree to true.
+
+
+
+
+
+
+
+
+
+
+ Event type Legacy event type
+ " animationend"" webkitAnimationEnd"
+ " animationiteration"" webkitAnimationIteration"
+ " animationstart"" webkitAnimationStart"
+ " transitionend"" webkitTransitionEnd"
+
+
+
+
+
+
+
+ capturing" and listener's
+ capture is false, then continue.
+
+ bubbling" and listener's
+ capture is true, then continue.
+
+
+
+
+ handleEvent", « event », and
+ event's {{Event/currentTarget}} attribute value. If this throws an exception, then:
+
+
+
+
+ Firing events
+
+
+
+
+submit at target with its
+ {{Event/cancelable}} attribute initialized to true".
+
+ click at
+ target using {{MouseEvent}} with its {{UIEvent/detail}} attribute initialized to 1".
+
+
+
+like at target.
+
+ Action versus occurrence
+
+Aborting ongoing activities
+
+
doAmazingness({ ... }) method could accept an {{AbortSignal}} object
+ in order to support aborting as follows:
+
+
+
+
+const controller = new AbortController();
+const signal = controller.signal;
+
+startSpinner();
+
+doAmazingness({ ..., signal })
+ .then(result => ...)
+ .catch(err => {
+ if (err.name == 'AbortError') return;
+ showUserErrorMessage();
+ })
+ .then(() => stopSpinner());
+
+// …
+
+controller.abort();doAmazingness could be implemented as follows:
+
+
+
+
+function doAmazingness({signal}) {
+ if (signal.aborted) {
+ return Promise.reject(new DOMException('Aborted', 'AbortError'));
+ }
+
+ return new Promise((resolve, reject) => {
+ // Begin doing amazingness, and call resolve(result) when done.
+ // But also, watch for signals:
+ signal.addEventListener('abort', () => {
+ // Stop doing amazingness, and:
+ reject(new DOMException('Aborted', 'AbortError'));
+ });
+ });
+}
+Interface {{AbortController}}
+
+
+[Exposed=(Window,Worker)]
+interface AbortController {
+ constructor();
+
+ [SameObject] readonly attribute AbortSignal signal;
+
+ void abort();
+};
+
+
+
+
+
+controller = new AbortController()
+ controller . signal
+ controller . abort()
+ AbortController() constructor, when
+invoked, must run these steps:
+
+
+
+
+signal attribute's getter, when
+invoked, must return this's signal.
+
+abort() method, when invoked, must
+signal abort on this's signal.
+
+
+Interface {{AbortSignal}}
+
+
+[Exposed=(Window,Worker)]
+interface AbortSignal : EventTarget {
+ readonly attribute boolean aborted;
+
+ attribute EventHandler onabort;
+};
+
+
+
+
+signal . aborted
+
+
+
+onabort attribute is an
+event handler IDL attribute for the onabort
+event handler, whose event handler event type is
+abort.
+
+
+
+
+
+
+
+
+
+
+Using {{AbortController}} and {{AbortSignal}} objects in
+APIs
+
+
+
+
+signal dictionary member.
+ doAmazingness(options) could be as
+ follows:
+
+
+
+signal member is present, then:
+
+
+
+
+ signal's [=AbortSignal/aborted flag=] is set, then [=reject=]
+ |p| with an "{{AbortError!!exception}}" {{DOMException}} and return |p|.
+
+ signal:
+
+
+
+
+
+
+ Nodes
+
+Introduction to "The DOM"
+
+In its original sense, "The DOM" is an API for
+accessing and manipulating documents (in particular, HTML and XML
+documents). In this specification, the term "document" is used for any
+markup-based resource, ranging from short static documents to long essays or
+reports with rich multimedia, as well as to fully-fledged interactive
+applications.
+
+
+<!DOCTYPE html>
+<html class=e>
+ <head><title>Aliens?</title></head>
+ <body>Why yes.</body>
+</html>
+
+
+It is represented as follows:
+
+
+
+
+
+
+
+
+
+html
+ html class="e"
+
+
+
+ head
+
+
+
+ title
+
+
+
+ body
+
+
+
+ Node tree
+
+
+
+
+
+
+
+
+
+Document tree
+
+Shadow tree
+
+Slots
+
+
+
+
+name, and
+ namespace is null, then:
+
+
+
+Slottables
+
+
+
+
+slot and namespace is null, then:
+
+
+
+Finding slots and slottables
+
+
+
+
+open", then return null.
+
+
+
+
+
+
+
+
+
+
+
+
+ Assigning slottables and slots
+
+
+
+
+
+
+
+Signaling slot change
+
+
+
+
+
+Mutation algorithms
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ connectedCallback", and an empty argument list.
+
+ connectedCallback will be enqueued automatically during the
+ upgrade an element algorithm.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+NodeIterator pre-removing steps given
+ node and iterator.
+
+
+
+
+ disconnectedCallback", and an empty argument list.
+
+
+
+ disconnectedCallback", and an empty argument list.
+ Mixin {{NonElementParentNode}}
+
+
+interface mixin NonElementParentNode {
+ Element? getElementById(DOMString elementId);
+};
+Document includes NonElementParentNode;
+DocumentFragment includes NonElementParentNode;
+
+
+
+
+
+node . getElementById(elementId)
+ getElementById(elementId)
+method, when invoked, must return the first element, in tree order, within
+this's descendants, whose ID is elementId, and null if
+there is no such element otherwise.
+
+
+Mixin {{DocumentOrShadowRoot}}
+
+
+interface mixin DocumentOrShadowRoot {
+};
+Document includes DocumentOrShadowRoot;
+ShadowRoot includes DocumentOrShadowRoot;
+
+
+Mixin {{ParentNode}}
+
+
+
+
+
+interface mixin ParentNode {
+ [SameObject] readonly attribute HTMLCollection children;
+ readonly attribute Element? firstElementChild;
+ readonly attribute Element? lastElementChild;
+ readonly attribute unsigned long childElementCount;
+
+ [CEReactions, Unscopable] void prepend((Node or DOMString)... nodes);
+ [CEReactions, Unscopable] void append((Node or DOMString)... nodes);
+ [CEReactions, Unscopable] void replaceChildren((Node or DOMString)... nodes);
+
+ Element? querySelector(DOMString selectors);
+ [NewObject] NodeList querySelectorAll(DOMString selectors);
+};
+Document includes ParentNode;
+DocumentFragment includes ParentNode;
+Element includes ParentNode;
+
+
+
+
+
+collection = node . {{ParentNode/children}}
+ element = node . {{ParentNode/firstElementChild}}
+ element = node . {{ParentNode/lastElementChild}}
+ node . prepend(nodes)
+ node . append(nodes)
+ node . replaceChildren(nodes)
+ node . querySelector(selectors)
+ node . querySelectorAll(selectors)
+ children attribute's getter must return an
+{{HTMLCollection}} collection rooted at this matching only element
+children.
+
+firstElementChild attribute's getter must
+return the first child that is an element, and null otherwise.
+
+lastElementChild attribute's getter must
+return the last child that is an element, and null otherwise.
+
+childElementCount attribute's getter must
+return the number of children of this that are elements.
+
+prepend(nodes) method, when invoked,
+must run these steps:
+
+
+
+
+append(nodes) method, when invoked,
+must run these steps:
+
+
+
+
+replaceChildren(nodes) method, when invoked,
+must run these steps:
+
+
+
+
+querySelector(selectors) method,
+when invoked, must return the first result of running scope-match a selectors string
+selectors against this, if the result is not an empty list, and null otherwise.
+
+querySelectorAll(selectors)
+method, when invoked, must return the static result of running
+scope-match a selectors string selectors against this.
+
+
+Mixin {{NonDocumentTypeChildNode}}
+
+
+interface mixin NonDocumentTypeChildNode {
+ readonly attribute Element? previousElementSibling;
+ readonly attribute Element? nextElementSibling;
+};
+Element includes NonDocumentTypeChildNode;
+CharacterData includes NonDocumentTypeChildNode;
+
+
+
+
+
+element = node . {{previousElementSibling}}
+ element = node . {{nextElementSibling}}
+ previousElementSibling
+attribute's getter must return the first preceding sibling that is an
+element, and null otherwise.
+
+nextElementSibling attribute's
+getter must return the first following sibling that is an
+element, and null otherwise.
+
+
+Mixin {{ChildNode}}
+
+
+interface mixin ChildNode {
+ [CEReactions, Unscopable] void before((Node or DOMString)... nodes);
+ [CEReactions, Unscopable] void after((Node or DOMString)... nodes);
+ [CEReactions, Unscopable] void replaceWith((Node or DOMString)... nodes);
+ [CEReactions, Unscopable] void remove();
+};
+DocumentType includes ChildNode;
+Element includes ChildNode;
+CharacterData includes ChildNode;
+
+
+
+
+
+node . {{before(...nodes)}}
+ node . {{after(...nodes)}}
+ node . {{replaceWith(...nodes)}}
+ node . {{ChildNode/remove()}}
+ before(nodes) method, when invoked,
+must run these steps:
+
+
+
+
+after(nodes) method, when invoked,
+must run these steps:
+
+
+
+
+replaceWith(nodes) method, when
+invoked, must run these steps:
+
+
+
+
+remove() method, when invoked, must run these
+steps:
+
+Mixin {{Slottable}}
+
+
+interface mixin Slottable {
+ readonly attribute HTMLSlotElement? assignedSlot;
+};
+Element includes Slottable;
+Text includes Slottable;
+
+
+assignedSlot
+attribute's getter must return the result of find a slot given this and with the
+open flag set.Old-style collections: {{NodeList}} and {{HTMLCollection}}
+
+A collection is an object that represents a list of
+nodes. A collection can be either
+live
+or static.
+Unless otherwise stated, a collection must be live.
+
+If a collection is live, then the attributes and methods
+on that object must operate on the actual underlying data, not a snapshot of
+the data.
+
+When a collection is created, a
+filter and a root are associated with it.
+
+The collection then
+represents
+a view of the subtree rooted at the collection's root, containing only nodes that match the
+given filter. The view is linear. In the absence of specific requirements to the contrary, the nodes
+within the collection must be sorted in tree order.
+
+
+Interface {{NodeList}}
+
+
+[Exposed=Window]
+interface NodeList {
+ getter Node? item(unsigned long index);
+ readonly attribute unsigned long length;
+ iterable<Node>;
+};
+
+
+
+
+
+item(index) method must return the
+indexth node in the collection. If there is no
+indexth node in the collection, then the method must return
+null.
+
+Interface {{HTMLCollection}}
+
+
+[Exposed=Window, LegacyUnenumerableNamedProperties]
+interface HTMLCollection {
+ readonly attribute unsigned long length;
+ getter Element? item(unsigned long index);
+ getter Element? namedItem(DOMString name);
+};
+
+
+sequence<T> in IDL instead).
+
+
+
+
+length attribute's getter must return
+the number of nodes represented by the collection.
+
+item(index) method, when
+invoked, must return the indexth element in the
+collection. If there is no indexth element in the
+collection, then the method must return null.
+
+
+
+
+
+
+
+ name attribute whose value is neither
+ the empty string nor is in result, append element's
+ name attribute value to
+ result.
+ namedItem(key) method, when
+invoked, must run these steps:
+
+
+
+
+
+
+
+
+
+ name attribute whose value is
+ key;
+ Mutation observers
+
+
+
+
+
+
+
+
+
+
+
+
+Interface {{MutationObserver}}
+
+
+[Exposed=Window]
+interface MutationObserver {
+ constructor(MutationCallback callback);
+
+ void observe(Node target, optional MutationObserverInit options = {});
+ void disconnect();
+ sequence<MutationRecord> takeRecords();
+};
+
+callback MutationCallback = void (sequence<MutationRecord> mutations, MutationObserver observer);
+
+dictionary MutationObserverInit {
+ boolean childList = false;
+ boolean attributes;
+ boolean characterData;
+ boolean subtree = false;
+ boolean attributeOldValue;
+ boolean characterDataOldValue;
+ sequence<DOMString> attributeFilter;
+};
+
+
+
+
+
+
+
+
+observer = new {{MutationObserver(callback)}}
+ observer . {{observe(target, options)}}
+
+
+
+ observer . {{disconnect()}}
+ observer . {{takeRecords()}}
+ MutationObserver(callback)
+constructor, when invoked, must run these steps:
+
+
+
+
+observe(target, options)
+method, when invoked, must run these steps:
+
+
+
+
+TypeError.
+
+ TypeError.
+
+ TypeError.
+
+ TypeError.
+
+
+
+
+
+
+disconnect() method, when invoked, must
+run these steps:
+
+
+
+
+takeRecords() method, when invoked, must
+run these steps:
+
+
+
+
+
+Queuing a mutation record
+
+
+
+
+
+
+
+
+
+
+ attributes" and options's
+ {{MutationObserverInit/attributes}} is not true
+
+
+ attributes", options's
+ {{MutationObserverInit/attributeFilter}} is present, and options's
+ {{MutationObserverInit/attributeFilter}} does not contain name or
+ namespace is non-null
+
+ characterData" and options's
+ {{MutationObserverInit/characterData}} is not true
+
+
+ childList" and options's
+ {{MutationObserverInit/childList}} is false
+
+
+ attributes" and options's
+ {{MutationObserverInit/attributeOldValue}} is true, or type is
+ "characterData" and options's
+ {{MutationObserverInit/characterDataOldValue}} is true, then set
+ interestedObservers[mo] to oldValue.
+
+
+
+
+
+
+
+childList" for target with
+ null, null, null, addedNodes, removedNodes, previousSibling,
+ and nextSibling.
+Interface {{MutationRecord}}
+
+
+[Exposed=Window]
+interface MutationRecord {
+ readonly attribute DOMString type;
+ [SameObject] readonly attribute Node target;
+ [SameObject] readonly attribute NodeList addedNodes;
+ [SameObject] readonly attribute NodeList removedNodes;
+ readonly attribute Node? previousSibling;
+ readonly attribute Node? nextSibling;
+ readonly attribute DOMString? attributeName;
+ readonly attribute DOMString? attributeNamespace;
+ readonly attribute DOMString? oldValue;
+};
+
+
+
+
+
+record . {{MutationRecord/type}}
+ attributes" if it was an
+ attribute mutation.
+ "characterData" if it was a mutation to a
+ {{CharacterData}} node. And
+ "childList" if it was a mutation to the
+ tree of
+ nodes.
+
+ record . {{MutationRecord/target}}
+ attributes", it is the
+ element whose
+ attribute changed. For
+ "characterData", it is the {{CharacterData}}
+ node. For "childList",
+ it is the node whose
+ children changed.
+
+ record . {{MutationRecord/addedNodes}}
+ record . {{MutationRecord/removedNodes}}
+ record . {{MutationRecord/previousSibling}}
+ record . {{MutationRecord/nextSibling}}
+ record . {{MutationRecord/attributeName}}
+ record . {{MutationRecord/attributeNamespace}}
+ record . {{MutationRecord/oldValue}}
+ attributes", it is the
+ value of the
+ changed attribute before the change.
+ For "characterData", it is the
+ data of the changed
+ node before the change. For
+ "childList", it is null.
+Garbage collection
+
+Interface {{Node}}
+
+
+[Exposed=Window]
+interface Node : EventTarget {
+ const unsigned short ELEMENT_NODE = 1;
+ const unsigned short ATTRIBUTE_NODE = 2;
+ const unsigned short TEXT_NODE = 3;
+ const unsigned short CDATA_SECTION_NODE = 4;
+ const unsigned short ENTITY_REFERENCE_NODE = 5; // historical
+ const unsigned short ENTITY_NODE = 6; // historical
+ const unsigned short PROCESSING_INSTRUCTION_NODE = 7;
+ const unsigned short COMMENT_NODE = 8;
+ const unsigned short DOCUMENT_NODE = 9;
+ const unsigned short DOCUMENT_TYPE_NODE = 10;
+ const unsigned short DOCUMENT_FRAGMENT_NODE = 11;
+ const unsigned short NOTATION_NODE = 12; // historical
+ readonly attribute unsigned short nodeType;
+ readonly attribute DOMString nodeName;
+
+ readonly attribute USVString baseURI;
+
+ readonly attribute boolean isConnected;
+ readonly attribute Document? ownerDocument;
+ Node getRootNode(optional GetRootNodeOptions options = {});
+ readonly attribute Node? parentNode;
+ readonly attribute Element? parentElement;
+ boolean hasChildNodes();
+ [SameObject] readonly attribute NodeList childNodes;
+ readonly attribute Node? firstChild;
+ readonly attribute Node? lastChild;
+ readonly attribute Node? previousSibling;
+ readonly attribute Node? nextSibling;
+
+ [CEReactions] attribute DOMString? nodeValue;
+ [CEReactions] attribute DOMString? textContent;
+ [CEReactions] void normalize();
+
+ [CEReactions, NewObject] Node cloneNode(optional boolean deep = false);
+ boolean isEqualNode(Node? otherNode);
+ boolean isSameNode(Node? otherNode); // historical alias of ===
+
+ const unsigned short DOCUMENT_POSITION_DISCONNECTED = 0x01;
+ const unsigned short DOCUMENT_POSITION_PRECEDING = 0x02;
+ const unsigned short DOCUMENT_POSITION_FOLLOWING = 0x04;
+ const unsigned short DOCUMENT_POSITION_CONTAINS = 0x08;
+ const unsigned short DOCUMENT_POSITION_CONTAINED_BY = 0x10;
+ const unsigned short DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC = 0x20;
+ unsigned short compareDocumentPosition(Node other);
+ boolean contains(Node? other);
+
+ DOMString? lookupPrefix(DOMString? namespace);
+ DOMString? lookupNamespaceURI(DOMString? prefix);
+ boolean isDefaultNamespace(DOMString? namespace);
+
+ [CEReactions] Node insertBefore(Node node, Node? child);
+ [CEReactions] Node appendChild(Node node);
+ [CEReactions] Node replaceChild(Node node, Node child);
+ [CEReactions] Node removeChild(Node child);
+};
+
+dictionary GetRootNodeOptions {
+ boolean composed = false;
+};
+
+
+
+
+
+
+
+The nodeType attribute's getter, when invoked, must return
+the first matching statement, switching on this:
+
+node . {{Node/nodeType}}
+
+
+
+ {{Node}} . {{Node/ELEMENT_NODE}} (1)
+ {{Node}} . {{Node/TEXT_NODE}} (3)
+ {{Node}} . {{Node/CDATA_SECTION_NODE}} (4)
+ {{Node}} . {{Node/PROCESSING_INSTRUCTION_NODE}} (7)
+ {{Node}} . {{Node/COMMENT_NODE}} (8)
+ {{Node}} . {{Node/DOCUMENT_NODE}} (9)
+ {{Node}} . {{Node/DOCUMENT_TYPE_NODE}} (10)
+ {{Node}} . {{Node/DOCUMENT_FRAGMENT_NODE}} (11)
+ node . {{Node/nodeName}}
+
+
+#text".
+
+ #cdata-section".
+
+ #comment".
+
+ #document".
+
+ #document-fragment".
+
+
+
+
+
+
+
+
+#text".
+
+ #cdata-section".
+
+ #comment".
+
+ #document".
+
+ #document-fragment".
+
+
+
+
+
+The node . {{Node/baseURI}}
+ baseURI attribute's getter must return
+node document's document base URL, serialized.
+
+
+
+
+
+
+node . {{Node/isConnected}}
+ node . {{Node/ownerDocument}}
+ node . {{Node/getRootNode()}}
+ node . getRootNode({ composed:true })
+ node . {{Node/parentNode}}
+ node . {{Node/parentElement}}
+ node . {{Node/hasChildNodes()}}
+ node . {{Node/childNodes}}
+ node . {{Node/firstChild}}
+ node . {{Node/lastChild}}
+ node . {{Node/previousSibling}}
+ node . {{Node/nextSibling}}
+ isConnected attribute's getter must return true,
+if this is connected, and false otherwise.ownerDocument attribute's getter must return null,
+if this is a document, and this's node document otherwise.
+
+getRootNode(options) method, when invoked,
+must return this's shadow-including root if options's
+{{GetRootNodeOptions/composed}} is true, and this's root otherwise.
+
+parentNode attribute's getter must return
+this's parent.
+
+parentElement attribute's getter must return
+this's parent element.
+
+hasChildNodes() method, when invoked, must return
+true if this has children, and false otherwise.
+
+childNodes attribute's getter must return a
+{{NodeList}} rooted at this matching only children.
+
+firstChild attribute's getter must return
+this's first child.
+
+lastChild attribute's getter must return
+this's last child.
+
+previousSibling attribute's getter must return
+this's previous sibling.
+
+nextSibling attribute's getter must return
+this's next sibling.
+
+
+
+
+
+The nodeValue attribute
+must return the following, depending on this:
+
+
+
+
+The {{Node/nodeValue}} attribute must,
+on setting, if the new value is null, act as if it was the empty string
+instead, and then do as described below, depending on this:
+
+
+
+
+textContent attribute's getter must return the
+following, switching on this:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+node . {{Node/normalize()}}
+ Text nodes and concatenates the
+ data of remaining contiguous exclusive Text nodes
+ into the first of their nodes.
+normalize() method, when invoked, must run these
+steps for each descendant exclusive Text node node of
+this:
+
+
+
+
+Text node, if any.
+
+ Text nodes (excluding itself), in
+ tree order.
+
+ Text node:
+
+
+
+
+ Text nodes
+ (excluding itself), in tree order.
+
+
+
+
+
+node . cloneNode([deep = false])
+ node . {{Node/isEqualNode(otherNode)}}
+
+
+
+
+
+ is value, with the synchronous custom elements
+ flag unset.
+
+
+
+
+ cloneNode(deep) method, when
+invoked, must run these steps:
+
+
+
+
+A node A
+equals a node
+B if all of the following conditions are true:
+
+
+
+
+
+
+ isEqualNode(otherNode) method, when
+invoked, must return true if otherNode is non-null and this equals
+otherNode, and false otherwise.
+
+isSameNode(otherNode) method, when
+invoked, must return true if otherNode is this, and false otherwise.
+
+
+
+
+
+
+These are the constants
+{{compareDocumentPosition()}}
+returns as mask:
+
+node . {{compareDocumentPosition(other)}}
+
+
+
+ {{Node}} . {{Node/DOCUMENT_POSITION_DISCONNECTED}} (1)
+ {{Node}} . {{Node/DOCUMENT_POSITION_PRECEDING}} (2)
+ {{Node}} . {{Node/DOCUMENT_POSITION_FOLLOWING}} (4)
+ {{Node}} . {{Node/DOCUMENT_POSITION_CONTAINS}} (8)
+ {{Node}} . {{Node/DOCUMENT_POSITION_CONTAINED_BY}} (16, 10 in hexadecimal)
+ node . {{Node/contains(other)}}
+
+
+
+compareDocumentPosition(other) method,
+when invoked, must run these steps:
+
+
+
+
+
+
+
+
+
+
+
+ Math.random() value can
+ be used.
+
+ contains(other) method, when invoked, must
+return true if other is an inclusive descendant of this, and false
+otherwise (including when other is null).
+
+
+
+
+
+
+
+
+
+
+xmlns" and value is
+ namespace, then return element's first such attribute's
+ local name.
+
+
+
+
+
+
+
+ xmlns", and
+ local name is prefix, or if prefix is null and it
+ has an attribute whose namespace is the
+ XMLNS namespace, namespace prefix is null, and local name
+ is "xmlns", then return its value if it is not the empty string, and
+ null otherwise.
+
+
+
+
+
+
+
+
+
+lookupPrefix(namespace) method, when
+invoked, must run these steps:
+
+
+
+
+
+
+lookupNamespaceURI(prefix) method, when
+invoked, must run these steps:
+
+
+
+
+isDefaultNamespace(namespace) method, when
+invoked, must run these steps:
+
+
+
+
+
+
+insertBefore(node, child)
+method, when invoked, must return the result of pre-inserting node into
+this before child.
+
+appendChild(node) method, when invoked,
+must return the result of appending node to this.
+
+replaceChild(node, child)
+method, when invoked, must return the result of replacing child with
+node within this.
+
+removeChild(child) method, when invoked,
+must return the result of pre-removing child from this.
+
+
+
+
+
+
+*" (U+002A), return a {{HTMLCollection}} rooted
+ at root, whose filter matches only descendant elements.
+
+
+
+
+
+
+
+When invoked with the same arguments, the same {{HTMLCollection}}
+object may be returned as returned by an earlier call.
+
+
+The
+list of elements with class names classNames
+for a node root is the
+{{HTMLCollection}} returned by the following algorithm:
+*" (U+002A), return a {{HTMLCollection}} rooted at
+ root, whose filter matches
+ descendant
+ elements.
+
+ *"
+ (U+002A), return a {{HTMLCollection}} rooted at
+ root, whose filter matches
+ descendant
+ elements whose
+ local name is
+ localName.
+
+ *"
+ (U+002A), return a {{HTMLCollection}} rooted at
+ root, whose filter matches
+ descendant
+ elements whose
+ namespace is
+ namespace.
+
+
+
+
+When invoked with the same argument, the same {{HTMLCollection}}
+object may be returned as returned by an earlier call.
+
+
+quirks", and in an identical to manner
+ otherwise.
+Interface {{Document}}
+
+
+[Exposed=Window]
+interface Document : Node {
+ constructor();
+
+ [SameObject] readonly attribute DOMImplementation implementation;
+ readonly attribute USVString URL;
+ readonly attribute USVString documentURI;
+ readonly attribute DOMString compatMode;
+ readonly attribute DOMString characterSet;
+ readonly attribute DOMString charset; // historical alias of .characterSet
+ readonly attribute DOMString inputEncoding; // historical alias of .characterSet
+ readonly attribute DOMString contentType;
+
+ readonly attribute DocumentType? doctype;
+ readonly attribute Element? documentElement;
+ HTMLCollection getElementsByTagName(DOMString qualifiedName);
+ HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);
+ HTMLCollection getElementsByClassName(DOMString classNames);
+
+ [CEReactions, NewObject] Element createElement(DOMString localName, optional (DOMString or ElementCreationOptions) options = {});
+ [CEReactions, NewObject] Element createElementNS(DOMString? namespace, DOMString qualifiedName, optional (DOMString or ElementCreationOptions) options = {});
+ [NewObject] DocumentFragment createDocumentFragment();
+ [NewObject] Text createTextNode(DOMString data);
+ [NewObject] CDATASection createCDATASection(DOMString data);
+ [NewObject] Comment createComment(DOMString data);
+ [NewObject] ProcessingInstruction createProcessingInstruction(DOMString target, DOMString data);
+
+ [CEReactions, NewObject] Node importNode(Node node, optional boolean deep = false);
+ [CEReactions] Node adoptNode(Node node);
+
+ [NewObject] Attr createAttribute(DOMString localName);
+ [NewObject] Attr createAttributeNS(DOMString? namespace, DOMString qualifiedName);
+
+ [NewObject] Event createEvent(DOMString interface); // historical
+
+ [NewObject] Range createRange();
+
+ // NodeFilter.SHOW_ALL = 0xFFFFFFFF
+ [NewObject] NodeIterator createNodeIterator(Node root, optional unsigned long whatToShow = 0xFFFFFFFF, optional NodeFilter? filter = null);
+ [NewObject] TreeWalker createTreeWalker(Node root, optional unsigned long whatToShow = 0xFFFFFFFF, optional NodeFilter? filter = null);
+};
+
+[Exposed=Window]
+interface XMLDocument : Document {};
+
+dictionary ElementCreationOptions {
+ DOMString is;
+};
+
+
+{{Document}} nodes are simply
+known as documents.
+
+Each document has an associated
+encoding (an encoding),
+content type (a string),
+URL (a URL),
+origin (an origin),
+type ("xml" or "html"), and
+mode ("no-quirks", "quirks", or "limited-quirks").
+[[!ENCODING]]
+[[!URL]]
+[[!HTML]]
+
+Unless stated otherwise, a document's encoding is the utf-8
+encoding, content type is
+"application/xml", URL is "about:blank",
+origin is an opaque origin,
+type is "xml", and its
+mode is "no-quirks".
+
+A document is said to be an XML document if its
+type is "xml", and an HTML document
+otherwise. Whether a document is an HTML document or an XML document
+affects the behavior of certain APIs.
+
+A document is said to be in
+no-quirks mode if its
+mode is "no-quirks",
+quirks mode if its mode
+is "quirks", and
+limited-quirks mode if its
+mode is "limited-quirks".
+
+about:blank"). [[!HTML]]
+
+ load" or
+document does not have a browsing context, and the document's
+relevant global object otherwise.
+
+
+
+
+
+
+document = new {{Document()}}
+ document . {{Document/implementation}}
+ document . {{Document/URL}}
+ document . {{Document/documentURI}}
+ document . {{Document/compatMode}}
+ BackCompat" if document's
+ mode is "quirks", and "CSS1Compat"
+ otherwise.
+
+ document . {{Document/characterSet}}
+ document . {{Document/contentType}}
+ Document() constructor, when invoked, must
+return a new document whose origin is the origin of
+current global object's associated Document. [[!HTML]]
+
+implementation attribute's getter must return the
+{{DOMImplementation}} object that is associated with the document.
+
+The URL attribute's getter and
+documentURI attribute's getter must return the
+URL, serialized.
+
+The compatMode attribute's getter must
+return "BackCompat" if this's mode is
+"quirks", and "CSS1Compat" otherwise.
+
+The characterSet attribute's getter,
+charset attribute's getter, and
+inputEncoding attribute's getter, must return
+this's encoding's name.
+
+The contentType attribute's getter must return the
+content type.
+
+
+
+
+
+
+The *" returns a {{HTMLCollection}} of all
+ descendant elements.
+
+ *" returns a {{HTMLCollection}} of all
+ descendant
+ elements.
+
+ If only namespace is "*" returns a
+ {{HTMLCollection}} of all
+ descendant
+ elements whose
+ local name is
+ localName.
+
+ If only localName is "*" returns a
+ {{HTMLCollection}} of all
+ descendant
+ elements whose
+ namespace is
+ namespace.
+
+ Otherwise, returns a {{HTMLCollection}} of all
+ descendant
+ elements whose
+ namespace is
+ namespace and
+ local name is
+ localName.
+
+ doctype attribute's getter must return the
+child of the document that is a doctype, and null otherwise.
+
+The documentElement attribute's getter must return
+the document element.
+
+The getElementsByTagName(qualifiedName)
+method, when invoked, must return the
+list of elements with qualified name qualifiedName for this.
+
+document.getElementsByTagName("FOO") will match
+<FOO> elements that are not in the
+HTML namespace, and <foo> elements that are in
+the HTML namespace, but not <FOO> elements
+that are in the HTML namespace.
+
+The
+getElementsByTagNameNS(namespace, localName)
+method, when invoked, must return the
+list of elements with namespace namespace and local name localName for
+this.
+
+The getElementsByClassName(classNames)
+method, when invoked, must return the list of elements with class names classNames
+for this.
+
+
+
+ A call to
+
+ <div id="example">
+ <p id="p1" class="aaa bbb"/>
+ <p id="p2" class="aaa ccc"/>
+ <p id="p3" class="bbb ccc"/>
+ </div>
+ document.getElementById("example").getElementsByClassName("aaa")
+ would return a {{HTMLCollection}} with the two paragraphs
+ p1 and p2 in it.
+
+ A call to
+ getElementsByClassName("ccc bbb")
+ would only return one node, however, namely p3. A call to
+ document.getElementById("example").getElementsByClassName("bbb ccc ")
+ would return the same thing.
+
+ A call to
+ getElementsByClassName("aaa,bbb")
+ would return no nodes; none of the elements above are in the
+ aaa,bbb class.
+
+
+
+
+
+The element interface for any
+name and namespace is {{Element}}, unless
+stated otherwise.
+
+element = document . createElement(localName [, options])
+ application/xhtml+xml", and null otherwise.
+
+ Name production an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}} will be thrown.
+
+ element = document . createElementNS(namespace, qualifiedName [, options])
+
+ :" (U+003E) in
+ qualifiedName or null. Its local name will be everything after
+ ":" (U+003E) in qualifiedName or qualifiedName.
+
+ Name production an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}} will be thrown.
+
+
+
+
+ QName production.
+ xml" and namespace is not the
+ XML namespace.
+ xmlns" and namespace is not the
+ XMLNS namespace.
+ xmlns".
+ documentFragment = document . {{createDocumentFragment()}}
+ text = document . {{createTextNode(data)}}
+ text = document . {{createCDATASection(data)}}
+ comment = document . {{createComment(data)}}
+ processingInstruction = document . {{createProcessingInstruction(target, data)}}
+ Name production an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}} will be thrown.
+ If data contains "?>" an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}} will be thrown.
+html
+and the HTML namespace, the {{HTMLHtmlElement}} interface is used.
+[[!HTML]]
+
+The createElement(localName, options) method, when
+invoked, must run these steps:
+
+
+
+
+Name production, then
+ throw an "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ application/xhtml+xml", and null otherwise.
+
+ createElementNS steps, given document,
+namespace, qualifiedName, and options, are as follows:
+
+
+
+
+createElementNS(namespace, qualifiedName, options)
+method, when invoked, must return the result of running the
+internal createElementNS steps, given this, namespace,
+qualifiedName, and options.
+
+createDocumentFragment() method, when invoked,
+must return a new {{DocumentFragment}} node with its node document set to
+this.
+
+The createTextNode(data) method, when
+invoked, must return a new {{Text}} node with its data set to
+data and node document set to this.
+
+Char production.
+
+createCDATASection(data) method, when
+invoked, must run these steps:
+
+
+
+
+The ]]>", then throw an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ createComment(data) method, when invoked,
+must return a new {{Comment}} node with its data set to
+data and node document set to this.
+
+Char production
+or that it contains two adjacent hyphens or ends with a hyphen.
+
+The
+createProcessingInstruction(target, data)
+method, when invoked, must run these steps:
+
+
+
+
+Name production,
+ then throw an "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ ?>", then throw an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ xml" or ":", or that
+data contains characters that match the
+Char production.
+
+
+
+
+
+
+The importNode(node, deep) method,
+when invoked, must run these steps:
+
+
+
+
+
+
+
+The
+
+
+
+
+ adoptedCallback", and an argument list containing oldDocument and
+ document.
+
+ adoptNode(node) method, when invoked,
+must run these steps:
+
+
+
+
+
+
+The createAttribute(localName) method, when
+invoked, must run these steps:
+
+
+
+
+The
+Name production in XML,
+ then throw an "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ createAttributeNS(namespace, qualifiedName)
+method, when invoked, must run these steps:
+
+
+
+
+
+
+createEvent(interface) method, when
+invoked, must run these steps:
+
+
+
+
+
+
+
+
+ String Interface Notes
+ " beforeunloadevent"{{BeforeUnloadEvent}} [[!HTML]]
+ " compositionevent"{{CompositionEvent}} [[!UIEVENTS]]
+
+ " customevent"{{CustomEvent}}
+ " devicemotionevent"{{DeviceMotionEvent}} [[!DEVICE-ORIENTATION]]
+ " deviceorientationevent"{{DeviceOrientationEvent}}
+ " dragevent"{{DragEvent}} [[!HTML]]
+ " event"{{Event}}
+ " events"
+
+ " focusevent"{{FocusEvent}} [[!UIEVENTS]]
+ " hashchangeevent"{{HashChangeEvent}} [[!HTML]]
+ " htmlevents"{{Event}}
+ " keyboardevent"{{KeyboardEvent}} [[!UIEVENTS]]
+ " messageevent"{{MessageEvent}} [[!HTML]]
+ " mouseevent"{{MouseEvent}} [[!UIEVENTS]]
+ " mouseevents"
+ " storageevent"{{StorageEvent}} [[!HTML]]
+ " svgevents"{{Event}}
+ " textevent"{{CompositionEvent}} [[!UIEVENTS]]
+ " touchevent"{{TouchEvent}} [[!TOUCH-EVENTS]]
+ " uievent"{{UIEvent}} [[!UIEVENTS]]
+ " uievents"
+
+
+createRange() method, when invoked, must return a
+new live range with (this, 0) as its start an end.
+
+
+
+createNodeIterator(root, whatToShow, filter)
+method, when invoked, must run these steps:
+
+
+
+
+createTreeWalker(root, whatToShow, filter)
+method, when invoked, must run these steps:
+
+
+
+
+
+Interface {{DOMImplementation}}
+
+User agents must create a {{DOMImplementation}} object whenever
+a document is created and associate it
+with that document.
+
+
+[Exposed=Window]
+interface DOMImplementation {
+ [NewObject] DocumentType createDocumentType(DOMString qualifiedName, DOMString publicId, DOMString systemId);
+ [NewObject] XMLDocument createDocument(DOMString? namespace, [LegacyNullToEmptyString] DOMString qualifiedName, optional DocumentType? doctype = null);
+ [NewObject] Document createHTMLDocument(optional DOMString title);
+
+ boolean hasFeature(); // useless; always returns true
+};
+
+
+
+
+
+doctype = document . {{Document/implementation}} . {{createDocumentType(qualifiedName, publicId, systemId)}}
+
+ Name production, an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}} is thrown, and if it does not match the
+ QName production, a
+ "{{NamespaceError!!exception}}" {{DOMException}} is thrown.
+
+ doc = document . {{Document/implementation}} . createDocument(namespace, qualifiedName [, doctype = null])
+
+ doc = document . {{Document/implementation}} . createHTMLDocument([title])
+
+ createDocumentType(qualifiedName, publicId, systemId)
+method, when invoked, must run these steps:
+
+
+
+
+PubidChar production or that systemId does not contain both a
+'"' and a "'".
+
+createDocument(namespace, qualifiedName, doctype)
+method, when invoked, must run these steps:
+
+
+
+
+The
+createElementNS steps, given
+ document, namespace, qualifiedName, and an empty dictionary.
+
+
+
+
+ application/xhtml+xml
+
+ image/svg+xml
+
+ application/xml
+ createHTMLDocument(title)
+method, when invoked, must run these steps:
+
+
+
+
+The text/html".
+
+ html" as its
+ name and with its node document set to doc, to
+ doc.
+
+
+
+
+ hasFeature() method, when
+invoked, must return true.
+
+Interface {{DocumentType}}
+
+
+[Exposed=Window]
+interface DocumentType : Node {
+ readonly attribute DOMString name;
+ readonly attribute DOMString publicId;
+ readonly attribute DOMString systemId;
+};
+
+
+name attribute's getter must return
+this's name.
+
+publicId attribute's getter must return
+this's public ID.
+
+systemId attribute's getter must return
+this's system ID.
+
+
+Interface {{DocumentFragment}}
+
+
+[Exposed=Window]
+interface DocumentFragment : Node {
+ constructor();
+};
+
+
+
+
+
+tree = new {{DocumentFragment()}}
+ DocumentFragment() constructor, when
+invoked, must return a new {{DocumentFragment}} node whose node document is
+current global object's associated Document.
+
+
+Interface {{ShadowRoot}}
+
+
+[Exposed=Window]
+interface ShadowRoot : DocumentFragment {
+ readonly attribute ShadowRootMode mode;
+ readonly attribute Element host;
+ attribute EventHandler onslotchange;
+};
+
+enum ShadowRootMode { "open", "closed" };
+
+
+open"
+or "closed").mode attribute's getter must return
+this's mode.host attribute's getter must return
+this's host.
+
+onslotchange attribute is an
+event handler IDL attribute for the
+onslotchange event handler, whose
+event handler event type is {{HTMLSlotElement/slotchange}}.
+
+
+
+
+
+
+closed" or A's root's
+ host is closed-shadow-hidden from B.
+
+
+
+
+
+
+ Interface {{Element}}
+
+
+[Exposed=Window]
+interface Element : Node {
+ readonly attribute DOMString? namespaceURI;
+ readonly attribute DOMString? prefix;
+ readonly attribute DOMString localName;
+ readonly attribute DOMString tagName;
+
+ [CEReactions] attribute DOMString id;
+ [CEReactions] attribute DOMString className;
+ [SameObject, PutForwards=value] readonly attribute DOMTokenList classList;
+ [CEReactions, Unscopable] attribute DOMString slot;
+
+ boolean hasAttributes();
+ [SameObject] readonly attribute NamedNodeMap attributes;
+ sequence<DOMString> getAttributeNames();
+ DOMString? getAttribute(DOMString qualifiedName);
+ DOMString? getAttributeNS(DOMString? namespace, DOMString localName);
+ [CEReactions] void setAttribute(DOMString qualifiedName, DOMString value);
+ [CEReactions] void setAttributeNS(DOMString? namespace, DOMString qualifiedName, DOMString value);
+ [CEReactions] void removeAttribute(DOMString qualifiedName);
+ [CEReactions] void removeAttributeNS(DOMString? namespace, DOMString localName);
+ [CEReactions] boolean toggleAttribute(DOMString qualifiedName, optional boolean force);
+ boolean hasAttribute(DOMString qualifiedName);
+ boolean hasAttributeNS(DOMString? namespace, DOMString localName);
+
+ Attr? getAttributeNode(DOMString qualifiedName);
+ Attr? getAttributeNodeNS(DOMString? namespace, DOMString localName);
+ [CEReactions] Attr? setAttributeNode(Attr attr);
+ [CEReactions] Attr? setAttributeNodeNS(Attr attr);
+ [CEReactions] Attr removeAttributeNode(Attr attr);
+
+ ShadowRoot attachShadow(ShadowRootInit init);
+ readonly attribute ShadowRoot? shadowRoot;
+
+ Element? closest(DOMString selectors);
+ boolean matches(DOMString selectors);
+ boolean webkitMatchesSelector(DOMString selectors); // historical alias of .matches
+
+ HTMLCollection getElementsByTagName(DOMString qualifiedName);
+ HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);
+ HTMLCollection getElementsByClassName(DOMString classNames);
+
+ [CEReactions] Element? insertAdjacentElement(DOMString where, Element element); // historical
+ void insertAdjacentText(DOMString where, DOMString data); // historical
+};
+
+dictionary ShadowRootInit {
+ required ShadowRootMode mode;
+ boolean delegatesFocus = false;
+};
+
+
+is value. When an
+element is created, all of these values are
+initialized.
+
+undefined", "failed", "uncustomized", or
+"custom". An element whose custom element state is
+"uncustomized" or "custom" is said to be
+defined. An element whose
+custom element state is "custom" is said to be
+custom.
+
+failed" state is used to ensure that if a custom element constructor fails to
+execute correctly the first time, it is not executed again by an
+upgrade.
+
+ <!DOCTYPE html>
+ <script>
+ window.customElements.define("sw-rey", class extends HTMLElement {})
+ window.customElements.define("sw-finn", class extends HTMLElement {}, { extends: "p" })
+ window.customElements.define("sw-kylo", class extends HTMLElement {
+ constructor() {
+ // super() intentionally omitted for this example
+ }
+ })
+ </script>
+
+ <!-- "undefined" (not defined, not custom) -->
+ <sw-han></sw-han>
+ <p is="sw-luke"></p>
+ <p is="asdf"></p>
+
+ <!-- "failed" (not defined, not custom) -->
+ <sw-kylo></sw-kylo>
+
+ <!-- "uncustomized" (defined, not custom) -->
+ <p></p>
+ <asdf></asdf>
+
+ <!-- "custom" (defined, custom) -->
+ <sw-rey></sw-rey>
+ <p is="sw-finn"></p>
+ :", followed by its
+local name, otherwise.
+
+
+
+
+
+
+
+
+
+ undefined",
+ custom element definition set to null,
+ is value set to is, and node document set to
+ document.
+
+
+
+
+
+
+ failed".
+
+
+
+
+
+ is value to null.
+
+
+ failed",
+ custom element definition set to null,
+ is value set to null, and node document set to
+ document.
+
+
+ undefined", custom element definition set to null,
+ is value set to null, and node document set to
+ document.
+
+
+
+ uncustomized", custom element definition set to null,
+ is value set to is, and node document set to
+ document.
+
+ undefined".
+
+
+
+attributes" for element with
+ attribute's local name, attribute's
+ namespace, oldValue, « », « », null, and null.
+
+ attributeChangedCallback", and an argument list containing attribute's
+ local name, oldValue, newValue, and attribute's
+ namespace.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+id attribute and a DTD. This specification makes ID
+a concept of the DOM and allows for only one per element, given by an
+id attribute.
+
+
+
+
+id, namespace is null, and
+ value is null or the empty string, then unset element's
+ ID.
+
+ id, namespace is null, then
+ set element's ID to value.
+class,
+id, and slot attributes on any element, it makes no
+claims as to whether using them is conforming or not.
+
+
+
+A node's
+parent of type
+{{Element}} is known as a parent element. If the
+node has a
+parent of a different type, its
+parent element is null.
+
+
+
+
+
+
+namespaceURI attribute's getter must return
+this's namespace.
+
+prefix attribute's getter must return
+this's namespace prefix.
+
+localName attribute's getter must return
+this's local name.
+
+tagName attribute's getter must return
+this's HTML-uppercased qualified name.
+
+
+
+
+
+
+element . id [ = value ]
+ id content attribute. Can be set to
+ change it.
+
+ element . className [ = value ]
+ class content attribute. Can be set
+ to change it.
+
+ element . classList
+ class content attribute as a
+ set of whitespace-separated tokens through a {{DOMTokenList}} object.
+
+ element . slot [ = value ]
+ slot content attribute. Can be set to
+ change it.
+
+
+
+id attribute must reflect the
+"id" content attribute.
+
+className attribute must
+reflect the "class" content attribute.
+
+classList attribute's getter must return a
+{{DOMTokenList}} object whose associated element is this and whose associated
+attribute's local name is class. The token set of this
+particular {{DOMTokenList}} object are also known as the element's
+classes.
+
+slot attribute must reflect the
+"slot" content attribute.
+
+id, class, and slot are effectively
+superglobal attributes as they can appear on any element, regardless of that element's
+namespace.
+
+
+
+
+element . hasAttributes()
+ element . getAttributeNames()
+ element . getAttribute(qualifiedName)
+ element . getAttributeNS(namespace, localName)
+ element . setAttribute(qualifiedName, value)
+ element . setAttributeNS(namespace, localName, value)
+ element . removeAttribute(qualifiedName)
+ element . removeAttributeNS(namespace, localName)
+ element . toggleAttribute(qualifiedName [, force])
+ element . hasAttribute(qualifiedName)
+ element . hasAttributeNS(namespace, localName)
+ hasAttributes() method, when invoked, must return
+false if this's attribute list is empty, and true
+otherwise.
+
+attributes attribute's getter must return the
+associated {{NamedNodeMap}}.
+
+getAttributeNames() method, when invoked, must
+return the qualified names of the attributes in this's
+attribute list, in order, and a new list otherwise.
+
+getAttribute(qualifiedName) method,
+when invoked, must run these steps:
+
+
+
+
+getAttributeNS(namespace, localName)
+method, when invoked, must these steps:
+
+
+
+
+setAttribute(qualifiedName, value)
+method, when invoked, must run these steps:
+
+
+
+
+Name production in
+ XML, then throw an "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ setAttributeNS(namespace, qualifiedName, value)
+method, when invoked, must run these steps:
+
+
+
+
+removeAttribute(qualifiedName)
+method, when invoked, must remove an attribute given
+qualifiedName and this, and then return undefined.
+
+removeAttributeNS(namespace, localName)
+method, when invoked, must
+remove an attribute given
+namespace, localName, and this, and then return undefined.
+
+hasAttribute(qualifiedName) method,
+when invoked, must run these steps:
+
+
+
+
+toggleAttribute(qualifiedName, force)
+method, when invoked, must run these steps:
+
+
+
+
+Name production in
+ XML, then throw an "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+
+
+
+ hasAttributeNS(namespace, localName)
+method, when invoked, must run these steps:
+
+
+
+
+
+
+getAttributeNode(qualifiedName)
+method, when invoked, must return the result of
+getting an attribute given qualifiedName and
+this.
+
+getAttributeNodeNS(namespace, localName)
+method, when invoked, must return the result of
+getting an attribute given
+namespace, localName, and this.
+
+setAttributeNode(attr) and
+setAttributeNodeNS(attr) methods, when
+invoked, must return the result of setting an attribute given
+attr and this.
+
+removeAttributeNode(attr) method,
+when invoked, must run these steps:
+
+
+
+
+
+
+
+
+
+var shadow = element . {{attachShadow(init)}}
+ var shadow = element . {{shadowRoot}}
+ open", and null otherwise.
+attachShadow(init) method, when
+invoked, must run these steps:
+
+
+
+
+
+
+
+ article",
+ "aside",
+ "blockquote",
+ "body",
+ "div",
+ "footer",
+ "h1",
+ "h2",
+ "h3",
+ "h4",
+ "h5",
+ "h6",
+ "header",
+ "main",
+ "nav",
+ "p",
+ "section", or
+ "span"
+ is value is not null, then:
+
+
+
+ is value.
+
+ shadowRoot attribute's getter must run these
+steps:
+
+
+
+
+closed",
+ then return null.
+
+
+
+
+The element . {{closest(selectors)}}
+ element . {{matches(selectors)}}
+ closest(selectors)
+method, when invoked, must run these steps:
+
+
+
+
+The matches(selectors) and
+webkitMatchesSelector(selectors) methods, when
+invoked, must run these steps:
+
+
+
+
+
+
+getElementsByTagName(qualifiedName)
+method, when invoked, must return the
+list of elements with qualified name qualifiedName for this.
+
+getElementsByTagNameNS(namespace, localName)
+method, when invoked, must return the
+list of elements with namespace namespace and local name localName for
+this.
+
+getElementsByClassName(classNames)
+method, when invoked, must return the list of elements with class names classNames
+for this.
+
+
+
+
+
+
+beforebegin"
+ afterbegin"
+ beforeend"
+ afterend"
+ insertAdjacentElement(where, element)
+method, when invoked, must return the result of running insert adjacent, give this,
+where, and element.
+
+insertAdjacentText(where, data)
+method, when invoked, must run these steps:
+
+
+
+
+Interface {{NamedNodeMap}}
+
+
+[Exposed=Window,
+ LegacyUnenumerableNamedProperties]
+interface NamedNodeMap {
+ readonly attribute unsigned long length;
+ getter Attr? item(unsigned long index);
+ getter Attr? getNamedItem(DOMString qualifiedName);
+ Attr? getNamedItemNS(DOMString? namespace, DOMString localName);
+ [CEReactions] Attr? setNamedItem(Attr attr);
+ [CEReactions] Attr? setNamedItemNS(Attr attr);
+ [CEReactions] Attr removeNamedItem(DOMString qualifiedName);
+ [CEReactions] Attr removeNamedItemNS(DOMString? namespace, DOMString localName);
+};
+
+
+A {{NamedNodeMap}} has an associated
+element (an
+element).
+
+A {{NamedNodeMap}} object's
+attribute list is its
+element's
+attribute list.
+
+
+
+length attribute's getter must return
+the attribute list's size.
+
+item(index) method, when
+invoked, must run these steps:
+
+
+
+
+
+
+
+
+
+
+ getNamedItem(qualifiedName)
+method, when invoked, must return the result of
+getting an attribute given qualifiedName and
+element.
+
+getNamedItemNS(namespace, localName)
+method, when invoked, must return the result of
+getting an attribute given
+namespace, localName, and
+element.
+
+setNamedItem(attr) and
+setNamedItemNS(attr)
+methods, when invoked, must return the result of setting an attribute
+given attr and element.
+
+removeNamedItem(qualifiedName)
+method, when invoked, must run these steps:
+
+
+
+
+removeNamedItemNS(namespace, localName)
+method, when invoked, must run these steps:
+
+
+
+
+
+Interface {{Attr}}
+
+
+[Exposed=Window]
+interface Attr : Node {
+ readonly attribute DOMString? namespaceURI;
+ readonly attribute DOMString? prefix;
+ readonly attribute DOMString localName;
+ readonly attribute DOMString name;
+ [CEReactions] attribute DOMString value;
+
+ readonly attribute Element? ownerElement;
+
+ readonly attribute boolean specified; // useless; always returns true
+};
+
+:", followed by its
+local name, otherwise.
+
+A attribute
+is an attribute whose
+local name is
+A and whose
+namespace and
+namespace prefix are
+null.
+
+
+
+namespaceURI attribute's getter must return the
+namespace.
+
+prefix attribute's getter must return the
+namespace prefix.
+
+localName attribute's getter must return the
+local name.
+
+name attribute's getter must return the
+qualified name.
+
+value attribute's getter must return the
+value.
+
+
+
+
+
+
+ownerElement attribute's getter must return
+this's element.
+
+
+
+specified attribute's getter must return true.
+
+
+Interface {{CharacterData}}
+
+
+[Exposed=Window]
+interface CharacterData : Node {
+ attribute [LegacyNullToEmptyString] DOMString data;
+ readonly attribute unsigned long length;
+ DOMString substringData(unsigned long offset, unsigned long count);
+ void appendData(DOMString data);
+ void insertData(unsigned long offset, DOMString data);
+ void deleteData(unsigned long offset, unsigned long count);
+ void replaceData(unsigned long offset, unsigned long count, DOMString data);
+};
+
+
+
+
+
+
+
+
+
+To substring data with node
+node, offset offset, and count
+count, run these steps:
+
+characterData" for node with
+ null, null, node's data, « », « », null, and null.
+
+
+
+
+data attribute's getter must return
+this's data. Its setter must replace data with node
+this, offset 0, count this's length, and data new value.
+
+length attribute's getter must return
+this's length.
+
+substringData(offset, count)
+method, when invoked, must return the result of running substring data with node this,
+offset offset, and count count.
+
+appendData(data) method, when
+invoked, must replace data with node this, offset this's
+length, count 0, and data data.
+
+insertData(offset, data)
+method, when invoked, must replace data with node this, offset offset,
+count 0, and data data.
+
+deleteData(offset, count)
+method, when invoked, must replace data with node this, offset offset,
+count count, and data the empty string.
+
+replaceData(offset, count, data)
+method, when invoked, must replace data with node this, offset offset,
+count count, and data data.
+
+
+Interface {{Text}}
+
+
+[Exposed=Window]
+interface Text : CharacterData {
+ constructor(optional DOMString data = "");
+
+ [NewObject] Text splitText(unsigned long offset);
+ readonly attribute DOMString wholeText;
+};
+
+
+
+
+
+text = new Text([data = ""])
+ text . {{Text/splitText(offset)}}
+ text . {{Text/wholeText}}
+
+
+Text nodes, and node's next sibling {{Text}}
+node, if any, and its contiguous Text nodes, avoiding any duplicates.
+
+Text node,
+if any, and its contiguous exclusive Text nodes, and node's
+next sibling exclusive Text node, if any, and its
+contiguous exclusive Text nodes, avoiding any duplicates.
+
+
+
+Text(data) constructor, when invoked,
+must return a new {{Text}} node whose data is data and
+node document is current global object's
+associated Document.
+
+To split a {{Text}}
+node node with offset
+offset, run these steps:
+
+
+
+
+
+
+
+ splitText(offset) method, when invoked,
+must split this with offset offset.
+
+wholeText attribute's getter must return the
+concatenation of the data of the
+contiguous Text nodes of this, in tree order.
+
+
+Interface {{CDATASection}}
+
+
+[Exposed=Window]
+interface CDATASection : Text {
+};
+
+
+Interface {{ProcessingInstruction}}
+
+
+[Exposed=Window]
+interface ProcessingInstruction : CharacterData {
+ readonly attribute DOMString target;
+};
+
+
+{{ProcessingInstruction}} nodes
+have an associated target.
+
+The target
+attribute must return the target.
+
+
+Interface {{Comment}}
+
+
+[Exposed=Window]
+interface Comment : CharacterData {
+ constructor(optional DOMString data = "");
+};
+
+
+
+
+
+comment = new Comment([data = ""])
+ Comment(data) constructor, when
+invoked, must return a new {{Comment}} node whose data is
+data and node document is current global object's
+associated Document.
+
+
+
+
+Ranges
+
+Introduction to "DOM Ranges"
+
+
+
+
+
+p
+
+
+<img src="insanity-wolf" alt="Little-endian BOM; decode as big-endian!">
+ <em>
+
+
+ p element, and
+em to the em
+element, this would be done as follows:
+
+
+
+
+var range = new Range(),
+ firstText = p.childNodes[1],
+ secondText = em.firstChild
+range.setStart(firstText, 9) // do not forget the leading space
+range.setEnd(secondText, 4)
+// range now stringifies to the aforementioned quote
+src and alt in the
+node tree above cannot be represented by a range. Ranges are only useful for
+nodes.
+
+Boundary points
+
+
+
+
+
+Interface {{AbstractRange}}
+
+
+[Exposed=Window]
+interface AbstractRange {
+ readonly attribute Node startContainer;
+ readonly attribute unsigned long startOffset;
+ readonly attribute Node endContainer;
+ readonly attribute unsigned long endOffset;
+ readonly attribute boolean collapsed;
+};
+
+
+
+
+
+node = range . startContainer
+ offset = range . startOffset
+ node = range . endContainer
+ offset = range . endOffset
+ collapsed = range . collapsed
+ startContainer
+attribute's getter must return this's start node.
+
+startOffset
+attribute's getter must return this's start offset.
+
+endContainer
+attribute's getter must return this's end node.
+
+endOffset
+attribute's getter must return this's end offset.
+
+collapsed
+attribute's getter must return true if this is collapsed, and false
+otherwise.
+
+
+Interface {{StaticRange}}
+
+
+dictionary StaticRangeInit {
+ required Node startContainer;
+ required unsigned long startOffset;
+ required Node endContainer;
+ required unsigned long endOffset;
+};
+
+[Exposed=Window]
+interface StaticRange : AbstractRange {
+ constructor(StaticRangeInit init);
+};
+
+
+
+
+
+staticRange = new StaticRange(init)
+ StaticRange(init) constructor,
+when invoked, must run these steps:
+
+
+
+
+
+Interface {{Range}}
+
+
+[Exposed=Window]
+interface Range : AbstractRange {
+ constructor();
+
+ readonly attribute Node commonAncestorContainer;
+
+ void setStart(Node node, unsigned long offset);
+ void setEnd(Node node, unsigned long offset);
+ void setStartBefore(Node node);
+ void setStartAfter(Node node);
+ void setEndBefore(Node node);
+ void setEndAfter(Node node);
+ void collapse(optional boolean toStart = false);
+ void selectNode(Node node);
+ void selectNodeContents(Node node);
+
+ const unsigned short START_TO_START = 0;
+ const unsigned short START_TO_END = 1;
+ const unsigned short END_TO_END = 2;
+ const unsigned short END_TO_START = 3;
+ short compareBoundaryPoints(unsigned short how, Range sourceRange);
+
+ [CEReactions] void deleteContents();
+ [CEReactions, NewObject] DocumentFragment extractContents();
+ [CEReactions, NewObject] DocumentFragment cloneContents();
+ [CEReactions] void insertNode(Node node);
+ [CEReactions] void surroundContents(Node newParent);
+
+ [NewObject] Range cloneRange();
+ void detach();
+
+ boolean isPointInRange(Node node, unsigned long offset);
+ short comparePoint(Node node, unsigned long offset);
+
+ boolean intersectsNode(Node node);
+
+ stringifier;
+};
+
+
+
+
+
+
+
+
+
+range = new Range()
+ Range() constructor, when invoked, must return
+a new live range with
+(current global object's associated Document, 0) as its
+start and end.
+
+
+
+
+
+
+commonAncestorContainer attribute's getter must
+run these steps:
+
+
+
+
+
+
+
+
+
+
+
+setStart(node, offset) method,
+when invoked, must set the start of this to boundary point
+(node, offset).
+
+setEnd(node, offset) method,
+when invoked, must set the end of this to boundary point
+(node, offset).
+
+setStartBefore(node) method, when
+invoked, must run these steps:
+
+
+
+
+setStartAfter(node) method, when invoked,
+must run these steps:
+
+
+
+
+setEndBefore(node), when invoked, method
+must run these steps:
+
+
+
+
+setEndAfter(node) method, when invoked,
+must run these steps:
+
+
+
+
+collapse(toStart) method, when invoked,
+must if toStart is true, set end to start, and set
+start to end otherwise.
+
+
+
+
+selectNode(node) method, when invoked,
+must select node within this.
+
+selectNodeContents(node) method, when
+invoked, must run these steps:
+
+
+
+
+
+
+compareBoundaryPoints(how, sourceRange)
+method, when invoked, must run these steps:
+
+
+
+
+
+
+
+
+
+
+ deleteContents() method, when invoked, must
+run these steps:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ extractContents() method, when invoked, must return
+the result of extracting this.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ cloneContents() method, when invoked, must return
+the result of cloning the contents of this.
+
+
+
+
+insertNode(node) method, when invoked,
+must insert node into this.
+
+surroundContents(newParent) method, when
+invoked, must run these steps:
+
+
+
+
+
+
+cloneRange() method, when invoked, must return a new
+live range with the same start and end as this.
+
+detach() method, when invoked, must do nothing.
+Its functionality (disabling a {{Range}} object) was removed, but the method itself
+is preserved for compatibility.
+
+
+
+
+
+
+isPointInRange(node, offset)
+method, when invoked, must run these steps:
+
+
+
+
+
+comparePoint(node, offset)
+method, when invoked, must run these steps:
+
+
+
+
+
+
+
+intersectsNode(node) method, when
+invoked, must run these steps:
+
+
+
+
+
+
+
+
+
+Traversal
+
+
+
+
+
+acceptNode", and
+ « node ». If this throws an exception, then unset traverser's
+ active flag and rethrow the exception.
+
+ Interface {{NodeIterator}}
+
+
+[Exposed=Window]
+interface NodeIterator {
+ [SameObject] readonly attribute Node root;
+ readonly attribute Node referenceNode;
+ readonly attribute boolean pointerBeforeReferenceNode;
+ readonly attribute unsigned long whatToShow;
+ readonly attribute NodeFilter? filter;
+
+ Node? nextNode();
+ Node? previousNode();
+
+ void detach();
+};
+
+
+NodeIterator pre-removing steps given a nodeIterator and
+toBeRemovedNode, are as follows:
+
+
+
+
+
+
+
+
+
+root attribute's getter, when invoked,
+must return this's root.
+
+referenceNode attribute's getter, when
+invoked, must return this's reference.
+
+pointerBeforeReferenceNode attribute's
+getter, when invoked, must return this's pointer before reference.
+
+whatToShow attribute's getter, when
+invoked, must return this's whatToShow.
+
+filter attribute's getter, when invoked,
+must return this's filter.
+
+
+
+
+
+
+
+
+
+
+ nextNode() method, when invoked, must return
+the result of traversing with this and next.
+
+previousNode() method, when invoked, must
+return the result of traversing with this and previous.
+
+detach() method, when invoked, must do
+nothing. Its functionality (disabling a {{NodeIterator}} object) was removed, but
+the method itself is preserved for compatibility.
+
+
+Interface {{TreeWalker}}
+
+
+[Exposed=Window]
+interface TreeWalker {
+ [SameObject] readonly attribute Node root;
+ readonly attribute unsigned long whatToShow;
+ readonly attribute NodeFilter? filter;
+ attribute Node currentNode;
+
+ Node? parentNode();
+ Node? firstChild();
+ Node? lastChild();
+ Node? previousSibling();
+ Node? nextSibling();
+ Node? previousNode();
+ Node? nextNode();
+};
+
+root attribute's getter, when invoked, must
+return this's root.
+
+whatToShow attribute's getter, when invoked,
+must return this's whatToShow.
+
+filter attribute's getter, when invoked,
+must return this's filter.
+
+currentNode attribute's getter, when
+invoked, must return this's current.
+
+
+
+parentNode() method, when invoked, must run
+these steps:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ firstChild() method, when invoked, must
+traverse children with this and first.
+
+lastChild() method, when invoked, must
+traverse children with this and last.
+
+
+
+
+
+
+
+
+
+ nextSibling() method, when invoked, must
+traverse siblings with this and next.
+
+previousSibling() method, when invoked, must
+traverse siblings with this and previous.
+
+previousNode() method, when invoked, must run
+these steps:
+
+
+
+
+
+
+
+
+
+
+
+
+
+ nextNode() method, when invoked, must run these
+steps:
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Interface {{NodeFilter}}
+
+
+[Exposed=Window]
+callback interface NodeFilter {
+ // Constants for acceptNode()
+ const unsigned short FILTER_ACCEPT = 1;
+ const unsigned short FILTER_REJECT = 2;
+ const unsigned short FILTER_SKIP = 3;
+
+ // Constants for whatToShow
+ const unsigned long SHOW_ALL = 0xFFFFFFFF;
+ const unsigned long SHOW_ELEMENT = 0x1;
+ const unsigned long SHOW_ATTRIBUTE = 0x2;
+ const unsigned long SHOW_TEXT = 0x4;
+ const unsigned long SHOW_CDATA_SECTION = 0x8;
+ const unsigned long SHOW_ENTITY_REFERENCE = 0x10; // historical
+ const unsigned long SHOW_ENTITY = 0x20; // historical
+ const unsigned long SHOW_PROCESSING_INSTRUCTION = 0x40;
+ const unsigned long SHOW_COMMENT = 0x80;
+ const unsigned long SHOW_DOCUMENT = 0x100;
+ const unsigned long SHOW_DOCUMENT_TYPE = 0x200;
+ const unsigned long SHOW_DOCUMENT_FRAGMENT = 0x400;
+ const unsigned long SHOW_NOTATION = 0x800; // historical
+
+ unsigned short acceptNode(Node node);
+};
+
+
+
+
+
+FILTER_ACCEPT (1);
+ FILTER_REJECT (2);
+ FILTER_SKIP (3).
+
+
+
+
+
+SHOW_ALL (4294967295, FFFFFFFF in hexadecimal);
+ SHOW_ELEMENT (1);
+ SHOW_ATTRIBUTE (2);
+ SHOW_TEXT (4);
+ SHOW_CDATA_SECTION (8);
+ SHOW_PROCESSING_INSTRUCTION (64, 40 in hexadecimal);
+ SHOW_COMMENT (128, 80 in hexadecimal);
+ SHOW_DOCUMENT (256, 100 in hexadecimal);
+ SHOW_DOCUMENT_TYPE (512, 200 in hexadecimal);
+ SHOW_DOCUMENT_FRAGMENT (1024, 400 in hexadecimal).
+Sets
+
+Interface {{DOMTokenList}}
+
+
+[Exposed=Window]
+interface DOMTokenList {
+ readonly attribute unsigned long length;
+ getter DOMString? item(unsigned long index);
+ boolean contains(DOMString token);
+ [CEReactions] void add(DOMString... tokens);
+ [CEReactions] void remove(DOMString... tokens);
+ [CEReactions] boolean toggle(DOMString token, optional boolean force);
+ [CEReactions] boolean replace(DOMString token, DOMString newToken);
+ boolean supports(DOMString token);
+ [CEReactions] stringifier attribute DOMString value;
+ iterable<DOMString>;
+};
+
+
+
+
+
+TypeError.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+tokenlist . {{DOMTokenList/length}}
+ tokenlist . {{DOMTokenList/item(index)}}
+ tokenlist[index]
+ tokenlist . {{DOMTokenList/contains(token)}}
+ tokenlist . add(tokens…)
+ tokenlist . remove(tokens…)
+ tokenlist . toggle(token [, force])
+ tokenlist . replace(token, newToken)
+ tokenlist . supports(token)
+ TypeError if the associated attribute has no supported tokens defined.
+
+ tokenlist . {{DOMTokenList/value}}
+ length attribute' getter must return
+this's token set's size.
+
+item(index) method, when
+invoked, must run these steps:
+
+contains(token) method, when
+invoked, must return true if this's token set[token] exists,
+and false otherwise.add(tokens…)
+method, when invoked, must run these steps:
+
+
+
+
+
+
+
+ remove(tokens…)
+method, when invoked, must run these steps:
+
+
+
+
+
+
+
+ toggle(token, force)
+method, when invoked, must run these steps:
+
+
+
+
+
+
+
+ replace(token, newToken)
+method, when invoked, must run these steps:
+
+
+
+
+
+supports(token)
+method, when invoked, must run these steps:
+
+
+
+
+value attribute must return the
+result of running this's serialize steps.
+
+XPath
+
+Interface {{XPathResult}}
+
+
+[Exposed=Window]
+interface XPathResult {
+ const unsigned short ANY_TYPE = 0;
+ const unsigned short NUMBER_TYPE = 1;
+ const unsigned short STRING_TYPE = 2;
+ const unsigned short BOOLEAN_TYPE = 3;
+ const unsigned short UNORDERED_NODE_ITERATOR_TYPE = 4;
+ const unsigned short ORDERED_NODE_ITERATOR_TYPE = 5;
+ const unsigned short UNORDERED_NODE_SNAPSHOT_TYPE = 6;
+ const unsigned short ORDERED_NODE_SNAPSHOT_TYPE = 7;
+ const unsigned short ANY_UNORDERED_NODE_TYPE = 8;
+ const unsigned short FIRST_ORDERED_NODE_TYPE = 9;
+
+ readonly attribute unsigned short resultType;
+ readonly attribute unrestricted double numberValue;
+ readonly attribute DOMString stringValue;
+ readonly attribute boolean booleanValue;
+ readonly attribute Node? singleNodeValue;
+ readonly attribute boolean invalidIteratorState;
+ readonly attribute unsigned long snapshotLength;
+
+ Node? iterateNext();
+ Node? snapshotItem(unsigned long index);
+};
+
+
+
+Interface {{XPathExpression}}
+
+
+[Exposed=Window]
+interface XPathExpression {
+ // XPathResult.ANY_TYPE = 0
+ XPathResult evaluate(Node contextNode, optional unsigned short type = 0, optional XPathResult? result = null);
+};
+
+
+
+Mixin {{XPathEvaluatorBase}}
+
+
+callback interface XPathNSResolver {
+ DOMString? lookupNamespaceURI(DOMString? prefix);
+};
+
+interface mixin XPathEvaluatorBase {
+ [NewObject] XPathExpression createExpression(DOMString expression, optional XPathNSResolver? resolver = null);
+ XPathNSResolver createNSResolver(Node nodeResolver);
+ // XPathResult.ANY_TYPE = 0
+ XPathResult evaluate(DOMString expression, Node contextNode, optional XPathNSResolver? resolver = null, optional unsigned short type = 0, optional XPathResult? result = null);
+};
+Document includes XPathEvaluatorBase;
+
+
+
+Interface {{XPathEvaluator}}
+
+
+[Exposed=Window]
+interface XPathEvaluator {
+ constructor();
+};
+
+XPathEvaluator includes XPathEvaluatorBase;
+
+
+Historical
+
+DOM Events
+
+
+
+
+
+DOM Core
+
+hasAttributes() and
+attributes moved from {{Node}} to {{Element}}.
+
+namespaceURI,
+prefix, and
+localName moved from {{Node}} to {{Element}} and
+{{Attr}}.
+
+
+
+
+DOMConfiguration
+ DOMError
+ DOMErrorHandler
+ DOMImplementationList
+ DOMImplementationSource
+ DOMLocator
+ DOMObject
+ DOMUserData
+ Entity
+ EntityReference
+ NameList
+ Notation
+ TypeInfo
+ UserDataHandler
+
+
+
+
+
+
+
+ isSupported
+ getFeature()
+ getUserData()
+ setUserData()
+
+
+
+ createEntityReference()
+ xmlEncoding
+ xmlStandalone
+ xmlVersion
+ strictErrorChecking
+ domConfig
+ normalizeDocument()
+ renameNode()
+
+
+
+ getFeature()
+
+
+
+ schemaTypeInfo
+ isId
+
+
+
+ schemaTypeInfo
+ setIdAttribute()
+ setIdAttributeNS()
+ setIdAttributeNode()
+
+
+
+ entities
+ notations
+ internalSubset
+
+
+isElementContentWhitespace
+ replaceWholeText()
+ DOM Ranges
+
+
+
+
+
+DOM Traversal
+
+
+
+
+
+Acknowledgments
+
+
+Group: WHATWG
+Date: 2020-12-21
+H1: DOM
+Shortname: dom
+Text Macro: TWITTER thedomstandard
+Text Macro: LATESTRD 2020-12
+Abstract: DOM defines a platform-neutral model for events, aborting activities, and node trees.
+Translation: ja https://triple-underscore.github.io/DOM4-ja.html
+Translate IDs: slottable slotable
+Ignored Terms: EmptyString, Array, Document
+Indent: 1
+
+
+
+urlPrefix: https://www.w3.org/TR/xml/#NT-
+ type: type
+ text: Name; url: Name
+ text: Char; url: Char
+ text: PubidChar; url: PubidChar
+urlPrefix: https://www.w3.org/TR/xml-names/#NT-
+ type: type
+ text: QName; url: QName
+url: https://w3c.github.io/DOM-Parsing/#dfn-createcontextualfragment-fragment
+ type: method; text: createContextualFragment(); for: Range
+type: interface
+ url: https://w3c.github.io/touch-events/#idl-def-touchevent
+ text: TouchEvent
+ url: https://w3c.github.io/deviceorientation/spec-source-orientation.html#devicemotion
+ text: DeviceMotionEvent
+ text: DeviceOrientationEvent
+ url: https://www.khronos.org/registry/webgl/specs/latest/1.0/#5.15
+ text: WebGLContextEvent
+urlPrefix: https://tc39.github.io/ecma262/#; spec: ECMASCRIPT
+ text: Construct; url: sec-construct; type: abstract-op
+ type: dfn
+ text: Realm; url: realm
+ text: surrounding agent; url: surrounding-agent
+urlPrefix: https://w3c.github.io/hr-time/#; spec: HR-TIME
+ type:typedef; urlPrefix: dom-; text: DOMHighResTimeStamp
+ type:dfn; text: time origin; url: dfn-time-origin
+ type:dfn; text: clock resolution
+
+
+
+spec:html; type:element
+ text: title
+ text: script
+
+
+
+
+Infrastructure
+
+Trees
+
+Ordered sets
+
+
+
+
+Selectors
+
+
+
+
+
+
+Namespaces
+
+Name or QName production.
+
+To validate and extract a namespace and qualifiedName,
+run these steps:
+
+
+
+
+
+
+:" (U+003E), then split the
+ string on it and set prefix to the part before and localName to
+ the part after.
+
+ xml" and namespace is not the
+ XML namespace, then throw a "{{NamespaceError!!exception}}" {{DOMException}}.
+
+ xmlns" and namespace is not the
+ XMLNS namespace, then throw a
+ "{{NamespaceError!!exception}}" {{DOMException}}.
+
+ xmlns", then throw a "{{NamespaceError!!exception}}"
+ {{DOMException}}.
+
+ Events
+
+Introduction to "DOM Events"
+
+Throughout the web platform events are dispatched to objects to signal an
+occurrence, such as network activity or user interaction. These objects implement the
+{{EventTarget}} interface and can therefore add event listeners to observe
+events by calling {{EventTarget/addEventListener()}}:
+
+
+obj.addEventListener("load", imgFetched)
+
+function imgFetched(ev) {
+ // great success
+ …
+}
+
+
+Event listeners can be removed
+by utilizing the
+{{EventTarget/removeEventListener()}}
+method passing the same arguments.
+
+Alternatively, event listeners can be removed by passing an {{AbortSignal}} to
+{{EventTarget/addEventListener()}} and calling {{AbortController/abort()}} on the controller
+owning the signal.
+
+Events are objects too and implement the
+{{Event}} interface (or a derived interface). In the example above
+ev is the event. ev is
+passed as an argument to the
+event listener's callback
+(typically a JavaScript Function as shown above).
+Event listeners key off the
+event's
+{{Event/type}} attribute value
+("load" in the above example). The
+event's
+{{Event/target}} attribute value returns the
+object to which the event was
+dispatched
+(obj above).
+
+
+// add an appropriate event listener
+obj.addEventListener("cat", function(e) { process(e.detail) })
+
+// create and dispatch the event
+var event = new CustomEvent("cat", {"detail":{"hazcheeseburger":true}})
+obj.dispatchEvent(event)
+
+
+Apart from signaling, events are
+sometimes also used to let an application control what happens next in an
+operation. For instance as part of form submission an
+event whose
+{{Event/type}} attribute value is
+"submit" is
+dispatched. If this
+event's
+{{Event/preventDefault()}} method is
+invoked, form submission will be terminated. Applications who wish to make
+use of this functionality through events
+dispatched by the application
+(synthetic events) can make use of the return value of the
+{{EventTarget/dispatchEvent()}} method:
+
+
+if(obj.dispatchEvent(event)) {
+ // event was not canceled, time for some magic
+ …
+}
+
+
+
+<!doctype html>
+<html>
+ <head>
+ <title>Boring example</title>
+ </head>
+ <body>
+ <p>Hello <span id=x>world</span>!</p>
+ <script>
+ function test(e) {
+ debug(e.target, e.currentTarget, e.eventPhase)
+ }
+ document.addEventListener("hey", test, {capture: true})
+ document.body.addEventListener("hey", test)
+ var ev = new Event("hey", {bubbles:true})
+ document.getElementById("x").dispatchEvent(ev)
+ </script>
+ </body>
+</html>
+
+
+debug function will be invoked twice. Each time the event's
+{{Event/target}} attribute value will be the span element. The first time
+{{Event/currentTarget}} attribute's value will be the document, the second time the
+body element. {{Event/eventPhase}} attribute's value switches from
+{{Event/CAPTURING_PHASE}} to {{Event/BUBBLING_PHASE}}. If an event listener was registered
+for the span element, {{Event/eventPhase}} attribute's value would have
+been {{Event/AT_TARGET}}.
+
+
+Interface {{Event}}
+
+
+[Exposed=(Window,Worker,AudioWorklet)]
+interface Event {
+ constructor(DOMString type, optional EventInit eventInitDict = {});
+
+ readonly attribute DOMString type;
+ readonly attribute EventTarget? target;
+ readonly attribute EventTarget? srcElement; // legacy
+ readonly attribute EventTarget? currentTarget;
+ sequence<EventTarget> composedPath();
+
+ const unsigned short NONE = 0;
+ const unsigned short CAPTURING_PHASE = 1;
+ const unsigned short AT_TARGET = 2;
+ const unsigned short BUBBLING_PHASE = 3;
+ readonly attribute unsigned short eventPhase;
+
+ undefined stopPropagation();
+ attribute boolean cancelBubble; // legacy alias of .stopPropagation()
+ undefined stopImmediatePropagation();
+
+ readonly attribute boolean bubbles;
+ readonly attribute boolean cancelable;
+ attribute boolean returnValue; // legacy
+ undefined preventDefault();
+ readonly attribute boolean defaultPrevented;
+ readonly attribute boolean composed;
+
+ [LegacyUnforgeable] readonly attribute boolean isTrusted;
+ readonly attribute DOMHighResTimeStamp timeStamp;
+
+ undefined initEvent(DOMString type, optional boolean bubbles = false, optional boolean cancelable = false); // legacy
+};
+
+dictionary EventInit {
+ boolean bubbles = false;
+ boolean cancelable = false;
+ boolean composed = false;
+};
+
+
+relatedTarget attribute. [[UIEVENTS]]
+
+
+
+
+event = new Event(type [, eventInitDict])
+ event . {{Event/type}}
+ click", "hashchange", or
+ "submit".
+
+ event . {{Event/target}}
+ event . {{Event/currentTarget}}
+ event . {{Event/composedPath()}}
+ closed" that are not reachable from event's
+ {{Event/currentTarget}}.
+
+ event . {{Event/eventPhase}}
+ event . stopPropagation()
+ event . stopImmediatePropagation()
+ event . {{Event/bubbles}}
+ event . {{Event/cancelable}}
+ event . preventDefault()
+ event . {{Event/defaultPrevented}}
+ event . {{Event/composed}}
+ event . {{Event/isTrusted}}
+ event . {{Event/timeStamp}}
+ type attribute must return the value it was
+initialized to. When an event is created the attribute must be initialized to the empty
+string.
+
+target attribute's getter, when invoked, must
+return this's target.
+
+srcElement attribute's getter, when invoked, must
+return this's target.
+
+currentTarget attribute must return the value it
+was initialized to. When an event is created the attribute must be initialized to null.
+
+composedPath() method, when invoked, must run these
+steps:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ eventPhase attribute must return the value it was
+initialized to, which must be one of the following:
+
+
+
+
+
+
+
+
+
+stopPropagation() method, when invoked, must set
+this's stop propagation flag.cancelBubble attribute's getter, when invoked,
+must return true if this's stop propagation flag is set, and false otherwise.
+
+stopImmediatePropagation() method, when invoked,
+must set this's stop propagation flag and this's
+stop immediate propagation flag.bubbles and
+cancelable attributes must return the values they were
+initialized to.
+
+returnValue attribute's getter, when invoked,
+must return false if this's canceled flag is set, and true otherwise.
+
+preventDefault() method, when invoked, must
+set the canceled flag with this.
+
+defaultPrevented attribute's getter, when
+invoked, must return true if this's canceled flag is set, and false otherwise.composed attribute's getter, when invoked, must
+return true if this's composed flag is set, and false otherwise.
+
+isTrusted attribute must return the value it was
+initialized to. When an event is created the attribute must be initialized to false.
+
+timeStamp attribute must return the value it was
+initialized to.
+
+
+
+
+
+
+initEvent(type, bubbles, cancelable)
+method, when invoked, must run these steps:
+
+
+Legacy extensions to the {{Window}} interface
+
+
+partial interface Window {
+ [Replaceable] readonly attribute any event; // legacy
+};
+
+
+event attribute's getter, when invoked, must
+return this's current event.
+
+Interface {{CustomEvent}}
+
+
+[Exposed=(Window,Worker)]
+interface CustomEvent : Event {
+ constructor(DOMString type, optional CustomEventInit eventInitDict = {});
+
+ readonly attribute any detail;
+
+ undefined initCustomEvent(DOMString type, optional boolean bubbles = false, optional boolean cancelable = false, optional any detail = null); // legacy
+};
+
+dictionary CustomEventInit : EventInit {
+ any detail = null;
+};
+
+
+Events using the
+{{CustomEvent}} interface can be used to carry custom data.
+
+
+
+
+event = new CustomEvent(type [, eventInitDict])
+ event . {{CustomEvent/detail}}
+ detail attribute must return the value it
+was initialized to.
+
+initCustomEvent(type, bubbles, cancelable, detail)
+method must, when invoked, run these steps:
+
+
+
+
+
+Constructing events
+
+Specifications may define
+event constructing steps for all or some
+events. The algorithm is passed an event as indicated in the
+inner event creation steps.
+
+
+
+
+
+
+
+timestamp property of NSEvent objects.
+
+
+
+
+
+Defining event interfaces
+
+In general, when defining a new interface that inherits from {{Event}} please always ask
+feedback from the WHATWG or the
+W3C WebApps WG community.
+
+The {{CustomEvent}} interface can be used as starting point.
+However, do not introduce any init*Event()
+methods as they are redundant with constructors. Interfaces that inherit
+from the {{Event}} interface that have such a method only have it
+for historical reasons.
+
+
+Interface {{EventTarget}}
+
+
+[Exposed=(Window,Worker,AudioWorklet)]
+interface EventTarget {
+ constructor();
+
+ undefined addEventListener(DOMString type, EventListener? callback, optional (AddEventListenerOptions or boolean) options = {});
+ undefined removeEventListener(DOMString type, EventListener? callback, optional (EventListenerOptions or boolean) options = {});
+ boolean dispatchEvent(Event event);
+};
+
+callback interface EventListener {
+ undefined handleEvent(Event event);
+};
+
+dictionary EventListenerOptions {
+ boolean capture = false;
+};
+
+dictionary AddEventListenerOptions : EventListenerOptions {
+ boolean passive = false;
+ boolean once = false;
+ AbortSignal signal;
+};
+
+
+
+
+
+click. Web compatibility prevented it
+from being removed and it is now the enshrined way of defining an activation of something. [[!HTML]]
+
+
+
+
+target = new EventTarget();
+ target . addEventListener(type, callback [, options])
+ target . removeEventListener(type, callback [, options])
+ target . dispatchEvent(event)
+
+
+
+
+
+
+
+
+
+ EventTarget() constructor, when invoked,
+must return a new {{EventTarget}}.
+
+
+
+
+
+
+addEventListener(type, callback, options)
+method, when invoked, must run these steps:
+
+
+
+
+
+
+
+document.open(). [[HTML]]
+
+removeEventListener(type, callback, options)
+method, when invoked, must run these steps:
+
+
+
+
+dispatchEvent(event) method, when
+invoked, must run these steps:
+
+
+
+
+
+Observing event listeners
+
+Dispatching events
+
+
+
+
+Document otherwise.
+ [[!HTML]]
+
+
+
+
+ click", and false otherwise.
+
+
+
+
+
+
+
+ closed", then set slot-in-closed-tree
+ to true.
+
+
+
+
+
+
+
+
+
+ capturing", and
+ legacyOutputDidListenersThrowFlag if given.
+
+
+
+
+
+ bubbling", and
+ legacyOutputDidListenersThrowFlag if given.
+
+
+
+
+
+
+
+
+
+closed", then set root-of-closed-tree to true.
+
+
+
+
+
+
+
+
+
+
+ Event type Legacy event type
+ " animationend"" webkitAnimationEnd"
+ " animationiteration"" webkitAnimationIteration"
+ " animationstart"" webkitAnimationStart"
+ " transitionend"" webkitTransitionEnd"
+
+
+
+
+
+
+
+ capturing" and listener's
+ capture is false, then continue.
+
+ bubbling" and listener's
+ capture is true, then continue.
+
+
+
+
+ handleEvent", « event », and
+ event's {{Event/currentTarget}} attribute value. If this throws an exception, then:
+
+
+
+
+ Firing events
+
+
+
+
+submit at target with its
+ {{Event/cancelable}} attribute initialized to true".
+
+ click at
+ target using {{MouseEvent}} with its {{UIEvent/detail}} attribute initialized to 1".
+
+
+
+like at target.
+
+ Action versus occurrence
+
+Aborting ongoing activities
+
+
doAmazingness({ ... }) method could accept an {{AbortSignal}} object
+ in order to support aborting as follows:
+
+
+
+
+const controller = new AbortController();
+const signal = controller.signal;
+
+startSpinner();
+
+doAmazingness({ ..., signal })
+ .then(result => ...)
+ .catch(err => {
+ if (err.name == 'AbortError') return;
+ showUserErrorMessage();
+ })
+ .then(() => stopSpinner());
+
+// …
+
+controller.abort();doAmazingness could be implemented as follows:
+
+
+
+
+function doAmazingness({signal}) {
+ if (signal.aborted) {
+ return Promise.reject(new DOMException('Aborted', 'AbortError'));
+ }
+
+ return new Promise((resolve, reject) => {
+ // Begin doing amazingness, and call resolve(result) when done.
+ // But also, watch for signals:
+ signal.addEventListener('abort', () => {
+ // Stop doing amazingness, and:
+ reject(new DOMException('Aborted', 'AbortError'));
+ });
+ });
+}
+Interface {{AbortController}}
+
+
+[Exposed=(Window,Worker)]
+interface AbortController {
+ constructor();
+
+ [SameObject] readonly attribute AbortSignal signal;
+
+ undefined abort();
+};
+
+
+
+
+
+controller = new AbortController()
+ controller . signal
+ controller . abort()
+ new AbortController()
+constructor steps are:
+
+signal getter steps are to return
+this's signal.
+
+abort() method steps are to
+signal abort on this's signal.
+
+
+Interface {{AbortSignal}}
+
+
+[Exposed=(Window,Worker)]
+interface AbortSignal : EventTarget {
+ readonly attribute boolean aborted;
+
+ attribute EventHandler onabort;
+};
+
+
+
+
+signal . aborted
+
+
+
+onabort attribute is an
+event handler IDL attribute for the onabort
+event handler, whose event handler event type is
+abort.
+
+
+
+
+
+
+
+
+
+
+Using {{AbortController}} and {{AbortSignal}} objects in
+APIs
+
+
+
+
+signal dictionary member.
+ doAmazingness(options) could be as
+ follows:
+
+
+
+signal member is present, then:
+
+
+
+
+ signal's [=AbortSignal/aborted flag=] is set, then [=reject=]
+ |p| with an "{{AbortError!!exception}}" {{DOMException}} and return |p|.
+
+ signal:
+
+
+
+
+
+
+ Nodes
+
+Introduction to "The DOM"
+
+In its original sense, "The DOM" is an API for
+accessing and manipulating documents (in particular, HTML and XML
+documents). In this specification, the term "document" is used for any
+markup-based resource, ranging from short static documents to long essays or
+reports with rich multimedia, as well as to fully-fledged interactive
+applications.
+
+
+<!DOCTYPE html>
+<html class=e>
+ <head><title>Aliens?</title></head>
+ <body>Why yes.</body>
+</html>
+
+
+It is represented as follows:
+
+
+
+
+
+
+
+
+
+html
+ html class="e"
+
+
+
+ head
+
+
+
+ title
+
+
+
+ body
+
+
+
+ Node tree
+
+
+
+
+
+
+
+
+
+Document tree
+
+Shadow tree
+
+Slots
+
+
+
+
+name, and
+ namespace is null, then:
+
+
+
+Slottables
+
+
+
+
+slot and namespace is null, then:
+
+
+
+Finding slots and slottables
+
+
+
+
+open", then return null.
+
+
+
+
+
+
+
+
+
+
+
+
+ Assigning slottables and slots
+
+
+
+
+
+
+
+Signaling slot change
+
+
+
+
+
+Mutation algorithms
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ connectedCallback", and an empty argument list.
+
+ connectedCallback will be enqueued automatically during the
+ upgrade an element algorithm.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+NodeIterator pre-removing steps given
+ node and iterator.
+
+
+
+
+ disconnectedCallback", and an empty argument list.
+
+
+
+ disconnectedCallback", and an empty argument list.
+ Mixin {{NonElementParentNode}}
+
+
+interface mixin NonElementParentNode {
+ Element? getElementById(DOMString elementId);
+};
+Document includes NonElementParentNode;
+DocumentFragment includes NonElementParentNode;
+
+
+
+
+
+node . getElementById(elementId)
+ getElementById(elementId)
+method, when invoked, must return the first element, in tree order, within
+this's descendants, whose ID is elementId, and null if
+there is no such element otherwise.
+
+
+Mixin {{DocumentOrShadowRoot}}
+
+
+interface mixin DocumentOrShadowRoot {
+};
+Document includes DocumentOrShadowRoot;
+ShadowRoot includes DocumentOrShadowRoot;
+
+
+Mixin {{ParentNode}}
+
+
+
+
+
+interface mixin ParentNode {
+ [SameObject] readonly attribute HTMLCollection children;
+ readonly attribute Element? firstElementChild;
+ readonly attribute Element? lastElementChild;
+ readonly attribute unsigned long childElementCount;
+
+ [CEReactions, Unscopable] undefined prepend((Node or DOMString)... nodes);
+ [CEReactions, Unscopable] undefined append((Node or DOMString)... nodes);
+ [CEReactions, Unscopable] undefined replaceChildren((Node or DOMString)... nodes);
+
+ Element? querySelector(DOMString selectors);
+ [NewObject] NodeList querySelectorAll(DOMString selectors);
+};
+Document includes ParentNode;
+DocumentFragment includes ParentNode;
+Element includes ParentNode;
+
+
+
+
+
+collection = node . {{ParentNode/children}}
+ element = node . {{ParentNode/firstElementChild}}
+ element = node . {{ParentNode/lastElementChild}}
+ node . prepend(nodes)
+ node . append(nodes)
+ node . replaceChildren(nodes)
+ node . querySelector(selectors)
+ node . querySelectorAll(selectors)
+ children attribute's getter must return an
+{{HTMLCollection}} collection rooted at this matching only element
+children.
+
+firstElementChild attribute's getter must
+return the first child that is an element, and null otherwise.
+
+lastElementChild attribute's getter must
+return the last child that is an element, and null otherwise.
+
+childElementCount attribute's getter must
+return the number of children of this that are elements.
+
+prepend(nodes) method, when invoked,
+must run these steps:
+
+
+
+
+append(nodes) method, when invoked,
+must run these steps:
+
+
+
+
+replaceChildren(nodes) method, when invoked,
+must run these steps:
+
+
+
+
+querySelector(selectors) method,
+when invoked, must return the first result of running scope-match a selectors string
+selectors against this, if the result is not an empty list, and null otherwise.
+
+querySelectorAll(selectors)
+method, when invoked, must return the static result of running
+scope-match a selectors string selectors against this.
+
+
+Mixin {{NonDocumentTypeChildNode}}
+
+
+interface mixin NonDocumentTypeChildNode {
+ readonly attribute Element? previousElementSibling;
+ readonly attribute Element? nextElementSibling;
+};
+Element includes NonDocumentTypeChildNode;
+CharacterData includes NonDocumentTypeChildNode;
+
+
+
+
+
+element = node . {{previousElementSibling}}
+ element = node . {{nextElementSibling}}
+ previousElementSibling
+attribute's getter must return the first preceding sibling that is an
+element, and null otherwise.
+
+nextElementSibling attribute's
+getter must return the first following sibling that is an
+element, and null otherwise.
+
+
+Mixin {{ChildNode}}
+
+
+interface mixin ChildNode {
+ [CEReactions, Unscopable] undefined before((Node or DOMString)... nodes);
+ [CEReactions, Unscopable] undefined after((Node or DOMString)... nodes);
+ [CEReactions, Unscopable] undefined replaceWith((Node or DOMString)... nodes);
+ [CEReactions, Unscopable] undefined remove();
+};
+DocumentType includes ChildNode;
+Element includes ChildNode;
+CharacterData includes ChildNode;
+
+
+
+
+
+node . {{before(...nodes)}}
+ node . {{after(...nodes)}}
+ node . {{replaceWith(...nodes)}}
+ node . {{ChildNode/remove()}}
+ before(nodes) method, when invoked,
+must run these steps:
+
+
+
+
+after(nodes) method, when invoked,
+must run these steps:
+
+
+
+
+replaceWith(nodes) method, when
+invoked, must run these steps:
+
+
+
+
+remove() method, when invoked, must run these
+steps:
+
+Mixin {{Slottable}}
+
+
+interface mixin Slottable {
+ readonly attribute HTMLSlotElement? assignedSlot;
+};
+Element includes Slottable;
+Text includes Slottable;
+
+
+assignedSlot
+attribute's getter must return the result of find a slot given this and with the
+open flag set.Old-style collections: {{NodeList}} and {{HTMLCollection}}
+
+A collection is an object that represents a list of
+nodes. A collection can be either
+live
+or static.
+Unless otherwise stated, a collection must be live.
+
+If a collection is live, then the attributes and methods
+on that object must operate on the actual underlying data, not a snapshot of
+the data.
+
+When a collection is created, a
+filter and a root are associated with it.
+
+The collection then
+represents
+a view of the subtree rooted at the collection's root, containing only nodes that match the
+given filter. The view is linear. In the absence of specific requirements to the contrary, the nodes
+within the collection must be sorted in tree order.
+
+
+Interface {{NodeList}}
+
+
+[Exposed=Window]
+interface NodeList {
+ getter Node? item(unsigned long index);
+ readonly attribute unsigned long length;
+ iterable<Node>;
+};
+
+
+
+
+
+item(index) method must return the
+indexth node in the collection. If there is no
+indexth node in the collection, then the method must return
+null.
+
+Interface {{HTMLCollection}}
+
+
+[Exposed=Window, LegacyUnenumerableNamedProperties]
+interface HTMLCollection {
+ readonly attribute unsigned long length;
+ getter Element? item(unsigned long index);
+ getter Element? namedItem(DOMString name);
+};
+
+
+sequence<T> in IDL instead).
+
+
+
+
+length attribute's getter must return
+the number of nodes represented by the collection.
+
+item(index) method, when
+invoked, must return the indexth element in the
+collection. If there is no indexth element in the
+collection, then the method must return null.
+
+
+
+
+
+
+
+ name attribute whose value is neither
+ the empty string nor is in result, append element's
+ name attribute value to
+ result.
+ namedItem(key) method, when
+invoked, must run these steps:
+
+
+
+
+
+
+
+
+
+ name attribute whose value is
+ key;
+ Mutation observers
+
+
+
+
+
+
+
+
+
+
+
+
+Interface {{MutationObserver}}
+
+
+[Exposed=Window]
+interface MutationObserver {
+ constructor(MutationCallback callback);
+
+ undefined observe(Node target, optional MutationObserverInit options = {});
+ undefined disconnect();
+ sequence<MutationRecord> takeRecords();
+};
+
+callback MutationCallback = undefined (sequence<MutationRecord> mutations, MutationObserver observer);
+
+dictionary MutationObserverInit {
+ boolean childList = false;
+ boolean attributes;
+ boolean characterData;
+ boolean subtree = false;
+ boolean attributeOldValue;
+ boolean characterDataOldValue;
+ sequence<DOMString> attributeFilter;
+};
+
+
+
+
+
+
+
+
+observer = new {{MutationObserver(callback)}}
+ observer . {{observe(target, options)}}
+
+
+
+ observer . {{disconnect()}}
+ observer . {{takeRecords()}}
+ MutationObserver(callback)
+constructor, when invoked, must run these steps:
+
+
+
+
+observe(target, options)
+method, when invoked, must run these steps:
+
+
+
+
+TypeError.
+
+ TypeError.
+
+ TypeError.
+
+ TypeError.
+
+
+
+
+
+
+disconnect() method, when invoked, must
+run these steps:
+
+
+
+
+takeRecords() method, when invoked, must
+run these steps:
+
+
+
+
+
+Queuing a mutation record
+
+
+
+
+
+
+
+
+
+
+ attributes" and options's
+ {{MutationObserverInit/attributes}} is not true
+
+
+ attributes", options's
+ {{MutationObserverInit/attributeFilter}} is present, and options's
+ {{MutationObserverInit/attributeFilter}} does not contain name or
+ namespace is non-null
+
+ characterData" and options's
+ {{MutationObserverInit/characterData}} is not true
+
+
+ childList" and options's
+ {{MutationObserverInit/childList}} is false
+
+
+ attributes" and options's
+ {{MutationObserverInit/attributeOldValue}} is true, or type is
+ "characterData" and options's
+ {{MutationObserverInit/characterDataOldValue}} is true, then set
+ interestedObservers[mo] to oldValue.
+
+
+
+
+
+
+
+childList" for target with
+ null, null, null, addedNodes, removedNodes, previousSibling,
+ and nextSibling.
+Interface {{MutationRecord}}
+
+
+[Exposed=Window]
+interface MutationRecord {
+ readonly attribute DOMString type;
+ [SameObject] readonly attribute Node target;
+ [SameObject] readonly attribute NodeList addedNodes;
+ [SameObject] readonly attribute NodeList removedNodes;
+ readonly attribute Node? previousSibling;
+ readonly attribute Node? nextSibling;
+ readonly attribute DOMString? attributeName;
+ readonly attribute DOMString? attributeNamespace;
+ readonly attribute DOMString? oldValue;
+};
+
+
+
+
+
+record . {{MutationRecord/type}}
+ attributes" if it was an
+ attribute mutation.
+ "characterData" if it was a mutation to a
+ {{CharacterData}} node. And
+ "childList" if it was a mutation to the
+ tree of
+ nodes.
+
+ record . {{MutationRecord/target}}
+ attributes", it is the
+ element whose
+ attribute changed. For
+ "characterData", it is the {{CharacterData}}
+ node. For "childList",
+ it is the node whose
+ children changed.
+
+ record . {{MutationRecord/addedNodes}}
+ record . {{MutationRecord/removedNodes}}
+ record . {{MutationRecord/previousSibling}}
+ record . {{MutationRecord/nextSibling}}
+ record . {{MutationRecord/attributeName}}
+ record . {{MutationRecord/attributeNamespace}}
+ record . {{MutationRecord/oldValue}}
+ attributes", it is the
+ value of the
+ changed attribute before the change.
+ For "characterData", it is the
+ data of the changed
+ node before the change. For
+ "childList", it is null.
+Garbage collection
+
+Interface {{Node}}
+
+
+[Exposed=Window]
+interface Node : EventTarget {
+ const unsigned short ELEMENT_NODE = 1;
+ const unsigned short ATTRIBUTE_NODE = 2;
+ const unsigned short TEXT_NODE = 3;
+ const unsigned short CDATA_SECTION_NODE = 4;
+ const unsigned short ENTITY_REFERENCE_NODE = 5; // legacy
+ const unsigned short ENTITY_NODE = 6; // legacy
+ const unsigned short PROCESSING_INSTRUCTION_NODE = 7;
+ const unsigned short COMMENT_NODE = 8;
+ const unsigned short DOCUMENT_NODE = 9;
+ const unsigned short DOCUMENT_TYPE_NODE = 10;
+ const unsigned short DOCUMENT_FRAGMENT_NODE = 11;
+ const unsigned short NOTATION_NODE = 12; // legacy
+ readonly attribute unsigned short nodeType;
+ readonly attribute DOMString nodeName;
+
+ readonly attribute USVString baseURI;
+
+ readonly attribute boolean isConnected;
+ readonly attribute Document? ownerDocument;
+ Node getRootNode(optional GetRootNodeOptions options = {});
+ readonly attribute Node? parentNode;
+ readonly attribute Element? parentElement;
+ boolean hasChildNodes();
+ [SameObject] readonly attribute NodeList childNodes;
+ readonly attribute Node? firstChild;
+ readonly attribute Node? lastChild;
+ readonly attribute Node? previousSibling;
+ readonly attribute Node? nextSibling;
+
+ [CEReactions] attribute DOMString? nodeValue;
+ [CEReactions] attribute DOMString? textContent;
+ [CEReactions] undefined normalize();
+
+ [CEReactions, NewObject] Node cloneNode(optional boolean deep = false);
+ boolean isEqualNode(Node? otherNode);
+ boolean isSameNode(Node? otherNode); // legacy alias of ===
+
+ const unsigned short DOCUMENT_POSITION_DISCONNECTED = 0x01;
+ const unsigned short DOCUMENT_POSITION_PRECEDING = 0x02;
+ const unsigned short DOCUMENT_POSITION_FOLLOWING = 0x04;
+ const unsigned short DOCUMENT_POSITION_CONTAINS = 0x08;
+ const unsigned short DOCUMENT_POSITION_CONTAINED_BY = 0x10;
+ const unsigned short DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC = 0x20;
+ unsigned short compareDocumentPosition(Node other);
+ boolean contains(Node? other);
+
+ DOMString? lookupPrefix(DOMString? namespace);
+ DOMString? lookupNamespaceURI(DOMString? prefix);
+ boolean isDefaultNamespace(DOMString? namespace);
+
+ [CEReactions] Node insertBefore(Node node, Node? child);
+ [CEReactions] Node appendChild(Node node);
+ [CEReactions] Node replaceChild(Node node, Node child);
+ [CEReactions] Node removeChild(Node child);
+};
+
+dictionary GetRootNodeOptions {
+ boolean composed = false;
+};
+
+
+
+
+
+
+
+The nodeType attribute's getter, when invoked, must return
+the first matching statement, switching on this:
+
+node . {{Node/nodeType}}
+
+
+
+ {{Node}} . {{Node/ELEMENT_NODE}} (1)
+ {{Node}} . {{Node/TEXT_NODE}} (3)
+ {{Node}} . {{Node/CDATA_SECTION_NODE}} (4)
+ {{Node}} . {{Node/PROCESSING_INSTRUCTION_NODE}} (7)
+ {{Node}} . {{Node/COMMENT_NODE}} (8)
+ {{Node}} . {{Node/DOCUMENT_NODE}} (9)
+ {{Node}} . {{Node/DOCUMENT_TYPE_NODE}} (10)
+ {{Node}} . {{Node/DOCUMENT_FRAGMENT_NODE}} (11)
+ node . {{Node/nodeName}}
+
+
+#text".
+
+ #cdata-section".
+
+ #comment".
+
+ #document".
+
+ #document-fragment".
+
+
+
+
+
+
+
+
+#text".
+
+ #cdata-section".
+
+ #comment".
+
+ #document".
+
+ #document-fragment".
+
+
+
+
+
+The node . {{Node/baseURI}}
+ baseURI attribute's getter must return
+node document's document base URL, serialized.
+
+
+
+
+
+
+node . {{Node/isConnected}}
+ node . {{Node/ownerDocument}}
+ node . {{Node/getRootNode()}}
+ node . getRootNode({ composed:true })
+ node . {{Node/parentNode}}
+ node . {{Node/parentElement}}
+ node . {{Node/hasChildNodes()}}
+ node . {{Node/childNodes}}
+ node . {{Node/firstChild}}
+ node . {{Node/lastChild}}
+ node . {{Node/previousSibling}}
+ node . {{Node/nextSibling}}
+ isConnected attribute's getter must return true,
+if this is connected, and false otherwise.ownerDocument attribute's getter must return null,
+if this is a document, and this's node document otherwise.
+
+getRootNode(options) method, when invoked,
+must return this's shadow-including root if options's
+{{GetRootNodeOptions/composed}} is true, and this's root otherwise.
+
+parentNode attribute's getter must return
+this's parent.
+
+parentElement attribute's getter must return
+this's parent element.
+
+hasChildNodes() method, when invoked, must return
+true if this has children, and false otherwise.
+
+childNodes attribute's getter must return a
+{{NodeList}} rooted at this matching only children.
+
+firstChild attribute's getter must return
+this's first child.
+
+lastChild attribute's getter must return
+this's last child.
+
+previousSibling attribute's getter must return
+this's previous sibling.
+
+nextSibling attribute's getter must return
+this's next sibling.
+
+
+
+
+
+The nodeValue attribute
+must return the following, depending on this:
+
+
+
+
+The {{Node/nodeValue}} attribute must,
+on setting, if the new value is null, act as if it was the empty string
+instead, and then do as described below, depending on this:
+
+
+
+
+textContent attribute's getter must return the
+following, switching on this:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+node . {{Node/normalize()}}
+ Text nodes and concatenates the
+ data of remaining contiguous exclusive Text nodes
+ into the first of their nodes.
+normalize() method, when invoked, must run these
+steps for each descendant exclusive Text node node of
+this:
+
+
+
+
+Text node, if any.
+
+ Text nodes (excluding itself), in
+ tree order.
+
+ Text node:
+
+
+
+
+ Text nodes
+ (excluding itself), in tree order.
+
+
+
+
+
+node . cloneNode([deep = false])
+ node . {{Node/isEqualNode(otherNode)}}
+
+
+
+
+
+ is value, with the synchronous custom elements
+ flag unset.
+
+
+
+
+ cloneNode(deep) method, when
+invoked, must run these steps:
+
+
+
+
+A node A
+equals a node
+B if all of the following conditions are true:
+
+
+
+
+
+
+ isEqualNode(otherNode) method, when
+invoked, must return true if otherNode is non-null and this equals
+otherNode, and false otherwise.
+
+isSameNode(otherNode) method, when
+invoked, must return true if otherNode is this, and false otherwise.
+
+
+
+
+
+
+These are the constants
+{{compareDocumentPosition()}}
+returns as mask:
+
+node . {{compareDocumentPosition(other)}}
+
+
+
+ {{Node}} . {{Node/DOCUMENT_POSITION_DISCONNECTED}} (1)
+ {{Node}} . {{Node/DOCUMENT_POSITION_PRECEDING}} (2)
+ {{Node}} . {{Node/DOCUMENT_POSITION_FOLLOWING}} (4)
+ {{Node}} . {{Node/DOCUMENT_POSITION_CONTAINS}} (8)
+ {{Node}} . {{Node/DOCUMENT_POSITION_CONTAINED_BY}} (16, 10 in hexadecimal)
+ node . {{Node/contains(other)}}
+
+
+
+compareDocumentPosition(other) method,
+when invoked, must run these steps:
+
+
+
+
+
+
+
+
+
+
+
+ Math.random() value can
+ be used.
+
+ contains(other) method, when invoked, must
+return true if other is an inclusive descendant of this, and false
+otherwise (including when other is null).
+
+
+
+
+
+
+
+
+
+
+xmlns" and value is
+ namespace, then return element's first such attribute's
+ local name.
+
+
+
+
+
+
+
+ xmlns", and
+ local name is prefix, or if prefix is null and it
+ has an attribute whose namespace is the
+ XMLNS namespace, namespace prefix is null, and local name
+ is "xmlns", then return its value if it is not the empty string, and
+ null otherwise.
+
+
+
+
+
+
+
+
+
+lookupPrefix(namespace) method, when
+invoked, must run these steps:
+
+
+
+
+
+
+lookupNamespaceURI(prefix) method, when
+invoked, must run these steps:
+
+
+
+
+isDefaultNamespace(namespace) method, when
+invoked, must run these steps:
+
+
+
+
+
+
+insertBefore(node, child)
+method, when invoked, must return the result of pre-inserting node into
+this before child.
+
+appendChild(node) method, when invoked,
+must return the result of appending node to this.
+
+replaceChild(node, child)
+method, when invoked, must return the result of replacing child with
+node within this.
+
+removeChild(child) method, when invoked,
+must return the result of pre-removing child from this.
+
+
+
+
+
+
+*" (U+002A), return a {{HTMLCollection}} rooted
+ at root, whose filter matches only descendant elements.
+
+
+
+
+
+
+
+When invoked with the same arguments, the same {{HTMLCollection}}
+object may be returned as returned by an earlier call.
+
+
+The
+list of elements with class names classNames
+for a node root is the
+{{HTMLCollection}} returned by the following algorithm:
+*" (U+002A), return a {{HTMLCollection}} rooted at
+ root, whose filter matches
+ descendant
+ elements.
+
+ *"
+ (U+002A), return a {{HTMLCollection}} rooted at
+ root, whose filter matches
+ descendant
+ elements whose
+ local name is
+ localName.
+
+ *"
+ (U+002A), return a {{HTMLCollection}} rooted at
+ root, whose filter matches
+ descendant
+ elements whose
+ namespace is
+ namespace.
+
+
+
+
+When invoked with the same argument, the same {{HTMLCollection}}
+object may be returned as returned by an earlier call.
+
+
+quirks", and in an identical to manner
+ otherwise.
+Interface {{Document}}
+
+
+[Exposed=Window]
+interface Document : Node {
+ constructor();
+
+ [SameObject] readonly attribute DOMImplementation implementation;
+ readonly attribute USVString URL;
+ readonly attribute USVString documentURI;
+ readonly attribute DOMString compatMode;
+ readonly attribute DOMString characterSet;
+ readonly attribute DOMString charset; // legacy alias of .characterSet
+ readonly attribute DOMString inputEncoding; // legacy alias of .characterSet
+ readonly attribute DOMString contentType;
+
+ readonly attribute DocumentType? doctype;
+ readonly attribute Element? documentElement;
+ HTMLCollection getElementsByTagName(DOMString qualifiedName);
+ HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);
+ HTMLCollection getElementsByClassName(DOMString classNames);
+
+ [CEReactions, NewObject] Element createElement(DOMString localName, optional (DOMString or ElementCreationOptions) options = {});
+ [CEReactions, NewObject] Element createElementNS(DOMString? namespace, DOMString qualifiedName, optional (DOMString or ElementCreationOptions) options = {});
+ [NewObject] DocumentFragment createDocumentFragment();
+ [NewObject] Text createTextNode(DOMString data);
+ [NewObject] CDATASection createCDATASection(DOMString data);
+ [NewObject] Comment createComment(DOMString data);
+ [NewObject] ProcessingInstruction createProcessingInstruction(DOMString target, DOMString data);
+
+ [CEReactions, NewObject] Node importNode(Node node, optional boolean deep = false);
+ [CEReactions] Node adoptNode(Node node);
+
+ [NewObject] Attr createAttribute(DOMString localName);
+ [NewObject] Attr createAttributeNS(DOMString? namespace, DOMString qualifiedName);
+
+ [NewObject] Event createEvent(DOMString interface); // legacy
+
+ [NewObject] Range createRange();
+
+ // NodeFilter.SHOW_ALL = 0xFFFFFFFF
+ [NewObject] NodeIterator createNodeIterator(Node root, optional unsigned long whatToShow = 0xFFFFFFFF, optional NodeFilter? filter = null);
+ [NewObject] TreeWalker createTreeWalker(Node root, optional unsigned long whatToShow = 0xFFFFFFFF, optional NodeFilter? filter = null);
+};
+
+[Exposed=Window]
+interface XMLDocument : Document {};
+
+dictionary ElementCreationOptions {
+ DOMString is;
+};
+
+
+{{Document}} nodes are simply
+known as documents.
+
+Each document has an associated
+encoding (an encoding),
+content type (a string),
+URL (a URL),
+origin (an origin),
+type ("xml" or "html"), and
+mode ("no-quirks", "quirks", or "limited-quirks").
+[[!ENCODING]]
+[[!URL]]
+[[!HTML]]
+
+Unless stated otherwise, a document's encoding is the utf-8
+encoding, content type is
+"application/xml", URL is "about:blank",
+origin is an opaque origin,
+type is "xml", and its
+mode is "no-quirks".
+
+A document is said to be an XML document if its
+type is "xml", and an HTML document
+otherwise. Whether a document is an HTML document or an XML document
+affects the behavior of certain APIs.
+
+A document is said to be in
+no-quirks mode if its
+mode is "no-quirks",
+quirks mode if its mode
+is "quirks", and
+limited-quirks mode if its
+mode is "limited-quirks".
+
+about:blank"). [[!HTML]]
+
+ load" or
+document does not have a browsing context, and the document's
+relevant global object otherwise.
+
+
+
+
+
+
+document = new {{Document()}}
+ document . {{Document/implementation}}
+ document . {{Document/URL}}
+ document . {{Document/documentURI}}
+ document . {{Document/compatMode}}
+ BackCompat" if document's
+ mode is "quirks", and "CSS1Compat"
+ otherwise.
+
+ document . {{Document/characterSet}}
+ document . {{Document/contentType}}
+ Document() constructor, when invoked, must
+return a new document whose origin is the origin of
+current global object's associated Document. [[!HTML]]
+
+implementation attribute's getter must return the
+{{DOMImplementation}} object that is associated with the document.
+
+The URL attribute's getter and
+documentURI attribute's getter must return the
+URL, serialized.
+
+The compatMode attribute's getter must
+return "BackCompat" if this's mode is
+"quirks", and "CSS1Compat" otherwise.
+
+The characterSet attribute's getter,
+charset attribute's getter, and
+inputEncoding attribute's getter, must return
+this's encoding's name.
+
+The contentType attribute's getter must return the
+content type.
+
+
+
+
+
+
+The *" returns a {{HTMLCollection}} of all
+ descendant elements.
+
+ *" returns a {{HTMLCollection}} of all
+ descendant
+ elements.
+
+ If only namespace is "*" returns a
+ {{HTMLCollection}} of all
+ descendant
+ elements whose
+ local name is
+ localName.
+
+ If only localName is "*" returns a
+ {{HTMLCollection}} of all
+ descendant
+ elements whose
+ namespace is
+ namespace.
+
+ Otherwise, returns a {{HTMLCollection}} of all
+ descendant
+ elements whose
+ namespace is
+ namespace and
+ local name is
+ localName.
+
+ doctype attribute's getter must return the
+child of the document that is a doctype, and null otherwise.
+
+The documentElement attribute's getter must return
+the document element.
+
+The getElementsByTagName(qualifiedName)
+method, when invoked, must return the
+list of elements with qualified name qualifiedName for this.
+
+document.getElementsByTagName("FOO") will match
+<FOO> elements that are not in the
+HTML namespace, and <foo> elements that are in
+the HTML namespace, but not <FOO> elements
+that are in the HTML namespace.
+
+The
+getElementsByTagNameNS(namespace, localName)
+method, when invoked, must return the
+list of elements with namespace namespace and local name localName for
+this.
+
+The getElementsByClassName(classNames)
+method, when invoked, must return the list of elements with class names classNames
+for this.
+
+
+
+ A call to
+
+ <div id="example">
+ <p id="p1" class="aaa bbb"/>
+ <p id="p2" class="aaa ccc"/>
+ <p id="p3" class="bbb ccc"/>
+ </div>
+ document.getElementById("example").getElementsByClassName("aaa")
+ would return a {{HTMLCollection}} with the two paragraphs
+ p1 and p2 in it.
+
+ A call to
+ getElementsByClassName("ccc bbb")
+ would only return one node, however, namely p3. A call to
+ document.getElementById("example").getElementsByClassName("bbb ccc ")
+ would return the same thing.
+
+ A call to
+ getElementsByClassName("aaa,bbb")
+ would return no nodes; none of the elements above are in the
+ aaa,bbb class.
+
+
+
+
+
+The element interface for any
+name and namespace is {{Element}}, unless
+stated otherwise.
+
+element = document . createElement(localName [, options])
+ application/xhtml+xml", and null otherwise.
+
+ Name production an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}} will be thrown.
+
+ element = document . createElementNS(namespace, qualifiedName [, options])
+
+ :" (U+003E) in
+ qualifiedName or null. Its local name will be everything after
+ ":" (U+003E) in qualifiedName or qualifiedName.
+
+ Name production an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}} will be thrown.
+
+
+
+
+ QName production.
+ xml" and namespace is not the
+ XML namespace.
+ xmlns" and namespace is not the
+ XMLNS namespace.
+ xmlns".
+ documentFragment = document . {{createDocumentFragment()}}
+ text = document . {{createTextNode(data)}}
+ text = document . {{createCDATASection(data)}}
+ comment = document . {{createComment(data)}}
+ processingInstruction = document . {{createProcessingInstruction(target, data)}}
+ Name production an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}} will be thrown.
+ If data contains "?>" an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}} will be thrown.
+html
+and the HTML namespace, the {{HTMLHtmlElement}} interface is used.
+[[!HTML]]
+
+The createElement(localName, options) method, when
+invoked, must run these steps:
+
+
+
+
+Name production, then
+ throw an "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ application/xhtml+xml", and null otherwise.
+
+ createElementNS steps, given document,
+namespace, qualifiedName, and options, are as follows:
+
+
+
+
+createElementNS(namespace, qualifiedName, options)
+method, when invoked, must return the result of running the
+internal createElementNS steps, given this, namespace,
+qualifiedName, and options.
+
+createDocumentFragment() method, when invoked,
+must return a new {{DocumentFragment}} node with its node document set to
+this.
+
+The createTextNode(data) method, when
+invoked, must return a new {{Text}} node with its data set to
+data and node document set to this.
+
+Char production.
+
+createCDATASection(data) method, when
+invoked, must run these steps:
+
+
+
+
+The ]]>", then throw an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ createComment(data) method, when invoked,
+must return a new {{Comment}} node with its data set to
+data and node document set to this.
+
+Char production
+or that it contains two adjacent hyphens or ends with a hyphen.
+
+The
+createProcessingInstruction(target, data)
+method, when invoked, must run these steps:
+
+
+
+
+Name production,
+ then throw an "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ ?>", then throw an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ xml" or ":", or that
+data contains characters that match the
+Char production.
+
+
+
+
+
+
+The importNode(node, deep) method,
+when invoked, must run these steps:
+
+
+
+
+
+
+
+The
+
+
+
+
+ adoptedCallback", and an argument list containing oldDocument and
+ document.
+
+ adoptNode(node) method, when invoked,
+must run these steps:
+
+
+
+
+
+
+The createAttribute(localName) method, when
+invoked, must run these steps:
+
+
+
+
+The
+Name production in XML,
+ then throw an "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ createAttributeNS(namespace, qualifiedName)
+method, when invoked, must run these steps:
+
+
+
+
+
+
+createEvent(interface) method, when
+invoked, must run these steps:
+
+
+
+
+
+
+
+
+ String Interface Notes
+ " beforeunloadevent"{{BeforeUnloadEvent}} [[!HTML]]
+ " compositionevent"{{CompositionEvent}} [[!UIEVENTS]]
+
+ " customevent"{{CustomEvent}}
+ " devicemotionevent"{{DeviceMotionEvent}} [[!DEVICE-ORIENTATION]]
+ " deviceorientationevent"{{DeviceOrientationEvent}}
+ " dragevent"{{DragEvent}} [[!HTML]]
+ " event"{{Event}}
+ " events"
+
+ " focusevent"{{FocusEvent}} [[!UIEVENTS]]
+ " hashchangeevent"{{HashChangeEvent}} [[!HTML]]
+ " htmlevents"{{Event}}
+ " keyboardevent"{{KeyboardEvent}} [[!UIEVENTS]]
+ " messageevent"{{MessageEvent}} [[!HTML]]
+ " mouseevent"{{MouseEvent}} [[!UIEVENTS]]
+ " mouseevents"
+ " storageevent"{{StorageEvent}} [[!HTML]]
+ " svgevents"{{Event}}
+ " textevent"{{CompositionEvent}} [[!UIEVENTS]]
+ " touchevent"{{TouchEvent}} [[!TOUCH-EVENTS]]
+ " uievent"{{UIEvent}} [[!UIEVENTS]]
+ " uievents"
+
+
+createRange() method, when invoked, must return a
+new live range with (this, 0) as its start an end.
+
+
+
+createNodeIterator(root, whatToShow, filter)
+method, when invoked, must run these steps:
+
+
+
+
+createTreeWalker(root, whatToShow, filter)
+method, when invoked, must run these steps:
+
+
+
+
+
+Interface {{DOMImplementation}}
+
+User agents must create a {{DOMImplementation}} object whenever
+a document is created and associate it
+with that document.
+
+
+[Exposed=Window]
+interface DOMImplementation {
+ [NewObject] DocumentType createDocumentType(DOMString qualifiedName, DOMString publicId, DOMString systemId);
+ [NewObject] XMLDocument createDocument(DOMString? namespace, [LegacyNullToEmptyString] DOMString qualifiedName, optional DocumentType? doctype = null);
+ [NewObject] Document createHTMLDocument(optional DOMString title);
+
+ boolean hasFeature(); // useless; always returns true
+};
+
+
+
+
+
+doctype = document . {{Document/implementation}} . {{createDocumentType(qualifiedName, publicId, systemId)}}
+
+ Name production, an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}} is thrown, and if it does not match the
+ QName production, a
+ "{{NamespaceError!!exception}}" {{DOMException}} is thrown.
+
+ doc = document . {{Document/implementation}} . createDocument(namespace, qualifiedName [, doctype = null])
+
+ doc = document . {{Document/implementation}} . createHTMLDocument([title])
+
+ createDocumentType(qualifiedName, publicId, systemId)
+method, when invoked, must run these steps:
+
+
+
+
+PubidChar production or that systemId does not contain both a
+'"' and a "'".
+
+createDocument(namespace, qualifiedName, doctype)
+method, when invoked, must run these steps:
+
+
+
+
+The
+createElementNS steps, given
+ document, namespace, qualifiedName, and an empty dictionary.
+
+
+
+
+ application/xhtml+xml
+
+ image/svg+xml
+
+ application/xml
+ createHTMLDocument(title)
+method, when invoked, must run these steps:
+
+
+
+
+The text/html".
+
+ html" as its
+ name and with its node document set to doc, to
+ doc.
+
+
+
+
+ hasFeature() method, when
+invoked, must return true.
+
+Interface {{DocumentType}}
+
+
+[Exposed=Window]
+interface DocumentType : Node {
+ readonly attribute DOMString name;
+ readonly attribute DOMString publicId;
+ readonly attribute DOMString systemId;
+};
+
+
+name attribute's getter must return
+this's name.
+
+publicId attribute's getter must return
+this's public ID.
+
+systemId attribute's getter must return
+this's system ID.
+
+
+Interface {{DocumentFragment}}
+
+
+[Exposed=Window]
+interface DocumentFragment : Node {
+ constructor();
+};
+
+
+
+
+
+tree = new {{DocumentFragment()}}
+ DocumentFragment() constructor, when
+invoked, must return a new {{DocumentFragment}} node whose node document is
+current global object's associated Document.
+
+
+Interface {{ShadowRoot}}
+
+
+[Exposed=Window]
+interface ShadowRoot : DocumentFragment {
+ readonly attribute ShadowRootMode mode;
+ readonly attribute Element host;
+ attribute EventHandler onslotchange;
+};
+
+enum ShadowRootMode { "open", "closed" };
+
+
+open"
+or "closed").mode attribute's getter must return
+this's mode.host attribute's getter must return
+this's host.
+
+onslotchange attribute is an
+event handler IDL attribute for the
+onslotchange event handler, whose
+event handler event type is {{HTMLSlotElement/slotchange}}.
+
+
+
+
+
+
+closed" or A's root's
+ host is closed-shadow-hidden from B.
+
+
+
+
+
+
+ Interface {{Element}}
+
+
+[Exposed=Window]
+interface Element : Node {
+ readonly attribute DOMString? namespaceURI;
+ readonly attribute DOMString? prefix;
+ readonly attribute DOMString localName;
+ readonly attribute DOMString tagName;
+
+ [CEReactions] attribute DOMString id;
+ [CEReactions] attribute DOMString className;
+ [SameObject, PutForwards=value] readonly attribute DOMTokenList classList;
+ [CEReactions, Unscopable] attribute DOMString slot;
+
+ boolean hasAttributes();
+ [SameObject] readonly attribute NamedNodeMap attributes;
+ sequence<DOMString> getAttributeNames();
+ DOMString? getAttribute(DOMString qualifiedName);
+ DOMString? getAttributeNS(DOMString? namespace, DOMString localName);
+ [CEReactions] undefined setAttribute(DOMString qualifiedName, DOMString value);
+ [CEReactions] undefined setAttributeNS(DOMString? namespace, DOMString qualifiedName, DOMString value);
+ [CEReactions] undefined removeAttribute(DOMString qualifiedName);
+ [CEReactions] undefined removeAttributeNS(DOMString? namespace, DOMString localName);
+ [CEReactions] boolean toggleAttribute(DOMString qualifiedName, optional boolean force);
+ boolean hasAttribute(DOMString qualifiedName);
+ boolean hasAttributeNS(DOMString? namespace, DOMString localName);
+
+ Attr? getAttributeNode(DOMString qualifiedName);
+ Attr? getAttributeNodeNS(DOMString? namespace, DOMString localName);
+ [CEReactions] Attr? setAttributeNode(Attr attr);
+ [CEReactions] Attr? setAttributeNodeNS(Attr attr);
+ [CEReactions] Attr removeAttributeNode(Attr attr);
+
+ ShadowRoot attachShadow(ShadowRootInit init);
+ readonly attribute ShadowRoot? shadowRoot;
+
+ Element? closest(DOMString selectors);
+ boolean matches(DOMString selectors);
+ boolean webkitMatchesSelector(DOMString selectors); // legacy alias of .matches
+
+ HTMLCollection getElementsByTagName(DOMString qualifiedName);
+ HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);
+ HTMLCollection getElementsByClassName(DOMString classNames);
+
+ [CEReactions] Element? insertAdjacentElement(DOMString where, Element element); // legacy
+ undefined insertAdjacentText(DOMString where, DOMString data); // legacy
+};
+
+dictionary ShadowRootInit {
+ required ShadowRootMode mode;
+ boolean delegatesFocus = false;
+};
+
+
+is value. When an
+element is created, all of these values are
+initialized.
+
+undefined", "failed", "uncustomized",
+"precustomized", or "custom". An element whose
+custom element state is "uncustomized" or "custom" is
+said to be defined. An element
+whose custom element state is "custom" is said to be
+custom.
+
+failed" and "precustomized" states are used to ensure that if a
+custom element constructor fails to execute correctly the first time, it is not executed
+again by an upgrade.
+
+ <!DOCTYPE html>
+ <script>
+ window.customElements.define("sw-rey", class extends HTMLElement {})
+ window.customElements.define("sw-finn", class extends HTMLElement {}, { extends: "p" })
+ window.customElements.define("sw-kylo", class extends HTMLElement {
+ constructor() {
+ // super() intentionally omitted for this example
+ }
+ })
+ </script>
+
+ <!-- "undefined" (not defined, not custom) -->
+ <sw-han></sw-han>
+ <p is="sw-luke"></p>
+ <p is="asdf"></p>
+
+ <!-- "failed" (not defined, not custom) -->
+ <sw-kylo></sw-kylo>
+
+ <!-- "uncustomized" (defined, not custom) -->
+ <p></p>
+ <asdf></asdf>
+
+ <!-- "custom" (defined, custom) -->
+ <sw-rey></sw-rey>
+ <p is="sw-finn"></p>
+ :", followed by its
+local name, otherwise.
+
+
+
+
+
+
+
+
+
+ undefined",
+ custom element definition set to null,
+ is value set to is, and node document set to
+ document.
+
+
+
+
+
+
+ failed".
+
+
+
+
+
+ is value to null.
+
+
+ failed",
+ custom element definition set to null,
+ is value set to null, and node document set to
+ document.
+
+
+ undefined", custom element definition set to null,
+ is value set to null, and node document set to
+ document.
+
+
+
+ uncustomized", custom element definition set to null,
+ is value set to is, and node document set to
+ document.
+
+ undefined".
+
+
+
+attributes" for element with
+ attribute's local name, attribute's
+ namespace, oldValue, « », « », null, and null.
+
+ attributeChangedCallback", and an argument list containing attribute's
+ local name, oldValue, newValue, and attribute's
+ namespace.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+id attribute and a DTD. This specification makes ID
+a concept of the DOM and allows for only one per element, given by an
+id attribute.
+
+
+
+
+id, namespace is null, and
+ value is null or the empty string, then unset element's
+ ID.
+
+ id, namespace is null, then
+ set element's ID to value.
+class,
+id, and slot attributes on any element, it makes no
+claims as to whether using them is conforming or not.
+
+
+
+A node's
+parent of type
+{{Element}} is known as a parent element. If the
+node has a
+parent of a different type, its
+parent element is null.
+
+
+
+
+
+
+namespaceURI attribute's getter must return
+this's namespace.
+
+prefix attribute's getter must return
+this's namespace prefix.
+
+localName attribute's getter must return
+this's local name.
+
+tagName attribute's getter must return
+this's HTML-uppercased qualified name.
+
+
+
+
+
+
+element . id [ = value ]
+ id content attribute. Can be set to
+ change it.
+
+ element . className [ = value ]
+ class content attribute. Can be set
+ to change it.
+
+ element . classList
+ class content attribute as a
+ set of whitespace-separated tokens through a {{DOMTokenList}} object.
+
+ element . slot [ = value ]
+ slot content attribute. Can be set to
+ change it.
+
+
+
+id attribute must reflect the
+"id" content attribute.
+
+className attribute must
+reflect the "class" content attribute.
+
+classList attribute's getter must return a
+{{DOMTokenList}} object whose associated element is this and whose associated
+attribute's local name is class. The token set of this
+particular {{DOMTokenList}} object are also known as the element's
+classes.
+
+slot attribute must reflect the
+"slot" content attribute.
+
+id, class, and slot are effectively
+superglobal attributes as they can appear on any element, regardless of that element's
+namespace.
+
+
+
+
+element . hasAttributes()
+ element . getAttributeNames()
+ element . getAttribute(qualifiedName)
+ element . getAttributeNS(namespace, localName)
+ element . setAttribute(qualifiedName, value)
+ element . setAttributeNS(namespace, localName, value)
+ element . removeAttribute(qualifiedName)
+ element . removeAttributeNS(namespace, localName)
+ element . toggleAttribute(qualifiedName [, force])
+ element . hasAttribute(qualifiedName)
+ element . hasAttributeNS(namespace, localName)
+ hasAttributes() method, when invoked, must return
+false if this's attribute list is empty, and true
+otherwise.
+
+attributes attribute's getter must return the
+associated {{NamedNodeMap}}.
+
+getAttributeNames() method, when invoked, must
+return the qualified names of the attributes in this's
+attribute list, in order, and a new list otherwise.
+
+getAttribute(qualifiedName) method,
+when invoked, must run these steps:
+
+
+
+
+getAttributeNS(namespace, localName)
+method, when invoked, must these steps:
+
+
+
+
+setAttribute(qualifiedName, value)
+method, when invoked, must run these steps:
+
+
+
+
+Name production in
+ XML, then throw an "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ setAttributeNS(namespace, qualifiedName, value)
+method, when invoked, must run these steps:
+
+
+
+
+removeAttribute(qualifiedName)
+method, when invoked, must remove an attribute given
+qualifiedName and this, and then return undefined.
+
+removeAttributeNS(namespace, localName)
+method, when invoked, must
+remove an attribute given
+namespace, localName, and this, and then return undefined.
+
+hasAttribute(qualifiedName) method,
+when invoked, must run these steps:
+
+
+
+
+toggleAttribute(qualifiedName, force)
+method, when invoked, must run these steps:
+
+
+
+
+Name production in
+ XML, then throw an "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+
+
+
+ hasAttributeNS(namespace, localName)
+method, when invoked, must run these steps:
+
+
+
+
+
+
+getAttributeNode(qualifiedName)
+method, when invoked, must return the result of
+getting an attribute given qualifiedName and
+this.
+
+getAttributeNodeNS(namespace, localName)
+method, when invoked, must return the result of
+getting an attribute given
+namespace, localName, and this.
+
+setAttributeNode(attr) and
+setAttributeNodeNS(attr) methods, when
+invoked, must return the result of setting an attribute given
+attr and this.
+
+removeAttributeNode(attr) method,
+when invoked, must run these steps:
+
+
+
+
+
+
+
+
+
+var shadow = element . {{attachShadow(init)}}
+ var shadow = element . {{shadowRoot}}
+ open", and null otherwise.
+attachShadow(init) method, when
+invoked, must run these steps:
+
+
+
+
+
+
+
+ article",
+ "aside",
+ "blockquote",
+ "body",
+ "div",
+ "footer",
+ "h1",
+ "h2",
+ "h3",
+ "h4",
+ "h5",
+ "h6",
+ "header",
+ "main",
+ "nav",
+ "p",
+ "section", or
+ "span"
+ is value is not null, then:
+
+
+
+ is value.
+
+ precustomized" or
+ "custom", then set shadow's
+ available to element internals to true.
+
+ shadowRoot attribute's getter must run these
+steps:
+
+
+
+
+closed",
+ then return null.
+
+
+
+
+The element . {{closest(selectors)}}
+ element . {{matches(selectors)}}
+ closest(selectors)
+method, when invoked, must run these steps:
+
+
+
+
+The matches(selectors) and
+webkitMatchesSelector(selectors) methods, when
+invoked, must run these steps:
+
+
+
+
+
+
+getElementsByTagName(qualifiedName)
+method, when invoked, must return the
+list of elements with qualified name qualifiedName for this.
+
+getElementsByTagNameNS(namespace, localName)
+method, when invoked, must return the
+list of elements with namespace namespace and local name localName for
+this.
+
+getElementsByClassName(classNames)
+method, when invoked, must return the list of elements with class names classNames
+for this.
+
+
+
+
+
+
+beforebegin"
+ afterbegin"
+ beforeend"
+ afterend"
+ insertAdjacentElement(where, element)
+method, when invoked, must return the result of running insert adjacent, give this,
+where, and element.
+
+insertAdjacentText(where, data)
+method, when invoked, must run these steps:
+
+
+
+
+Interface {{NamedNodeMap}}
+
+
+[Exposed=Window,
+ LegacyUnenumerableNamedProperties]
+interface NamedNodeMap {
+ readonly attribute unsigned long length;
+ getter Attr? item(unsigned long index);
+ getter Attr? getNamedItem(DOMString qualifiedName);
+ Attr? getNamedItemNS(DOMString? namespace, DOMString localName);
+ [CEReactions] Attr? setNamedItem(Attr attr);
+ [CEReactions] Attr? setNamedItemNS(Attr attr);
+ [CEReactions] Attr removeNamedItem(DOMString qualifiedName);
+ [CEReactions] Attr removeNamedItemNS(DOMString? namespace, DOMString localName);
+};
+
+
+A {{NamedNodeMap}} has an associated
+element (an
+element).
+
+A {{NamedNodeMap}} object's
+attribute list is its
+element's
+attribute list.
+
+
+
+length attribute's getter must return
+the attribute list's size.
+
+item(index) method, when
+invoked, must run these steps:
+
+
+
+
+
+
+
+
+
+
+ getNamedItem(qualifiedName)
+method, when invoked, must return the result of
+getting an attribute given qualifiedName and
+element.
+
+getNamedItemNS(namespace, localName)
+method, when invoked, must return the result of
+getting an attribute given
+namespace, localName, and
+element.
+
+setNamedItem(attr) and
+setNamedItemNS(attr)
+methods, when invoked, must return the result of setting an attribute
+given attr and element.
+
+removeNamedItem(qualifiedName)
+method, when invoked, must run these steps:
+
+
+
+
+removeNamedItemNS(namespace, localName)
+method, when invoked, must run these steps:
+
+
+
+
+
+Interface {{Attr}}
+
+
+[Exposed=Window]
+interface Attr : Node {
+ readonly attribute DOMString? namespaceURI;
+ readonly attribute DOMString? prefix;
+ readonly attribute DOMString localName;
+ readonly attribute DOMString name;
+ [CEReactions] attribute DOMString value;
+
+ readonly attribute Element? ownerElement;
+
+ readonly attribute boolean specified; // useless; always returns true
+};
+
+:", followed by its
+local name, otherwise.
+
+A attribute
+is an attribute whose
+local name is
+A and whose
+namespace and
+namespace prefix are
+null.
+
+
+
+namespaceURI attribute's getter must return the
+namespace.
+
+prefix attribute's getter must return the
+namespace prefix.
+
+localName attribute's getter must return the
+local name.
+
+name attribute's getter must return the
+qualified name.
+
+value attribute's getter must return the
+value.
+
+
+
+
+
+
+ownerElement attribute's getter must return
+this's element.
+
+
+
+specified attribute's getter must return true.
+
+
+Interface {{CharacterData}}
+
+
+[Exposed=Window]
+interface CharacterData : Node {
+ attribute [LegacyNullToEmptyString] DOMString data;
+ readonly attribute unsigned long length;
+ DOMString substringData(unsigned long offset, unsigned long count);
+ undefined appendData(DOMString data);
+ undefined insertData(unsigned long offset, DOMString data);
+ undefined deleteData(unsigned long offset, unsigned long count);
+ undefined replaceData(unsigned long offset, unsigned long count, DOMString data);
+};
+
+
+
+
+
+
+
+
+
+To substring data with node
+node, offset offset, and count
+count, run these steps:
+
+characterData" for node with
+ null, null, node's data, « », « », null, and null.
+
+
+
+
+data attribute's getter must return
+this's data. Its setter must replace data with node
+this, offset 0, count this's length, and data new value.
+
+length attribute's getter must return
+this's length.
+
+substringData(offset, count)
+method, when invoked, must return the result of running substring data with node this,
+offset offset, and count count.
+
+appendData(data) method, when
+invoked, must replace data with node this, offset this's
+length, count 0, and data data.
+
+insertData(offset, data)
+method, when invoked, must replace data with node this, offset offset,
+count 0, and data data.
+
+deleteData(offset, count)
+method, when invoked, must replace data with node this, offset offset,
+count count, and data the empty string.
+
+replaceData(offset, count, data)
+method, when invoked, must replace data with node this, offset offset,
+count count, and data data.
+
+
+Interface {{Text}}
+
+
+[Exposed=Window]
+interface Text : CharacterData {
+ constructor(optional DOMString data = "");
+
+ [NewObject] Text splitText(unsigned long offset);
+ readonly attribute DOMString wholeText;
+};
+
+
+
+
+
+text = new Text([data = ""])
+ text . {{Text/splitText(offset)}}
+ text . {{Text/wholeText}}
+
+
+Text nodes, and node's next sibling {{Text}}
+node, if any, and its contiguous Text nodes, avoiding any duplicates.
+
+Text node,
+if any, and its contiguous exclusive Text nodes, and node's
+next sibling exclusive Text node, if any, and its
+contiguous exclusive Text nodes, avoiding any duplicates.
+
+
+
+Text(data) constructor, when invoked,
+must return a new {{Text}} node whose data is data and
+node document is current global object's
+associated Document.
+
+To split a {{Text}}
+node node with offset
+offset, run these steps:
+
+
+
+
+
+
+
+ splitText(offset) method, when invoked,
+must split this with offset offset.
+
+wholeText attribute's getter must return the
+concatenation of the data of the
+contiguous Text nodes of this, in tree order.
+
+
+Interface {{CDATASection}}
+
+
+[Exposed=Window]
+interface CDATASection : Text {
+};
+
+
+Interface {{ProcessingInstruction}}
+
+
+[Exposed=Window]
+interface ProcessingInstruction : CharacterData {
+ readonly attribute DOMString target;
+};
+
+
+{{ProcessingInstruction}} nodes
+have an associated target.
+
+The target
+attribute must return the target.
+
+
+Interface {{Comment}}
+
+
+[Exposed=Window]
+interface Comment : CharacterData {
+ constructor(optional DOMString data = "");
+};
+
+
+
+
+
+comment = new Comment([data = ""])
+ Comment(data) constructor, when
+invoked, must return a new {{Comment}} node whose data is
+data and node document is current global object's
+associated Document.
+
+
+
+Ranges
+
+Introduction to "DOM Ranges"
+
+
+
+
+
+p
+
+
+<img src="insanity-wolf" alt="Little-endian BOM; decode as big-endian!">
+ <em>
+
+
+ p element, and
+em to the em
+element, this would be done as follows:
+
+
+
+
+var range = new Range(),
+ firstText = p.childNodes[1],
+ secondText = em.firstChild
+range.setStart(firstText, 9) // do not forget the leading space
+range.setEnd(secondText, 4)
+// range now stringifies to the aforementioned quote
+src and alt in the
+node tree above cannot be represented by a range. Ranges are only useful for
+nodes.
+
+Boundary points
+
+
+
+
+
+Interface {{AbstractRange}}
+
+
+[Exposed=Window]
+interface AbstractRange {
+ readonly attribute Node startContainer;
+ readonly attribute unsigned long startOffset;
+ readonly attribute Node endContainer;
+ readonly attribute unsigned long endOffset;
+ readonly attribute boolean collapsed;
+};
+
+
+
+
+
+node = range . startContainer
+ offset = range . startOffset
+ node = range . endContainer
+ offset = range . endOffset
+ collapsed = range . collapsed
+ startContainer
+attribute's getter must return this's start node.
+
+startOffset
+attribute's getter must return this's start offset.
+
+endContainer
+attribute's getter must return this's end node.
+
+endOffset
+attribute's getter must return this's end offset.
+
+collapsed
+attribute's getter must return true if this is collapsed, and false
+otherwise.
+
+
+Interface {{StaticRange}}
+
+
+dictionary StaticRangeInit {
+ required Node startContainer;
+ required unsigned long startOffset;
+ required Node endContainer;
+ required unsigned long endOffset;
+};
+
+[Exposed=Window]
+interface StaticRange : AbstractRange {
+ constructor(StaticRangeInit init);
+};
+
+
+
+
+
+staticRange = new StaticRange(init)
+ StaticRange(init) constructor,
+when invoked, must run these steps:
+
+
+
+
+
+Interface {{Range}}
+
+
+[Exposed=Window]
+interface Range : AbstractRange {
+ constructor();
+
+ readonly attribute Node commonAncestorContainer;
+
+ undefined setStart(Node node, unsigned long offset);
+ undefined setEnd(Node node, unsigned long offset);
+ undefined setStartBefore(Node node);
+ undefined setStartAfter(Node node);
+ undefined setEndBefore(Node node);
+ undefined setEndAfter(Node node);
+ undefined collapse(optional boolean toStart = false);
+ undefined selectNode(Node node);
+ undefined selectNodeContents(Node node);
+
+ const unsigned short START_TO_START = 0;
+ const unsigned short START_TO_END = 1;
+ const unsigned short END_TO_END = 2;
+ const unsigned short END_TO_START = 3;
+ short compareBoundaryPoints(unsigned short how, Range sourceRange);
+
+ [CEReactions] undefined deleteContents();
+ [CEReactions, NewObject] DocumentFragment extractContents();
+ [CEReactions, NewObject] DocumentFragment cloneContents();
+ [CEReactions] undefined insertNode(Node node);
+ [CEReactions] undefined surroundContents(Node newParent);
+
+ [NewObject] Range cloneRange();
+ undefined detach();
+
+ boolean isPointInRange(Node node, unsigned long offset);
+ short comparePoint(Node node, unsigned long offset);
+
+ boolean intersectsNode(Node node);
+
+ stringifier;
+};
+
+
+
+
+
+
+
+
+
+range = new Range()
+ Range() constructor, when invoked, must return
+a new live range with
+(current global object's associated Document, 0) as its
+start and end.
+
+
+
+
+
+
+commonAncestorContainer attribute's getter must
+run these steps:
+
+
+
+
+
+
+
+
+
+
+
+setStart(node, offset) method,
+when invoked, must set the start of this to boundary point
+(node, offset).
+
+setEnd(node, offset) method,
+when invoked, must set the end of this to boundary point
+(node, offset).
+
+setStartBefore(node) method, when
+invoked, must run these steps:
+
+
+
+
+setStartAfter(node) method, when invoked,
+must run these steps:
+
+
+
+
+setEndBefore(node), when invoked, method
+must run these steps:
+
+
+
+
+setEndAfter(node) method, when invoked,
+must run these steps:
+
+
+
+
+collapse(toStart) method, when invoked,
+must if toStart is true, set end to start, and set
+start to end otherwise.
+
+
+
+
+selectNode(node) method, when invoked,
+must select node within this.
+
+selectNodeContents(node) method, when
+invoked, must run these steps:
+
+
+
+
+
+
+compareBoundaryPoints(how, sourceRange)
+method, when invoked, must run these steps:
+
+
+
+
+
+
+
+
+
+
+ deleteContents() method, when invoked, must
+run these steps:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ extractContents() method, when invoked, must return
+the result of extracting this.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ cloneContents() method, when invoked, must return
+the result of cloning the contents of this.
+
+
+
+
+insertNode(node) method, when invoked,
+must insert node into this.
+
+surroundContents(newParent) method, when
+invoked, must run these steps:
+
+
+
+
+
+
+cloneRange() method, when invoked, must return a new
+live range with the same start and end as this.
+
+detach() method, when invoked, must do nothing.
+Its functionality (disabling a {{Range}} object) was removed, but the method itself
+is preserved for compatibility.
+
+
+
+
+
+
+isPointInRange(node, offset)
+method, when invoked, must run these steps:
+
+
+
+
+
+comparePoint(node, offset)
+method, when invoked, must run these steps:
+
+
+
+
+
+
+
+intersectsNode(node) method, when
+invoked, must run these steps:
+
+
+
+
+
+
+
+
+
+Traversal
+
+
+
+
+
+acceptNode", and
+ « node ». If this throws an exception, then unset traverser's
+ active flag and rethrow the exception.
+
+ Interface {{NodeIterator}}
+
+
+[Exposed=Window]
+interface NodeIterator {
+ [SameObject] readonly attribute Node root;
+ readonly attribute Node referenceNode;
+ readonly attribute boolean pointerBeforeReferenceNode;
+ readonly attribute unsigned long whatToShow;
+ readonly attribute NodeFilter? filter;
+
+ Node? nextNode();
+ Node? previousNode();
+
+ undefined detach();
+};
+
+
+NodeIterator pre-removing steps given a nodeIterator and
+toBeRemovedNode, are as follows:
+
+
+
+
+
+
+
+
+
+root attribute's getter, when invoked,
+must return this's root.
+
+referenceNode attribute's getter, when
+invoked, must return this's reference.
+
+pointerBeforeReferenceNode attribute's
+getter, when invoked, must return this's pointer before reference.
+
+whatToShow attribute's getter, when
+invoked, must return this's whatToShow.
+
+filter attribute's getter, when invoked,
+must return this's filter.
+
+
+
+
+
+
+
+
+
+
+ nextNode() method, when invoked, must return
+the result of traversing with this and next.
+
+previousNode() method, when invoked, must
+return the result of traversing with this and previous.
+
+detach() method, when invoked, must do
+nothing. Its functionality (disabling a {{NodeIterator}} object) was removed, but
+the method itself is preserved for compatibility.
+
+
+Interface {{TreeWalker}}
+
+
+[Exposed=Window]
+interface TreeWalker {
+ [SameObject] readonly attribute Node root;
+ readonly attribute unsigned long whatToShow;
+ readonly attribute NodeFilter? filter;
+ attribute Node currentNode;
+
+ Node? parentNode();
+ Node? firstChild();
+ Node? lastChild();
+ Node? previousSibling();
+ Node? nextSibling();
+ Node? previousNode();
+ Node? nextNode();
+};
+
+root attribute's getter, when invoked, must
+return this's root.
+
+whatToShow attribute's getter, when invoked,
+must return this's whatToShow.
+
+filter attribute's getter, when invoked,
+must return this's filter.
+
+currentNode attribute's getter, when
+invoked, must return this's current.
+
+
+
+parentNode() method, when invoked, must run
+these steps:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ firstChild() method, when invoked, must
+traverse children with this and first.
+
+lastChild() method, when invoked, must
+traverse children with this and last.
+
+
+
+
+
+
+
+
+
+ nextSibling() method, when invoked, must
+traverse siblings with this and next.
+
+previousSibling() method, when invoked, must
+traverse siblings with this and previous.
+
+previousNode() method, when invoked, must run
+these steps:
+
+
+
+
+
+
+
+
+
+
+
+
+
+ nextNode() method, when invoked, must run these
+steps:
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Interface {{NodeFilter}}
+
+
+[Exposed=Window]
+callback interface NodeFilter {
+ // Constants for acceptNode()
+ const unsigned short FILTER_ACCEPT = 1;
+ const unsigned short FILTER_REJECT = 2;
+ const unsigned short FILTER_SKIP = 3;
+
+ // Constants for whatToShow
+ const unsigned long SHOW_ALL = 0xFFFFFFFF;
+ const unsigned long SHOW_ELEMENT = 0x1;
+ const unsigned long SHOW_ATTRIBUTE = 0x2;
+ const unsigned long SHOW_TEXT = 0x4;
+ const unsigned long SHOW_CDATA_SECTION = 0x8;
+ const unsigned long SHOW_ENTITY_REFERENCE = 0x10; // legacy
+ const unsigned long SHOW_ENTITY = 0x20; // legacy
+ const unsigned long SHOW_PROCESSING_INSTRUCTION = 0x40;
+ const unsigned long SHOW_COMMENT = 0x80;
+ const unsigned long SHOW_DOCUMENT = 0x100;
+ const unsigned long SHOW_DOCUMENT_TYPE = 0x200;
+ const unsigned long SHOW_DOCUMENT_FRAGMENT = 0x400;
+ const unsigned long SHOW_NOTATION = 0x800; // legacy
+
+ unsigned short acceptNode(Node node);
+};
+
+
+
+
+
+FILTER_ACCEPT (1);
+ FILTER_REJECT (2);
+ FILTER_SKIP (3).
+
+
+
+
+
+SHOW_ALL (4294967295, FFFFFFFF in hexadecimal);
+ SHOW_ELEMENT (1);
+ SHOW_ATTRIBUTE (2);
+ SHOW_TEXT (4);
+ SHOW_CDATA_SECTION (8);
+ SHOW_PROCESSING_INSTRUCTION (64, 40 in hexadecimal);
+ SHOW_COMMENT (128, 80 in hexadecimal);
+ SHOW_DOCUMENT (256, 100 in hexadecimal);
+ SHOW_DOCUMENT_TYPE (512, 200 in hexadecimal);
+ SHOW_DOCUMENT_FRAGMENT (1024, 400 in hexadecimal).
+Sets
+
+Interface {{DOMTokenList}}
+
+
+[Exposed=Window]
+interface DOMTokenList {
+ readonly attribute unsigned long length;
+ getter DOMString? item(unsigned long index);
+ boolean contains(DOMString token);
+ [CEReactions] undefined add(DOMString... tokens);
+ [CEReactions] undefined remove(DOMString... tokens);
+ [CEReactions] boolean toggle(DOMString token, optional boolean force);
+ [CEReactions] boolean replace(DOMString token, DOMString newToken);
+ boolean supports(DOMString token);
+ [CEReactions] stringifier attribute DOMString value;
+ iterable<DOMString>;
+};
+
+
+
+
+
+TypeError.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+tokenlist . {{DOMTokenList/length}}
+ tokenlist . {{DOMTokenList/item(index)}}
+ tokenlist[index]
+ tokenlist . {{DOMTokenList/contains(token)}}
+ tokenlist . add(tokens…)
+ tokenlist . remove(tokens…)
+ tokenlist . toggle(token [, force])
+ tokenlist . replace(token, newToken)
+ tokenlist . supports(token)
+ TypeError if the associated attribute has no supported tokens defined.
+
+ tokenlist . {{DOMTokenList/value}}
+ length attribute' getter must return
+this's token set's size.
+
+item(index) method, when
+invoked, must run these steps:
+
+contains(token) method, when
+invoked, must return true if this's token set[token] exists,
+and false otherwise.add(tokens…)
+method, when invoked, must run these steps:
+
+
+
+
+
+
+
+ remove(tokens…)
+method, when invoked, must run these steps:
+
+
+
+
+
+
+
+ toggle(token, force)
+method, when invoked, must run these steps:
+
+
+
+
+
+
+
+ replace(token, newToken)
+method, when invoked, must run these steps:
+
+
+
+
+
+supports(token)
+method, when invoked, must run these steps:
+
+
+
+
+value attribute must return the
+result of running this's serialize steps.
+
+XPath
+
+Interface {{XPathResult}}
+
+
+[Exposed=Window]
+interface XPathResult {
+ const unsigned short ANY_TYPE = 0;
+ const unsigned short NUMBER_TYPE = 1;
+ const unsigned short STRING_TYPE = 2;
+ const unsigned short BOOLEAN_TYPE = 3;
+ const unsigned short UNORDERED_NODE_ITERATOR_TYPE = 4;
+ const unsigned short ORDERED_NODE_ITERATOR_TYPE = 5;
+ const unsigned short UNORDERED_NODE_SNAPSHOT_TYPE = 6;
+ const unsigned short ORDERED_NODE_SNAPSHOT_TYPE = 7;
+ const unsigned short ANY_UNORDERED_NODE_TYPE = 8;
+ const unsigned short FIRST_ORDERED_NODE_TYPE = 9;
+
+ readonly attribute unsigned short resultType;
+ readonly attribute unrestricted double numberValue;
+ readonly attribute DOMString stringValue;
+ readonly attribute boolean booleanValue;
+ readonly attribute Node? singleNodeValue;
+ readonly attribute boolean invalidIteratorState;
+ readonly attribute unsigned long snapshotLength;
+
+ Node? iterateNext();
+ Node? snapshotItem(unsigned long index);
+};
+
+
+
+Interface {{XPathExpression}}
+
+
+[Exposed=Window]
+interface XPathExpression {
+ // XPathResult.ANY_TYPE = 0
+ XPathResult evaluate(Node contextNode, optional unsigned short type = 0, optional XPathResult? result = null);
+};
+
+
+
+Mixin {{XPathEvaluatorBase}}
+
+
+callback interface XPathNSResolver {
+ DOMString? lookupNamespaceURI(DOMString? prefix);
+};
+
+interface mixin XPathEvaluatorBase {
+ [NewObject] XPathExpression createExpression(DOMString expression, optional XPathNSResolver? resolver = null);
+ XPathNSResolver createNSResolver(Node nodeResolver);
+ // XPathResult.ANY_TYPE = 0
+ XPathResult evaluate(DOMString expression, Node contextNode, optional XPathNSResolver? resolver = null, optional unsigned short type = 0, optional XPathResult? result = null);
+};
+Document includes XPathEvaluatorBase;
+
+
+
+Interface {{XPathEvaluator}}
+
+
+[Exposed=Window]
+interface XPathEvaluator {
+ constructor();
+};
+
+XPathEvaluator includes XPathEvaluatorBase;
+
+
+Historical
+
+
+
+
+DOMConfiguration
+ DOMError
+ DOMErrorHandler
+ DOMImplementationList
+ DOMImplementationSource
+ DOMLocator
+ DOMObject
+ DOMUserData
+ Entity
+ EntityReference
+ MutationEvent
+ MutationNameEvent
+ NameList
+ Notation
+ RangeException
+ TypeInfo
+ UserDataHandler
+
+
+
+
+
+
+
+
+ schemaTypeInfo
+ isId
+
+
+
+ createEntityReference()
+ xmlEncoding
+ xmlStandalone
+ xmlVersion
+ strictErrorChecking
+ domConfig
+ normalizeDocument()
+ renameNode()
+
+
+
+ entities
+ notations
+ internalSubset
+
+
+
+ getFeature()
+
+
+
+ schemaTypeInfo
+ setIdAttribute()
+ setIdAttributeNS()
+ setIdAttributeNode()
+
+
+
+ isSupported
+ getFeature()
+ getUserData()
+ setUserData()
+
+
+
+
+
+
+ isElementContentWhitespace
+ replaceWholeText()
+
+
+Acknowledgments
+
+
+Group: WHATWG
+Date: 2021-06-21
+H1: DOM
+Shortname: dom
+Text Macro: TWITTER thedomstandard
+Text Macro: LATESTRD 2021-06
+Abstract: DOM defines a platform-neutral model for events, aborting activities, and node trees.
+Translation: ja https://triple-underscore.github.io/DOM4-ja.html
+Translate IDs: slottable slotable
+Ignored Terms: EmptyString, Array, Document
+Indent: 1
+
+
+
+urlPrefix: https://www.w3.org/TR/xml/#NT-
+ type: type
+ text: Name; url: Name
+ text: Char; url: Char
+ text: PubidChar; url: PubidChar
+urlPrefix: https://www.w3.org/TR/xml-names/#NT-
+ type: type
+ text: QName; url: QName
+url: https://w3c.github.io/DOM-Parsing/#dfn-createcontextualfragment-fragment
+ type: method; text: createContextualFragment(); for: Range
+type: interface
+ url: https://w3c.github.io/touch-events/#idl-def-touchevent
+ text: TouchEvent
+ url: https://w3c.github.io/deviceorientation/spec-source-orientation.html#devicemotion
+ text: DeviceMotionEvent
+ text: DeviceOrientationEvent
+urlPrefix: https://tc39.github.io/ecma262/#; spec: ECMASCRIPT
+ text: Construct; url: sec-construct; type: abstract-op
+ type: dfn
+ text: Realm; url: realm
+ text: surrounding agent; url: surrounding-agent
+urlPrefix: https://w3c.github.io/hr-time/#; spec: HR-TIME
+ type:typedef; urlPrefix: dom-; text: DOMHighResTimeStamp
+ type:dfn; text: time origin; url: dfn-time-origin
+ type:dfn; text: clock resolution
+
+
+
+spec:html; type:element
+ text: title
+ text: script
+
+
+
+
+Infrastructure
+
+Trees
+
+Ordered sets
+
+
+
+
+Selectors
+
+
+
+
+
+
+Namespaces
+
+QName production.
+
+To validate and extract a namespace and qualifiedName,
+run these steps:
+
+
+
+
+
+
+:" (U+003E), then split the
+ string on it and set prefix to the part before and localName to
+ the part after.
+
+ xml" and namespace is not the
+ XML namespace, then throw a "{{NamespaceError!!exception}}" {{DOMException}}.
+
+ xmlns" and namespace is not the
+ XMLNS namespace, then throw a
+ "{{NamespaceError!!exception}}" {{DOMException}}.
+
+ xmlns", then throw a "{{NamespaceError!!exception}}"
+ {{DOMException}}.
+
+ Events
+
+Introduction to "DOM Events"
+
+Throughout the web platform events are dispatched to objects to signal an
+occurrence, such as network activity or user interaction. These objects implement the
+{{EventTarget}} interface and can therefore add event listeners to observe
+events by calling {{EventTarget/addEventListener()}}:
+
+
+obj.addEventListener("load", imgFetched)
+
+function imgFetched(ev) {
+ // great success
+ …
+}
+
+
+Event listeners can be removed
+by utilizing the
+{{EventTarget/removeEventListener()}}
+method, passing the same arguments.
+
+Alternatively, event listeners can be removed by passing an {{AbortSignal}} to
+{{EventTarget/addEventListener()}} and calling {{AbortController/abort()}} on the controller
+owning the signal.
+
+Events are objects too and implement the
+{{Event}} interface (or a derived interface). In the example above
+ev is the event. ev is
+passed as an argument to the
+event listener's callback
+(typically a JavaScript Function as shown above).
+Event listeners key off the
+event's
+{{Event/type}} attribute value
+("load" in the above example). The
+event's
+{{Event/target}} attribute value returns the
+object to which the event was
+dispatched
+(obj above).
+
+
+// add an appropriate event listener
+obj.addEventListener("cat", function(e) { process(e.detail) })
+
+// create and dispatch the event
+var event = new CustomEvent("cat", {"detail":{"hazcheeseburger":true}})
+obj.dispatchEvent(event)
+
+
+Apart from signaling, events are
+sometimes also used to let an application control what happens next in an
+operation. For instance as part of form submission an
+event whose
+{{Event/type}} attribute value is
+"submit" is
+dispatched. If this
+event's
+{{Event/preventDefault()}} method is
+invoked, form submission will be terminated. Applications who wish to make
+use of this functionality through events
+dispatched by the application
+(synthetic events) can make use of the return value of the
+{{EventTarget/dispatchEvent()}} method:
+
+
+if(obj.dispatchEvent(event)) {
+ // event was not canceled, time for some magic
+ …
+}
+
+
+
+<!doctype html>
+<html>
+ <head>
+ <title>Boring example</title>
+ </head>
+ <body>
+ <p>Hello <span id=x>world</span>!</p>
+ <script>
+ function test(e) {
+ debug(e.target, e.currentTarget, e.eventPhase)
+ }
+ document.addEventListener("hey", test, {capture: true})
+ document.body.addEventListener("hey", test)
+ var ev = new Event("hey", {bubbles:true})
+ document.getElementById("x").dispatchEvent(ev)
+ </script>
+ </body>
+</html>
+
+
+debug function will be invoked twice. Each time the event's
+{{Event/target}} attribute value will be the span element. The first time
+{{Event/currentTarget}} attribute's value will be the document, the second time the
+body element. {{Event/eventPhase}} attribute's value switches from
+{{Event/CAPTURING_PHASE}} to {{Event/BUBBLING_PHASE}}. If an event listener was registered
+for the span element, {{Event/eventPhase}} attribute's value would have
+been {{Event/AT_TARGET}}.
+
+
+Interface {{Event}}
+
+
+[Exposed=(Window,Worker,AudioWorklet)]
+interface Event {
+ constructor(DOMString type, optional EventInit eventInitDict = {});
+
+ readonly attribute DOMString type;
+ readonly attribute EventTarget? target;
+ readonly attribute EventTarget? srcElement; // legacy
+ readonly attribute EventTarget? currentTarget;
+ sequence<EventTarget> composedPath();
+
+ const unsigned short NONE = 0;
+ const unsigned short CAPTURING_PHASE = 1;
+ const unsigned short AT_TARGET = 2;
+ const unsigned short BUBBLING_PHASE = 3;
+ readonly attribute unsigned short eventPhase;
+
+ undefined stopPropagation();
+ attribute boolean cancelBubble; // legacy alias of .stopPropagation()
+ undefined stopImmediatePropagation();
+
+ readonly attribute boolean bubbles;
+ readonly attribute boolean cancelable;
+ attribute boolean returnValue; // legacy
+ undefined preventDefault();
+ readonly attribute boolean defaultPrevented;
+ readonly attribute boolean composed;
+
+ [LegacyUnforgeable] readonly attribute boolean isTrusted;
+ readonly attribute DOMHighResTimeStamp timeStamp;
+
+ undefined initEvent(DOMString type, optional boolean bubbles = false, optional boolean cancelable = false); // legacy
+};
+
+dictionary EventInit {
+ boolean bubbles = false;
+ boolean cancelable = false;
+ boolean composed = false;
+};
+
+
+relatedTarget attribute. [[UIEVENTS]]
+
+
+
+
+event = new Event(type [, eventInitDict])
+ event . {{Event/type}}
+ click", "hashchange", or
+ "submit".
+
+ event . {{Event/target}}
+ event . {{Event/currentTarget}}
+ event . {{Event/composedPath()}}
+ closed" that are not reachable from event's
+ {{Event/currentTarget}}.
+
+ event . {{Event/eventPhase}}
+ event . stopPropagation()
+ event . stopImmediatePropagation()
+ event . {{Event/bubbles}}
+ event . {{Event/cancelable}}
+ event . preventDefault()
+ event . {{Event/defaultPrevented}}
+ event . {{Event/composed}}
+ event . {{Event/isTrusted}}
+ event . {{Event/timeStamp}}
+ type attribute must return the value it was
+initialized to. When an event is created the attribute must be initialized to the empty
+string.
+
+target getter steps are to return this's
+target.
+
+srcElement getter steps are to return
+this's target.
+
+currentTarget attribute must return the value it
+was initialized to. When an event is created the attribute must be initialized to null.
+
+composedPath() method steps are:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ eventPhase attribute must return the value it was
+initialized to, which must be one of the following:
+
+
+
+
+
+
+
+
+
+stopPropagation() method steps are to set
+this's stop propagation flag.cancelBubble getter steps are to return true if
+this's stop propagation flag is set; otherwise false.
+
+stopImmediatePropagation() method steps are to set
+this's stop propagation flag and this's
+stop immediate propagation flag.
+
+bubbles and
+cancelable attributes must return the values they were
+initialized to.
+
+returnValue getter steps are to return false if
+this's canceled flag is set; otherwise true.
+
+preventDefault() method steps are to
+set the canceled flag with this.
+
+defaultPrevented getter steps are to return true
+if this's canceled flag is set; otherwise false.
+
+composed getter steps are to return true if
+this's composed flag is set; otherwise false.
+
+
+
+isTrusted attribute must return the value it was
+initialized to. When an event is created the attribute must be initialized to false.
+
+timeStamp attribute must return the value it was
+initialized to.
+
+
+
+
+
+
+initEvent(type, bubbles, cancelable)
+method steps are:
+
+
+
+
+Legacy extensions to the {{Window}} interface
+
+
+partial interface Window {
+ [Replaceable] readonly attribute (Event or undefined) event; // legacy
+};
+
+
+event getter steps are to return this's
+current event.
+
+Interface {{CustomEvent}}
+
+
+[Exposed=(Window,Worker)]
+interface CustomEvent : Event {
+ constructor(DOMString type, optional CustomEventInit eventInitDict = {});
+
+ readonly attribute any detail;
+
+ undefined initCustomEvent(DOMString type, optional boolean bubbles = false, optional boolean cancelable = false, optional any detail = null); // legacy
+};
+
+dictionary CustomEventInit : EventInit {
+ any detail = null;
+};
+
+
+Events using the
+{{CustomEvent}} interface can be used to carry custom data.
+
+
+
+
+event = new CustomEvent(type [, eventInitDict])
+ event . {{CustomEvent/detail}}
+ detail attribute must return the value it
+was initialized to.
+
+initCustomEvent(type, bubbles, cancelable, detail)
+method steps are:
+
+
+
+
+
+Constructing events
+
+Specifications may define
+event constructing steps for all or some
+events. The algorithm is passed an event as indicated in the
+inner event creation steps.
+
+
+
+
+
+
+
+timestamp property of NSEvent objects.
+
+
+
+
+
+Defining event interfaces
+
+In general, when defining a new interface that inherits from {{Event}} please always ask
+feedback from the WHATWG or the
+W3C WebApps WG community.
+
+The {{CustomEvent}} interface can be used as starting point.
+However, do not introduce any init*Event()
+methods as they are redundant with constructors. Interfaces that inherit
+from the {{Event}} interface that have such a method only have it
+for historical reasons.
+
+
+Interface {{EventTarget}}
+
+
+[Exposed=(Window,Worker,AudioWorklet)]
+interface EventTarget {
+ constructor();
+
+ undefined addEventListener(DOMString type, EventListener? callback, optional (AddEventListenerOptions or boolean) options = {});
+ undefined removeEventListener(DOMString type, EventListener? callback, optional (EventListenerOptions or boolean) options = {});
+ boolean dispatchEvent(Event event);
+};
+
+callback interface EventListener {
+ undefined handleEvent(Event event);
+};
+
+dictionary EventListenerOptions {
+ boolean capture = false;
+};
+
+dictionary AddEventListenerOptions : EventListenerOptions {
+ boolean passive = false;
+ boolean once = false;
+ AbortSignal signal;
+};
+
+
+
+
+
+click. Web compatibility prevented it
+from being removed and it is now the enshrined way of defining an activation of something. [[!HTML]]
+
+
+
+
+target = new EventTarget();
+ target . addEventListener(type, callback [, options])
+ target . removeEventListener(type, callback [, options])
+ target . dispatchEvent(event)
+
+
+
+
+
+
+
+
+
+ new EventTarget()
+constructor steps are to do nothing.
+
+
+
+
+
+
+addEventListener(type, callback, options)
+method steps are:
+
+
+
+
+
+
+
+document.open(). [[HTML]]
+
+removeEventListener(type, callback, options)
+method steps are:
+
+
+
+
+dispatchEvent(event) method steps
+are:
+
+
+
+
+
+Observing event listeners
+
+Dispatching events
+
+
+
+
+Document otherwise.
+ [[!HTML]]
+
+
+
+
+ click"; otherwise false.
+
+
+
+
+
+
+
+ closed", then set slot-in-closed-tree
+ to true.
+
+
+
+
+
+
+
+
+
+ capturing", and
+ legacyOutputDidListenersThrowFlag if given.
+
+
+
+
+
+ bubbling", and
+ legacyOutputDidListenersThrowFlag if given.
+
+
+
+
+
+
+
+
+
+closed", then set root-of-closed-tree to true.
+
+
+
+
+
+
+
+
+
+
+ Event type Legacy event type
+ " animationend"" webkitAnimationEnd"
+ " animationiteration"" webkitAnimationIteration"
+ " animationstart"" webkitAnimationStart"
+ " transitionend"" webkitTransitionEnd"
+
+
+
+
+
+
+
+ capturing" and listener's
+ capture is false, then continue.
+
+ bubbling" and listener's
+ capture is true, then continue.
+
+
+
+
+ handleEvent", « event », and
+ event's {{Event/currentTarget}} attribute value. If this throws an exception, then:
+
+
+
+
+ Firing events
+
+
+
+
+submit at target with its
+ {{Event/cancelable}} attribute initialized to true".
+
+ click at
+ target using {{MouseEvent}} with its {{UIEvent/detail}} attribute initialized to 1".
+
+
+
+like at target.
+
+ Action versus occurrence
+
+Aborting ongoing activities
+
+
doAmazingness({ ... }) method could accept an {{AbortSignal}} object
+ in order to support aborting as follows:
+
+
+
+
+const controller = new AbortController();
+const signal = controller.signal;
+
+startSpinner();
+
+doAmazingness({ ..., signal })
+ .then(result => ...)
+ .catch(err => {
+ if (err.name == 'AbortError') return;
+ showUserErrorMessage();
+ })
+ .then(() => stopSpinner());
+
+// …
+
+controller.abort();doAmazingness could be implemented as follows:
+
+
+
+
+function doAmazingness({signal}) {
+ if (signal.aborted) {
+ return Promise.reject(new DOMException('Aborted', 'AbortError'));
+ }
+
+ return new Promise((resolve, reject) => {
+ // Begin doing amazingness, and call resolve(result) when done.
+ // But also, watch for signals:
+ signal.addEventListener('abort', () => {
+ // Stop doing amazingness, and:
+ reject(new DOMException('Aborted', 'AbortError'));
+ });
+ });
+}
+Interface {{AbortController}}
+
+
+[Exposed=(Window,Worker)]
+interface AbortController {
+ constructor();
+
+ [SameObject] readonly attribute AbortSignal signal;
+
+ undefined abort();
+};
+
+
+
+
+
+controller = new AbortController()
+ controller . signal
+ controller . abort()
+ new AbortController()
+constructor steps are:
+
+signal getter steps are to return
+this's signal.
+
+abort() method steps are to
+signal abort on this's signal.
+
+
+Interface {{AbortSignal}}
+
+
+[Exposed=(Window,Worker)]
+interface AbortSignal : EventTarget {
+ [NewObject] static AbortSignal abort();
+
+ readonly attribute boolean aborted;
+
+ attribute EventHandler onabort;
+};
+
+
+
+
+AbortSignal . abort()
+ signal . aborted
+
+
+
+abort() method steps are:
+
+
+
+
+onabort attribute is an
+event handler IDL attribute for the onabort
+event handler, whose event handler event type is
+abort.
+
+
+
+
+
+
+
+
+
+
+Using {{AbortController}} and {{AbortSignal}} objects in
+APIs
+
+
+
+
+signal dictionary member.
+ doAmazingness(options) could be as
+ follows:
+
+
+
+signal member is present, then:
+
+
+
+
+ signal's [=AbortSignal/aborted flag=] is set, then [=reject=]
+ |p| with an "{{AbortError!!exception}}" {{DOMException}} and return |p|.
+
+ signal:
+
+
+
+
+
+
+ Nodes
+
+Introduction to "The DOM"
+
+In its original sense, "The DOM" is an API for
+accessing and manipulating documents (in particular, HTML and XML
+documents). In this specification, the term "document" is used for any
+markup-based resource, ranging from short static documents to long essays or
+reports with rich multimedia, as well as to fully-fledged interactive
+applications.
+
+
+<!DOCTYPE html>
+<html class=e>
+ <head><title>Aliens?</title></head>
+ <body>Why yes.</body>
+</html>
+
+
+It is represented as follows:
+
+
+
+
+
+
+
+
+
+html
+ html class="e"
+
+
+
+ head
+
+
+
+ title
+
+
+
+ body
+
+
+
+ Node tree
+
+
+
+
+
+
+
+
+
+Document tree
+
+Shadow tree
+
+Slots
+
+
+
+
+name, and
+ namespace is null, then:
+
+
+
+Slottables
+
+
+
+
+slot and namespace is null, then:
+
+
+
+Finding slots and slottables
+
+
+
+
+open", then return null.manual", then
+ return the slot in shadow's descendants whose
+ manually assigned nodes contains slottable, if any; otherwise
+ null.
+
+
+
+
+manual", then:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Assigning slottables and slots
+
+
+
+
+
+
+
+Signaling slot change
+
+
+
+
+
+Mutation algorithms
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ named" and node is a
+ slottable, then assign a slot for node.
+
+
+
+
+
+ connectedCallback", and an empty argument list.
+
+ connectedCallback will be enqueued automatically during the
+ upgrade an element algorithm.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+NodeIterator pre-removing steps given
+ node and iterator.
+
+
+
+
+ disconnectedCallback", and an empty argument list.
+
+
+
+ disconnectedCallback", and an empty argument list.
+ Mixin {{NonElementParentNode}}
+
+
+interface mixin NonElementParentNode {
+ Element? getElementById(DOMString elementId);
+};
+Document includes NonElementParentNode;
+DocumentFragment includes NonElementParentNode;
+
+
+
+
+
+node . getElementById(elementId)
+ getElementById(elementId)
+method steps are to return the first element, in tree order, within
+this's descendants, whose ID is elementId; otherwise, if
+there is no such element, null.
+
+
+Mixin {{DocumentOrShadowRoot}}
+
+
+interface mixin DocumentOrShadowRoot {
+};
+Document includes DocumentOrShadowRoot;
+ShadowRoot includes DocumentOrShadowRoot;
+
+
+Mixin {{ParentNode}}
+
+
+
+
+
+interface mixin ParentNode {
+ [SameObject] readonly attribute HTMLCollection children;
+ readonly attribute Element? firstElementChild;
+ readonly attribute Element? lastElementChild;
+ readonly attribute unsigned long childElementCount;
+
+ [CEReactions, Unscopable] undefined prepend((Node or DOMString)... nodes);
+ [CEReactions, Unscopable] undefined append((Node or DOMString)... nodes);
+ [CEReactions, Unscopable] undefined replaceChildren((Node or DOMString)... nodes);
+
+ Element? querySelector(DOMString selectors);
+ [NewObject] NodeList querySelectorAll(DOMString selectors);
+};
+Document includes ParentNode;
+DocumentFragment includes ParentNode;
+Element includes ParentNode;
+
+
+
+
+
+collection = node . {{ParentNode/children}}
+ element = node . {{ParentNode/firstElementChild}}
+ element = node . {{ParentNode/lastElementChild}}
+ node . prepend(nodes)
+ node . append(nodes)
+ node . replaceChildren(nodes)
+ node . querySelector(selectors)
+ node . querySelectorAll(selectors)
+ children getter steps are to return an
+{{HTMLCollection}} collection rooted at this matching only element
+children.
+
+firstElementChild getter steps are to return
+the first child that is an element; otherwise null.
+
+lastElementChild getter steps are to return
+the last child that is an element; otherwise null.
+
+childElementCount getter steps are to return
+the number of children of this that are elements.
+
+prepend(nodes) method steps are:
+
+
+
+
+append(nodes) method steps are:
+
+
+
+
+replaceChildren(nodes) method steps
+are:
+
+
+
+
+querySelector(selectors) method
+steps are to return the first result of running scope-match a selectors string
+selectors against this, if the result is not an empty list; otherwise null.
+
+querySelectorAll(selectors) method
+steps are to return the static result of running
+scope-match a selectors string selectors against this.
+
+
+Mixin {{NonDocumentTypeChildNode}}
+
+
+interface mixin NonDocumentTypeChildNode {
+ readonly attribute Element? previousElementSibling;
+ readonly attribute Element? nextElementSibling;
+};
+Element includes NonDocumentTypeChildNode;
+CharacterData includes NonDocumentTypeChildNode;
+
+
+
+
+
+element = node . {{previousElementSibling}}
+ element = node . {{nextElementSibling}}
+ previousElementSibling getter
+steps are to return the first preceding sibling that is an
+element; otherwise null.
+
+nextElementSibling getter
+steps are to return the first following sibling that is an
+element; otherwise null.
+
+
+Mixin {{ChildNode}}
+
+
+interface mixin ChildNode {
+ [CEReactions, Unscopable] undefined before((Node or DOMString)... nodes);
+ [CEReactions, Unscopable] undefined after((Node or DOMString)... nodes);
+ [CEReactions, Unscopable] undefined replaceWith((Node or DOMString)... nodes);
+ [CEReactions, Unscopable] undefined remove();
+};
+DocumentType includes ChildNode;
+Element includes ChildNode;
+CharacterData includes ChildNode;
+
+
+
+
+
+node . {{before(...nodes)}}
+ node . {{after(...nodes)}}
+ node . {{replaceWith(...nodes)}}
+ node . {{ChildNode/remove()}}
+ before(nodes) method steps are:
+
+
+
+
+after(nodes) method steps are:
+
+
+
+
+replaceWith(nodes) method steps are:
+
+
+
+
+remove() method steps are:
+
+Mixin {{Slottable}}
+
+
+interface mixin Slottable {
+ readonly attribute HTMLSlotElement? assignedSlot;
+};
+Element includes Slottable;
+Text includes Slottable;
+
+
+assignedSlot
+getter steps are to return the result of find a slot given this and with the
+open flag set.
+
+
+Old-style collections: {{NodeList}} and {{HTMLCollection}}
+
+A collection is an object that represents a list of
+nodes. A collection can be either
+live
+or static.
+Unless otherwise stated, a collection must be live.
+
+If a collection is live, then the attributes and methods
+on that object must operate on the actual underlying data, not a snapshot of
+the data.
+
+When a collection is created, a
+filter and a root are associated with it.
+
+The collection then
+represents
+a view of the subtree rooted at the collection's root, containing only nodes that match the
+given filter. The view is linear. In the absence of specific requirements to the contrary, the nodes
+within the collection must be sorted in tree order.
+
+
+Interface {{NodeList}}
+
+
+[Exposed=Window]
+interface NodeList {
+ getter Node? item(unsigned long index);
+ readonly attribute unsigned long length;
+ iterable<Node>;
+};
+
+
+
+
+
+item(index) method must return the
+indexth node in the collection. If there is no
+indexth node in the collection, then the method must return
+null.
+
+Interface {{HTMLCollection}}
+
+
+[Exposed=Window, LegacyUnenumerableNamedProperties]
+interface HTMLCollection {
+ readonly attribute unsigned long length;
+ getter Element? item(unsigned long index);
+ getter Element? namedItem(DOMString name);
+};
+
+
+sequence<T> in IDL instead).
+
+
+
+
+length getter steps are to return the
+number of nodes represented by the collection.
+
+item(index) method steps are to
+return the indexth element in the collection. If there
+is no indexth element in the collection, then the method
+must return null.
+
+
+
+
+
+
+
+ name attribute whose value is neither
+ the empty string nor is in result, append element's
+ name attribute value to
+ result.
+ namedItem(key) method steps are:
+
+
+
+
+
+
+
+
+
+ name attribute whose value is
+ key;
+ Mutation observers
+
+
+
+
+
+
+
+
+
+
+
+
+Interface {{MutationObserver}}
+
+
+[Exposed=Window]
+interface MutationObserver {
+ constructor(MutationCallback callback);
+
+ undefined observe(Node target, optional MutationObserverInit options = {});
+ undefined disconnect();
+ sequence<MutationRecord> takeRecords();
+};
+
+callback MutationCallback = undefined (sequence<MutationRecord> mutations, MutationObserver observer);
+
+dictionary MutationObserverInit {
+ boolean childList = false;
+ boolean attributes;
+ boolean characterData;
+ boolean subtree = false;
+ boolean attributeOldValue;
+ boolean characterDataOldValue;
+ sequence<DOMString> attributeFilter;
+};
+
+
+
+
+
+
+
+
+observer = new {{MutationObserver(callback)}}
+ observer . {{observe(target, options)}}
+
+
+
+ observer . {{disconnect()}}
+ observer . {{takeRecords()}}
+ new MutationObserver(callback)
+constructor steps are:
+
+
+
+
+observe(target, options)
+method steps are:
+
+
+
+
+TypeError.
+
+ TypeError.
+
+ TypeError.
+
+ TypeError.
+
+
+
+
+
+
+disconnect() method steps are:
+
+
+
+
+takeRecords() method steps are:
+
+
+
+
+
+Queuing a mutation record
+
+
+
+
+
+
+
+
+
+
+ attributes" and
+ options["{{MutationObserverInit/attributes}}"] either does not exist
+ or is false
+
+ attributes",
+ options["{{MutationObserverInit/attributeFilter}}"] exists, and
+ options["{{MutationObserverInit/attributeFilter}}"] does not contain
+ name or namespace is non-null
+
+ characterData" and
+ options["{{MutationObserverInit/characterData}}"] either does not
+ exist or is false
+
+ childList" and
+ options["{{MutationObserverInit/childList}}"] is false
+
+
+ attributes" and
+ options["{{MutationObserverInit/attributeOldValue}}"] is true, or type is
+ "characterData" and
+ options["{{MutationObserverInit/characterDataOldValue}}"] is true, then
+ set interestedObservers[mo] to oldValue.
+
+
+
+
+
+
+
+childList" for target with
+ null, null, null, addedNodes, removedNodes, previousSibling,
+ and nextSibling.
+Interface {{MutationRecord}}
+
+
+[Exposed=Window]
+interface MutationRecord {
+ readonly attribute DOMString type;
+ [SameObject] readonly attribute Node target;
+ [SameObject] readonly attribute NodeList addedNodes;
+ [SameObject] readonly attribute NodeList removedNodes;
+ readonly attribute Node? previousSibling;
+ readonly attribute Node? nextSibling;
+ readonly attribute DOMString? attributeName;
+ readonly attribute DOMString? attributeNamespace;
+ readonly attribute DOMString? oldValue;
+};
+
+
+
+
+
+record . {{MutationRecord/type}}
+ attributes" if it was an
+ attribute mutation.
+ "characterData" if it was a mutation to a
+ {{CharacterData}} node. And
+ "childList" if it was a mutation to the
+ tree of
+ nodes.
+
+ record . {{MutationRecord/target}}
+ attributes", it is the
+ element whose
+ attribute changed. For
+ "characterData", it is the {{CharacterData}}
+ node. For "childList",
+ it is the node whose
+ children changed.
+
+ record . {{MutationRecord/addedNodes}}
+ record . {{MutationRecord/removedNodes}}
+ record . {{MutationRecord/previousSibling}}
+ record . {{MutationRecord/nextSibling}}
+ record . {{MutationRecord/attributeName}}
+ record . {{MutationRecord/attributeNamespace}}
+ record . {{MutationRecord/oldValue}}
+ attributes", it is the
+ value of the
+ changed attribute before the change.
+ For "characterData", it is the
+ data of the changed
+ node before the change. For
+ "childList", it is null.
+Garbage collection
+
+Interface {{Node}}
+
+
+[Exposed=Window]
+interface Node : EventTarget {
+ const unsigned short ELEMENT_NODE = 1;
+ const unsigned short ATTRIBUTE_NODE = 2;
+ const unsigned short TEXT_NODE = 3;
+ const unsigned short CDATA_SECTION_NODE = 4;
+ const unsigned short ENTITY_REFERENCE_NODE = 5; // legacy
+ const unsigned short ENTITY_NODE = 6; // legacy
+ const unsigned short PROCESSING_INSTRUCTION_NODE = 7;
+ const unsigned short COMMENT_NODE = 8;
+ const unsigned short DOCUMENT_NODE = 9;
+ const unsigned short DOCUMENT_TYPE_NODE = 10;
+ const unsigned short DOCUMENT_FRAGMENT_NODE = 11;
+ const unsigned short NOTATION_NODE = 12; // legacy
+ readonly attribute unsigned short nodeType;
+ readonly attribute DOMString nodeName;
+
+ readonly attribute USVString baseURI;
+
+ readonly attribute boolean isConnected;
+ readonly attribute Document? ownerDocument;
+ Node getRootNode(optional GetRootNodeOptions options = {});
+ readonly attribute Node? parentNode;
+ readonly attribute Element? parentElement;
+ boolean hasChildNodes();
+ [SameObject] readonly attribute NodeList childNodes;
+ readonly attribute Node? firstChild;
+ readonly attribute Node? lastChild;
+ readonly attribute Node? previousSibling;
+ readonly attribute Node? nextSibling;
+
+ [CEReactions] attribute DOMString? nodeValue;
+ [CEReactions] attribute DOMString? textContent;
+ [CEReactions] undefined normalize();
+
+ [CEReactions, NewObject] Node cloneNode(optional boolean deep = false);
+ boolean isEqualNode(Node? otherNode);
+ boolean isSameNode(Node? otherNode); // legacy alias of ===
+
+ const unsigned short DOCUMENT_POSITION_DISCONNECTED = 0x01;
+ const unsigned short DOCUMENT_POSITION_PRECEDING = 0x02;
+ const unsigned short DOCUMENT_POSITION_FOLLOWING = 0x04;
+ const unsigned short DOCUMENT_POSITION_CONTAINS = 0x08;
+ const unsigned short DOCUMENT_POSITION_CONTAINED_BY = 0x10;
+ const unsigned short DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC = 0x20;
+ unsigned short compareDocumentPosition(Node other);
+ boolean contains(Node? other);
+
+ DOMString? lookupPrefix(DOMString? namespace);
+ DOMString? lookupNamespaceURI(DOMString? prefix);
+ boolean isDefaultNamespace(DOMString? namespace);
+
+ [CEReactions] Node insertBefore(Node node, Node? child);
+ [CEReactions] Node appendChild(Node node);
+ [CEReactions] Node replaceChild(Node node, Node child);
+ [CEReactions] Node removeChild(Node child);
+};
+
+dictionary GetRootNodeOptions {
+ boolean composed = false;
+};
+
+
+
+
+
+
+
+node . {{Node/nodeType}}
+
+
+
+ {{Node}} . {{Node/ELEMENT_NODE}} (1)
+ {{Node}} . {{Node/TEXT_NODE}} (3)
+ {{Node}} . {{Node/CDATA_SECTION_NODE}} (4)
+ {{Node}} . {{Node/PROCESSING_INSTRUCTION_NODE}} (7)
+ {{Node}} . {{Node/COMMENT_NODE}} (8)
+ {{Node}} . {{Node/DOCUMENT_NODE}} (9)
+ {{Node}} . {{Node/DOCUMENT_TYPE_NODE}} (10)
+ {{Node}} . {{Node/DOCUMENT_FRAGMENT_NODE}} (11)
+ node . {{Node/nodeName}}
+
+
+#text".
+
+ #cdata-section".
+
+ #comment".
+
+ #document".
+
+ #document-fragment".
+
+
+
+
+
+
+
+
+#text".
+
+ #cdata-section".
+
+ #comment".
+
+ #document".
+
+ #document-fragment".
+
+
+
+
+
+node . {{Node/baseURI}}
+ baseURI getter steps are to return this's
+node document's document base URL, serialized.
+
+
+
+
+
+
+node . {{Node/isConnected}}
+ node . {{Node/ownerDocument}}
+ node . {{Node/getRootNode()}}
+ node . getRootNode({ composed:true })
+ node . {{Node/parentNode}}
+ node . {{Node/parentElement}}
+ node . {{Node/hasChildNodes()}}
+ node . {{Node/childNodes}}
+ node . {{Node/firstChild}}
+ node . {{Node/lastChild}}
+ node . {{Node/previousSibling}}
+ node . {{Node/nextSibling}}
+ isConnected getter steps are to return true,
+if this is connected; otherwise false.ownerDocument getter steps are to return null,
+if this is a document; otherwise this's node document.
+
+getRootNode(options) method steps are to
+return this's shadow-including root if
+options["{{GetRootNodeOptions/composed}}"] is true; otherwise this's
+root.
+
+parentNode getter steps are to return
+this's parent.
+
+parentElement getter steps are to return
+this's parent element.
+
+hasChildNodes() method steps are to return true if
+this has children; otherwise false.
+
+childNodes getter steps are to return a
+{{NodeList}} rooted at this matching only children.
+
+firstChild getter steps are to return
+this's first child.
+
+lastChild getter steps are to return this's
+last child.
+
+previousSibling getter steps are to return
+this's previous sibling.
+
+nextSibling getter steps are to return
+this's next sibling.
+
+
+
+
+
+The nodeValue attribute
+must return the following, depending on this:
+
+
+
+
+The {{Node/nodeValue}} attribute must,
+on setting, if the new value is null, act as if it was the empty string
+instead, and then do as described below, depending on this:
+
+
+
+
+textContent getter steps are to return the
+following, switching on this:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+node . {{Node/normalize()}}
+ Text nodes and concatenates the
+ data of remaining contiguous exclusive Text nodes
+ into the first of their nodes.
+normalize() method steps are to run these steps for
+each descendant exclusive Text node node of this:
+
+
+
+
+Text node, if any.
+
+ Text nodes (excluding itself), in
+ tree order.
+
+ Text node:
+
+
+
+
+ Text nodes
+ (excluding itself), in tree order.
+
+
+
+
+
+node . cloneNode([deep = false])
+ node . {{Node/isEqualNode(otherNode)}}
+
+
+
+
+
+ is value, with the synchronous custom elements
+ flag unset.
+
+
+
+
+ cloneNode(deep) method steps are:
+
+
+
+
+A node A
+equals a node
+B if all of the following conditions are true:
+
+
+
+
+
+
+ isEqualNode(otherNode) method steps are to
+return true if otherNode is non-null and this equals
+otherNode; otherwise false.
+
+isSameNode(otherNode) method steps are to
+return true if otherNode is this; otherwise false.
+
+
+
+
+
+
+node . {{compareDocumentPosition(other)}}
+
+
+
+ {{Node}} . {{Node/DOCUMENT_POSITION_DISCONNECTED}} (1)
+ {{Node}} . {{Node/DOCUMENT_POSITION_PRECEDING}} (2)
+ {{Node}} . {{Node/DOCUMENT_POSITION_FOLLOWING}} (4)
+ {{Node}} . {{Node/DOCUMENT_POSITION_CONTAINS}} (8)
+ {{Node}} . {{Node/DOCUMENT_POSITION_CONTAINED_BY}} (16, 10 in hexadecimal)
+ node . {{Node/contains(other)}}
+
+
+
+compareDocumentPosition(other) method
+steps are:
+
+
+
+
+
+
+
+
+
+
+
+ Math.random() value can
+ be used.
+
+ contains(other) method steps are to return
+true if other is an inclusive descendant of this; otherwise false
+(including when other is null).
+
+
+
+
+
+
+
+
+
+
+xmlns" and value is
+ namespace, then return element's first such attribute's
+ local name.
+
+
+
+
+
+
+
+ xmlns", and
+ local name is prefix, or if prefix is null and it
+ has an attribute whose namespace is the
+ XMLNS namespace, namespace prefix is null, and local name
+ is "xmlns", then return its value if it is not the empty string, and
+ null otherwise.
+
+
+
+
+
+
+
+
+
+lookupPrefix(namespace) method steps are:
+
+
+
+
+
+
+lookupNamespaceURI(prefix) method steps
+are:
+
+
+
+
+isDefaultNamespace(namespace) method steps
+are:
+
+
+
+
+
+
+insertBefore(node, child)
+method steps are to return the result of pre-inserting node into this
+before child.
+
+appendChild(node) method steps are to
+return the result of appending node to this.
+
+replaceChild(node, child)
+method steps are to return the result of replacing child with node
+within this.
+
+removeChild(child) method steps are to
+return the result of pre-removing child from this.
+
+
+
+
+
+
+*" (U+002A), return a {{HTMLCollection}} rooted
+ at root, whose filter matches only descendant elements.
+
+
+
+
+
+
+
+When invoked with the same arguments, the same {{HTMLCollection}}
+object may be returned as returned by an earlier call.
+
+
+The
+list of elements with class names classNames
+for a node root is the
+{{HTMLCollection}} returned by the following algorithm:
+*" (U+002A), return a {{HTMLCollection}} rooted at
+ root, whose filter matches
+ descendant
+ elements.
+
+ *"
+ (U+002A), return a {{HTMLCollection}} rooted at
+ root, whose filter matches
+ descendant
+ elements whose
+ local name is
+ localName.
+
+ *"
+ (U+002A), return a {{HTMLCollection}} rooted at
+ root, whose filter matches
+ descendant
+ elements whose
+ namespace is
+ namespace.
+
+
+
+
+When invoked with the same argument, the same {{HTMLCollection}}
+object may be returned as returned by an earlier call.
+
+
+quirks"; otherwise in an identical to
+ manner.
+Interface {{Document}}
+
+
+[Exposed=Window]
+interface Document : Node {
+ constructor();
+
+ [SameObject] readonly attribute DOMImplementation implementation;
+ readonly attribute USVString URL;
+ readonly attribute USVString documentURI;
+ readonly attribute DOMString compatMode;
+ readonly attribute DOMString characterSet;
+ readonly attribute DOMString charset; // legacy alias of .characterSet
+ readonly attribute DOMString inputEncoding; // legacy alias of .characterSet
+ readonly attribute DOMString contentType;
+
+ readonly attribute DocumentType? doctype;
+ readonly attribute Element? documentElement;
+ HTMLCollection getElementsByTagName(DOMString qualifiedName);
+ HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);
+ HTMLCollection getElementsByClassName(DOMString classNames);
+
+ [CEReactions, NewObject] Element createElement(DOMString localName, optional (DOMString or ElementCreationOptions) options = {});
+ [CEReactions, NewObject] Element createElementNS(DOMString? namespace, DOMString qualifiedName, optional (DOMString or ElementCreationOptions) options = {});
+ [NewObject] DocumentFragment createDocumentFragment();
+ [NewObject] Text createTextNode(DOMString data);
+ [NewObject] CDATASection createCDATASection(DOMString data);
+ [NewObject] Comment createComment(DOMString data);
+ [NewObject] ProcessingInstruction createProcessingInstruction(DOMString target, DOMString data);
+
+ [CEReactions, NewObject] Node importNode(Node node, optional boolean deep = false);
+ [CEReactions] Node adoptNode(Node node);
+
+ [NewObject] Attr createAttribute(DOMString localName);
+ [NewObject] Attr createAttributeNS(DOMString? namespace, DOMString qualifiedName);
+
+ [NewObject] Event createEvent(DOMString interface); // legacy
+
+ [NewObject] Range createRange();
+
+ // NodeFilter.SHOW_ALL = 0xFFFFFFFF
+ [NewObject] NodeIterator createNodeIterator(Node root, optional unsigned long whatToShow = 0xFFFFFFFF, optional NodeFilter? filter = null);
+ [NewObject] TreeWalker createTreeWalker(Node root, optional unsigned long whatToShow = 0xFFFFFFFF, optional NodeFilter? filter = null);
+};
+
+[Exposed=Window]
+interface XMLDocument : Document {};
+
+dictionary ElementCreationOptions {
+ DOMString is;
+};
+
+
+xml" or "html"), and
+mode ("no-quirks", "quirks", or "limited-quirks").
+[[!ENCODING]]
+[[!URL]]
+[[!HTML]]
+
+application/xml", URL is "about:blank",
+origin is an opaque origin,
+type is "xml", and its
+mode is "no-quirks".
+
+xml"; otherwise an HTML document. Whether a document is an
+HTML document or an XML document affects the behavior of certain APIs.
+
+no-quirks",
+quirks mode if its mode
+is "quirks", and
+limited-quirks mode if its
+mode is "limited-quirks".
+
+about:blank"). [[!HTML]]
+
+ load" or
+document does not have a browsing context; otherwise the
+document's relevant global object.
+
+
+
+
+
+
+document = new {{Document()}}
+ document . {{Document/implementation}}
+ document . {{Document/URL}}
+ document . {{Document/documentURI}}
+ document . {{Document/compatMode}}
+ BackCompat" if document's mode is
+ "quirks"; otherwise "CSS1Compat".
+
+ document . {{Document/characterSet}}
+ document . {{Document/contentType}}
+ new Document() constructor
+steps are to set this's origin to the origin of
+current global object's associated Document. [[!HTML]]
+
+implementation getter steps are to return the
+{{DOMImplementation}} object that is associated with this.
+
+URL and
+documentURI getter steps are to return this's
+URL, serialized.
+
+compatMode getter steps are to return
+"BackCompat" if this's mode is "quirks";
+otherwise "CSS1Compat".
+
+characterSet,
+charset, and
+inputEncoding getter steps are to return
+this's encoding's name.
+
+contentType getter steps are to return
+this's content type.
+
+
+
+
+
+
+*" returns a {{HTMLCollection}} of all
+ descendant elements.
+
+ *" returns a {{HTMLCollection}} of all
+ descendant
+ elements.
+
+ If only namespace is "*" returns a
+ {{HTMLCollection}} of all
+ descendant
+ elements whose
+ local name is
+ localName.
+
+ If only localName is "*" returns a
+ {{HTMLCollection}} of all
+ descendant
+ elements whose
+ namespace is
+ namespace.
+
+ Otherwise, returns a {{HTMLCollection}} of all
+ descendant
+ elements whose
+ namespace is
+ namespace and
+ local name is
+ localName.
+
+ doctype getter steps are to return the
+child of this that is a doctype; otherwise null.
+
+documentElement getter steps are to return
+this's document element.
+
+getElementsByTagName(qualifiedName)
+method steps are to return the list of elements with qualified name qualifiedName
+for this.
+
+document.getElementsByTagName("FOO") will match
+<FOO> elements that are not in the
+HTML namespace, and <foo> elements that are in
+the HTML namespace, but not <FOO> elements
+that are in the HTML namespace.
+
+getElementsByTagNameNS(namespace, localName)
+method steps are to return the list of elements with namespace namespace and local
+name localName for this.
+
+getElementsByClassName(classNames)
+method steps are to return the list of elements with class names classNames for
+this.
+
+
+
+ A call to
+
+ <div id="example">
+ <p id="p1" class="aaa bbb"/>
+ <p id="p2" class="aaa ccc"/>
+ <p id="p3" class="bbb ccc"/>
+ </div>
+ document.getElementById("example").getElementsByClassName("aaa")
+ would return a {{HTMLCollection}} with the two paragraphs
+ p1 and p2 in it.
+
+ A call to
+ getElementsByClassName("ccc bbb")
+ would only return one node, however, namely p3. A call to
+ document.getElementById("example").getElementsByClassName("bbb ccc ")
+ would return the same thing.
+
+ A call to
+ getElementsByClassName("aaa,bbb")
+ would return no nodes; none of the elements above are in the
+ aaa,bbb class.
+
+
+
+
+
+element = document . createElement(localName [, options])
+ application/xhtml+xml"; otherwise null.
+
+ Name production an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}} will be thrown.
+
+ element = document . createElementNS(namespace, qualifiedName [, options])
+
+ :" (U+003E) in
+ qualifiedName or null. Its local name will be everything after
+ ":" (U+003E) in qualifiedName or qualifiedName.
+
+ QName production an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}} will be thrown.
+
+
+
+
+ xml" and namespace is not the
+ XML namespace.
+ xmlns" and namespace is not the
+ XMLNS namespace.
+ xmlns".
+ documentFragment = document . {{createDocumentFragment()}}
+ text = document . {{createTextNode(data)}}
+ text = document . {{createCDATASection(data)}}
+ comment = document . {{createComment(data)}}
+ processingInstruction = document . {{createProcessingInstruction(target, data)}}
+ Name production an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}} will be thrown.
+ If data contains "?>" an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}} will be thrown.
+html and the
+HTML namespace, the {{HTMLHtmlElement}} interface is used. [[!HTML]]
+
+createElement(localName, options)
+method steps are:
+
+
+
+
+Name production, then
+ throw an "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ application/xhtml+xml"; otherwise null.
+
+ createElementNS steps, given document,
+namespace, qualifiedName, and options, are as follows:
+
+
+
+
+createElementNS(namespace, qualifiedName, options)
+method steps are to return the result of running the
+internal createElementNS steps, given this, namespace,
+qualifiedName, and options.
+
+createDocumentFragment() method steps are to
+return a new {{DocumentFragment}} node whose node document is this.
+
+createTextNode(data) method steps are
+to return a new {{Text}} node whose data is data and
+node document is this.
+
+Char production.
+
+createCDATASection(data) method steps
+are:
+
+
+
+
+]]>", then throw an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ createComment(data) method steps are
+to return a new {{Comment}} node whose data is data and
+node document is this.
+
+Char production
+or that it contains two adjacent hyphens or ends with a hyphen.
+
+createProcessingInstruction(target, data)
+method steps are:
+
+
+
+
+Name production,
+ then throw an "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ ?>", then throw an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ xml" or ":", or that
+data contains characters that match the
+Char production.
+
+
+
+
+
+
+importNode(node, deep)
+method steps are:
+
+
+
+
+
+
+
+
+
+
+
+
+ adoptedCallback", and an argument list containing oldDocument and
+ document.
+
+ adoptNode(node) method steps are:
+
+
+
+
+
+
+createAttribute(localName) method
+steps are:
+
+
+
+
+Name production in XML,
+ then throw an "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ createAttributeNS(namespace, qualifiedName)
+method steps are:
+
+
+
+
+
+
+createEvent(interface) method steps
+are:
+
+
+
+
+
+
+
+
+ String Interface Notes
+ " beforeunloadevent"{{BeforeUnloadEvent}} [[!HTML]]
+ " compositionevent"{{CompositionEvent}} [[!UIEVENTS]]
+
+ " customevent"{{CustomEvent}}
+ " devicemotionevent"{{DeviceMotionEvent}} [[!DEVICE-ORIENTATION]]
+ " deviceorientationevent"{{DeviceOrientationEvent}}
+ " dragevent"{{DragEvent}} [[!HTML]]
+ " event"{{Event}}
+ " events"
+
+ " focusevent"{{FocusEvent}} [[!UIEVENTS]]
+ " hashchangeevent"{{HashChangeEvent}} [[!HTML]]
+ " htmlevents"{{Event}}
+ " keyboardevent"{{KeyboardEvent}} [[!UIEVENTS]]
+ " messageevent"{{MessageEvent}} [[!HTML]]
+ " mouseevent"{{MouseEvent}} [[!UIEVENTS]]
+ " mouseevents"
+ " storageevent"{{StorageEvent}} [[!HTML]]
+ " svgevents"{{Event}}
+ " textevent"{{CompositionEvent}} [[!UIEVENTS]]
+ " touchevent"{{TouchEvent}} [[!TOUCH-EVENTS]]
+ " uievent"{{UIEvent}} [[!UIEVENTS]]
+ " uievents"
+
+
+createRange() method steps are to return a new
+live range with (this, 0) as its start an end.
+
+
+
+createNodeIterator(root, whatToShow, filter)
+method steps are:
+
+
+
+
+createTreeWalker(root, whatToShow, filter)
+method steps are:
+
+
+
+
+
+Interface {{DOMImplementation}}
+
+User agents must create a {{DOMImplementation}} object whenever
+a document is created and associate it
+with that document.
+
+
+[Exposed=Window]
+interface DOMImplementation {
+ [NewObject] DocumentType createDocumentType(DOMString qualifiedName, DOMString publicId, DOMString systemId);
+ [NewObject] XMLDocument createDocument(DOMString? namespace, [LegacyNullToEmptyString] DOMString qualifiedName, optional DocumentType? doctype = null);
+ [NewObject] Document createHTMLDocument(optional DOMString title);
+
+ boolean hasFeature(); // useless; always returns true
+};
+
+
+
+
+
+doctype = document . {{Document/implementation}} . {{createDocumentType(qualifiedName, publicId, systemId)}}
+
+ Name production, an
+ "{{InvalidCharacterError!!exception}}" {{DOMException}} is thrown, and if it does not match the
+ QName production, a
+ "{{NamespaceError!!exception}}" {{DOMException}} is thrown.
+
+ doc = document . {{Document/implementation}} . createDocument(namespace, qualifiedName [, doctype = null])
+
+ doc = document . {{Document/implementation}} . createHTMLDocument([title])
+
+ createDocumentType(qualifiedName, publicId, systemId)
+method steps are:
+
+
+
+
+PubidChar production or that systemId does not contain both a
+'"' and a "'".
+
+createDocument(namespace, qualifiedName, doctype)
+method steps are:
+
+
+
+
+createElementNS steps, given
+ document, namespace, qualifiedName, and an empty dictionary.
+
+
+
+
+ application/xhtml+xml
+
+ image/svg+xml
+
+ application/xml
+ createHTMLDocument(title)
+method steps are:
+
+
+
+
+text/html".
+
+ html" as its
+ name and with its node document set to doc, to
+ doc.
+
+
+
+
+ hasFeature() method steps are to
+return true.
+
+Interface {{DocumentType}}
+
+
+[Exposed=Window]
+interface DocumentType : Node {
+ readonly attribute DOMString name;
+ readonly attribute DOMString publicId;
+ readonly attribute DOMString systemId;
+};
+
+
+name getter steps are to return
+this's name.
+
+publicId getter steps are to return
+this's public ID.
+
+systemId getter steps are to return
+this's system ID.
+
+
+Interface {{DocumentFragment}}
+
+
+[Exposed=Window]
+interface DocumentFragment : Node {
+ constructor();
+};
+
+
+
+
+
+tree = new {{DocumentFragment()}}
+ new DocumentFragment()
+constructor steps are to set this's node document to
+current global object's associated Document.
+
+
+Interface {{ShadowRoot}}
+
+
+[Exposed=Window]
+interface ShadowRoot : DocumentFragment {
+ readonly attribute ShadowRootMode mode;
+ readonly attribute boolean delegatesFocus;
+ readonly attribute SlotAssignmentMode slotAssignment;
+ readonly attribute Element host;
+ attribute EventHandler onslotchange;
+};
+
+enum ShadowRootMode { "open", "closed" };
+enum SlotAssignmentMode { "manual", "named" };
+
+
+open"
+or "closed").manual" or "named").
+
+mode getter steps are to return
+this's mode.delegatesFocus getter steps are to return
+this's delegates focus.slotAssignment getter steps are to return
+this's slot assignment.
+
+host getter steps are to return
+this's host.
+
+onslotchange attribute is an
+event handler IDL attribute for the
+onslotchange event handler, whose
+event handler event type is {{HTMLSlotElement/slotchange}}.
+
+
+
+
+
+
+closed" or A's root's
+ host is closed-shadow-hidden from B.
+
+
+
+
+
+
+ Interface {{Element}}
+
+
+[Exposed=Window]
+interface Element : Node {
+ readonly attribute DOMString? namespaceURI;
+ readonly attribute DOMString? prefix;
+ readonly attribute DOMString localName;
+ readonly attribute DOMString tagName;
+
+ [CEReactions] attribute DOMString id;
+ [CEReactions] attribute DOMString className;
+ [SameObject, PutForwards=value] readonly attribute DOMTokenList classList;
+ [CEReactions, Unscopable] attribute DOMString slot;
+
+ boolean hasAttributes();
+ [SameObject] readonly attribute NamedNodeMap attributes;
+ sequence<DOMString> getAttributeNames();
+ DOMString? getAttribute(DOMString qualifiedName);
+ DOMString? getAttributeNS(DOMString? namespace, DOMString localName);
+ [CEReactions] undefined setAttribute(DOMString qualifiedName, DOMString value);
+ [CEReactions] undefined setAttributeNS(DOMString? namespace, DOMString qualifiedName, DOMString value);
+ [CEReactions] undefined removeAttribute(DOMString qualifiedName);
+ [CEReactions] undefined removeAttributeNS(DOMString? namespace, DOMString localName);
+ [CEReactions] boolean toggleAttribute(DOMString qualifiedName, optional boolean force);
+ boolean hasAttribute(DOMString qualifiedName);
+ boolean hasAttributeNS(DOMString? namespace, DOMString localName);
+
+ Attr? getAttributeNode(DOMString qualifiedName);
+ Attr? getAttributeNodeNS(DOMString? namespace, DOMString localName);
+ [CEReactions] Attr? setAttributeNode(Attr attr);
+ [CEReactions] Attr? setAttributeNodeNS(Attr attr);
+ [CEReactions] Attr removeAttributeNode(Attr attr);
+
+ ShadowRoot attachShadow(ShadowRootInit init);
+ readonly attribute ShadowRoot? shadowRoot;
+
+ Element? closest(DOMString selectors);
+ boolean matches(DOMString selectors);
+ boolean webkitMatchesSelector(DOMString selectors); // legacy alias of .matches
+
+ HTMLCollection getElementsByTagName(DOMString qualifiedName);
+ HTMLCollection getElementsByTagNameNS(DOMString? namespace, DOMString localName);
+ HTMLCollection getElementsByClassName(DOMString classNames);
+
+ [CEReactions] Element? insertAdjacentElement(DOMString where, Element element); // legacy
+ undefined insertAdjacentText(DOMString where, DOMString data); // legacy
+};
+
+dictionary ShadowRootInit {
+ required ShadowRootMode mode;
+ boolean delegatesFocus = false;
+ SlotAssignmentMode slotAssignment = "named";
+};
+
+
+is value. When an
+element is created, all of these values are
+initialized.
+
+undefined", "failed", "uncustomized",
+"precustomized", or "custom". An element whose
+custom element state is "uncustomized" or "custom" is
+said to be defined. An element
+whose custom element state is "custom" is said to be
+custom.
+
+failed" and "precustomized" states are used to ensure that if a
+custom element constructor fails to execute correctly the first time, it is not executed
+again by an upgrade.
+
+ <!DOCTYPE html>
+ <script>
+ window.customElements.define("sw-rey", class extends HTMLElement {})
+ window.customElements.define("sw-finn", class extends HTMLElement {}, { extends: "p" })
+ window.customElements.define("sw-kylo", class extends HTMLElement {
+ constructor() {
+ // super() intentionally omitted for this example
+ }
+ })
+ </script>
+
+ <!-- "undefined" (not defined, not custom) -->
+ <sw-han></sw-han>
+ <p is="sw-luke"></p>
+ <p is="asdf"></p>
+
+ <!-- "failed" (not defined, not custom) -->
+ <sw-kylo></sw-kylo>
+
+ <!-- "uncustomized" (defined, not custom) -->
+ <p></p>
+ <asdf></asdf>
+
+ <!-- "custom" (defined, custom) -->
+ <sw-rey></sw-rey>
+ <p is="sw-finn"></p>
+ :", followed by its
+local name.
+
+
+
+
+
+
+
+
+
+ undefined",
+ custom element definition set to null,
+ is value set to is, and node document set to
+ document.
+
+
+
+
+
+
+ failed".
+
+
+
+
+
+ is value to null.
+
+
+ failed",
+ custom element definition set to null,
+ is value set to null, and node document set to
+ document.
+
+
+ undefined", custom element definition set to null,
+ is value set to null, and node document set to
+ document.
+
+
+
+ uncustomized", custom element definition set to null,
+ is value set to is, and node document set to
+ document.
+
+ undefined".
+
+
+
+attributes" for element with
+ attribute's local name, attribute's
+ namespace, oldValue, « », « », null, and null.
+
+ attributeChangedCallback", and an argument list containing attribute's
+ local name, oldValue, newValue, and attribute's
+ namespace.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+id attribute and a DTD. This specification makes ID
+a concept of the DOM and allows for only one per element, given by an
+id attribute.
+
+
+
+
+id, namespace is null, and
+ value is null or the empty string, then unset element's
+ ID.
+
+ id, namespace is null, then
+ set element's ID to value.
+class,
+id, and slot attributes on any element, it makes no
+claims as to whether using them is conforming or not.
+
+
+
+A node's
+parent of type
+{{Element}} is known as a parent element. If the
+node has a
+parent of a different type, its
+parent element is null.
+
+
+
+
+
+
+namespaceURI getter steps are to return
+this's namespace.
+
+prefix getter steps are to return
+this's namespace prefix.
+
+localName getter steps are to return
+this's local name.
+
+tagName getter steps are to return
+this's HTML-uppercased qualified name.
+
+
+
+
+
+
+element . id [ = value ]
+ id content attribute. Can be set to
+ change it.
+
+ element . className [ = value ]
+ class content attribute. Can be set
+ to change it.
+
+ element . classList
+ class content attribute as a
+ set of whitespace-separated tokens through a {{DOMTokenList}} object.
+
+ element . slot [ = value ]
+ slot content attribute. Can be set to
+ change it.
+
+
+
+id attribute must reflect the
+"id" content attribute.
+
+className attribute must
+reflect the "class" content attribute.
+
+classList getter steps are to return a
+{{DOMTokenList}} object whose associated element is this and whose associated
+attribute's local name is class. The token set of this
+particular {{DOMTokenList}} object are also known as the element's
+classes.
+
+slot attribute must reflect the
+"slot" content attribute.
+
+id, class, and slot are effectively
+superglobal attributes as they can appear on any element, regardless of that element's
+namespace.
+
+
+
+
+element . hasAttributes()
+ element . getAttributeNames()
+ element . getAttribute(qualifiedName)
+ element . getAttributeNS(namespace, localName)
+ element . setAttribute(qualifiedName, value)
+ element . setAttributeNS(namespace, localName, value)
+ element . removeAttribute(qualifiedName)
+ element . removeAttributeNS(namespace, localName)
+ element . toggleAttribute(qualifiedName [, force])
+ element . hasAttribute(qualifiedName)
+ element . hasAttributeNS(namespace, localName)
+ hasAttributes() method steps are to return false
+if this's attribute list is empty; otherwise true.
+
+attributes getter steps are to return the
+associated {{NamedNodeMap}}.
+
+getAttributeNames() method steps are to return the
+qualified names of the attributes in this's
+attribute list, in order; otherwise a new list.
+
+getAttribute(qualifiedName) method
+steps are:
+
+
+
+
+getAttributeNS(namespace, localName)
+method steps are:
+
+
+
+
+setAttribute(qualifiedName, value)
+method steps are:
+
+
+
+
+Name production in
+ XML, then throw an "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+ setAttributeNS(namespace, qualifiedName, value)
+method steps are:
+
+
+
+
+removeAttribute(qualifiedName)
+method steps are to remove an attribute given
+qualifiedName and this, and then return undefined.
+
+removeAttributeNS(namespace, localName)
+method steps are to remove an attribute
+given namespace, localName, and this, and then return undefined.
+
+hasAttribute(qualifiedName) method
+steps are:
+
+
+
+
+toggleAttribute(qualifiedName, force)
+method steps are:
+
+
+
+
+Name production in
+ XML, then throw an "{{InvalidCharacterError!!exception}}" {{DOMException}}.
+
+
+
+
+ hasAttributeNS(namespace, localName)
+method steps are:
+
+
+
+
+
+
+getAttributeNode(qualifiedName) method
+steps are to return the result of getting an attribute given
+qualifiedName and this.
+
+getAttributeNodeNS(namespace, localName)
+method steps are to return the result of
+getting an attribute given
+namespace, localName, and this.
+
+setAttributeNode(attr) and
+setAttributeNodeNS(attr) methods steps are to
+return the result of setting an attribute given attr and
+this.
+
+removeAttributeNode(attr) method steps
+are:
+
+
+
+
+
+
+
+
+
+var shadow = element . {{attachShadow(init)}}
+ var shadow = element . {{shadowRoot}}
+ open", and null otherwise.
+attachShadow(init) method steps are:
+
+
+
+
+
+
+
+ article",
+ "aside",
+ "blockquote",
+ "body",
+ "div",
+ "footer",
+ "h1",
+ "h2",
+ "h3",
+ "h4",
+ "h5",
+ "h6",
+ "header",
+ "main",
+ "nav",
+ "p",
+ "section", or
+ "span"
+ is value is not null, then:
+
+
+
+ is value.
+
+ precustomized" or
+ "custom", then set shadow's
+ available to element internals to true.
+
+ shadowRoot getter steps are:
+
+
+
+
+closed",
+ then return null.
+
+
+
+
+element . {{closest(selectors)}}
+ element . {{matches(selectors)}}
+ closest(selectors) method steps are:
+
+
+
+
+matches(selectors) and
+webkitMatchesSelector(selectors) method steps
+are:
+
+
+
+
+
+
+getElementsByTagName(qualifiedName)
+method steps are to return the list of elements with qualified name qualifiedName
+for this.
+
+getElementsByTagNameNS(namespace, localName)
+method steps are to return the list of elements with namespace namespace and local
+name localName for this.
+
+getElementsByClassName(classNames)
+method steps are to return the list of elements with class names classNames for
+this.
+
+
+
+
+
+
+beforebegin"
+ afterbegin"
+ beforeend"
+ afterend"
+ insertAdjacentElement(where, element)
+method steps are to return the result of running insert adjacent, give this,
+where, and element.
+
+insertAdjacentText(where, data)
+method steps are:
+
+
+
+
+Interface {{NamedNodeMap}}
+
+
+[Exposed=Window,
+ LegacyUnenumerableNamedProperties]
+interface NamedNodeMap {
+ readonly attribute unsigned long length;
+ getter Attr? item(unsigned long index);
+ getter Attr? getNamedItem(DOMString qualifiedName);
+ Attr? getNamedItemNS(DOMString? namespace, DOMString localName);
+ [CEReactions] Attr? setNamedItem(Attr attr);
+ [CEReactions] Attr? setNamedItemNS(Attr attr);
+ [CEReactions] Attr removeNamedItem(DOMString qualifiedName);
+ [CEReactions] Attr removeNamedItemNS(DOMString? namespace, DOMString localName);
+};
+
+
+A {{NamedNodeMap}} has an associated
+element (an
+element).
+
+A {{NamedNodeMap}} object's
+attribute list is its
+element's
+attribute list.
+
+
+
+length getter steps are to return
+the attribute list's size.
+
+item(index) method steps are:
+
+
+
+
+
+
+
+
+
+
+ getNamedItem(qualifiedName)
+method steps are to return the result of getting an attribute
+given qualifiedName and element.
+
+getNamedItemNS(namespace, localName)
+method steps are to return the result of
+getting an attribute given
+namespace, localName, and element.
+
+setNamedItem(attr) and
+setNamedItemNS(attr) method steps are
+to return the result of setting an attribute given attr and
+element.
+
+removeNamedItem(qualifiedName)
+method steps are:
+
+
+
+
+removeNamedItemNS(namespace, localName)
+method steps are:
+
+
+
+
+
+Interface {{Attr}}
+
+
+[Exposed=Window]
+interface Attr : Node {
+ readonly attribute DOMString? namespaceURI;
+ readonly attribute DOMString? prefix;
+ readonly attribute DOMString localName;
+ readonly attribute DOMString name;
+ [CEReactions] attribute DOMString value;
+
+ readonly attribute Element? ownerElement;
+
+ readonly attribute boolean specified; // useless; always returns true
+};
+
+:", followed by its
+local name, otherwise.
+
+A attribute
+is an attribute whose
+local name is
+A and whose
+namespace and
+namespace prefix are
+null.
+
+
+
+namespaceURI getter steps are to return
+this's namespace.
+
+prefix getter steps are to return this's
+namespace prefix.
+
+localName getter steps are to return
+this's local name.
+
+name getter steps are to return this's
+qualified name.
+
+value getter steps are to return this's
+value.
+
+
+
+
+
+
+ownerElement getter steps are to return
+this's element.
+
+
+
+specified getter steps are to return true.
+
+
+Interface {{CharacterData}}
+
+
+[Exposed=Window]
+interface CharacterData : Node {
+ attribute [LegacyNullToEmptyString] DOMString data;
+ readonly attribute unsigned long length;
+ DOMString substringData(unsigned long offset, unsigned long count);
+ undefined appendData(DOMString data);
+ undefined insertData(unsigned long offset, DOMString data);
+ undefined deleteData(unsigned long offset, unsigned long count);
+ undefined replaceData(unsigned long offset, unsigned long count, DOMString data);
+};
+
+
+
+
+
+
+
+
+
+To substring data with node
+node, offset offset, and count
+count, run these steps:
+
+characterData" for node with
+ null, null, node's data, « », « », null, and null.
+
+
+
+
+data getter steps are to return
+this's data. Its setter must replace data with node
+this, offset 0, count this's length, and data new value.
+
+length getter steps are to return
+this's length.
+
+substringData(offset, count)
+method steps are to return the result of running substring data with node this,
+offset offset, and count count.
+
+appendData(data) method steps are
+to replace data with node this, offset this's length, count 0,
+and data data.
+
+insertData(offset, data)
+method steps are to replace data with node this, offset offset, count 0,
+and data data.
+
+deleteData(offset, count)
+method steps are to replace data with node this, offset offset, count
+count, and data the empty string.
+
+replaceData(offset, count, data)
+method steps are to replace data with node this, offset offset, count
+count, and data data.
+
+
+Interface {{Text}}
+
+
+[Exposed=Window]
+interface Text : CharacterData {
+ constructor(optional DOMString data = "");
+
+ [NewObject] Text splitText(unsigned long offset);
+ readonly attribute DOMString wholeText;
+};
+
+
+
+
+
+text = new Text([data = ""])
+ text . {{Text/splitText(offset)}}
+ text . {{Text/wholeText}}
+
+
+Text nodes, and node's next sibling {{Text}}
+node, if any, and its contiguous Text nodes, avoiding any duplicates.
+
+Text node,
+if any, and its contiguous exclusive Text nodes, and node's
+next sibling exclusive Text node, if any, and its
+contiguous exclusive Text nodes, avoiding any duplicates.
+
+
+
+new Text(data)
+constructor steps are to set this's data to data and
+this's node document to current global object's
+associated Document.
+
+To split a {{Text}}
+node node with offset
+offset, run these steps:
+
+
+
+
+
+
+
+ splitText(offset) method steps are to
+split this with offset offset.
+
+wholeText getter steps are to return the
+concatenation of the data of the
+contiguous Text nodes of this, in tree order.
+
+
+Interface {{CDATASection}}
+
+
+[Exposed=Window]
+interface CDATASection : Text {
+};
+
+
+Interface {{ProcessingInstruction}}
+
+
+[Exposed=Window]
+interface ProcessingInstruction : CharacterData {
+ readonly attribute DOMString target;
+};
+
+
+{{ProcessingInstruction}} nodes
+have an associated target.
+
+The target
+attribute must return the target.
+
+
+Interface {{Comment}}
+
+
+[Exposed=Window]
+interface Comment : CharacterData {
+ constructor(optional DOMString data = "");
+};
+
+
+
+
+
+comment = new Comment([data = ""])
+ new Comment(data)
+constructor steps are to set this's data to data and
+this's node document to current global object's
+associated Document.
+
+
+
+Ranges
+
+Introduction to "DOM Ranges"
+
+
+
+
+
+p
+
+
+<img src="insanity-wolf" alt="Little-endian BOM; decode as big-endian!">
+ <em>
+
+
+ p element, and
+em to the em
+element, this would be done as follows:
+
+
+
+
+var range = new Range(),
+ firstText = p.childNodes[1],
+ secondText = em.firstChild
+range.setStart(firstText, 9) // do not forget the leading space
+range.setEnd(secondText, 4)
+// range now stringifies to the aforementioned quote
+src and alt in the
+node tree above cannot be represented by a range. Ranges are only useful for
+nodes.
+
+Boundary points
+
+
+
+
+
+Interface {{AbstractRange}}
+
+
+[Exposed=Window]
+interface AbstractRange {
+ readonly attribute Node startContainer;
+ readonly attribute unsigned long startOffset;
+ readonly attribute Node endContainer;
+ readonly attribute unsigned long endOffset;
+ readonly attribute boolean collapsed;
+};
+
+
+
+
+
+node = range . startContainer
+ offset = range . startOffset
+ node = range . endContainer
+ offset = range . endOffset
+ collapsed = range . collapsed
+ startContainer
+getter steps are to return this's start node.
+
+startOffset
+getter steps are to return this's start offset.
+
+endContainer
+getter steps are to return this's end node.
+
+endOffset
+getter steps are to return this's end offset.
+
+collapsed
+getter steps are to return true if this is collapsed; otherwise false.
+
+
+Interface {{StaticRange}}
+
+
+dictionary StaticRangeInit {
+ required Node startContainer;
+ required unsigned long startOffset;
+ required Node endContainer;
+ required unsigned long endOffset;
+};
+
+[Exposed=Window]
+interface StaticRange : AbstractRange {
+ constructor(StaticRangeInit init);
+};
+
+
+
+
+
+staticRange = new StaticRange(init)
+ new StaticRange(init)
+constructor steps are:
+
+
+
+
+
+Interface {{Range}}
+
+
+[Exposed=Window]
+interface Range : AbstractRange {
+ constructor();
+
+ readonly attribute Node commonAncestorContainer;
+
+ undefined setStart(Node node, unsigned long offset);
+ undefined setEnd(Node node, unsigned long offset);
+ undefined setStartBefore(Node node);
+ undefined setStartAfter(Node node);
+ undefined setEndBefore(Node node);
+ undefined setEndAfter(Node node);
+ undefined collapse(optional boolean toStart = false);
+ undefined selectNode(Node node);
+ undefined selectNodeContents(Node node);
+
+ const unsigned short START_TO_START = 0;
+ const unsigned short START_TO_END = 1;
+ const unsigned short END_TO_END = 2;
+ const unsigned short END_TO_START = 3;
+ short compareBoundaryPoints(unsigned short how, Range sourceRange);
+
+ [CEReactions] undefined deleteContents();
+ [CEReactions, NewObject] DocumentFragment extractContents();
+ [CEReactions, NewObject] DocumentFragment cloneContents();
+ [CEReactions] undefined insertNode(Node node);
+ [CEReactions] undefined surroundContents(Node newParent);
+
+ [NewObject] Range cloneRange();
+ undefined detach();
+
+ boolean isPointInRange(Node node, unsigned long offset);
+ short comparePoint(Node node, unsigned long offset);
+
+ boolean intersectsNode(Node node);
+
+ stringifier;
+};
+
+
+
+
+
+
+
+
+
+range = new Range()
+ new Range() constructor steps are
+to set this's start and end to
+(current global object's associated Document, 0).
+
+
+
+
+
+
+commonAncestorContainer getter steps are:
+
+
+
+
+
+
+
+
+
+
+
+setStart(node, offset) method
+steps are to set the start of this to boundary point
+(node, offset).
+
+setEnd(node, offset) method
+steps are to set the end of this to boundary point
+(node, offset).
+
+setStartBefore(node) method steps are:
+
+
+
+
+setStartAfter(node) method steps are:
+
+
+
+
+setEndBefore(node) method steps are:
+
+
+
+
+setEndAfter(node) method steps are:
+
+
+
+
+collapse(toStart) method steps are to, if
+toStart is true, set end to start; otherwise set
+start to end.
+
+
+
+
+selectNode(node) method steps are to
+select node within this.
+
+selectNodeContents(node) method steps
+are:
+
+
+
+
+
+
+compareBoundaryPoints(how, sourceRange)
+method steps are:
+
+
+
+
+
+
+
+
+
+
+ deleteContents() method steps are:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ extractContents() method steps are to return the
+result of extracting this.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ cloneContents() method steps are to return the
+result of cloning the contents of this.
+
+
+
+
+insertNode(node) method steps are to
+insert node into this.
+
+surroundContents(newParent) method steps
+are:
+
+
+
+
+
+
+cloneRange() method steps are to return a new
+live range with the same start and end as this.
+
+detach() method steps are to do nothing.
+Its functionality (disabling a {{Range}} object) was removed, but the method itself
+is preserved for compatibility.
+
+
+
+
+
+
+isPointInRange(node, offset)
+method steps are:
+
+
+
+
+
+comparePoint(node, offset)
+method steps are:
+
+
+
+
+
+
+
+intersectsNode(node) method steps are:
+
+
+
+
+
+
+
+
+
+Traversal
+
+
+
+
+
+acceptNode", and
+ « node ». If this throws an exception, then unset traverser's
+ active flag and rethrow the exception.
+
+ Interface {{NodeIterator}}
+
+
+[Exposed=Window]
+interface NodeIterator {
+ [SameObject] readonly attribute Node root;
+ readonly attribute Node referenceNode;
+ readonly attribute boolean pointerBeforeReferenceNode;
+ readonly attribute unsigned long whatToShow;
+ readonly attribute NodeFilter? filter;
+
+ Node? nextNode();
+ Node? previousNode();
+
+ undefined detach();
+};
+
+
+NodeIterator pre-removing steps given a nodeIterator and
+toBeRemovedNode, are as follows:
+
+
+
+
+
+
+
+
+
+root getter steps are to return
+this's root.
+
+referenceNode getter steps are to return
+this's reference.
+
+pointerBeforeReferenceNode getter steps
+are to return this's pointer before reference.
+
+whatToShow getter steps are to return
+this's whatToShow.
+
+filter getter steps are to return
+this's filter.
+
+
+
+
+
+
+
+
+
+
+ nextNode() method steps are to return the
+result of traversing with this and next.
+
+previousNode() method steps are to return the
+result of traversing with this and previous.
+
+detach() method steps are to do nothing.
+Its functionality (disabling a {{NodeIterator}} object) was removed, but the method
+itself is preserved for compatibility.
+
+
+Interface {{TreeWalker}}
+
+
+[Exposed=Window]
+interface TreeWalker {
+ [SameObject] readonly attribute Node root;
+ readonly attribute unsigned long whatToShow;
+ readonly attribute NodeFilter? filter;
+ attribute Node currentNode;
+
+ Node? parentNode();
+ Node? firstChild();
+ Node? lastChild();
+ Node? previousSibling();
+ Node? nextSibling();
+ Node? previousNode();
+ Node? nextNode();
+};
+
+root getter steps are to return
+this's root.
+
+whatToShow getter steps are to return
+this's whatToShow.
+
+filter getter steps are to return
+this's filter.
+
+currentNode getter steps are to return
+this's current.
+
+
+
+parentNode() method steps are:
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ firstChild() method steps are to
+traverse children with this and first.
+
+lastChild() method steps are to
+traverse children with this and last.
+
+
+
+
+
+
+
+
+
+ nextSibling() method steps are to
+traverse siblings with this and next.
+
+previousSibling() method steps are to
+traverse siblings with this and previous.
+
+previousNode() method steps are:
+
+
+
+
+
+
+
+
+
+
+
+
+
+ nextNode() method steps are:
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Interface {{NodeFilter}}
+
+
+[Exposed=Window]
+callback interface NodeFilter {
+ // Constants for acceptNode()
+ const unsigned short FILTER_ACCEPT = 1;
+ const unsigned short FILTER_REJECT = 2;
+ const unsigned short FILTER_SKIP = 3;
+
+ // Constants for whatToShow
+ const unsigned long SHOW_ALL = 0xFFFFFFFF;
+ const unsigned long SHOW_ELEMENT = 0x1;
+ const unsigned long SHOW_ATTRIBUTE = 0x2;
+ const unsigned long SHOW_TEXT = 0x4;
+ const unsigned long SHOW_CDATA_SECTION = 0x8;
+ const unsigned long SHOW_ENTITY_REFERENCE = 0x10; // legacy
+ const unsigned long SHOW_ENTITY = 0x20; // legacy
+ const unsigned long SHOW_PROCESSING_INSTRUCTION = 0x40;
+ const unsigned long SHOW_COMMENT = 0x80;
+ const unsigned long SHOW_DOCUMENT = 0x100;
+ const unsigned long SHOW_DOCUMENT_TYPE = 0x200;
+ const unsigned long SHOW_DOCUMENT_FRAGMENT = 0x400;
+ const unsigned long SHOW_NOTATION = 0x800; // legacy
+
+ unsigned short acceptNode(Node node);
+};
+
+
+
+
+
+FILTER_ACCEPT (1);
+ FILTER_REJECT (2);
+ FILTER_SKIP (3).
+
+
+
+
+
+SHOW_ALL (4294967295, FFFFFFFF in hexadecimal);
+ SHOW_ELEMENT (1);
+ SHOW_ATTRIBUTE (2);
+ SHOW_TEXT (4);
+ SHOW_CDATA_SECTION (8);
+ SHOW_PROCESSING_INSTRUCTION (64, 40 in hexadecimal);
+ SHOW_COMMENT (128, 80 in hexadecimal);
+ SHOW_DOCUMENT (256, 100 in hexadecimal);
+ SHOW_DOCUMENT_TYPE (512, 200 in hexadecimal);
+ SHOW_DOCUMENT_FRAGMENT (1024, 400 in hexadecimal).
+Sets
+
+Interface {{DOMTokenList}}
+
+
+[Exposed=Window]
+interface DOMTokenList {
+ readonly attribute unsigned long length;
+ getter DOMString? item(unsigned long index);
+ boolean contains(DOMString token);
+ [CEReactions] undefined add(DOMString... tokens);
+ [CEReactions] undefined remove(DOMString... tokens);
+ [CEReactions] boolean toggle(DOMString token, optional boolean force);
+ [CEReactions] boolean replace(DOMString token, DOMString newToken);
+ boolean supports(DOMString token);
+ [CEReactions] stringifier attribute DOMString value;
+ iterable<DOMString>;
+};
+
+
+
+
+
+TypeError.
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+tokenlist . {{DOMTokenList/length}}
+ tokenlist . {{DOMTokenList/item(index)}}
+ tokenlist[index]
+ tokenlist . {{DOMTokenList/contains(token)}}
+ tokenlist . add(tokens…)
+ tokenlist . remove(tokens…)
+ tokenlist . toggle(token [, force])
+ tokenlist . replace(token, newToken)
+ tokenlist . supports(token)
+ TypeError if the associated attribute has no supported tokens defined.
+
+ tokenlist . {{DOMTokenList/value}}
+ length attribute' getter must return
+this's token set's size.
+
+item(index) method steps are:
+
+contains(token) method steps are
+to return true if this's token set[token] exists; otherwise
+false.
+
+add(tokens…)
+method steps are:
+
+
+
+
+
+
+
+ remove(tokens…)
+method steps are:
+
+
+
+
+
+
+
+ toggle(token, force)
+method steps are:
+
+
+
+
+
+
+
+ replace(token, newToken)
+method steps are:
+
+
+
+
+
+supports(token)
+method steps are:
+
+
+
+
+value attribute must return the
+result of running this's serialize steps.
+
+XPath
+
+Interface {{XPathResult}}
+
+
+[Exposed=Window]
+interface XPathResult {
+ const unsigned short ANY_TYPE = 0;
+ const unsigned short NUMBER_TYPE = 1;
+ const unsigned short STRING_TYPE = 2;
+ const unsigned short BOOLEAN_TYPE = 3;
+ const unsigned short UNORDERED_NODE_ITERATOR_TYPE = 4;
+ const unsigned short ORDERED_NODE_ITERATOR_TYPE = 5;
+ const unsigned short UNORDERED_NODE_SNAPSHOT_TYPE = 6;
+ const unsigned short ORDERED_NODE_SNAPSHOT_TYPE = 7;
+ const unsigned short ANY_UNORDERED_NODE_TYPE = 8;
+ const unsigned short FIRST_ORDERED_NODE_TYPE = 9;
+
+ readonly attribute unsigned short resultType;
+ readonly attribute unrestricted double numberValue;
+ readonly attribute DOMString stringValue;
+ readonly attribute boolean booleanValue;
+ readonly attribute Node? singleNodeValue;
+ readonly attribute boolean invalidIteratorState;
+ readonly attribute unsigned long snapshotLength;
+
+ Node? iterateNext();
+ Node? snapshotItem(unsigned long index);
+};
+
+
+
+Interface {{XPathExpression}}
+
+
+[Exposed=Window]
+interface XPathExpression {
+ // XPathResult.ANY_TYPE = 0
+ XPathResult evaluate(Node contextNode, optional unsigned short type = 0, optional XPathResult? result = null);
+};
+
+
+
+Mixin {{XPathEvaluatorBase}}
+
+
+callback interface XPathNSResolver {
+ DOMString? lookupNamespaceURI(DOMString? prefix);
+};
+
+interface mixin XPathEvaluatorBase {
+ [NewObject] XPathExpression createExpression(DOMString expression, optional XPathNSResolver? resolver = null);
+ XPathNSResolver createNSResolver(Node nodeResolver);
+ // XPathResult.ANY_TYPE = 0
+ XPathResult evaluate(DOMString expression, Node contextNode, optional XPathNSResolver? resolver = null, optional unsigned short type = 0, optional XPathResult? result = null);
+};
+Document includes XPathEvaluatorBase;
+
+
+
+Interface {{XPathEvaluator}}
+
+
+[Exposed=Window]
+interface XPathEvaluator {
+ constructor();
+};
+
+XPathEvaluator includes XPathEvaluatorBase;
+
+
+XSLT
+
+Interface {{XSLTProcessor}}
+
+
+[Exposed=Window]
+interface XSLTProcessor {
+ constructor();
+ undefined importStylesheet(Node style);
+ [CEReactions] DocumentFragment transformToFragment(Node source, Document output);
+ [CEReactions] Document transformToDocument(Node source);
+ undefined setParameter([LegacyNullToEmptyString] DOMString namespaceURI, DOMString localName, any value);
+ any getParameter([LegacyNullToEmptyString] DOMString namespaceURI, DOMString localName);
+ undefined removeParameter([LegacyNullToEmptyString] DOMString namespaceURI, DOMString localName);
+ undefined clearParameters();
+ undefined reset();
+};
+
+
+
+
+Historical
+
+
+
+
+DOMConfiguration
+ DOMError
+ DOMErrorHandler
+ DOMImplementationList
+ DOMImplementationSource
+ DOMLocator
+ DOMObject
+ DOMUserData
+ Entity
+ EntityReference
+ MutationEvent
+ MutationNameEvent
+ NameList
+ Notation
+ RangeException
+ TypeInfo
+ UserDataHandler
+
+
+
+
+
+
+
+
+ schemaTypeInfo
+ isId
+
+
+
+ createEntityReference()
+ xmlEncoding
+ xmlStandalone
+ xmlVersion
+ strictErrorChecking
+ domConfig
+ normalizeDocument()
+ renameNode()
+
+
+
+ entities
+ notations
+ internalSubset
+
+
+
+ getFeature()
+
+
+
+ schemaTypeInfo
+ setIdAttribute()
+ setIdAttributeNS()
+ setIdAttributeNode()
+
+
+
+ isSupported
+ getFeature()
+ getUserData()
+ setUserData()
+
+
+
+
+
+
+ isElementContentWhitespace
+ replaceWholeText()
+
+
+Acknowledgments
+
+