大网数据广告活动
Web 标准与前端开发

Node:removeChild() 方法

· 52CE 我爱测

Node 接口的 **`removeChild()`** 方法会从 DOM 中移除一个子节点,并返回移除的节点。

DOM

Node 接口的 removeChild() 方法会从 DOM 中移除一个子节点,并返回移除的节点。

[!NOTE] 只要对被移除的子节点保持引用,它仍然存在于内存中,但不再是 DOM 的一部分。在以后的代码中仍可重复使用。

如果不存储 removeChild() 的返回值,也不保留其他引用,该节点将在短时间内在内存中自动删除。

与 Node.cloneNode() 不同,返回值保留了与其关联的 EventListener 对象。

语法

removeChild(child)

参数

  • child
    • : Node,即要从 DOM 中删除的子节点。

异常

  • NotFoundError DOMException
    • : 如果 child 不是该节点的子节点,则抛出此异常。
  • TypeError
    • : 如果 child 为 null,则抛出此异常。

示例

简单的示例

给定以下 HTML:

<div id="parent">
  <div id="child"></div>
</div>

在已知其父节点时移除指定元素:

const parent = document.getElementById("parent");
const child = document.getElementById("child");
const throwawayNode = parent.removeChild(child);

在不需要指定其父节点的情况下移除指定元素:

const node = document.getElementById("child");
if (node.parentNode) {
  node.parentNode.removeChild(node);
}

从元素中移除所有子元素:

const element = document.getElementById("idOfParent");
while (element.firstChild) {
  element.removeChild(element.firstChild);
}

引发 TypeError


<div id="parent"></div>
const parent = document.getElementById("parent");
const child = document.getElementById("child");

// 抛出未捕获的 TypeError
const garbage = parent.removeChild(child);

引发 NotFoundError


<div id="parent">
  <div id="child"></div>
</div>
const parent = document.getElementById("parent");
const child = document.getElementById("child");

// 第一次调用正确并移除了该节点。
const garbage = parent.removeChild(child);

// 抛出 NotFoundError
garbage = parent.removeChild(child);

规范

浏览器兼容性

参见

  • Node.replaceChild()
  • Node.parentNode
  • Element.remove()
  • Node.cloneNode()

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。