CKTIS / JavaScript
Element.replaceWith — zastępowanie elementu
Element.replaceWith zastępuje element w jego rodzicu węzłami i tekstem. Ciągi znaków stają się tekstem, a nie kodem HTML.
Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Składnia
element.replaceWith(...nodes)Element.replaceWith pochodzi z miksinu ChildNode w standardzie DOM, nie z edycji ECMAScript. Wywołanie element.replaceWith(...nodes) zastępuje sam element, nie jego dzieci; replaceChildren(...nodes) zmienia dzieci.
Argumentami są węzły i ciągi znaków, w podanej kolejności. Węzły są przenoszone, nie kopiowane; ciągi tworzą węzły Text, bez interpretowania HTML. Metoda zwraca undefined. Wywołanie bez argumentów usuwa element; bez rodzica nie wykonuje zmian.
Niedozwolona struktura drzewa może spowodować HierarchyRequestError. Dostępność sprawdzisz przez typeof Element.prototype.replaceWith === 'function' w środowisku z DOM; sama wersja Node.js jej nie potwierdza.
Przykłady
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);Wynik
new <text> true true true
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.