Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła