DOM

Document.replaceChildren() メソッド

 編集:2022.09.06 by T.A.

Document の既存の子を、指定された新しい子のセットに置き換えます。

Document.replaceChildren(param1[, param2[, [, paramN]]])
Document Document
paramn Document の既存の子を置き換える Node または string オブジェクトのセット。置換オブジェクトが指定されていない場合、次に、Document からすべての子ノードが空になります。

なし(undefined)。

例外
HierarchyRequestError(DOMException
ノード ツリーの制約に違反した場合にスローされます。
ドキュメントを空にする

replaceChildren() は、ドキュメントのすべての子を空にするための非常に便利なメカニズムを提供します。引数を指定せずにドキュメントで呼び出します。

document.replaceChildren();
document.children; // HTMLCollection []
document.replaceChildren();
alert(document.children.length);	//「0」が表示され、ダイアログを閉じると画面がまっさらに変わる。
document.replaceChildren("文字列");	//エラー発生:Failed to execute 'replaceChildren' on 'Document': Nodes of type '#text' may not be inserted inside nodes of type '#document'.
	//「Document」で「replaceChildren」を実行できませんでした: タイプ「#text」のノードは、タイプ「#document」のノード内に挿入できない場合があります。
Html=document.createElement("HTML");
document.replaceChildren(Html);	//エラー発生:Failed to execute 'replaceChildren' on 'Document': Only one element on document allowed.
	//'ドキュメント' で 'replaceChildren' を実行できませんでした: ドキュメントで許可される要素は 1 つだけです。

¶結局なにもできない document.replaceChildren() 。


テスト