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.