MDN may have intermittent access issues April 18 13:00 - April 19 01:00 UTC. See whistlepig.mozilla.org for all notifications.

mozilla
Your Search Results

    NodeList.length

    Summary

    length returns the number of items in a NodeList.

    Syntax

    numItems =
    nodeList.length
    
    • numItems is an integer value representing the number of items in a NodeList.

    Example

    // all the paragraphs in the document 
    var items = document.getElementsByTagName("p"); 
    // for each item in the list,
    // append the entire element as a string of HTML
    var gross = "";
    for (var i = 0; i < items.length; i++) {
      gross += items[i].innerHTML;
    }
    // gross is now all the HTML for the paragraphs
    

    Notes

    Despite the location of this page in the reference, length is not a property of Element, but rather of a NodeList. NodeList objects are returned from a number of DOM methods, such as document.getElementsByTagName.

    length is a very common property in DOM programming. It's very common to test the length of a list (to see if it exists at all) and to use it as the iterator in a for loop, as in the example above.

    Specification

    length

    Document Tags and Contributors

    Last updated by: fscholz,