CKTIS / HTML
onwaiting — obsługa oczekiwania na dane multimedialne
Atrybut onwaiting określa kod wykonywany po zdarzeniu waiting. W elementach audio i video zdarzenie to sygnalizuje, że odtwarzanie nie może być kontynuowane z powodu braku wystarczających danych. Sam atrybut nie uruchamia pobierania ani odtwarzania.
Wersja: WHATWG HTML Living Standard; index snapshot date recorded separately
Składnia
onwaiting="JavaScript statements"
media.onwaiting = (event) => { /* handle waiting */ };onwaiting jest atrybutem obsługi zdarzenia waiting. Jego wartość w HTML to kod JavaScript, a nie wartość logiczna. Jest dostępny dla wszystkich elementów HTML, ale jego typowe zastosowanie dotyczy elementów audio i video. Odpowiada mu właściwość JavaScript onwaiting.
Zdarzenie waiting wskazuje, że odtwarzanie nie może być kontynuowane, ponieważ brakuje danych potrzebnych do następnego kroku. Może wystąpić przy rozpoczynaniu odtwarzania lub po wyczerpaniu bufora. Nie oznacza samo w sobie trwałego błędu ani przerwania połączenia sieciowego. Nie należy go utożsamiać ze zdarzeniem stalled, które dotyczy braku napływu danych podczas próby ich pobierania.
W procedurze obsługi można pokazać wskaźnik oczekiwania; zdarzenie playing pozwala zareagować na rozpoczęcie lub wznowienie odtwarzania. Naturalne zdarzenie waiting nie bąbelkuje i nie można go anulować, więc return false nie wznowi odtwarzania. Przypisanie funkcji do media.onwaiting zastępuje dotychczasową funkcję tej właściwości; addEventListener('waiting', handler) umożliwia rejestrowanie niezależnych odbiorców.
Przykład celowo wysyła syntetyczne zdarzenie, aby wynik nie zależał od pliku multimedialnego ani sieci. Akapit powinien zmienić tekst z idle na waiting. Test potwierdza wyłącznie sposób podłączenia obsługi: nie wywołuje rzeczywistego buforowania ani nie zmienia stanu odtwarzania. Polityka bezpieczeństwa strony może blokować skrypty i procedury obsługi zapisane bezpośrednio w HTML.
Przykłady
<!doctype html>
<meta charset="utf-8">
<title>onwaiting demo</title>
<video id="media" onwaiting="document.getElementById('status').textContent = event.type"></video>
<p id="status">idle</p>
<script>
const media = document.getElementById('media');
media.dispatchEvent(new Event('waiting'));
</script>Wynik
waiting
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.