Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

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.

Izvori