語法與回傳值
parentNode.removeChild(childNode)
- childNode:要移除的子節點(必須是
parentNode 的直接子節點)。
- 回傳值:被移除的節點引用,可用於後續操作或記憶體釋放。
- 異常:若節點非子節點,拋出
NotFoundError (DOMException)。
基本範例:移除首尾子元素
<div id="guoDiv">
<span>1</span>
<span>2</span>
<span>3</span>
</div>
<script>
var oDiv = document.getElementById("guoDiv");
// 移除第一個子元素
var firstChild = oDiv.firstElementChild || oDiv.firstChild;
var removed = oDiv.removeChild(firstChild);
console.log("已移除:", removed.innerHTML); // "1"
console.log("剩餘子元素數:", oDiv.children.length); // 2
// 移除最後一個子元素
var lastChild = oDiv.lastElementChild || oDiv.lastChild;
removed = oDiv.removeChild(lastChild);
console.log("已移除:", removed.innerHTML); // "3"
console.log("剩餘子元素數:", oDiv.children.length); // 1
</script>
批量移除所有子節點
// 方法一:迴圈移除 (注意 live 集合)
while (oDiv.firstChild) {
oDiv.removeChild(oDiv.firstChild);
}
// 方法二:innerHTML = '' (最快,但不觸發 DOMNodeRemoved 事件)
oDiv.innerHTML = '';
// 方法三:DocumentFragment 暫存 (需保留節點參考)
var fragment = document.createDocumentFragment();
while (oDiv.firstChild) {
fragment.appendChild(oDiv.firstChild); // 移動而非複製
}
// 稍後可 fragment.appendChild 還原
常見應用場景
| 場景 | 說明 |
| 清空列表重新渲染 | list.innerHTML = '' 或迴圈 removeChild |
| 移除特定條件節點 | 遍歷 children 陣列,符合條件 removeChild |
| 元件銷毀清理 | 移除事件監聽器後 removeChild 釋放記憶體 |
| 拖放排序 | 從原列表 removeChild,插入新列表 insertBefore |
注意事項與最佳實踐
- 事件監聽器:移除前建議先
removeEventListener,避免記憶體洩漏(現代瀏覽器 GC 處理較好,但舊 IE 需手動)。
- 子節點集合即時性:
childNodes、children 為即時集合,正向迴圈移除會導致索引錯位,務必反向迴圈或用 while(firstChild)。
- 文字節點:
firstChild/lastChild 可能為文字節點(換行空白),操作元素請用 firstElementChild/lastElementChild。
- 記憶體釋放:移除後若無其他引用,節點及其子樹將被 GC 回收。大型應用可配合
WeakMap 追蹤。
相關方法速查
| 方法 | 用途 | 回傳值 |
appendChild(node) | 末尾新增子節點 | 新增節點 |
insertBefore(new, ref) | 參考節點前插入 | 新增節點 |
replaceChild(new, old) | 替換子節點 | 被替換節點 |
removeChild(node) | 移除子節點 | 被移除節點 |
cloneNode(deep) | 複製節點 | 新節點 |