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.