CKTIS / JavaScript
HTMLMediaElement.pause() — pausar la reproducción
El método pause() pausa un elemento de audio o vídeo sin volver al principio. No acepta argumentos y devuelve undefined. El estado paused cambia de forma síncrona, mientras que el evento pause se envía más tarde.
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
media.pause()HTMLMediaElement.pause es un método de la API web del navegador que heredan los elementos audio y video. Llama a media.pause() en un elemento multimedia. El método no acepta argumentos y devuelve undefined, no una promesa. No forma parte de ECMAScript; que un proyecto incluya Node.js no confirma que el método esté disponible allí.
Si paused es false, el método lo establece en true de forma síncrona. No vuelve al principio de la reproducción. Para reanudarla, usa play(). Volver a llamar a pause() en un elemento que ya está pausado no genera otro evento pause.
Cuando cambia el estado, el navegador pone en cola una tarea que envía primero timeupdate y después pause; estos eventos no se envían antes de que el método devuelva el control. Tras enviar ambos eventos, la tarea rechaza con AbortError únicamente las promesas devueltas por play() que seguían en la lista de promesas de reproducción pendientes del elemento cuando el algoritmo de pause() tomó esa lista. Una promesa ya retirada de la lista para una tarea en cola que envía playing aún puede resolverse. Gestiona los rechazos de las promesas devueltas por play(). Si networkState es NETWORK_EMPTY, pause() también ejecuta el algoritmo de selección de recursos; no trates este método como un mecanismo para cancelar descargas.
El ejemplo usa deliberadamente un elemento nuevo sin fuente, cuyo estado inicial es paused === true. Muestra el valor devuelto y que se puede repetir la llamada de forma segura, pero no demuestra cómo interrumpir una reproducción activa.
Ejemplos
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
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.