Knowledge baseExam Center
ENEnglish
Choose language13

CKTIS / JavaScript

Element.releasePointerCapture() — releasing pointer capture

releasePointerCapture(pointerId) releases an element's capture of a particular pointer, restoring normal position-based event targeting.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

element.releasePointerCapture(pointerId)

Element.releasePointerCapture releases capture for the pointer identified by pointerId, normally obtained from an event. It returns undefined. Capture directs events to an element even outside its bounds; releasing restores normal position-based targeting. It does not end physical contact or a button press.

An inactive identifier throws a DOMException named NotFoundError. For an active pointer, the method does nothing if this element has no capture. hasPointerCapture(pointerId) checks pending capture state; release clears that state immediately, but lostpointercapture need not fire synchronously.

The browser also releases capture after pointerup or pointercancel. The example releases it earlier, on the first movement after pressing. This is a browser Pointer Events API, not an ECMAScript feature; Node 24 does not establish its availability. Check support in target browsers.

Examples

const pad = document.createElement('button');
pad.textContent = 'Press and move';
pad.style.touchAction = 'none';
document.body.append(pad);

pad.addEventListener('pointerdown', (event) => {
  pad.setPointerCapture(event.pointerId);
});

pad.addEventListener('pointermove', (event) => {
  if (pad.hasPointerCapture(event.pointerId)) {
    const result = pad.releasePointerCapture(event.pointerId);
    console.log(result, pad.hasPointerCapture(event.pointerId));
  }
});

Result

undefined false

The displayed code and declared result were verified in an isolated environment using the method recorded in the verification evidence for this exact version.

Sources