Document: replaceChildren() メソッド
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年10月以降、すべてのブラウザーで利用可能です。
Document.replaceChildren() メソッドは Document の既存の子を指定した新しい子で置き換えます。
構文
js
replaceChildren(param1)
replaceChildren(param1, param2)
replaceChildren(param1, param2, /* …, */ paramN)
引数
param1, …,paramN-
一連の
Nodeまたは文字列オブジェクトで、これがDocumentの既存の子ノードを置き換えます。置き換えるオブジェクトを指定しなかった場合は、Documentからすべての子ノードを削除します。
返値
なし (undefined)。
例外
HierarchyRequestErrorDOMException-
ノードツリーの制約に違反した場合に発生します。
例
文書を空にする
replaceChildren()`は、文書の子要素をすべて空にするとても便利なメカニズムを提供します。引数を指定しないで、文書に対して呼び出すのです。
js
document.replaceChildren();
document.children; // HTMLCollection []
仕様書
| 仕様書 |
|---|
| DOM # ref-for-dom-parentnode-replacechildren① |