Document: replaceChildren() 方法

Document.replaceChildren() 方法用一组指定的新子节点替换 Document 的现有子节点。

语法

js
replaceChildren(param1)
replaceChildren(param1, param2)
replaceChildren(param1, param2, /* …, */ paramN)

参数

param1，…, paramN

一组要替换 Document 现有子节点的 Node 对象或字符串。如果没有指定替换对象，则 Document 将清空所有子节点。

返回值

无 (undefined).

异常

HierarchyRequestError DOMException

如果违反了 节点树的约束，则抛出此异常。

示例

清空文档

replaceChildren() 提供了一种非常方便的机制来清空文档的所有子节点。您可以在不指定任何参数的情况下在文档上调用它

js
document.replaceChildren();
document.children; // HTMLCollection []

规范

规范
DOM 标准
# ref-for-dom-parentnode-replacechildren①

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅