| 11 |
<span class=secno>$1 </span>事象定義 |
<span class=secno>$1 </span>事象定義 |
| 12 |
|
|
| 13 |
#en |
#en |
| 14 |
Messages in <a href="#server-sent">server-sent events</a>, <a |
Messages in <a href=#server-sent-events>server-sent events</a>, <a |
| 15 |
href="#web-sockets">Web sockets</a>, <a |
href=#network>Web sockets</a>, <a |
| 16 |
href="#cross-document">cross-document messaging</a>, and <a |
href=#crossDocumentMessages>cross-document messaging</a>, and <a |
| 17 |
href="#channel0">channel messaging</a> use the <dfn id=message2 |
href=#channel-messaging>channel messaging</a> use the <dfn id=event-message |
| 18 |
title=event-message><code>message</code></dfn> event. |
title=event-message><code>message</code></dfn> event. |
| 19 |
#ja |
#ja |
| 20 |
<a href="#server-sent">鯖送信事象</a>、<a |
<a href=#server-sent-events>鯖送信事象</a>、<a |
| 21 |
href="#web-sockets">Web ソケット</a>、<a |
href=#network>Web ソケット</a>、<a |
| 22 |
href="#cross-document">文書間メッセージ交換</a>、<a |
href=#crossDocumentMessages>文書間メッセージ交換</a>、<a |
| 23 |
href="#channel0">通信路メッセージ交換</a>のメッセージは<dfn id=message2 |
href=#channel-messaging>通信路メッセージ交換</a>のメッセージは<dfn id=event-message |
| 24 |
title=event-message><code>message</code></dfn> 事象を使います。 |
title=event-message><code>message</code></dfn> 事象を使います。 |
| 25 |
|
|
| 26 |
#en |
#en |
| 35 |
title=dom-*><code>*()</code></dfn> |
title=dom-*><code>*()</code></dfn> |
| 36 |
methods must initialise the event in a manner analogous to the |
methods must initialise the event in a manner analogous to the |
| 37 |
similarly-named methods in the DOM3 Events interfaces. <a |
similarly-named methods in the DOM3 Events interfaces. <a |
| 38 |
href="#refsDOM3EVENTS">[DOM3EVENTS]</a> |
href=#refsDOM3EVENTS>[DOM3EVENTS]</a> |
| 39 |
#ja |
#ja |
| 40 |
<dfn id=$1 |
<dfn id=$1 |
| 41 |
title=dom-$2><code>$3()</code></dfn> |
title=dom-$2><code>$3()</code></dfn> |
| 43 |
title=dom-$5><code>initMessageEventNS()</code></dfn> |
title=dom-$5><code>initMessageEventNS()</code></dfn> |
| 44 |
メソッドは、 DOM3 事象界面の似たような名前のメソッドと同じような方法で事象を初期化しなければ[[MUST:なりません]]。 |
メソッドは、 DOM3 事象界面の似たような名前のメソッドと同じような方法で事象を初期化しなければ[[MUST:なりません]]。 |
| 45 |
<a |
<a |
| 46 |
href="#refsDOM3EVENTS">[DOM3EVENTS]</a> |
href=#refsDOM3EVENTS>[DOM3EVENTS]</a> |
| 47 |
|
|
| 48 |
#en |
#en |
| 49 |
The <dfn id=data4 title=dom-MessageEvent-data><code>data</code></dfn> |
The <dfn id=dom-messageevent-data title=dom-MessageEvent-data><code>data</code></dfn> |
| 50 |
attribute represents the message being sent. |
attribute represents the message being sent. |
| 51 |
#ja |
#ja |
|
<dfn id=data4 title=dom-MessageEvent-data><code>data</code></dfn> |
|
|
属性は送信されたメッセージを表します。 |
|
| 52 |
|
<dfn id=dom-messageevent-data title=dom-MessageEvent-data><code>data</code></dfn> |
| 53 |
|
属性は送信されたメッセージを表します。 |
| 54 |
|
|
| 55 |
|
#en |
| 56 |
|
The <dfn id=dom-messageevent-origin |
| 57 |
|
title=dom-MessageEvent-origin><code>origin</code></dfn> attribute |
| 58 |
|
represents, in <a href=#server-sent-events>server-sent events</a> and <a |
| 59 |
|
href=#crossDocumentMessages>cross-document messaging</a>, the <a |
| 60 |
|
href=#origin-0>origin</a> of the document that sent the message |
| 61 |
|
(typically the scheme, hostname, and port of the document, but not its |
| 62 |
|
path or fragment identifier). |
| 63 |
|
#ja |
| 64 |
|
<dfn id=dom-messageevent-origin |
| 65 |
|
title=dom-MessageEvent-origin><code>origin</code></dfn> |
| 66 |
|
属性は、 <a href=#server-sent-events>鯖送信事象</a>と<a |
| 67 |
|
href=#crossDocumentMessages>文書間メッセージ交換</a>において、メッセージを送信した文書の<a |
| 68 |
|
href=#origin-0>起源</a> |
| 69 |
|
(普通は当該文書の scheme と hostname と port で、 path や素片識別子は含みません。) |
| 70 |
|
を表します。 |
| 71 |
|
|
| 72 |
|
#en |
| 73 |
|
The <dfn id=dom-messageevent-lasteventid |
| 74 |
|
title=dom-MessageEvent-lastEventId><code>lastEventId</code></dfn> |
| 75 |
|
attribute represents, in <a href=#server-sent-events>server-sent events</a>, |
| 76 |
|
the <span>last event ID string</span> of the event source. |
| 77 |
|
#ja |
| 78 |
|
<dfn id=dom-messageevent-lasteventid |
| 79 |
|
title=dom-MessageEvent-lastEventId><code>lastEventId</code></dfn> |
| 80 |
|
属性は、<a href=#server-sent-events>鯖送信事象</a>において、 |
| 81 |
|
事象源の<span>最終事象識別子文字列</span>を表します。 |
| 82 |
|
|
| 83 |
|
#en |
| 84 |
|
The <dfn id=dom-messageevent-source |
| 85 |
|
title=dom-MessageEvent-source><code>source</code></dfn> attribute |
| 86 |
|
represents, in <a href=#crossDocumentMessages>cross-document messaging</a>, the |
| 87 |
|
<code><a href=#window>Window</a></code> from which the message came. |
| 88 |
|
#ja |
| 89 |
|
<dfn id=dom-messageevent-source |
| 90 |
|
title=dom-MessageEvent-source><code>source</code></dfn> 属性は、 |
| 91 |
|
<a href=#crossDocumentMessages>文書間メッセージ交換</a>において、 |
| 92 |
|
メッセージが送られて来た元の |
| 93 |
|
<code><a href=#window>Window</a></code> を表します。 |
| 94 |
|
|
| 95 |
|
#en |
| 96 |
|
The <dfn id=dom-messageevent-messageport |
| 97 |
|
title=dom-MessageEvent-messagePort><code>messagePort</code></dfn> |
| 98 |
|
attribute represents, in <a href=#crossDocumentMessages>cross-document |
| 99 |
|
messaging</a> and <a href=#channel-messaging>channel messaging</a> the <code><a |
| 100 |
|
href=#messageport>MessagePort</a></code> being sent, if any. |
| 101 |
|
#ja |
| 102 |
|
<dfn id=dom-messageevent-messageport |
| 103 |
|
title=dom-MessageEvent-messagePort><code>messagePort</code></dfn> |
| 104 |
|
属性は、<a href=#crossDocumentMessages>文書間メッセージ交換</a>と<a href=#channel-messaging>通信路メッセージ交換</a>において、 |
| 105 |
|
送信された <code><a |
| 106 |
|
href=#messageport>MessagePort</a></code> があれば、 |
| 107 |
|
それを表します。 |
| 108 |
|
|
| 109 |
|
|
| 110 |
|
#en |
| 111 |
|
Unless otherwise specified, when the user agent creates and dispatches a |
| 112 |
|
<code title=event-message><a href=#event-message>message</a></code> event in |
| 113 |
|
the algorithms described in the following sections, the <code |
| 114 |
|
title=dom-MessageEvent-lastEventId><a |
| 115 |
|
href=#dom-messageevent-lasteventid>lastEventId</a></code> attribute must be the empty |
| 116 |
|
string, the <code title=dom-MessageEvent-origin><a |
| 117 |
|
href=#dom-messageevent-origin>origin</a></code> attribute must be the empty string, the |
| 118 |
|
<code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> |
| 119 |
|
attribute must be null, and the <code |
| 120 |
|
title=dom-MessageEvent-messagePort><a |
| 121 |
|
href=#dom-messageevent-messageport>messagePort</a></code> attribute must be null. |
| 122 |
|
#ja |
| 123 |
|
特に規定がない場合、利用者エージェントが以後の節で説明する算法の中で |
| 124 |
|
<code title=event-message><a href=#event-message>message</a></code> |
| 125 |
|
事象を作成して発送する時に、 <code |
| 126 |
|
title=dom-MessageEvent-lastEventId><a |
| 127 |
|
href=#dom-messageevent-lasteventid>lastEventId</a></code> 属性は空文字列でなければ[[MUST:ならず]]、 |
| 128 |
|
<code title=dom-MessageEvent-origin><a |
| 129 |
|
href=#dom-messageevent-origin>origin</a></code> 属性は空文字列でなければ[[MUST:ならず]]、 |
| 130 |
|
<code title=dom-MessageEvent-source><a href=#dom-messageevent-source>source</a></code> |
| 131 |
|
属性は null でなければ[[MUST:ならず]]、 <code |
| 132 |
|
title=dom-MessageEvent-messagePort><a |
| 133 |
|
href=#dom-messageevent-messageport>messagePort</a></code> |
| 134 |
|
属性は null でなければ[[MUST:なりません]]。 |
| 135 |
|
|
| 136 |
|
|
| 137 |
|
#pattern |
| 138 |
|
<span class=secno>* </span><dfn |
| 139 |
|
>Server-sent events</dfn> |
| 140 |
|
#ja |
| 141 |
|
<span class=secno>$1 </span><dfn |
| 142 |
|
>鯖送信事象</dfn> |
| 143 |
|
|
| 144 |
|
#en |
| 145 |
|
This section describes a mechanism for allowing servers to dispatch DOM |
| 146 |
|
events into documents that expect it. The <code><a |
| 147 |
|
href=#the-eventsource-element>eventsource</a></code> element provides a simple |
| 148 |
|
interface to this mechanism. |
| 149 |
|
#ja |
| 150 |
|
この節は、鯖が事象を待ち受けている文書の中に DOM |
| 151 |
|
事象を発送できるようにする仕組みを説明します。 |
| 152 |
|
<code><a |
| 153 |
|
href=#the-eventsource-element>eventsource</a></code> |
| 154 |
|
要素はこの仕組みに対する単純な界面を提供しています。 |
| 155 |
|
|
| 156 |
|
#en |
| 157 |
|
Any object that implements the <code>EventTarget</code> interface must |
| 158 |
|
also implement the <code><a |
| 159 |
|
href=#remoteeventtarget>RemoteEventTarget</a></code> interface. |
| 160 |
|
#ja |
| 161 |
|
<code>EventTarget</code> 界面を実装するオブジェクトは、 <code><a |
| 162 |
|
href=#remoteeventtarget>RemoteEventTarget</a></code> |
| 163 |
|
界面も実装しなければ[[MUST:なりません]]。 |
| 164 |
|
|
| 165 |
|
#en |
| 166 |
|
When the <dfn id=dom-remoteeventtarget-addeventsource |
| 167 |
|
title=dom-RemoteEventTarget-addEventSource><code>addEventSource(<var |
| 168 |
|
title="">src</var>)</code></dfn> method is invoked, the user agent must <a |
| 169 |
|
href=#resolve-a-url title="resolve a url">resolve</a> the <a |
| 170 |
|
href=#url>URL</a> specified in <var title="">src</var>, and if that |
| 171 |
|
succeeds, add the resulting <a href=#absolute-url>absolute URL</a> to the <a |
| 172 |
|
href=#concept-eventsource-list title=concept-eventsource-list>list of event sources</a> |
| 173 |
|
for that object. The same URL can be registered multiple times. If the URL |
| 174 |
|
fails to resolve, then the user agent must raise a <code>SYNTAX_ERR</code> |
| 175 |
|
exception. |
| 176 |
|
#ja |
| 177 |
|
<dfn id=dom-remoteeventtarget-addeventsource |
| 178 |
|
title=dom-RemoteEventTarget-addEventSource><code>addEventSource(<var |
| 179 |
|
title="">src</var>)</code></dfn> |
| 180 |
|
メソッドが呼び出された時、利用者エージェントは |
| 181 |
|
<var title="">src</var> |
| 182 |
|
に指定された <a |
| 183 |
|
href=#url>URL</a> |
| 184 |
|
を<a |
| 185 |
|
href=#resolve-a-url title="resolve a url">解決</a>し、 |
| 186 |
|
それが成功した場合、得られた<a href=#absolute-url>絶対 URL</a> をそのオブジェクトの<a |
| 187 |
|
href=#concept-eventsource-list title=concept-eventsource-list>事象源のリスト</a>に追加しなければ[[MUST:なりません]]。 |
| 188 |
|
同じ URL を何度も登録することができます。 |
| 189 |
|
URL の解決に失敗した場合は、利用者エージェントは <code>SYNTAX_ERR</code> |
| 190 |
|
例外を発生させなければ[[MUST:なりません]]。 |
| 191 |
|
|
| 192 |
|
#en |
| 193 |
|
When the <dfn id=dom-remoteeventtarget-removeeventsource |
| 194 |
|
title=dom-RemoteEventTarget-removeEventSource><code>removeEventSource(<var |
| 195 |
|
title="">src</var>)</code></dfn> method is invoked, the user agent must <a |
| 196 |
|
href=#resolve-a-url title="resolve a url">resolve</a> the <a |
| 197 |
|
href=#url>URL</a> specified in <var title="">src</var>, and if that |
| 198 |
|
succeeds, remove the resulting <a href=#absolute-url>absolute URL</a> from |
| 199 |
|
the <a href=#concept-eventsource-list title=concept-eventsource-list>list of event |
| 200 |
|
sources</a> for that object. If the same URI has been registered multiple |
| 201 |
|
times, removing it must remove only one instance of that URI for each |
| 202 |
|
invocation of the <code title=removeEventSource>removeEventSource()</code> |
| 203 |
|
method. If the URL fails to resolve, the user agent does nothing. |
| 204 |
|
#ja |
| 205 |
|
<dfn id=dom-remoteeventtarget-removeeventsource |
| 206 |
|
title=dom-RemoteEventTarget-removeEventSource><code>removeEventSource(<var |
| 207 |
|
title="">src</var>)</code></dfn> |
| 208 |
|
メソッドが呼び出された時、利用者エージェントは |
| 209 |
|
<var title="">src</var> に指定された <a |
| 210 |
|
href=#url>URL</a> を<a |
| 211 |
|
href=#resolve-a-url title="resolve a url">解決</a>し、 |
| 212 |
|
それが成功した場合、得られた<a href=#absolute-url>絶対 URL</a> をそのオブジェクトの<a href=#concept-eventsource-list title=concept-eventsource-list>事象源のリスト</a>からさ駆除しなければ[[MUST:なりません]]。 |
| 213 |
|
同じ URI が複数回登録されている場合、 |
| 214 |
|
<code title=removeEventSource>removeEventSource()</code> |
| 215 |
|
メソッドを呼び出す時に削除するのはその URI |
| 216 |
|
の1つの実現値だけを削除しなければ[[MUST:なりません]]。 |
| 217 |
|
URL の解決に失敗した場合は、利用者エージェントは何もしません。 |
| 218 |
|
|
| 219 |
|
|
| 220 |
|
#pattern |
| 221 |
|
<span class=secno>* </span>Connecting to an event |
| 222 |
|
stream |
| 223 |
|
#ja |
| 224 |
|
<span class=secno>$1 </span>事象ストリームへの接続 |
Parent Directory
| 
Revision Log
| 
Patch