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

CKTIS / JavaScript

Node.insertBefore — insertar antes de un nodo hijo

Node.insertBefore inserta o mueve un nodo para colocarlo antes de un hijo especificado. Si se pasa null, lo inserta al final.

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

parent.insertBefore(node, child)

Llama a Node.insertBefore en el padre: parent.insertBefore(node, child). child debe ser un hijo directo del padre o null (para añadir el nodo al final). Proporciona los dos argumentos. El método devuelve node.

Un nodo que ya existe se mueve, no se copia. Con un DocumentFragment, se insertan sus hijos; el fragmento devuelto queda vacío.

Una jerarquía no válida, como un ciclo, produce HierarchyRequestError. El método comprueba si la inserción crearía un ciclo antes de comprobar si child pertenece al padre. Si la inserción crearía un ciclo, lanza HierarchyRequestError aunque child no pertenezca al padre. Si se superan las comprobaciones anteriores y child no es ni null ni un hijo directo del padre, lanza NotFoundError. Esta es una API del DOM, no de ECMAScript; tener Node.js 24 por sí solo no demuestra que el DOM esté disponible.

Ejemplos

const parent = document.createElement('div');
const a = document.createTextNode('A');
const b = document.createTextNode('B');
parent.insertBefore(b, null);
const returned = parent.insertBefore(a, b);
console.log(parent.textContent);
console.log(returned === a);
parent.insertBefore(b, a);
console.log(parent.textContent);

Resultado

AB
true
BA

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