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

CKTIS / JavaScript

HTMLMediaElement.play() — iniciar la reproducción de forma asíncrona

El método play() solicita que se inicie o reanude la reproducción de audio o vídeo. Devuelve una Promise, así que la interfaz debe contemplar tanto el inicio de la reproducción como el rechazo de la solicitud.

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.play() // Promise<undefined>; media is an HTMLAudioElement or HTMLVideoElement

HTMLMediaElement.play() es un método de la API Web del navegador para elementos audio y video, no una función de ECMAScript. No recibe argumentos. Devuelve una Promise que se cumple con el valor undefined cuando empieza la reproducción, no cuando termina el contenido multimedia.

Usa await media.play() dentro de try...catch. Ni que la llamada haya retornado ni paused === false confirman que la reproducción haya empezado. La promesa puede seguir pendiente mientras se cargan los datos; actualiza la interfaz cuando se resuelva o se rechace.

NotAllowedError significa que la reproducción no está permitida, por ejemplo, debido a la política de reproducción automática. Llama al método directamente desde un controlador de clic, pero gestiona igualmente el rechazo. NotSupportedError se refiere a una fuente no compatible. Interrumpir una solicitud pendiente mediante pause() o una recarga puede causar AbortError.

El ejemplo proporciona deliberadamente texto en lugar de una grabación para mostrar cómo gestionar un rechazo sin un archivo externo. No demuestra una reproducción satisfactoria. Esta API pertenece al HTML Living Standard; Node 24 en un repositorio no demuestra que esté disponible en el navegador.

Ejemplos

const media = document.createElement('audio');
media.src = 'data:text/plain,not-media';
const button = document.createElement('button');
button.textContent = 'Test play()';
const status = document.createElement('pre');
document.body.append(button, status);

button.addEventListener('click', async () => {
  button.disabled = true;
  try {
    await media.play();
    status.textContent = 'Playback started';
  } catch (error) {
    status.textContent = `Rejected: ${error.name}`;
  } finally {
    button.disabled = false;
  }
});

Resultado

Rejected: NotSupportedError

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.

Fuentes