ZVON > References > DOM2 Reference

removeChild (method )

Owning interface and usage:  
Node.removeChild(oldChild)

Member of these other interfaces:  
Attr, CDATASection, CharacterData, Comment, Document, DocumentFragment, DocumentType, Element, Entity, EntityReference, Notation, ProcessingInstruction, Text

Description:  
Removes the child node indicated by oldChild from the list of children, and returns it.

Parameters:  
Node oldChild  -  The node being removed.

Returns:  
Node -  The node removed.

Exceptions:  
DOMException NO_MODIFICATION_ALLOWED_ERR
Raised if this node is readonly.
DOMException NOT_FOUND_ERR
Raised if oldChild is not a child of this node.


Example:
Text in the first DIV.
Some text in the second DIV.
Some text and element in the third DIV.
We can try another elements. It will be much more interesting.
Text in the last DIV.
Source:
   <div id="doc">
     <div>
       Text in the first DIV.
     </div>
     <div id="DDD" class="secondClass">
       Some text in the second DIV.
     </div>
     <div class="thirdClass">
       Some text and <span id="SSS">element</span> in the third DIV.
     </div>
     <div class="fourthClass">
       We can try <i>another elements</i>.
       It will be much more <b>interesting</b>.
     </div>
     <div>
       Text in the last DIV.
     </div>
   </div>
     
JavaScript:
  var elem = document.getElementById('SSS');
  var output1 = elem.firstChild.nodeValue;
  elem.removeChild(elem.firstChild);
  var output2 = elem.firstChild;
Output:
desired your browser
output1: element
output2: null