childElementCount property

Retrieves the number of immediate child nodes of the current element or a zero if the element does not contain any child nodes. IElementTraversal::childElementCount does not return all child nodes, only child nodes that are IHTMLDOMNode::nodeType =1, or element nodes.

Internet Explorer 9



HRESULT value = object.get_childElementCount(* p);

Property values

Type: long

The number of child elements.

Standards information


The IElementTraversal::childElementCount property only returns immediate children of the current node. It does not count descendent children of the immediate children.


This example shows how to use IElementTraversal::childElementCount to get the number of immediate children of a div tag. Be aware that because decendent children of the the div tag "divWithChildren" are ignored.

<!DOCTYPE html>
        <title>childElementCount example</title>
        function GetCount () {
            var testArea = document.getElementById ("testArea");
            var childCount = 0;
                childCount = testArea.childElementCount;
            alert ("The number of child elements is " + childCount);
    <div id="testArea" >
    <p>This is the test area, which contains several children.</p>
        <div id="divWithChildren">
            <div>a descendant child of a div</div>
            <div>also a descendent child of a div</div>
        <p>A paragraph tag to consider.</p>
        <input type="text" size="80" value="And a text box as well"/> 
    <p><input type="button" value="Get the number child elements in our test" name="abutton"  onclick="GetCount ();" /> </p>