Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Node.insertBefore — inserire prima di un nodo figlio

Node.insertBefore inserisce o sposta un nodo prima di un figlio specificato. Passando null, il nodo viene inserito alla fine.

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

Sintassi

parent.insertBefore(node, child)

Chiama Node.insertBefore sul genitore: parent.insertBefore(node, child). child deve essere un figlio diretto del genitore oppure null (per aggiungere il nodo alla fine). Fornisci entrambi gli argomenti. Il metodo restituisce node.

Un nodo già esistente viene spostato, non copiato. Con un DocumentFragment vengono inseriti i suoi figli; il frammento restituito è vuoto.

Una gerarchia non consentita, per esempio un ciclo, causa HierarchyRequestError. Il metodo verifica se l’inserimento creerebbe un ciclo prima di controllare se child appartiene al genitore. Se l’inserimento dovesse creare un ciclo, il metodo lancia HierarchyRequestError anche se child non appartiene al genitore. Se i controlli precedenti vengono superati e child non è né null né un figlio diretto del genitore, il metodo lancia NotFoundError. Questa è un’API DOM, non ECMAScript; la sola presenza di Node.js 24 non dimostra che il DOM sia disponibile.

Esempi

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);

Risultato

AB
true
BA

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti