Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes