EventSource インターフェイスは、Server-sent events を受け取るために使用します。HTTP でサーバと接続して、接続を切断せずに text/event-stream 形式でイベントを受信します。
プロパティ
このインターフェイスは、親である EventTarget からプロパティを継承します。
EventSource.onerror- エラーが発生したときに呼び出される
EventHandlerであり、オブジェクトでerrorイベントが発生します。 EventSource.onmessagemessageイベントを受け取ったとき、すなわち発信元からメッセージが到着したときに呼び出されるEventHandlerです。EventSource.onopenopenイベントを受け取ったとき、すなわち接続を開始したときに呼び出されるEventHandlerです。EventSource.readyState読取専用- 接続の状態を表す
unsigned short値です。許容値はCONNECTING(0)、OPEN(1)、CLOSED(2) です。 EventSource.url読取専用- ソースの URL を表す
DOMStringです。
メソッド
このインターフェイスは、親である EventTarget からメソッドを継承します。
EventSource.close()- 接続を切断して、
readyState属性をCLOSEDに設定します。すでに切断されている場合は何も行いません。
仕様
| 仕様書 | 策定状況 | コメント |
|---|---|---|
| WHATWG HTML Living Standard The definition of 'EventSource' in that specification. |
Living Standard |
ブラウザ実装状況
| 機能 | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| 基本サポート | 9 | 6.0 (6.0) | ? | 11 | 5 |
| CORS のサポート | 26 | 11.0 (11.0) | ? | 12 | ? |
| 機能 | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| 基本サポート | 4.4 | ? | ? | ? | ? |