Latest web development tutorials
 

HTML DOM item() Method

< Element Object

Example

Get the HTML content of the first <p> element (index 0) inside the document:

var nodelist = document.getElementsByTagName("P").item(0).innerHTML;

The result of nodelist will be:

The first p element in the document.
Try it Yourself »

More "Try it Yourself" examples below.


Definition and Usage

The item() method returns a node at the specified index in a NodeList object.

The nodes are sorted as they appear in the source code, and the index starts at 0.

A Node object's collection of child nodes is an example of a NodeList object.

Note: There are two ways to access a node at the specified index in a node list:

This syntax:

document.body.childNodes.item(0);    // The first child node of <body>Try it

Will produce the same result as this syntax:

document.body.childNodes[0];         // The first child node of <body>Try it

You can use whatever method you like, however, the most common method is [index].

Tip: Use the length property to return the number of nodes in a NodeList object.


Browser Support

Method
item() Yes Yes Yes Yes Yes

Syntax

nodelist.item(index)

or simply:

nodelist[index]

Parameter Values

Parameter Type Description
index Number Required. The index of the node you want to return, in the node list.

Note: The index starts at 0

Technical Details

Return Value: A Node object, representing the node at the specified index.

Note: Returns null if the index number is out of range
DOM Version Core Level 1 Nodelist Object

Examples

More Examples

Example

Get the HTML content of the first <p> element (index 0) inside a <div> element:

var div = document.getElementById("myDIV");
var nodelist = div.getElementsByTagName("P")[0].innerHTML;

The result of nodelist will be:

First p element in div.
Try it Yourself »

Example

Change the HTML content of the first <p> element (index 0) inside a <div> element:

var div = document.getElementById("myDIV");
div.getElementsByTagName("P")[0].innerHTML = "Paragraph changed";
Try it Yourself »

Example

Loop through all elements with class="child" in a <div> element, and change their background color:

var div = document.getElementById("myDIV");
var nodelist = div.getElementsByClassName("child");

var i;
for (i = 0; i < nodelist.length; i++) {
    nodelist[i].style.backgroundColor = "red";
}
Try it Yourself »

Related Pages

HTML DOM Reference: nodelist.length Property

HTML DOM Reference: element.childNodes Property

HTML DOM Reference: href="met_element_getelementsbyclassname.html">element.getElementsByClassName() Method

HTML DOM Reference: href="met_element_getelementsbytagname.html">element.getElementsByTagName() Method

HTML DOM Reference: href="met_element_queryselectorall.html">element.querySelectorAll() Method

HTML DOM Reference: href="met_document_getelementsbyclassname.html">document.getElementsByClassName() Method

HTML DOM Reference: href="met_doc_getelementsbyname.html">document.getElementsByName() Method

HTML DOM Reference: href="met_document_getelementsbytagname.html">document.getElementsByTagName() Method

HTML DOM Reference: href="met_document_queryselectorall.html">document.querySelectorAll() Method


< Element Object