DOMRectList: item() method
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.
The DOMRectList
method
item()
returns the DOMRect
at the specified index within the list, or null
if the index is out of range.
Syntax
js
rectList.item(index)
Parameters
- index
-
A zero-based integer representing the position of the
DOMRect
in theDOMRectList
to retrieve.
Return value
A DOMRect
object at the specified index in the DOMRectList
, or null if index is greater than or equal to the number of rectangles in the list.
Example
js
const rects = document.getElementById("rects").getClientRects();
console.log(rects.length); // Number of rectangles in the DOMRectList
if (rects.length > 0) {
console.log(rects.item(0)); // Logs the first DOMRect object
}
Specifications
Specification |
---|
Geometry Interfaces Module Level 1 # dom-domrectlist-item |