NodeList: length property
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
The NodeList.length
property returns the number of items
in a NodeList
.
Value
An integer value representing the number of items in a NodeList
.
Examples
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.
js
// All the paragraphs in the document
const items = document.getElementsByTagName("p");
// For each item in the list,
// append the entire element as a string of HTML
let gross = "";
for (let i = 0; i < items.length; i++) {
gross += items[i].innerHTML;
}
// gross is now all the HTML for the paragraphs
Specifications
Specification |
---|
DOM Standard # ref-for-dom-nodelist-length① |
Browser compatibility
BCD tables only load in the browser