stalled ( onstalled )イベント
stalled ( onstalled )イベントは、ダウンロードしたデータが利用できないときに発生するイベントです。
このイベントは、<audio> または <video> におけるメディアリソースファイルのダウンロードプロセスに使用できます。また、FileReader や XMLHttpRequest においても使用できるようです。
document.getElementById('example').addEventListener("stalled", (event)=>{
console.log( event );
});
詳しくは Example を参照してください
stalled ( onstalled )イベントが、ページの遷移、エレメントの読み込みで使用できるかは未だ確かめていません。
このイベントが FileReader や XMLHttpRequest で機能するか未だ試していませんので確かなことは分かりません。
壊れたファイルの読み込みや存在していないファイルの読み込みを行いましたが、stalled イベントは発生しませんでした。
ページ内 Index
構文(Syntax)
in HTML
<tagelement onstalled ="function(); ...;">
in JavaScript
object.onstalled = function(){... };
addEventListener()
スクリプトを直接記述する方法。スクリプトから関数を呼び出せる。
object.addEventListener("stalled ", ()=>{ ... },false);
// または
object.addEventListener("stalled ",function(){ ... },false);
イベントについてはEventを参照してください。 イベントの監視についてはEventTargetが担っています。
備考(Remarks)
| Bubbles | No |
| Cancelable | No |
| Interface | Event |
| Supported HTML Elements | <audio>,<video> |
Example
stalled ( onstalled )イベントの例です。以下の例で読み込もうとしているのは壊れたファイルです。
以下に例では、もしもダウンロードしたデータが利用できなければ stalled イベントが発生すればアラートが表示されますが、壊れたファイルではこのイベントは発生しないようです。
関連するイベント
読み込みに使用するイベントです。エレメントのロード、ファイルのダウンロード、動画や音声といったメディデータのダウンロードと用途によって機能する/しないイベントがあります。
| イベント | 概要 |
|---|---|
| onabort | 読み込みが途中でキャンセルされたら |
| onerror | リソースの読み込みの失敗または実行時にエラーが発生したら |
| onload | ファイルやエレメントのロードに時に発生。window でページの初期設定に使用 |
| onloadeddata | メディアデータの読み込みが終了したら |
| onloadedmetadata | メディアのメタデータの読み込みが完了したら |
| onloadend | 読み込みが終了したら |
| onloadstart | メディアデータのダウンロードプロセスが始まったら |
| onprogress | ファイルやメディアデータをダウンロードをしている間 |
| onstalled | ダウンロードをしたデータが利用できない |
| onsuspend | ダウンロードデータがないと |
