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

関連情報