Module org.htmlunit
Package org.htmlunit.javascript.host.dom

Class Node

java.lang.Object
org.htmlunit.corejs.javascript.SlotMapOwner<org.htmlunit.corejs.javascript.Scriptable>
org.htmlunit.corejs.javascript.ScriptableObject
org.htmlunit.javascript.HtmlUnitScriptable
org.htmlunit.javascript.host.event.EventTarget
org.htmlunit.javascript.host.dom.Node
All Implemented Interfaces:
Serializable, Cloneable, org.htmlunit.corejs.javascript.ConstProperties<org.htmlunit.corejs.javascript.Scriptable>, org.htmlunit.corejs.javascript.debug.DebuggableObject, org.htmlunit.corejs.javascript.PropHolder<org.htmlunit.corejs.javascript.Scriptable>, org.htmlunit.corejs.javascript.Scriptable, org.htmlunit.corejs.javascript.SymbolScriptable
Direct Known Subclasses:
Attr, CharacterData, Document, DocumentFragment, DocumentType, Element
public class Node extends EventTarget
The JavaScript object Node which is the base class for all DOM objects. This will typically wrap an instance of DomNode.
Author:
Mike Bowler, David K. Taylor, Barnaby Court, Christian Sell, George Murnock, Chris Erskine, Bruce Faulkner, Ahmed Ashour, Ronald Brill, Frank Danek
See Also:

  • Nested Class Summary

    Nested classes/interfaces inherited from class org.htmlunit.corejs.javascript.ScriptableObject

    org.htmlunit.corejs.javascript.ScriptableObject.DescriptorInfo, org.htmlunit.corejs.javascript.ScriptableObject.KeyComparator, org.htmlunit.corejs.javascript.ScriptableObject.LambdaGetterFunction, org.htmlunit.corejs.javascript.ScriptableObject.LambdaSetterFunction

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final int
    ATTRIBUTE_NODE
    The node is an attribute.
    static final int
    CDATA_SECTION_NODE
    The node is a CDATA section.
    static final int
    COMMENT_NODE
    The node is a comment.
    static final int
    DOCUMENT_FRAGMENT_NODE
    The node is a document fragment.
    static final int
    DOCUMENT_NODE
    The node is a document.
    static final int
    DOCUMENT_POSITION_CONTAINED_BY
    The reference node is contained by the other node.
    static final int
    DOCUMENT_POSITION_CONTAINS
    The reference node contains the other node.
    static final int
    DOCUMENT_POSITION_DISCONNECTED
    The nodes are disconnected.
    static final int
    DOCUMENT_POSITION_FOLLOWING
    The reference node follows the other node.
    static final int
    DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC
    The document position is implementation-specific.
    static final int
    DOCUMENT_POSITION_PRECEDING
    The reference node precedes the other node.
    static final int
    DOCUMENT_TYPE_NODE
    The node is a document type.
    static final int
    ELEMENT_NODE
    The node is an element.
    static final int
    ENTITY_NODE
    The node is an entity.
    static final int
    ENTITY_REFERENCE_NODE
    The node is an entity reference.
    static final int
    NOTATION_NODE
    The node is a notation.
    static final int
    PROCESSING_INSTRUCTION_NODE
    The node is a processing instruction.
    static final int
    TEXT_NODE
    The node is a text node.

    Fields inherited from class org.htmlunit.corejs.javascript.ScriptableObject

    CONST, DONTENUM, EMPTY, PERMANENT, READONLY, UNINITIALIZED_CONST

    Fields inherited from class org.htmlunit.corejs.javascript.SlotMapOwner

    isSealed

    Fields inherited from interface org.htmlunit.corejs.javascript.Scriptable

    NOT_FOUND

  • Constructor Summary

    Constructors
    Constructor
    Description
    Node()
     

  • Method Summary

    Modifier and Type
    Method
    Description
    protected static void
    after(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function)
    Inserts a set of Node or DOMString objects in the children list of this ChildNode's parent, just after this ChildNode.
    protected static void
    append(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function)
    Inserts a set of Node objects or string objects after the last child of the Element.
    Node
    appendChild(Object childObject)
    Adds a DOM node to the node.
    protected static void
    before(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function)
    Inserts a set of Node or DOMString objects in the children list of this ChildNode's parent, just before this ChildNode.
    Node
    cloneNode(boolean deep)
    Clones this node.
    int
    compareDocumentPosition(Object node)
    Compares the positions of this node and the provided node within the document.
    boolean
    contains(Object element)
    Returns whether the specified node is contained within this node.
    NamedNodeMap
    getAttributes()
    Returns the attributes of this XML element.
    String
    getBaseURI()
    Returns the Base URI as a string.
    protected int
    getChildElementCount()
    Returns the current number of child elements.
    NodeList
    getChildNodes()
    Returns the child nodes of the current element.
    protected HTMLCollection
    getChildren()
    Returns the child elements of this node.
    Node
    getFirstChild()
    Gets the JavaScript property firstChild for the node that contains the current node.
    protected Element
    getFirstElementChild()
    Returns the first element child.
    protected Node
    getJavaScriptNode(DomNode domNode)
    Gets the JavaScript node for a given DomNode.
    Node
    getLastChild()
    Gets the JavaScript property lastChild for the node that contains the current node.
    protected Element
    getLastElementChild()
    Returns the last element child.
    String
    getLocalName()
    Returns the local name of this attribute.
    String
    getNamespaceURI()
    Returns the URI that identifies an XML namespace.
    Node
    getNextSibling()
    Gets the JavaScript property nextSibling for the node that contains the current node.
    String
    getNodeName()
    Gets the JavaScript property nodeName for the current node.
    int
    getNodeType()
    Gets the JavaScript property nodeType for the current node.
    String
    getNodeValue()
    Gets the JavaScript property nodeValue for the current node.
    HtmlUnitScriptable
    getOwnerDocument()
    Returns the owner document.
    final Node
    getParent()
    Returns this node's parent node.
    Element
    getParentElement()
    Gets the JavaScript property parentElement.
    Object
    getParentNode()
    Gets the JavaScript property parentNode for the node that contains the current node.
    String
    getPrefix()
    Returns the namespace prefix.
    Node
    getPreviousSibling()
    Gets the JavaScript property previousSibling for the node that contains the current node.
    Node
    getRootNode()
    Returns the root node of this node's tree.
    String
    getTextContent()
    Gets the textContent attribute.
    boolean
    hasAttributes()
    Returns whether this node has any attributes.
    boolean
    hasChildNodes()
    Returns whether this node has any child nodes.
    static Node
    insertBefore(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.VarScope scope, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function)
    Add a DOM node as a child to this node before the referenced node.
    protected Node
    insertBeforeImpl(Object[] args)
    Add a DOM node as a child to this node before the referenced node.
    boolean
    isEqualNode(Node other)
    Determines whether this node is structurally equal to the specified node.
    boolean
    isSameNode(Object other)
    Determines whether this node and the specified node are the same object.
    void
    jsConstructor()
    JavaScript constructor.
    String
    lookupPrefix(String namespace)
    Returns the namespace prefix for the specified namespace URI.
    static void
    moveBefore(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.VarScope scope, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function)
    Moves a given Node inside the invoking node as a direct child, before a given reference node.
    void
    normalize()
    Merges adjacent TextNode objects to produce a normalized document object model.
    protected static void
    prepend(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function)
    Inserts a set of Node objects or string objects before the first child of the Element.
    protected void
    remove()
    Removes the DOM node from its parent.
    Node
    removeChild(Object childObject)
    Removes a DOM node from this node.
    Node
    replaceChild(Object newChildObject, Object oldChildObject)
    Replaces a child DOM node with another DOM node.
    protected static void
    replaceChildren(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function)
    Replaces the existing children of a Node with a specified new set of children.
    protected static void
    replaceWith(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function)
    Replaces this ChildNode in the children list of its parent with a set of Node or DOMString objects.
    void
    setNodeValue(String newValue)
    Sets the JavaScript property nodeValue for the current node.
    void
    setTextContent(Object value)
    Replace all children elements of this element with the supplied value.

    Methods inherited from class org.htmlunit.javascript.host.event.EventTarget

    addEventListener, clearEventListenersContainer, dispatchEvent, executeEventLocally, fireEvent, getEventHandler, getEventListenersContainer, hasEventHandlers, isEventHandlerOnWindow, removeEventListener, setEventHandler

    Methods inherited from class org.htmlunit.javascript.HtmlUnitScriptable

    clone, equivalentValues, get, getBrowserVersion, getClassName, getDefaultValue, getDomNodeOrDie, getDomNodeOrNull, getPrototype, getScriptableFor, getWindow, getWindow, getWindowOrWorkerGlobalScope, getWithPreemption, has, hasInstance, makeScriptableFor, put, setClassName, setDomNode, setDomNode, setupPromise, setupRejectedPromise

    Methods inherited from class org.htmlunit.corejs.javascript.ScriptableObject

    applyDescriptorToAttributeBitset, avoidObjectDetection, buildDataDescriptor, callMethod, callMethod, checkNotSealed, checkPropertyChangeForSlot, checkPropertyChangeForSlot, checkPropertyDefinition, checkPropertyDefinition, checkSlotRemoval, defineBuiltinProperty, defineBuiltinProperty, defineBuiltInProperty, defineBuiltInProperty, defineBuiltInProperty, defineBuiltInProperty, defineClass, defineClass, defineClass, defineConst, defineConstProperty, defineFunctionProperties, defineOwnProperties, defineOwnProperty, defineOwnProperty, defineOwnProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, defineProperty, delete, delete, delete, deleteProperty, deleteProperty, deleteProperty, ensureScriptable, ensureScriptableObject, ensureScriptableObjectButNotSymbol, ensureSymbolScriptable, ensureType, get, get, getAllIds, getAncestor, getArrayPrototype, getClassPrototype, getClassPrototype, getDefaultValue, getExternalArrayData, getExternalArrayLength, getFunctionPrototype, getGeneratorFunctionPrototype, getGetterOrSetter, getGetterOrSetter, getObjectPrototype, getOwnPropertyDescriptor, getParentScope, getProperty, getProperty, getProperty, getProperty, getProperty, getPropertyIds, getPrototype, getSuperProperty, getSuperProperty, getSuperProperty, getThis, getTopLevelScope, getTopScopeValue, getTypedProperty, getTypedProperty, getTypeOf, hasProperty, hasProperty, hasProperty, hasProperty, isAccessorDescriptor, isAccessorDescriptor, isConst, isDataDescriptor, isEmpty, isExtensible, isFalse, isGenericDescriptor, isGenericDescriptor, isGetterOrSetter, isGetterOrSetter, isTrue, preventExtensions, put, put, putConst, putConstProperty, putConstProperty, putOwnProperty, putOwnProperty, putOwnProperty, putProperty, putProperty, putProperty, putProperty, putSuperProperty, putSuperProperty, putSuperProperty, querySlot, redefineProperty, redefineProperty, sameValue, sealObject, setCommonDescriptorProperties, setExternalArrayData, setGetterOrSetter, setParentScope, setPrototype, size

    Methods inherited from class org.htmlunit.corejs.javascript.SlotMapOwner

    associateValue, checkNotSealed, copyAssociatedValue, createSlotMap, defineProperty, defineProperty, get, getAssociatedValue, getAttributes, getAttributes, getAttributes, getAttributes, getAttributes, getIds, has, has, isSealed, readMaps, setAttributes, setAttributes, setAttributes, setAttributes, setAttributes, writeMaps

    Methods inherited from class java.lang.Object

    equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    Methods inherited from interface org.htmlunit.corejs.javascript.Scriptable

    get, getIds, has, has

    Methods inherited from interface org.htmlunit.corejs.javascript.SymbolScriptable

    get, has

  • Field Details

  • Constructor Details

    • Node

      public Node()

  • Method Details

    • jsConstructor

      public void jsConstructor()
      JavaScript constructor.
      Overrides:
      jsConstructor in class EventTarget

    • getNodeType

      public int getNodeType()
      Gets the JavaScript property nodeType for the current node.
      Returns:
      the node type

    • getNodeName

      public String getNodeName()
      Gets the JavaScript property nodeName for the current node.
      Returns:
      the node name

    • getNodeValue

      public String getNodeValue()
      Gets the JavaScript property nodeValue for the current node.
      Returns:
      the node value

    • setNodeValue

      public void setNodeValue(String newValue)
      Sets the JavaScript property nodeValue for the current node.
      Parameters:
      newValue - the new node value

    • appendChild

      public Node appendChild(Object childObject)
      Adds a DOM node to the node.
      Parameters:
      childObject - the node to add to this node
      Returns:
      the newly added child node

    • insertBefore

      public static Node insertBefore(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.VarScope scope, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function)
      Add a DOM node as a child to this node before the referenced node. If the referenced node is null, append to the end.
      Parameters:
      context - the JavaScript context
      scope - the scope
      thisObj - the scriptable
      args - the arguments passed into the method
      function - the function
      Returns:
      the newly added child node

    • insertBeforeImpl

      protected Node insertBeforeImpl(Object[] args)
      Add a DOM node as a child to this node before the referenced node. If the referenced node is null, append to the end.
      Parameters:
      args - the arguments
      Returns:
      the newly added child node

    • remove

      protected void remove()
      Removes the DOM node from its parent.
      See Also:

    • removeChild

      public Node removeChild(Object childObject)
      Removes a DOM node from this node.
      Parameters:
      childObject - the node to remove from this node
      Returns:
      the removed child node

    • replaceChild

      public Node replaceChild(Object newChildObject, Object oldChildObject)
      Replaces a child DOM node with another DOM node.
      Parameters:
      newChildObject - the node to add as a child of this node
      oldChildObject - the node to remove as a child of this node
      Returns:
      the removed child node

    • moveBefore

      public static void moveBefore(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.VarScope scope, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function)
      Moves a given Node inside the invoking node as a direct child, before a given reference node.
      Parameters:
      context - the JavaScript context
      scope - the scope
      thisObj - the scriptable
      args - the arguments passed into the method
      function - the function

    • cloneNode

      public Node cloneNode(boolean deep)
      Clones this node.
      Parameters:
      deep - if true, recursively clones all descendants
      Returns:
      the newly cloned node

    • isEqualNode

      public boolean isEqualNode(Node other)
      Determines whether this node is structurally equal to the specified node.
      Parameters:
      other - the node to compare with
      Returns:
      true if the two nodes are structurally equal
      See Also:

    • isSameNode

      public boolean isSameNode(Object other)
      Determines whether this node and the specified node are the same object.
      Parameters:
      other - the node to test against
      Returns:
      true if this node is the same node as the given one

    • hasChildNodes

      public boolean hasChildNodes()
      Returns whether this node has any child nodes.
      Returns:
      true if this node has any child nodes

    • lookupPrefix

      public String lookupPrefix(String namespace)
      Returns the namespace prefix for the specified namespace URI.
      Parameters:
      namespace - the namespace URI
      Returns:
      the corresponding namespace prefix, or null if none exists; if multiple prefixes are possible, the first one is returned

    • getChildNodes

      public NodeList getChildNodes()
      Returns the child nodes of the current element.
      Returns:
      the child nodes of the current element

    • getParent

      public final Node getParent()
      Returns this node's parent node.
      Returns:
      this node's parent node

    • getParentNode

      public Object getParentNode()
      Gets the JavaScript property parentNode for the node that contains the current node.
      Returns:
      the parent node

    • getNextSibling

      public Node getNextSibling()
      Gets the JavaScript property nextSibling for the node that contains the current node.
      Returns:
      the next sibling node or null if the current node has no next sibling.

    • getPreviousSibling

      public Node getPreviousSibling()
      Gets the JavaScript property previousSibling for the node that contains the current node.
      Returns:
      the previous sibling node or null if the current node has no previous sibling.

    • getFirstChild

      public Node getFirstChild()
      Gets the JavaScript property firstChild for the node that contains the current node.
      Returns:
      the first child node or null if the current node has no children.

    • getLastChild

      public Node getLastChild()
      Gets the JavaScript property lastChild for the node that contains the current node.
      Returns:
      the last child node or null if the current node has no children.

    • getJavaScriptNode

      protected Node getJavaScriptNode(DomNode domNode)
      Gets the JavaScript node for a given DomNode.
      Parameters:
      domNode - the DomNode
      Returns:
      the JavaScript node or null if the DomNode was null

    • getOwnerDocument

      public HtmlUnitScriptable getOwnerDocument()
      Returns the owner document.
      Returns:
      the document

    • getRootNode

      public Node getRootNode()
      Returns the root node of this node's tree.
      Returns:
      the root node

    • compareDocumentPosition

      public int compareDocumentPosition(Object node)
      Compares the positions of this node and the provided node within the document.
      Parameters:
      node - node object that specifies the node to check
      Returns:
      how the node is positioned relatively to the reference node.
      See Also:

    • normalize

      public void normalize()
      Merges adjacent TextNode objects to produce a normalized document object model.

    • getTextContent

      public String getTextContent()
      Gets the textContent attribute.
      Returns:
      the contents of this node as text

    • setTextContent

      public void setTextContent(Object value)
      Replace all children elements of this element with the supplied value.
      Parameters:
      value - - the new value for the contents of this node

    • getParentElement

      public Element getParentElement()
      Gets the JavaScript property parentElement.
      Returns:
      the parent element
      See Also:

    • getAttributes

      public NamedNodeMap getAttributes()
      Returns the attributes of this XML element.
      Returns:
      the attributes of this XML element
      See Also:

    • contains

      public boolean contains(Object element)
      Returns whether the specified node is contained within this node.
      Parameters:
      element - the node to check
      Returns:
      true if the specified node is contained within this node

    • getBaseURI

      public String getBaseURI()
      Returns the Base URI as a string.
      Returns:
      the Base URI as a string

    • hasAttributes

      public boolean hasAttributes()
      Returns whether this node has any attributes.
      Returns:
      true if this node has one or more attributes

    • getPrefix

      public String getPrefix()
      Returns the namespace prefix.
      Returns:
      the namespace prefix

    • getLocalName

      public String getLocalName()
      Returns the local name of this attribute.
      Returns:
      the local name of this attribute

    • getNamespaceURI

      public String getNamespaceURI()
      Returns the URI that identifies an XML namespace.
      Returns:
      the URI that identifies an XML namespace

    • getChildElementCount

      protected int getChildElementCount()
      Returns the current number of child elements.
      Returns:
      the child element count

    • getFirstElementChild

      protected Element getFirstElementChild()
      Returns the first element child.
      Returns:
      the first element child

    • getLastElementChild

      protected Element getLastElementChild()
      Returns the last element child.
      Returns:
      the last element child

    • getChildren

      protected HTMLCollection getChildren()
      Returns the child elements of this node.
      Returns:
      a live collection of this node's child elements
      See Also:

    • after

      protected static void after(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function)
      Inserts a set of Node or DOMString objects in the children list of this ChildNode's parent, just after this ChildNode.
      Parameters:
      context - the context
      thisObj - this object
      args - the arguments
      function - the function

    • append

      protected static void append(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function)
      Inserts a set of Node objects or string objects after the last child of the Element. String objects are inserted as equivalent Text nodes.
      Parameters:
      context - the context
      thisObj - this object
      args - the arguments
      function - the function

    • prepend

      protected static void prepend(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function)
      Inserts a set of Node objects or string objects before the first child of the Element. String objects are inserted as equivalent Text nodes.
      Parameters:
      context - the context
      thisObj - this object
      args - the arguments
      function - the function

    • replaceChildren

      protected static void replaceChildren(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function)
      Replaces the existing children of a Node with a specified new set of children. These can be string or Node objects.
      Parameters:
      context - the context
      thisObj - this object
      args - the arguments
      function - the function

    • before

      protected static void before(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function)
      Inserts a set of Node or DOMString objects in the children list of this ChildNode's parent, just before this ChildNode.
      Parameters:
      context - the context
      thisObj - this object
      args - the arguments
      function - the function

    • replaceWith

      protected static void replaceWith(org.htmlunit.corejs.javascript.Context context, org.htmlunit.corejs.javascript.Scriptable thisObj, Object[] args, org.htmlunit.corejs.javascript.Function function)
      Replaces this ChildNode in the children list of its parent with a set of Node or DOMString objects.
      Parameters:
      context - the context
      thisObj - this object
      args - the arguments
      function - the function