CKTIS / JavaScript
Node.removeChild(): odklop podrejenega vozlišča
Metoda parent.removeChild(child) odklopi neposrednega otroka od njegovega nadrejenega vozlišča in vrne isto vozlišče, ki ga je mogoče znova vstaviti.
Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
parent.removeChild(child)Node.removeChild je instančna metoda vmesnika Node, določena s standardom DOM, ne z ECMAScriptom. Pokličite parent.removeChild(child) na nadrejenem vozlišču; child je lahko tudi besedilno vozlišče.
Metoda vrne isti objekt child. Po odklopu je njegov parentNode enak null; ohranjeno vozlišče je mogoče znova vstaviti z appendChild. Odklop ne uniči ne objekta ne njegovega poddrevesa.
Če je child vozlišče tipa Node, vendar ni neposreden otrok vozlišča parent, metoda sproži DOMException z imenom NotFoundError. To se zgodi na primer, če podate bolj oddaljenega potomca ali poskusite znova odstraniti že odklopljenega otroka. Če podate null, se TypeError sproži med pretvorbo argumenta po pravilih Web IDL, še preden se preveri nadrejeno vozlišče. Primer zahteva DOM v brskalniku; sama različica Node.js ne dokazuje, da je ta API na voljo.
Primeri
const parent = document.createElement('div');
const child = document.createTextNode('Hello');
parent.appendChild(child);
const removed = parent.removeChild(child);
console.log(removed === child);
console.log(child.parentNode === null);
console.log(parent.childNodes.length);
parent.appendChild(removed);
console.log(parent.textContent);Rezultat
true true 0 Hello
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.