Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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.

Fonti