The NodeList.length
property returns the number of items
in a NodeList
.
Syntax
numItems = nodeList.length
numItems
is an integer value representing the number of items in aNodeList
.
Example
The length
property is often useful in DOM programming. It's often used to
test the length of a list, to see if it exists at all. It's also commonly used as the
iterator in a for
loop, as in this 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
Specifications
Specification | Status | Comment |
---|---|---|
DOM The definition of 'NodeList: length' in that specification. |
Living Standard |
Browser compatibility
BCD tables only load in the browser