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.