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

CKTIS / JavaScript

HTMLMediaElement.pause() — colocar a reprodução em pausa

O método pause() coloca um elemento de áudio ou vídeo em pausa sem voltar ao início. Não recebe argumentos e devolve undefined. O estado paused muda de forma síncrona, enquanto o evento pause é enviado mais tarde.

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

media.pause()

HTMLMediaElement.pause é um método da Web API do browser, herdado pelos elementos audio e video. Chame media.pause() num elemento multimédia. O método não recebe argumentos e devolve undefined, não uma promessa. Não faz parte do próprio ECMAScript; a presença de Node.js num projeto não confirma que o método esteja disponível.

Se paused for false, o método define-o sincronamente como true. Não faz a reprodução voltar ao início. Para retomar a reprodução, use play(). Chamar novamente pause() num elemento que já está em pausa não gera outro evento pause.

Quando o estado muda, o browser coloca em fila uma tarefa que envia primeiro timeupdate e depois pause; estes eventos não são enviados antes de o método devolver o controlo. Depois de enviar ambos os eventos, a tarefa rejeita com AbortError apenas as promessas devolvidas por play() que ainda estavam na lista de promessas de reprodução pendentes do elemento quando o algoritmo de pause() recolheu essa lista. Uma promessa já retirada da lista para uma tarefa em fila que envia playing ainda pode ser resolvida. Trate as rejeições das promessas devolvidas por play(). Se networkState for NETWORK_EMPTY, pause() também executa o algoritmo de seleção de recursos — não use este método como mecanismo para cancelar uma transferência.

O exemplo usa deliberadamente um elemento novo sem origem, que começa com paused === true. Demonstra o valor devolvido e chamadas repetidas em segurança, mas não demonstra a interrupção de uma reprodução ativa.

Exemplos

const media = document.createElement('video');
const result = media.pause();
console.log(media.paused);
console.log(result === undefined);
media.pause();
console.log(media.paused);

Resultado

true
true
true

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