Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

Node.firstChild — el primer nodo hijo

Node.firstChild es una propiedad de solo lectura que devuelve el primer nodo hijo directo o null. También incluye texto y comentarios, por lo que el nodo devuelto no tiene por qué ser un elemento.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

node.firstChild

Node.firstChild lee el primer nodo hijo directo según el orden del árbol, no el primer elemento a cualquier profundidad. Devuelve un objeto Node o null si el nodo no tiene hijos. Es una propiedad de solo lectura, no un método: usa node.firstChild, sin paréntesis de llamada.

Un hijo puede ser un elemento, un nodo Text o un nodo Comment. También cuenta el texto que contiene únicamente espacios en blanco. Si necesitas el primer hijo que sea un elemento, usa firstElementChild en un Element, Document o DocumentFragment; esta propiedad omite el texto y los comentarios.

Comprueba que el resultado no sea null antes de acceder a sus propiedades. La lectura no crea una copia: puedes modificar el nodo devuelto. Después de añadir o quitar hijos, otra lectura de firstChild refleja el árbol actual; una referencia guardada anteriormente no pasa a apuntar al nuevo primer hijo.

El ejemplo crea un elemento desvinculado, añade texto en blanco y un elemento, y después elimina los hijos. Requiere un entorno DOM de navegador. Esta es una API del estándar DOM, no una función de una edición concreta de ECMAScript; la versión de Node.js de un repositorio no demuestra que haya compatibilidad con las API del navegador.

Ejemplos

const parent = document.createElement('div');
const text = document.createTextNode('\n  ');
const element = document.createElement('span');
parent.append(text, element);

console.log(parent.firstChild === text);
console.log(parent.firstChild.nodeType === Node.TEXT_NODE);
console.log(parent.firstElementChild === element);
parent.removeChild(text);
console.log(parent.firstChild === element);
parent.removeChild(element);
console.log(parent.firstChild === null);

Resultado

true
true
true
true
true

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes