TouchList: item() method

{{ APIRef("Touch Events") }}

The item() method returns the {{ domxref("Touch") }} object at the specified index in the {{ domxref("TouchList") }}.

Syntax

item(index)

Parameters

• index
  • : The index of the {{ domxref("Touch") }} object to retrieve. The index is a number in the range of 0 to one less than the length of the {{ domxref("TouchList") }}.

Return value

The requested {{ domxref("Touch") }} object from the {{ domxref("TouchList") }}. Returns null if the index is not less than the length of the list.

Examples

This code example illustrates the use of the {{domxref("TouchList")}} interface's item method and the {{domxref("TouchList.length","length")}} property.

const target = document.getElementById("target");

target.addEventListener("touchstart", (ev) => {
  // If this touchstart event started on element target,
  // set touch to the first item in the targetTouches list;
  // otherwise set touch to the first item in the touches list
  const touch =
    ev.targetTouches.length >= 1
      ? ev.targetTouches.item(0)
      : ev.touches.item(0);
});

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}