Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes