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

CKTIS / JavaScript

Estado y tiempo de reproducción: paused, muted, currentTime y duration

Consulta por separado la pausa y el silencio, ajusta la posición de reproducción en segundos y distingue una duración conocida de `NaN` e `Infinity`.

Versión: ECMAScript 2024 and the current web platform; runtime support varies

Sintaxis

media.paused              // boolean, read-only
media.muted               // boolean, read/write
media.muted = true        // mute the audio output
media.currentTime         // number in seconds, read/write
media.currentTime = 12.5  // request a position on the media timeline
media.duration            // number in seconds, read-only; may be NaN or Infinity

paused, muted, currentTime y duration son propiedades de instancia de HTMLMediaElement disponibles en los elementos audio y video. Pertenecen a la plataforma web, no a ECMAScript en sí, así que no des por hecho que existen en un entorno sin DOM.

paused es un booleano de solo lectura. Un elemento nuevo empieza con paused === true. Llama a pause() y play() en vez de asignar un valor a paused. La promesa que devuelve play() puede rechazarse, por ejemplo si el navegador bloquea la reproducción automática. paused === false no garantiza que la posición avance: el elemento puede estar esperando datos.

muted es un booleano de lectura y escritura que indica si el audio está silenciado. media.muted = true silencia la salida de audio; false desactiva el silencio. Silenciar no equivale a pausar ni a poner volume a cero. defaultMuted refleja el atributo HTML muted, que indica el estado de silencio predeterminado, no el actual.

currentTime devuelve la posición de reproducción en la línea temporal del medio, en segundos, incluidas las fracciones. Antes de que estén disponibles los metadatos, una asignación guarda la posición inicial solicitada; después, inicia un salto a otra posición. NaN y los valores infinitos provocan un TypeError. La posición efectiva puede diferir de la solicitada: consulta los intervalos de seekable, sobre todo en emisiones en directo, y usa seeked para detectar que el salto ha terminado.

duration es de solo lectura. Un valor finito indica la posición final en segundos en la línea temporal del medio, es decir, su duración si empieza en cero. NaN significa que la duración aún no está disponible; Infinity indica que el medio no tiene un final conocido. Lee el valor en loadedmetadata y actualízalo en durationchange. Si la línea temporal empieza en cero, calcula currentTime / duration solo cuando Number.isFinite(duration) && duration > 0.

Ejemplos

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Media playback state and time</title>
</head>
<body>
  <script>
    const media = document.createElement("video");
    console.log(`currentTime=${media.currentTime}`);

    media.muted = true;
    media.currentTime = 2.5;

    console.log(
      `paused=${media.paused}, muted=${media.muted}, ` +
      `currentTime=${media.currentTime}, duration=${media.duration}`
    );
  </script>
</body>
</html>

Resultado

currentTime=0
paused=true, muted=true, currentTime=2.5, duration=NaN

Guarda el ejemplo como archivo HTML, ábrelo en un navegador y consulta la consola. El elemento no tiene fuente: `2.5` es la posición inicial guardada, no el resultado de un salto ni de la reproducción. El elemento sigue en pausa y `duration` sigue siendo `NaN`.

Lecciones relacionadas

  • JavaScript · Lección 28 · Intermedio · Versión: 3

Fuentes