文档:replaceChildren() 方法

Baseline 已广泛支持

此功能已得到充分验证,并且可在多种设备和浏览器版本上使用。自 ⁨2020 年 10 月⁩ 起,所有浏览器均已支持此功能。

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①

浏览器兼容性

另见