[13] [DFN[[CODE(DOMi)@en[[[EventSource]]]]]] は、[[遠隔DOM事象]]を受信するための[[物体]]が実装する [[DOM界面]]です。 * 仕様書 [REFS[ - [48] [CITE@en-GB-x-hixie[HTML Standard]] ([TIME[2014-12-04 10:25:09 +09:00]] 版) ]REFS] * 文脈 [66] いわゆる[[プッシュ型]]の[[サーバー]]から[[クライアント]]への情報伝達に使うことができます。 [67] しかし更新頻度が低ければ[[ポーリング]]でよく、高いか不定なら [[WebSocket]] が便利なので、 [[SSE]] はあまり出番もないかもしれません。 [EG[ [68] 例えば[[チャット]]は[[サーバー]]から任意のタイミングで発言を送信したいので、 [[SSE]] が使えそうに見えます。しかし[[クライアント]]から[[サーバー]]へも発言を送りたいので、 どうせなら同じ [[WebSocket]] の接続を使った方がよく、一方向の [[SSE]] を使う理由は薄いです。 ]EG] [99] [[MCP Streamable HTTP]] * [CODE(DOMi)@en[EventSource]] コンストラクター [73] [FIG(steps)[ @@ = [74] [[文脈オブジェクト]]の[F[関連設定群オブジェクト]]の[F[大域オブジェクト]]の [F[[CODE(DOMi)@en[EventSource]]群]]に、 [[弱い参照]]で[VAR[イベント源]]を追加します。 [WEAK[([[unloading document cleanup steps]] で参照されます。)]] = [75] [VAR[イベント源]]を返します。 ]FIG] * 歴史 ** [CODE(HTMLe)@en[event-source]] 要素の登場 [14] はじめ、 [CODE(HTMLe)@en[[[event-source]]]] [[要素]]として [[Ian Hickson]] により提案されていました。この提案は後に [[Web Applications 1.0]] 仕様書 ([[HTML5]]) に組み入れられました。 ;; [23] [CITE@en-GB-x-Hixie[Hixie's Natural Log: Server-sent DOM events]] ([TIME[2004-04-28 15:45]] 版) [FIG(data)[ [93] [[HTML要素概説]] :[F[要素名]]:[CODE[event-source]] :日付:[TIME[2004-04-28]] :説明: [TIME[2004-04-28]]、 [[Ian Hickson]] は[[Webログ]]で、 [CODE[event-source]] を提案した。 :出典: [REFS[ - [DFN[SSDE]]: [CITE@en-GB-x-Hixie[Hixie's Natural Log: Server-sent DOM events]], [DATA(.author)[[[Ian Hickson]]]], [TIME(.published)[2004-04-28 15:45 [SMALLCAPS[UTC]]][2004-04-28T15:45Z]], [TIME[2024-09-01T08:20:42.000Z]] ]REFS] ]FIG] ;; [22] [CITE@en-GB-hixie[Server Sent Events 1.0]] ([TIME[2006-07-31 15:51:28 +09:00]] 版) >Working Draft 8 June 2004 ** WA1 [DEL[ [1] [CITE[Web Applications 1.0]] ]DEL] [FIG(data)[ [92] [[HTML要素概説]] :[F[要素名]]:[CODE[event-source]] :日付:[TIME[2004-09-23]] :説明: [TIME[2004-09-23]]版 [CITE@en-GB-hixie[Web Applications 1.0]] に [CODE[event-source]] がある。 :出典: [REFS[ - [DFN[WA1-20040923]]: [CITE@en-GB-hixie[Web Applications 1.0]], [DATA(.author)[[[WHATWG]]]], [[Ian Hickson]], [DATA(.status)[[[Working Draft]]]], [TIME(.published)[23 September 2004][2004-09-23]], [TIME[2024-09-01T06:53:36.000Z]], [TIME[2004-10-09T15:04:52.113Z]] ]REFS] ]FIG] ** HTML5 [27] 2008年2月に大改訂がありましたが、その前の仕様は >>28 のような感じでした。 [28] [CITE@en-GB-hixie[HTML 5]] ([TIME[2007-10-29 06:22:51 +09:00]] 版) [21] [[Opera]] 9 以降で実装されています。 [[ニンテンドーDSiブラウザー]]でも使えます。 [2] [CITE[Opera Web Chat]] ([[名無しさん]]) [3] [CITE[Event Streaming to Web Browsers - Web Applications Blog - by Web Applications]] [19] [CITE@en[Event Streaming to Web Browsers]] ([[Opera Software ASA]] 著, [TIME[2011-02-03 10:59:19 +09:00]] 版) [4] [CITE[EarthQuakes Map Widget - Opera Widgets]] ([[名無しさん]] [WEAK[2006-09-09 03:28:34 +00:00]]) [5] [CITE[Bug 338583 – Add support for Server-Sent DOM Events (Remote Events)]] ([CODE[2007-08-17 13:54:47 +09:00]] 版) ** [CODE(MIME)@en[application/x-dom-event-stream]] から [CODE(MIME)@en[text/event-stream]] へ [6] [[Hixie]] が Status を [Q@en[Being considered for removal]] に設定しているみたいです。 ([[名無しさん]] [WEAK[2007-12-09 05:50:04 +00:00]]) [7] >>6 大改訂があった結果、[CODE(HTMLe)@en[[[event-source]]]] は [Q@en[Last call for comments]]、 [[鯖送信DOM事象]]の章は [Q@en[Working draft]] になっています。 ([[名無しさん]] [WEAK[2008-02-23 10:28:51 +00:00]]) [8] >>7 さっきの [[Ian Hickson]] の [['''#'''whatwg]] での発言によると、 削ろうと思ったけど残すべきという意見があって、 それがもっともだと思ったから削るのはやめたと。 ([[名無しさん]] [WEAK[2008-02-23 10:41:26 +00:00]]) [9] [CITE[Re: several messages about and related subjects]] ([[Ian Hickson ]] 著, [TIME[2008-02-22 10:16:51 +09:00]] 版) [24] [CITE@en[HTML5 Tracker]] ([TIME[2008-02-22 09:43Z]] 版) [25] >>24 では大規模な変更があり、 [[MIME型]]も [CODE(MIME)@en[[[application/x-dom-event-stream]]]] から [CODE(MIME)@en[[[text/event-stream]]]] に変更されました。 [98] [CITE['''['''whatwg''']''' several messages about and related subjects]], [TIME[2024-09-20T16:18:31.000Z]], [TIME[2024-09-28T02:02:09.786Z]] ** [CODE(HTMLe)@en[event-source]] から [CODE(HTMLe)@en[eventsource]] へ [10] [TIME[2008-07-11]]、 [[HTML5]] で定義されていた [CODE(HTMLe)@en[[[event-source]]]] [[要素]]は、 [CODE(HTMLe)@en[[[eventsource]]]] に改名されました。 [SRC[>>26]] [REFS[ - [26] [CITE@en[Web Applications 1.0 r1863 Rename to for consistency, while we sill can]] ([TIME[2008-07-11 18:40:00 +09:00]] 版) -- [94] [CITE@en['''['''o''']''' (2) Rename to for consistency, while…]], [[Hixie]], [TIME[2008-07-11 18:40:38 +09:00]], [TIME[2024-09-04T12:39:51.000Z]] ]REFS] [FIG(data)[ [95] [[HTML要素概説]] :[F[要素名]]:[CODE[event-source]] :[F[要素名]]:[CODE[eventsource]] :日付:[TIME[2008-07-11]] :説明: [TIME[2008-07-11]]、 [CITE[HTML5]] の [CODE[event-source]] は [CODE[eventsource]] に改称された。 :出典: [REFS[ - [CITE[HTML5 r1863]], [DATA(.author)[[[Hixie]]]], [TIME(.published)[2008-07-11 18:40:38 +09:00]], [TIME[2024-09-04T12:39:51.000Z]] ]REFS] ]FIG] ** [CODE(HTMLe)@en[eventsource]] 要素から [CODE(DOMi)@en[EventSource]] 界面へ [11] 以前から [CODE(HTMLe)@en[[[eventsource]]]] [[要素]]は[[要素]]である意味があるのか疑問視する意見がありましたが、 2009年2月に[[要素]]としては削除され、 [CODE(DOMi)@en[[[EventSource]]]] [[DOM]] [[界面]]となりました。 [12] [CITE[IRC logs: freenode / #whatwg / 20090226]] ([TIME[2009-03-09 18:58:46 +09:00]] 版) >17:40 (hsivonen) Hixie: so what's the remaining selling point over Web Sockets? that you can feed EventSource from a regular HTTP server? >17:40 (Hixie) the only selling point over websocket that it's ever had is that it is compatible with CGI scripts [15] [CITE@en-US-x-Hixie[Server-Sent Events]] ([TIME[2009-03-27 10:09:23 +09:00]] 版) [16] [CITE@en-US-x-Hixie[Server-Sent Events]] ([TIME[2009-04-23 13:50:52 +09:00]] 版) -[17] [CITE@en[(X)HTML5 Tracking]] ([TIME[2009-09-06 10:20:51 +09:00]] 版) -- [96] [CITE@en['''['''''']''' (0) Drop . Replace the API with an EventSource object…]], [[Hixie]], [TIME[2009-02-26 17:33:42 +09:00]], [TIME[2024-09-07T02:59:43.000Z]] [18] [CITE[IRC logs: freenode / #whatwg / 20100427]] ([TIME[2010-05-16 19:00:37 +09:00]] 版) [FIG(data)[ [97] [[HTML要素概説]] :[F[要素名]]:[CODE[eventsource]] :日付:[TIME[2009-02-26]] :説明: [TIME[2009-02-26]]、 [CITE[HTML5]] の [CODE[eventsource]] は削除され、 [CODE(DOMi)[EventSource]] [[インターフェイス]]が追加された。 :出典: [REFS[ - [CITE[HTML5 r2870]], [DATA(.author)[[[Hixie]]]], [TIME(.published)[2009-02-26 17:33:42 +09:00]], [TIME[2024-09-07T02:59:43.000Z]] ]REFS] ]FIG] * テスト・ケース [20] [CITE[Index of /~wakaba/-temp/test/dom/eventsource]] ([TIME[2011-02-03 11:02:37 +09:00]] 版) * メモ [29] [CITE@en-US-x-Hixie[Server-Sent Events]] ( ([TIME[2011-02-09 06:05:52 +09:00]] 版)) [30] [CITE[''''''[''''''whatwg'''''']'''''' EventSource - Handling a charset in the content-type header]] ( ([TIME[2011-06-18 08:37:41 +09:00]] 版)) [31] [CITE[''''''[''''''whatwg'''''']'''''' Enhancement request: change EventSource to allow cross-domain access]] ( ([TIME[2011-06-18 08:38:12 +09:00]] 版)) [32] [CITE@en-US-x-Hixie[Server-Sent Events]] ( ([TIME[2011-10-19 02:35:51 +09:00]] 版)) [33] [CITE@ja[Opera Desktop Team - Web Sockets enter the Opera House]] ( ([TIME[2010-10-23 00:19:44 +09:00]] 版)) [34] [CITE@en[Web Applications 1.0 r6848 Require implementations to ignore all MIME type parameters on text/event-stream resourcesAffected topics: Server-Sent Events]] ( ([TIME[2011-12-07 08:52:00 +09:00]] 版)) [35] [CITE@en-US-x-Hixie[Server-Sent Events]] ([TIME[2009-10-29 03:44:26 +09:00]] 版) [36] [CITE@en-US-x-Hixie[Server-Sent Events]] ( ([TIME[2012-04-25 05:35:01 +09:00]] 版)) [37] [CITE[''''''[''''''ietf-types'''''']'''''' Registration for text/event-stream]] ( ([TIME[2012-08-07 11:52:20 +09:00]] 版)) [38] [CITE@en-US-x-Hixie[Server-Sent Events]] ( ([TIME[2012-10-22 21:35:04 +09:00]] 版)) [39] [CITE@en-US-x-Hixie[Server-Sent Events]] ( ([TIME[2012-12-10 08:07:34 +09:00]] 版)) [40] [CITE@en-US-x-Hixie[Server-Sent Events]] ([TIME[2009-12-18 01:36:25 +09:00]] 版) [41] [CITE@en-US-x-Hixie[Server-Sent Events]] ( ([TIME[2011-03-10 02:22:44 +09:00]] 版)) [42] [CITE[IRC logs: freenode / #whatwg / 20130917]] ( ([TIME[2013-09-20 00:01:06 +09:00]] 版)) [43] [CITE@en[Web Applications 1.0 r3552 Include MIME type registration sections.]] ( ([TIME[2009-08-07 18:44:00 +09:00]] 版)) [44] [CITE@en[Web Applications 1.0 r8475 Make the EventSource processing model a mite more generic to allow other user agent types to implement this spec.]] ( ([TIME[2014-02-08 09:31:00 +09:00]] 版)) [45] [CITE@en[MIX: Dropping exceptions for XHR and EventSource. · aac819b · w3c/webappsec]] ( ([TIME[2014-11-04 03:25:13 +09:00]] 版)) [46] [CITE@en[RE: ''''''[''''''eventsource'''''']'''''' Seeking status and plans]] ( ([[Zhang, Zhiqiang]] 著, [TIME[2014-10-15 18:10:48 +09:00]] 版)) [47] [CITE@en-US[Server-Sent Events]] ( ([TIME[2014-12-05 04:46:25 +09:00]] 版)) [49] [CITE@en[Streaming | Flowdock API]] ( ([TIME[2015-01-05 20:57:48 +09:00]] 版)) [50] [CITE@en-US[Server-Sent Events]] ( ([TIME[2015-01-29 18:17:14 +09:00]] 版)) [FIG(quote)[ [FIGCAPTION[ [51] [CITE@en[Streaming | Flowdock API]] ([TIME[2015-03-29 18:05:37 +09:00]] 版) ]FIGCAPTION] > Event-Stream follows the HTML5 Server-Sent Events specification. Each event contains a JSON-encoded message. ]FIG] [FIG(quote)[ [FIGCAPTION[ [52] [CITE[REST API - Firebase]] ([TIME[2015-03-29 19:06:44 +09:00]] 版) ]FIGCAPTION] > Firebase REST endpoints support the EventSource / Server-Sent Events protocol as well. ]FIG] [53] [CITE@en[1156137 – EventSource only works with HTTP channels]] ([TIME[2015-04-27 23:09:59 +09:00]] 版) [54] [CITE[''''''[''''''whatwg'''''']'''''' Server-sent events feedback]] ( ([TIME[2011-02-05 09:56:18 +09:00]] 版)) [55] [CITE@en[25984 – EventSource should support RequestInfo]] ([TIME[2015-09-16 11:39:00 +09:00]] 版) [56] [CITE@en[Integrate Fetch into HTML · whatwg/html@7c5555a]] ([TIME[2015-09-18 19:46:07 +09:00]] 版) [57] [CITE@en[Allow user agents to fail a failed EventSource connection · whatwg/html@3970693]] ([TIME[2015-10-07 13:45:27 +09:00]] 版) [58] [CITE@en[PSA: Change the Latest Editor's Drafts of WebStorage, WebWorkers, WebMessaging, Server-Sent Events and WebSockets]] ([[Xiaoqian Wu]] 著, [TIME[2015-10-20 02:52:22 +09:00]] 版) [59] [CITE@en[URLs are parsed and produce records · whatwg/html@30bc255]] ([TIME[2016-02-14 23:05:21 +09:00]] 版) [60] [CITE@en[EventSource has no need to set Cache-Control · whatwg/html@6f47a53]] ([TIME[2016-03-08 18:38:51 +09:00]] 版) [FIG(quote)[ [FIGCAPTION[ [61] [CITE[JSON Mail Access Protocol Specification (JMAP)]] ([TIME[2016-03-11 14:55:42 +09:00]] 版) ]FIGCAPTION] > There are two mechanisms by which the client can receive the push events. The first is directly via a text/event-stream resource ]FIG] [62] [CITE@en[Make EventSource use the base URL of its global · whatwg/html@3175b53]] ([TIME[2016-04-22 18:23:18 +09:00]] 版) [63] [CITE@en[Move server-sent events IANA considerations to the index]] ( ([[momdo]]著, [TIME[2016-05-23 21:11:39 +09:00]])) [FIG(quote)[ [FIGCAPTION[ [64] [CITE[Server-Sent Eventsでtail -Fっぽいやつ - Qiita]] ( ([TIME[2016-05-26 21:54:34 +09:00]])) ]FIGCAPTION] > tail -Fっぽく、ファイルが更新されたらブラウザに差分をPUSHするスクリプトを書いてみました。 ]FIG] [65] [CITE@en[Align Fetch's destination concept with changes in Fetch]] ([[sideshowbarker]]著, [TIME[2016-07-05 02:46:14 +09:00]]) [69] [CITE@en[Set some MessageEvent's isTrusted attributes to true]] ([[domenic]]著, [TIME[2016-10-26 02:33:24 +09:00]]) [70] [CITE@en[Specify the realm for the SSE MessageEvent]] ([[domenic]]著, [TIME[2016-10-28 02:17:38 +09:00]]) [FIG(quote)[ [FIGCAPTION[ [71] [CITE@en[Streaming | Flowdock API]] ([TIME[2016-12-21 22:49:46 +09:00]]) ]FIGCAPTION] > Event-Stream (text/event-stream) > Event-Stream follows the HTML5 Server-Sent Events specification. Each event contains a JSON-encoded message. ]FIG] [FIG(quote)[ [FIGCAPTION[ [72] [CITE[Realtime messaging - Restdb.io]] ([[the team at restdb.io]]著, [TIME[2016-12-21 23:02:15 +09:00]]) ]FIGCAPTION] > RestDB.io can act as a Realtime messaging hub for your application. You can use the realtime API from web clients and servers, actually any client that can connect to your database using the HTTP EventSource API. > ]FIG] [FIG(quote)[ [FIGCAPTION[ [76] [CITE@en[RFC 8040 - RESTCONF Protocol]] ([TIME[2017-03-27 23:03:09 +09:00]]) ]FIGCAPTION] > event stream resource: a resource that represents an SSE > (Server-Sent Events) event stream. The content consists of text > using the media type "text/event-stream", as defined by the SSE > specification ]FIG] [77] [CITE@en[documentation/Streaming-API.md at master · tootsuite/documentation]] ([TIME[2017-04-14 00:48:51 +09:00]]) [78] [CITE@en[EventSource: ignore IDs with U+0000]] ([[annevk]]著, [TIME[2017-07-19 23:29:11 +09:00]]) [79] [CITE@en['''['''EventSource''']''' Is Last-Event-ID header value allowed to contain any-char? · Issue #689 · whatwg/html]] ([TIME[2017-08-04 13:51:33 +09:00]]) [80] [CITE@en[Add an introductory API overview block for EventSource]] ([[sideshowbarker]]著, [TIME[2017-12-15 09:08:43 +09:00]]) [81] [CITE@en[Add a domintro block for EventSource interface by sideshowbarker · Pull Request #3173 · whatwg/html]] ([TIME[2017-12-16 12:28:13 +09:00]]) [82] [CITE@en[Editorial: less continue after returning]] ([[annevk]]著, [TIME[2018-01-23 23:24:34 +09:00]]) [83] [CITE@en["Return the new EventSource object, but continue..." · Issue #692 · whatwg/html]] ([TIME[2018-01-25 13:02:21 +09:00]]) [84] [CITE@en[Editorial: less continue after returning by annevk · Pull Request #3385 · whatwg/html]] ([TIME[2018-01-25 13:02:30 +09:00]]) [85] [CITE@en[EventSource close · Issue #3380 · whatwg/html]] ([TIME[2018-02-13 01:19:37 +09:00]]) [86] [CITE@en[Clarify if EventSource interface is enabled in Service Worker · Issue #3620 · whatwg/html]] ([TIME[2018-04-15 21:44:25 +09:00]]) [87] [CITE@en[When to "fail the connection" of an EventSource? · Issue #3789 · whatwg/html]] ([TIME[2018-07-03 22:33:07 +09:00]]) [88] [CITE@en[Memorandum of Understanding Between W3C and WHATWG]] ([TIME[2019-05-28 17:23:37 +09:00]]) [89] [CITE@ja[データの取得  |  Firebase]] ([TIME[2020-09-09T06:11:11.000Z]], [TIME[2020-10-06T02:37:42.113Z]]) [90] [CITE@en[Editorial: remove unnecessary parameter]] ([[jugglinmike]], [TIME[2019-12-06 03:38:23 +09:00]], [TIME[2021-03-17T11:30:12.000Z]]) [91] [CITE@en[Editorial: remove unnecessary parameter by jugglinmike · Pull Request #5132 · whatwg/html]] ([TIME[2021-03-17T11:30:24.000Z]])