Element: hasPointerCapture() method

{{APIRef("DOM")}}

The hasPointerCapture() method of the {{domxref("Element")}} interface checks whether the element on which it is invoked has pointer capture for the pointer identified by the given pointer ID.

Syntax

hasPointerCapture(pointerId)

Parameters

• pointerId
  • : The {{domxref("PointerEvent.pointerId", "pointerId")}} of a {{domxref("PointerEvent")}} object.

Return value

A boolean value — true if the element does have pointer capture for the pointer identified by the given pointer ID, false if it doesn't.

Examples

<div id="target">Touch this element with a pointer.</div>

const el = document.getElementById("target");
el.addEventListener("pointerdown", (ev) => {
  // Element 'target' will receive/capture further events
  el.setPointerCapture(ev.pointerId);

  // …

  // Check whether element still has pointer capture
  const pointerCap = el.hasPointerCapture(ev.pointerId);
  if (pointerCap) {
    // We've still got pointer capture
  } else {
    // oops, we've lost pointer capture!
  }
});

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• {{ domxref("Element.setPointerCapture()")}}
• {{ domxref("Element.releasePointerCapture()")}}
• {{ domxref("Pointer_events","Pointer Events", "", 1) }}