Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri