CKTIS / JavaScript
Element.releasePointerCapture() — liberar la captura del puntero
releasePointerCapture(pointerId) libera la captura de un puntero concreto por parte de un elemento y restablece la selección normal del destino de los eventos según la posición.
Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxis
element.releasePointerCapture(pointerId)Element.releasePointerCapture libera la captura del puntero identificado por pointerId, que normalmente se obtiene de un evento. Devuelve undefined. La captura dirige los eventos al elemento incluso cuando el puntero está fuera de sus límites; al liberarla, se restablece la selección normal del destino según la posición. No finaliza el contacto físico ni la pulsación de un botón.
Un identificador inactivo provoca una DOMException con el nombre NotFoundError. Para un puntero activo, el método no hace nada si este elemento no lo tiene capturado. hasPointerCapture(pointerId) comprueba el estado de captura pendiente; la liberación borra ese estado inmediatamente, pero lostpointercapture no tiene por qué emitirse de forma síncrona.
El navegador también libera la captura después de pointerup o pointercancel. El ejemplo la libera antes, en el primer movimiento después de pulsar. Esta es una API de Pointer Events del navegador, no una característica de ECMAScript; Node 24 no demuestra que esté disponible. Comprueba la compatibilidad en los navegadores de destino.
Ejemplos
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));
}
});Resultado
undefined false
El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.