W3cubDocs

/Web APIs

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

item(index)

Parameters

index

A zero-based integer representing the position of the DOMRect in the DOMRectList 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

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

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet WebView Android WebView on iOS
item 2 12 3 ≤12.1 4 18 4 ≤12.1 3 1.0 4.4 3

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/DOMRectList/item