CharacterData: replaceWith() メソッド

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

replaceWith()CharacterData インターフェイスのメソッドで、親ノードの子リスト内にあるこのノードを、一連の Node オブジェクトまたは文字列で置き換えます。

文字列は Text ノードとして置き換えられます。この文字列は Text() コンストラクターに引数として渡されます。

構文

js
replaceWith(nodes)

引数

nodes 省略可

カンマ区切りの Node オブジェクトまたは文字列のリストで、現在のノードを置き換えるものです。

メモ: 引数が渡されなかった場合、このメソッドはこのノードを DOM ツリーから取り除くだけの動作をします。

返値

なし (undefined)。

例外

HierarchyRequestError DOMException

ノードが階層内の指定された位置に挿入できない場合に発生します。

html
<p id="myText">Some text</p>
js
let text = document.getElementById("myText").firstChild;
let em = document.createElement("em");
em.textContent = "Italic text";

text.replaceWith(em); // `Some text` を `Italic text` で置き換える

仕様書

Specification
DOM Standard
# ref-for-dom-childnode-replacewith①

ブラウザーの互換性

BCD tables only load in the browser

関連情報