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