Node

Propiedades de instancia

Además de las propiedades a continuación, Node hereda propiedades de su padre, EventTarget.

Node.baseURI Read only

Devuelve una cadena que representa la URL base del documento que contiene el Node.

Node.childNodes Read only

Devuelve un NodeList en vivo que contiene todos los elementos secundarios de este nodo (incluidos elementos, texto y comentarios). Un NodeList en vivo significa que si los hijos de Node cambian, el objeto NodeList se actualiza automáticamente.

Node.firstChild Read only

Devuelve un Node que representa el primer nodo hijo directo del nodo, o null si el nodo no tiene ningún hijo.

Node.isConnected Read only

Un valor booleano que indica si el nodo está conectado o no (directa o indirectamente) al objeto de contexto, por ejemplo el objeto Document en el caso del DOM normal, o ShadowRoot en el caso de un DOM oculto.

Node.lastChild Read only

Devuelve un Node que representa el último nodo hijo directo del nodo, o null si el nodo no tiene ningún hijo.

Node.nextSibling Read only

Devuelve un Node que representa el siguiente nodo en el árbol, o null si no existe tal nodo.

Node.nodeName Read only

Devuelve una cadena que contiene el nombre de Node. La estructura del nombre diferirá con el tipo de nodo. Por ejemplo, un HTMLElement contendrá el nombre de la etiqueta correspondiente, como 'audio' para un HTMLAudioElement, un Text tendrá la cadena '#text', o un nodo Document tendrá la cadena '#document'.

Node.nodeType Read only

Devuelve un unsigned short que representa el tipo del nodo. Los valores posibles son:

Nombre	Valor
ELEMENT_NODE	1
ATTRIBUTE_NODE	2
TEXT_NODE	3
CDATA_SECTION_NODE	4
PROCESSING_INSTRUCTION_NODE	7
COMMENT_NODE	8
DOCUMENT_NODE	9
DOCUMENT_TYPE_NODE	10
DOCUMENT_FRAGMENT_NODE	11

Node.nodeValue

Devuelve/Establece el valor del nodo actual.

Node.ownerDocument Read only

Devuelve el Document al que pertenece este nodo. Si el nodo es en sí mismo un documento, devuelve null.

Node.parentNode Read only

Devuelve un Node que es el padre de este nodo. Si no existe tal nodo, como si este nodo es la parte superior del árbol o si no participa en un árbol, esta propiedad devuelve null.

Node.parentElement Read only

Devuelve un Element que es el padre de este nodo. Si el nodo no tiene padre, o si ese padre no es Element, esta propiedad devuelve null.

Node.previousSibling Read only

Devuelve un Node que representa el nodo anterior en el árbol, o null si no existe tal nodo.

Node.textContent

Devuelve/Establece el contenido textual de un elemento y todos sus descendientes.

Métodos de instancia

Además de los métodos a continuación, Node hereda métodos de su padre, EventTarget.

Node.appendChild()

Agrega el argumento childNode especificado como el último hijo del nodo actual. Si el argumento hace referencia a un nodo existente en el árbol DOM, el nodo se separará de su posición actual y se adjuntará a la nueva posición.

Node.cloneNode()

Clona un Node y, opcionalmente, todo su contenido. Por defecto, clona el contenido del nodo.

Node.compareDocumentPosition()

Compara la posición del nodo actual con otro nodo en cualquier otro documento.

Node.contains()

Devuelve el valor true o false que indica si un nodo es o no descendiente del nodo que llama.

Node.getRootNode()

Devuelve la raíz del objeto de contexto que, opcionalmente, incluye la raíz oculta si está disponible.

Node.hasChildNodes()

Devuelve un valor booleano que indica si el elemento tiene o no nodos secundarios.

Node.insertBefore()

Inserta un Node antes del nodo de referencia como hijo de un nodo principal especificado.

Node.isDefaultNamespace()

Acepta un URI de espacio de nombres como argumento y devuelve un valor booleano con un valor de true si el espacio de nombres es el espacio de nombres predeterminado en el nodo dado o false si no lo es.

Node.isEqualNode()

Devuelve un valor booleano que indica si dos nodos son o no del mismo tipo y todos los puntos de datos que los definen coinciden.

Node.isSameNode()

Devuelve un valor booleano que indica si los dos nodos son iguales o no (es decir, hacen referencia al mismo objeto).

Node.lookupPrefix()

Devuelve una cadena que contiene el prefijo para un URI de espacio de nombres dado, si está presente, y null si no lo está. Cuando son posibles varios prefijos, el resultado depende de la implementación.

Node.lookupNamespaceURI()

Acepta un prefijo y devuelve el URI del espacio de nombres asociado con él en el nodo dado si lo encuentra (y null si no). Proporcionar null para el prefijo devolverá el espacio de nombres predeterminado.

Node.normalize()

Limpia todos los nodos de texto debajo de este elemento (combina adyacentes, elimina vacíos).

Node.removeChild()

Elimina un nodo hijo del elemento actual, que debe ser uns hijo del nodo actual.

Node.replaceChild()

Reemplaza un Node hijo del actual con el segundo dado en el parámetro.

Ejemplos

Eliminar todos los hijos anidados dentro de un nodo

Esta función elimina cada primer hijo de un elemento, hasta que no quede ninguno.

function removeAllChildren(element) {
  while (element.firstChild) {
    element.removeChild(element.firstChild);
  }
}

El uso de esta función es una sola llamada. Aquí vaciamos el cuerpo del documento:

removeAllChildren(document.body);

Una alternativa podría ser establecer textContent a una cadena vacía: document.body.textContent = "".

Recursión a través de nodos hijos

La siguiente función llama recursivamente a una función callback para cada nodo contenido en un nodo raíz (incluida la propia raíz):

function eachNode(rootNode, callback) {
  if (!callback) {
    const nodes = [];
    eachNode(rootNode, (node) => {
      nodes.push(node);
    });
    return nodes;
  }

  if (callback(rootNode) === false) {
    return false;
  }

  if (rootNode.hasChildNodes()) {
    for (const node of rootNode.childNodes) {
      if (eachNode(node, callback) === false) {
        return;
      }
    }
  }
}

La función llama recursivamente a una función para cada nodo descendiente de rootNode (incluida la propia raíz).

Si se omite callback, la función devuelve Array en su lugar, que contiene rootNode y todos los nodos contenidos dentro.

Si se proporciona callback y devuelve false cuando se llama, el nivel de recurrencia actual se aborta y la función reanuda la ejecución en el nivel del último padre. Esto se puede usar para abortar bucles una vez que se ha encontrado un nodo (como buscar un nodo de texto que contiene una determinada cadena).

La función tiene dos parámetros:

rootNode

El objeto Node cuyos descendientes serán recursivos.

callback Opcional

Una función callback opcional que recibe un Node como único argumento. Si se omite, eachNode devuelve un Array de cada nodo contenido dentro de rootNode (incluida la propia raíz).

Lo siguiente demuestra un uso real de la función eachNode(): buscar texto en una página web.

Usamos una función contenedora llamada grep para hacer la búsqueda:

function grep(parentNode, pattern) {
  let matches = [];
  let endScan = false;

  eachNode(parentNode, (node) => {
    if (endScan) {
      return false;
    }

    // Ignora cualquier cosa que no sea un nodo de texto
    if (node.nodeType !== Node.TEXT_NODE) {
      return;
    }

    if (typeof pattern === "string" && node.textContent.includes(pattern)) {
      matches.push(node);
    } else if (pattern.test(node.textContent)) {
      if (!pattern.global) {
        endScan = true;
        matches = node;
      } else {
        matches.push(node);
      }
    }
  });

  return matches;
}

Especificaciones

Compatibilidad con navegadores