Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onsuspend — gestire la sospensione del recupero dei media

L’attributo onsuspend specifica il codice JavaScript da eseguire quando si verifica l’evento suspend. Per audio e video, questo evento indica che il browser ha intenzionalmente smesso di recuperare dati per il momento, non che la riproduzione è stata messa in pausa.

Versione: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintassi

onsuspend="JavaScript statements"

onsuspend è un attributo globale di contenuto per la gestione dell’evento suspend. Il suo valore è codice JavaScript, non un indirizzo di risorsa né un valore booleano. Sebbene l’attributo sia disponibile sugli elementi HTML, il suo uso tipico riguarda gli elementi audio e video.

Il browser genera suspend quando sospende intenzionalmente il recupero dei dati multimediali e imposta networkState su NETWORK_IDLE. Per esempio, può aspettare che inizi la riproduzione prima di scaricare altri dati. Questo, di per sé, non indica un errore né una riproduzione in pausa: pause riguarda la riproduzione, mentre stalled si riferisce al caso in cui il browser cerca di recuperare dati ma non li riceve.

Nel codice dell’attributo, event fornisce l’oggetto evento. In JavaScript puoi invece assegnare una funzione alla proprietà element.onsuspend oppure usare element.addEventListener('suspend', handler). Il nome dell’evento non include il prefisso on.

L’esempio genera un evento sintetico per rendere il risultato indipendente dalla rete e dalle decisioni del browser sul buffering. Verifica solo l’esecuzione del codice dell’attributo; non sospende il recupero dei dati e non modifica networkState. La policy di sicurezza di una pagina può bloccare il codice dei gestori di eventi scritto direttamente negli attributi.

Esempi

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onsuspend demo</title>
<audio id="media" onsuspend="document.getElementById('result').textContent = event.type"></audio>
<output id="result">pending</output>
<script>
  document.getElementById('media').dispatchEvent(new Event('suspend'));
</script>
</html>

Risultato

suspend

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