--- title: Node.removeChild slug: Web/API/Node/removeChild tags: - API - DOM - DOM Element Methods - Method translation_of: Web/API/Node/removeChild ---
{{ApiRef}}

Аннотация

Удаляет дочерний элемент из DOM. Возвращает удаленный элемент.

Синтаксис

var oldChild = element.removeChild(child);
element.removeChild(child);

Удаленный дочерний элемент остается в памяти, но больше не является частью DOM. Вы можете повторно использовать удаленный элемент с помощью ссылки на объект - oldChild.

Если child не является дочерним элементом element, тогда метод генерирует исключение. Также это происходит если child является дочерним элементом element во время вызова метода, но был удален во время вызова обработчика событий удаляющего элемент(т.e при удалении элемента непосредственно перед вызовом обработчика событий).

Пример

<!-- Пример -->

<div id="top" align="center">
  <div id="nested"></div>
</div>
// Удаление элемента с известным родителем
var d = document.getElementById("top");
var d_nested = document.getElementById("nested");
var throwawayNode = d.removeChild(d_nested);
// Удаление элемента без указания его родителя
var node = document.getElementById("nested");
if (node.parentNode) {
  node.parentNode.removeChild(node);
}
// Удаление всех дочерних элементов
var element = document.getElementById("top");
while (element.firstChild) {
  element.removeChild(element.firstChild);
}

Спецификация

См. также