Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / HTML

onstalled — obsługa zastoju pobierania multimediów

Atrybut onstalled określa kod uruchamiany po zdarzeniu stalled, gdy przeglądarka próbuje pobierać dane multimedialne, ale dane nie napływają. Dotyczy to pobierania, niekoniecznie zatrzymania odtwarzania.

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

Składnia

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

onstalled to atrybut obsługi zdarzenia stalled. Jest dostępny jako globalny atrybut HTML, ale przeglądarka naturalnie wysyła to zdarzenie do elementów multimedialnych audio i video. Wartość atrybutu zawiera instrukcje JavaScript, a nie adres zasobu ani wartość logiczną.

Zdarzenie występuje, gdy element aktywnie próbuje uzyskać dane multimedialne, lecz przez czas określony przez mechanizm wykrywania zastoju nie otrzymuje danych. Nie oznacza to automatycznie błędu ani przerwania odtwarzania: zbuforowane dane mogą wystarczyć do dalszego odtwarzania. waiting dotyczy oczekiwania odtwarzania na dane, a suspend oznacza wstrzymanie pobierania przez przeglądarkę.

W HTML użyj onstalled="..."; w JavaScript przypisz funkcję do media.onstalled. Przypisanie zastępuje poprzednią obsługę w tym samym slocie. Alternatywa media.addEventListener("stalled", handler) pozwala rejestrować niezależne procedury. Nie umieszczaj niezaufanego tekstu w kodzie atrybutu; polityka Content Security Policy może blokować taką obsługę inline.

Przykład wysyła syntetyczne zdarzenie, aby deterministycznie sprawdzić powiązanie atrybutu z kodem. Nie pobiera pliku i nie symuluje rzeczywistego stanu sieci ani bufora. Oczekiwany tekst akapitu to stalled.

Przykłady

<!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>

Wynik

stalled

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła