CKTIS / JavaScript
Element.replaceWith — zamenjava elementa
Element.replaceWith zamenja element znotraj njegovega nadrejenega elementa z vozlišči in besedilom. Nizi postanejo besedilo, ne oznake HTML.
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
element.replaceWith(...nodes)Element.replaceWith izhaja iz mešanice ChildNode v standardu DOM, ne iz izdaje ECMAScript. Klic element.replaceWith(...nodes) zamenja sam element, ne njegovih otrok; replaceChildren(...nodes) spremeni otroke.
Argumenti so vozlišča in nizi v navedenem vrstnem redu. Vozlišča se premaknejo, ne kopirajo; nizi ustvarijo vozlišča Text, ne da bi se razčlenila koda HTML. Metoda vrne undefined. Klic brez argumentov odstrani element; če nima nadrejenega elementa, ne spremeni ničesar.
Neveljavna drevesna struktura lahko povzroči HierarchyRequestError. Razpoložljivost preverite v okolju DOM z izrazom typeof Element.prototype.replaceWith === 'function'; sama različica Node.js ne potrjuje podpore.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.