Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / JavaScript

Node.appendChild — připojení uzlu

Node.appendChild přidá uzel jako posledního potomka rodiče. Vrátí předaný uzel a existující uzel přesune, místo aby jej zkopíroval.

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

Syntaxe

parent.appendChild(node)

parent.appendChild(node) přijímá jeden Node a vrací tentýž objekt. Jde o DOM API, nikoli o funkci ECMAScriptu.

Pokud node už má rodiče, přesune se, nezkopíruje. Opětovné přidání existujícího potomka jej přesune na konec. U DocumentFragment se jeho potomci přesunou v dosavadním pořadí; vrácený fragment bude prázdný.

Neplatná hierarchie, například vložení předka do jeho potomka, způsobí chybu HierarchyRequestError. Na rozdíl od append() tato metoda nepřijímá text ani více argumentů jako seznam uzlů.

Příklad vyžaduje DOM prohlížeče; samotná verze Node.js nedokládá podporu tohoto API. Výsledek BA ukazuje přesunutí uzlu first.

Příklady

const parent = document.createElement('div');
const first = document.createElement('span');
first.textContent = 'A';
const second = document.createElement('span');
second.textContent = 'B';

parent.appendChild(first);
parent.appendChild(second);
const returned = parent.appendChild(first);

console.log(parent.textContent);
console.log(returned === first);
console.log(parent.childNodes.length);

Výsledek

BA
true
2

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje