CKTIS / JavaScript
Element.releasePointerCapture() — libertar a captura do ponteiro
releasePointerCapture(pointerId) liberta a captura de um ponteiro específico por um elemento e repõe a determinação normal do destino dos eventos com base na posição.
Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintaxe
element.releasePointerCapture(pointerId)Element.releasePointerCapture liberta a captura do ponteiro identificado por pointerId, normalmente obtido a partir de um evento. Devolve undefined. A captura encaminha os eventos para o elemento mesmo quando o ponteiro está fora dos seus limites; ao libertá-la, é reposta a determinação normal do destino com base na posição. Não termina o contacto físico nem uma pressão num botão.
Um identificador inativo provoca uma DOMException com o nome NotFoundError. Para um ponteiro ativo, o método não faz nada se este elemento não o tiver capturado. hasPointerCapture(pointerId) verifica o estado de captura pendente; a libertação limpa esse estado imediatamente, mas lostpointercapture não tem necessariamente de ser emitido de forma síncrona.
O browser também liberta a captura após pointerup ou pointercancel. O exemplo liberta-a mais cedo, no primeiro movimento após premir. Esta é uma API Pointer Events do browser, não uma funcionalidade ECMAScript; o Node 24 não comprova a sua disponibilidade. Verifique o suporte nos browsers de destino.
Exemplos
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
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.