CKTIS / HTML
onsuspend — obsługa wstrzymania pobierania multimediów
Atrybut onsuspend określa kod JavaScript wykonywany po zdarzeniu suspend. Dla audio i video zdarzenie to oznacza, że przeglądarka celowo nie pobiera obecnie danych, a nie że odtwarzanie zostało wstrzymane.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
onsuspend="JavaScript statements"onsuspend jest globalnym atrybutem obsługi zdarzenia suspend. Jego wartością jest kod JavaScript, a nie adres zasobu ani wartość logiczna. Choć atrybut jest dostępny na elementach HTML, jego typowe zastosowanie dotyczy elementów audio i video.
Przeglądarka emituje suspend, gdy celowo wstrzymuje pobieranie danych multimedialnych; ustawia wtedy networkState na NETWORK_IDLE. Może na przykład czekać na rozpoczęcie odtwarzania przed pobraniem dalszych danych. Nie oznacza to samo w sobie błędu ani wstrzymania odtwarzania: pause dotyczy odtwarzania, a stalled — sytuacji, gdy przeglądarka próbuje pobierać dane, ale ich nie otrzymuje.
W kodzie atrybutu event udostępnia obiekt zdarzenia. W JavaScript można zamiast atrybutu przypisać funkcję do właściwości element.onsuspend lub użyć element.addEventListener('suspend', handler). Nazwa zdarzenia nie zawiera przedrostka on.
Przykład wywołuje zdarzenie syntetyczne, aby wynik był niezależny od sieci i decyzji przeglądarki o buforowaniu. Sprawdza wyłącznie uruchomienie kodu atrybutu; nie wstrzymuje pobierania i nie zmienia networkState. Polityka bezpieczeństwa strony może blokować kod obsługi zapisany bezpośrednio w atrybutach.
Przykłady
<!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>Wynik
suspend
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.