CKTIS / JavaScript
HTMLMediaElement.pause() — mettere in pausa la riproduzione
Il metodo pause() mette in pausa un elemento audio o video senza riportarlo all’inizio. Non accetta argomenti e restituisce undefined. Lo stato paused cambia in modo sincrono, mentre l’evento pause viene inviato in seguito.
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.pause()HTMLMediaElement.pause è un metodo della Web API del browser, ereditato dagli elementi audio e video. Chiama media.pause() su un elemento multimediale. Il metodo non accetta argomenti e restituisce undefined, non una promise. Non fa parte di ECMAScript; la presenza di Node.js in un progetto non ne dimostra la disponibilità.
Se paused è false, il metodo lo imposta sincronicamente su true. Non riporta la riproduzione all’inizio. Per riprenderla, usa play(). Chiamare di nuovo pause() su un elemento già in pausa non genera un altro evento pause.
Quando lo stato cambia, il browser accoda un’attività che invia prima timeupdate e poi pause; questi eventi non vengono inviati prima che il metodo restituisca il controllo. Dopo aver inviato entrambi gli eventi, l’attività rifiuta con AbortError solo le promise restituite da play() che erano ancora nell’elenco delle promise di riproduzione in attesa dell’elemento quando l’algoritmo di pause() ha prelevato l’elenco. Una promise già prelevata dall’elenco per un’attività in coda che invia playing può ancora essere risolta. Gestisci il rifiuto delle promise restituite da play(). Se networkState è NETWORK_EMPTY, pause() avvia anche l’algoritmo di selezione delle risorse: non considerare questo metodo un meccanismo per annullare un download.
L’esempio usa intenzionalmente un nuovo elemento senza sorgente, che inizialmente ha paused === true. Mostra il valore restituito e la possibilità di ripetere la chiamata in sicurezza, ma non dimostra l’interruzione di una riproduzione attiva.
Esempi
const media = document.createElement('video');
const result = media.pause();
console.log(media.paused);
console.log(result === undefined);
media.pause();
console.log(media.paused);Risultato
true true true
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.