Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / HTML

onstalled — gestire i download multimediali bloccati

L’attributo onstalled specifica il codice da eseguire per l’evento stalled, quando il browser tenta di recuperare dati multimediali ma i dati non arrivano. Riguarda il download, non necessariamente un’interruzione della riproduzione.

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

Sintassi

HTML: onstalled="JavaScript statements"
JavaScript: media.onstalled = handler;
Alternative: media.addEventListener("stalled", handler);

onstalled è un attributo contenuto gestore di eventi per stalled. È disponibile come attributo HTML globale, ma il browser invia normalmente questo evento agli elementi multimediali audio e video. Il suo valore contiene istruzioni JavaScript, non un indirizzo di risorsa né un valore booleano.

L’evento si verifica quando un elemento sta cercando attivamente di ottenere dati multimediali, ma non ne riceve per il tempo di attesa previsto dal meccanismo di rilevamento del blocco. Questo non significa automaticamente che ci sia un errore o che la riproduzione sia interrotta: i dati nel buffer possono consentire alla riproduzione di continuare. waiting riguarda la riproduzione in attesa di dati, mentre suspend indica che il browser ha sospeso il recupero.

In HTML, usa onstalled="..."; in JavaScript, assegna una funzione a media.onstalled. L’assegnazione sostituisce il gestore precedente in quello slot. L’alternativa media.addEventListener("stalled", handler) registra listener indipendenti. Non inserire testo non attendibile nel codice dell’attributo; la Content Security Policy può bloccare i gestori inline.

L’esempio invia un evento sintetico per verificare in modo deterministico il collegamento dell’attributo. Non scarica file e non simula lo stato effettivo della rete o del buffer. Il testo previsto nel paragrafo è stalled.

Esempi

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>onstalled demonstration</title>
<audio id="media" onstalled="document.getElementById('status').textContent = event.type"></audio>
<p id="status">pending</p>
<script>
  const media = document.getElementById('media');
  media.dispatchEvent(new Event('stalled'));
</script>
</html>

Risultato

stalled

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