CKTIS / JavaScript
Element.replaceWith — zamjena elementa
Element.replaceWith zamjenjuje element unutar njegova roditelja čvorovima i tekstom. Nizovi postaju tekst, a ne HTML oznake.
Verzija: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaksa
element.replaceWith(...nodes)Element.replaceWith dolazi iz mixina ChildNode u standardu DOM, a ne iz nekog izdanja ECMAScripta. Poziv element.replaceWith(...nodes) zamjenjuje sam element, a ne njegovu djecu; replaceChildren(...nodes) mijenja djecu.
Argumenti su čvorovi i nizovi, navedenim redoslijedom. Čvorovi se premještaju, a ne kopiraju; nizovi stvaraju čvorove Text bez parsiranja HTML-a. Metoda vraća undefined. Poziv bez argumenata uklanja element; ako nema roditelja, ne dolazi do promjena.
Neispravna struktura stabla može uzrokovati HierarchyRequestError. Dostupnost provjerite u DOM okruženju pomoću izraza typeof Element.prototype.replaceWith === 'function'; sama verzija Node.js-a ne potvrđuje da je funkcija podržana.
Primjeri
const container = document.createElement('div');
const oldElement = document.createElement('span');
oldElement.textContent = 'old';
container.appendChild(oldElement);
const replacement = document.createElement('strong');
replacement.textContent = 'new';
const result = oldElement.replaceWith(replacement, ' <text>');
console.log(container.textContent);
console.log(container.firstChild === replacement);
console.log(oldElement.parentNode === null);
console.log(result === undefined);Rezultat
new <text> true true true
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.