Node

Node es una interfaz en la cuál un número de objetos de tipo DOM API heredan. Esta interfaz permite que esos objetos sean tratados similarmente.

Las siguientes interfaces todas heredan de los metodos y propiedades de Node: Document, Element, CharacterData (en-US) (heredan el Text (en-US), el Comment, y CDATASection (en-US)), ProcessingInstruction (en-US), DocumentFragment, DocumentType (en-US), Notation, Entity, EntityReference

Estas interfaces pueden retornar null en casos particulares donde los métodos y las propiedades no son relevantes. Pueden retornar una excepción - por ejemplo cuando se agregan hijos a un tipo de node del cuál no puede existir hijos.

Propiedades

herendan propiedades de sus padres EventTarget.[1]

Node.baseURI (en-US) Read only

Retorna un DOMString representando la base de la URL. El concepto de la base de la URL cambia de un lenguaje a otro; en HTML, le corresponde al protocolo, el nombre del dominio y la estructura del directorio, eso es todo hasta el último '/'.

Node.baseURIObject (en-US) Non-standard

(Not available to web content.) The read-only nsIURI object representing the base URI for the element.

Node.childNodes Read only

Returns a live NodeList containing all the children of this node. NodeList being live means that if the children of the Node change, the NodeList object is automatically updated.

Node.firstChild (en-US) Read only

Returns a Node representing the first direct child node of the node, or null if the node has no child.

Node.lastChild Read only

Returns a Node representing the last direct child node of the node, or null if the node has no child.

Node.localName (en-US) Obsoleto Read only

Returns a DOMString representing the local part of the qualified name of an element. In Firefox 3.5 and earlier, the property upper-cases the local name for HTML elements (but not XHTML elements). In later versions, this does not happen, so the property is in lower case for both HTML and XHTML. Though recent specifications require localName to be defined on the Element interface, Gecko-based browsers still implement it on the Node interface.

Node.namespaceURI (en-US) Obsoleto Read only

The namespace URI of this node, or null if it is no namespace. In Firefox 3.5 and earlier, HTML elements are in no namespace. In later versions, HTML elements are in the http://www.w3.org/1999/xhtml namespace in both HTML and XML trees. Though recent specifications require namespaceURI to be defined on the Element interface, Gecko-based browsers still implement it on the Node interface.

Node.nextSibling Read only

Returns a Node representing the next node in the tree, or null if there isn't such node.

Node.nodeName Read only

Returns a DOMString containing the name of the Node. The structure of the name will differ with the name type. E.g. An HTMLElement will contain the name of the corresponding tag, like 'audio' for an HTMLAudioElement, a Text (en-US) node will have the '#text' string, or a Document node will have the '#document' string.

Node.nodePrincipal (en-US) Non-standard

A nsIPrincipal representing the node principal.

Node.nodeTypeRead only

Returns an unsigned short representing the type of the node. Possible values are:

Name Value
ELEMENT_NODE 1
ATTRIBUTE_NODE Obsoleto 2
TEXT_NODE 3
CDATA_SECTION_NODE Obsoleto 4
ENTITY_REFERENCE_NODE Obsoleto 5
ENTITY_NODE Obsoleto 6
PROCESSING_INSTRUCTION_NODE 7
COMMENT_NODE 8
DOCUMENT_NODE 9
DOCUMENT_TYPE_NODE 10
DOCUMENT_FRAGMENT_NODE 11
NOTATION_NODE Obsoleto 12
Node.nodeValue

Is a DOMString representing the value of an object. For most Node type, this returns null and any set operation is ignored. For nodes of type TEXT_NODE (Text (en-US) objects), COMMENT_NODE (Comment objects), and PROCESSING_INSTRUCTION_NODE (ProcessingInstruction (en-US) objects), the value corresponds to the text data contained in the object.

Node.ownerDocument Read only

Returns the Document that this node belongs to. If no document is associated with it, returns null.

Node.parentNode Read only

Returns a Node that is the parent of this node. If there is no such node, like if this node is the top of the tree or if doesn't participate in a tree, this property returns null.

Node.parentElement Read only

Returns an Element that is the parent of this node. If the node has no parent, or if that parent is not an Element, this property returns null.

Node.prefix (en-US) Obsoleto Read only

Is a DOMString representing the namespace prefix of the node, or null if no prefix is specified. Though recent specifications require prefix to be defined on the Element interface, Gecko-based browsers still implement it on the Node interface.

Node.previousSibling Read only

Returns a Node representing the previous node in the tree, or null if there isn't such node.

Node.textContent

Is a DOMString representing the textual content of an element and all its descendants.

Methods

Inherits methods from its parents EventTarget.[1]

Node.appendChild()

Insert a Node as the last child node of this element.

Node.cloneNode()

Clone a Node, and optionally, all of its contents. By default, it clones the content of the node.

Node.compareDocumentPosition() (en-US)

Empty

Node.contains()

Empty

Node.getFeature() Obsoleto

...

Node.getUserData() Obsoleto

Allows a user to get some DOMUserData from the node.

Node.hasAttributes() Obsoleto

Returns a Boolean (en-US) indicating if the element has any attributes, or not.

Node.hasChildNodes()

Returns a Boolean (en-US) indicating if the element has any child nodes, or not.

Node.insertBefore()

Inserts the first Node given in a parameter immediately before the second, child of this element, Node.

Node.isDefaultNamespace() (en-US)

Empty

Node.isEqualNode() (en-US)

Empty

Node.isSameNode() Obsoleto

Empty

Node.isSupported() (en-US) Obsoleto

Returns a Boolean (en-US) flag containing the result of a test whether the DOM implementation implements a specific feature and this feature is supported by the specific node.

Node.lookupPrefix() (en-US)

Empty

Node.lookupNamespaceURI() (en-US)

Empty

Node.normalize() (en-US)

Clean up all the text nodes under this element (merge adjacent, remove empty).

Node.removeChild()

Removes a child node from the current element, which must be a child of the current node.

Node.replaceChild()

Replaces one child Node of the current one with the second one given in parameter.

Node.setUserData() Obsoleto

Allows a user to attach, or remove, DOMUserData to the node.

Examples

Browse all child nodes

The following function recursively cycles all child nodes of a node and executes a callback function upon them (and upon the parent node itself).

function DOMComb (oParent, oCallback) {
  if (oParent.hasChildNodes()) {
    for (var oNode = oParent.firstChild; oNode; oNode = oNode.nextSibling) {
      DOMComb(oNode, oCallback);
    }
  }
  oCallback.call(oParent);
}

Syntax

DOMComb(parentNode, callbackFunction);

Description

Recursively cycle all child nodes of parentNode and parentNode itself and execute the callbackFunction upon them as this objects.

Parameters

parentNode

The parent node (Node Object).

callbackFunction

The callback function (Function (en-US)).

Sample usage

The following example send to the console.log the text content of the body:

function printContent () {
  if (this.nodeValue) { console.log(this.nodeValue); }
}

onload = function () {
  DOMComb(document.body, printContent);
};

Remove all children nested within a node

Element.prototype.removeAll = function () {
  while (this.firstChild) { this.removeChild(this.firstChild); }
  return this;
};

Sample usage

/* ... an alternative to document.body.innerHTML = "" ... */
document.body.removeAll();

Especificaciones

Specification
DOM Standard
# interface-node

Compatibilidad con navegadores

BCD tables only load in the browser