Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

HTMLMediaElement.play() — avviare la riproduzione in modo asincrono

Il metodo play() richiede di avviare o riprendere la riproduzione audio o video. Restituisce una Promise, quindi l’interfaccia deve considerare sia l’avvio della riproduzione sia il rifiuto della richiesta.

Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintassi

media.play() // Promise<undefined>; media is an HTMLAudioElement or HTMLVideoElement

HTMLMediaElement.play() è un metodo della Web API del browser per gli elementi audio e video, non una funzione ECMAScript. Non accetta argomenti. Restituisce una Promise che viene soddisfatta con il valore undefined quando la riproduzione inizia, non quando il contenuto multimediale termina.

Usa await media.play() all’interno di try...catch. Né il ritorno della chiamata né paused === false confermano che la riproduzione sia iniziata. La promise può restare in sospeso durante il caricamento dei dati; aggiorna l’interfaccia dopo che è stata risolta o rifiutata.

NotAllowedError significa che la riproduzione non è consentita, per esempio a causa della politica di riproduzione automatica. Chiama il metodo direttamente in un gestore di clic, ma gestisci comunque il rifiuto. NotSupportedError riguarda una sorgente non supportata. L’interruzione di una richiesta in sospeso tramite pause() o il ricaricamento può causare AbortError.

L’esempio fornisce intenzionalmente testo invece di una registrazione per mostrare la gestione di un rifiuto senza un file esterno. Non dimostra una riproduzione riuscita. Questa API appartiene all’HTML Living Standard; Node 24 in un repository non dimostra la disponibilità nel browser.

Esempi

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;
  }
});

Risultato

Rejected: NotSupportedError

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti