Node

Module: JavaScript DOM API

The basic document node.

#include <Node.idl>

Inherits from EventTarget

Inherited by Attr, CharacterData, Document, DocumentFragment, DocumentType, Element

Public Functions

	Name
Node	removeChild(Node oldChild) remove a child node
Node	appendChild(Node newChild) append a node as a child
void	append((Node or DOMString)… newChildren) append nodes and string objects as children, where the string objects are inserted as equivalent Text nodes
Node	replaceChild(Node newChild, Node oldChild) replace oldChild with newChild
Node	insertBefore(Node node, Node? referenceNode) insert a node before the reference node, as a child of the current node
Node	cloneNode(optional boolean deep =false)
boolean	isEqualNode(Node? otherNode)
boolean	isSameNode(Node? otherNode)
boolean	hasChildNodes()
boolean	contains(Node? other)
DOMString	lookupPrefix(DOMString? namespace)
boolean	isDefaultNamespace(DOMString? namespace)
void	normalize()
unsigned short	compareDocumentPosition(Node other)
Node	getRootNode(optional GetRootNodeOptions options)
DOMString	lookupNamespaceURI(DOMString? prefix)

Public Attributes

	Name
const unsigned short	ELEMENT_NODE
const unsigned short	ATTRIBUTE_NODE
const unsigned short	TEXT_NODE
const unsigned short	CDATA_SECTION_NODE
const unsigned short	ENTITY_REFERENCE_NODE
const unsigned short	ENTITY_NODE
const unsigned short	PROCESSING_INSTRUCTION_NODE
const unsigned short	COMMENT_NODE
const unsigned short	DOCUMENT_NODE
const unsigned short	DOCUMENT_TYPE_NODE
const unsigned short	DOCUMENT_FRAGMENT_NODE
const unsigned short	NOTATION_NODE
const unsigned short	DOCUMENT_POSITION_DISCONNECTED
const unsigned short	DOCUMENT_POSITION_PRECEDING
const unsigned short	DOCUMENT_POSITION_FOLLOWING
const unsigned short	DOCUMENT_POSITION_CONTAINS
const unsigned short	DOCUMENT_POSITION_CONTAINED_BY
const unsigned short	DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC
readonly attribute DOMString	nodeName
attribute DOMString	nodeValue
attribute DOMString	textContent
readonly attribute unsigned short	nodeType type of the node
readonly attribute Node	parentNode parent of the node
readonly attribute Element	parentElement parent element of the node. If parent is not an Element, returns null.
readonly attribute NodeList	childNodes list of the children of this node
readonly attribute Node	firstChild the node’s first child in the tree, or null if the node is childless
readonly attribute Node	lastChild last child of the node, or null if there are no child elements
readonly attribute Node	previousSibling the node immediately preceding the specified one in its parent’s children, or null if the specified node is the first in that list
readonly attribute Node	nextSibling the node immediately following the specified one in its parent’s children, or null if the specified node is the last node in that list
readonly attribute Document	ownerDocument The Document object associated with this node. This is also the Document object used to create new nodes. When this node is a Document or a DocumentType which is not used with any Document yet, this is null.
readonly attribute USVString	baseURI
readonly attribute boolean	isConnected
attribute EventSetter	slotchange

Additional inherited members

Public Functions inherited from EventTarget

	Name
void	addEventListener(DOMInternedString type, EventListener listener, optional AddEventListenerOptions options)
void	removeEventListener(DOMInternedString type, EventListener listener, optional RemoveEventListenerOptions options)
boolean	dispatchEvent(Event event)

Public Functions Documentation

function removeChild

Node removeChild(
    Node oldChild
)

remove a child node

Parameters:

• oldChild the child node to be removed

Return: the removed child node

function appendChild

Node appendChild(
    Node newChild
)

append a node as a child

Parameters:

• newChild the node to append

Return: the appended child node

function append

void append(
    (Node or DOMString)... newChildren
)

append nodes and string objects as children, where the string objects are inserted as equivalent Text nodes

Parameters:

• newChildren the nodes or strings to append

function replaceChild

Node replaceChild(
    Node newChild,
    Node oldChild
)

replace oldChild with newChild

Return: the replaced child node

function insertBefore

Node insertBefore(
    Node node,
    Node? referenceNode
)

insert a node before the reference node, as a child of the current node

Parameters:

• node the new node to be inserted
• referenceNode the reference node (if null, node will be inserted at the end of the child nodes list)

Return: the inserted node

function cloneNode

Node cloneNode(
    optional boolean deep =false
)

Return: a clone of the node

function isEqualNode

boolean isEqualNode(
    Node? otherNode
)

function isSameNode

boolean isSameNode(
    Node? otherNode
)

function hasChildNodes

boolean hasChildNodes()

function contains

boolean contains(
    Node? other
)

function lookupPrefix

DOMString lookupPrefix(
    DOMString? namespace
)

function isDefaultNamespace

boolean isDefaultNamespace(
    DOMString? namespace
)

function normalize

void normalize()

function compareDocumentPosition

unsigned short compareDocumentPosition(
    Node other
)

function getRootNode

Node getRootNode(
    optional GetRootNodeOptions options
)

function lookupNamespaceURI

DOMString lookupNamespaceURI(
    DOMString? prefix
)

Public Attributes Documentation

variable ELEMENT_NODE

const unsigned short ELEMENT_NODE = 1;

variable ATTRIBUTE_NODE

const unsigned short ATTRIBUTE_NODE = 2;

variable TEXT_NODE

const unsigned short TEXT_NODE = 3;

variable CDATA_SECTION_NODE

const unsigned short CDATA_SECTION_NODE = 4;

variable ENTITY_REFERENCE_NODE

const unsigned short ENTITY_REFERENCE_NODE = 5;

variable ENTITY_NODE

const unsigned short ENTITY_NODE = 6;

variable PROCESSING_INSTRUCTION_NODE

const unsigned short PROCESSING_INSTRUCTION_NODE = 7;

variable COMMENT_NODE

const unsigned short COMMENT_NODE = 8;

variable DOCUMENT_NODE

const unsigned short DOCUMENT_NODE = 9;

variable DOCUMENT_TYPE_NODE

const unsigned short DOCUMENT_TYPE_NODE = 10;

variable DOCUMENT_FRAGMENT_NODE

const unsigned short DOCUMENT_FRAGMENT_NODE = 11;

variable NOTATION_NODE

const unsigned short NOTATION_NODE = 12;

variable DOCUMENT_POSITION_DISCONNECTED

const unsigned short DOCUMENT_POSITION_DISCONNECTED = 0x01;

variable DOCUMENT_POSITION_PRECEDING

const unsigned short DOCUMENT_POSITION_PRECEDING = 0x02;

variable DOCUMENT_POSITION_FOLLOWING

const unsigned short DOCUMENT_POSITION_FOLLOWING = 0x04;

variable DOCUMENT_POSITION_CONTAINS

const unsigned short DOCUMENT_POSITION_CONTAINS = 0x08;

variable DOCUMENT_POSITION_CONTAINED_BY

const unsigned short DOCUMENT_POSITION_CONTAINED_BY = 0x10;

variable DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC

const unsigned short DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC = 0x20;

variable nodeName

readonly attribute DOMString nodeName;

variable nodeValue

attribute DOMString nodeValue;

variable textContent

attribute DOMString textContent;

variable nodeType

readonly attribute unsigned short nodeType;

type of the node

variable parentNode

readonly attribute Node parentNode;

parent of the node

variable parentElement

readonly attribute Element parentElement;

parent element of the node. If parent is not an Element, returns null.

variable childNodes

readonly attribute NodeList childNodes;

list of the children of this node

variable firstChild

readonly attribute Node firstChild;

the node’s first child in the tree, or null if the node is childless

variable lastChild

readonly attribute Node lastChild;

last child of the node, or null if there are no child elements

variable previousSibling

readonly attribute Node previousSibling;

the node immediately preceding the specified one in its parent’s children, or null if the specified node is the first in that list

variable nextSibling

readonly attribute Node nextSibling;

the node immediately following the specified one in its parent’s children, or null if the specified node is the last node in that list

variable ownerDocument

readonly attribute Document ownerDocument;

The Document object associated with this node. This is also the Document object used to create new nodes. When this node is a Document or a DocumentType which is not used with any Document yet, this is null.

variable baseURI

readonly attribute USVString baseURI;

variable isConnected

readonly attribute boolean isConnected;

variable slotchange

attribute EventSetter slotchange;

---