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 normal 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

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung Internet
Basic supportChrome Full support 1Edge Full support 12Firefox ? IE ? Opera ? Safari ? WebView Android Full support YesChrome Android Full support YesEdge Mobile ? Firefox Android ? Opera Android ? Safari iOS ? Samsung Internet Android Full support Yes

Legend

Full support  
Full support
Compatibility unknown  
Compatibility unknown

Document Tags and Contributors

Last updated by: mfuji09,