diff options
| author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
|---|---|---|
| committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
| commit | 33058f2b292b3a581333bdfb21b8f671898c5060 (patch) | |
| tree | 51c3e392513ec574331b2d3f85c394445ea803c6 /files/ja/web/api/messageport | |
| parent | 8b66d724f7caf0157093fb09cfec8fbd0c6ad50a (diff) | |
| download | translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.gz translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.bz2 translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.zip | |
initial commit
Diffstat (limited to 'files/ja/web/api/messageport')
| -rw-r--r-- | files/ja/web/api/messageport/close/index.html | 145 | ||||
| -rw-r--r-- | files/ja/web/api/messageport/index.html | 104 | ||||
| -rw-r--r-- | files/ja/web/api/messageport/onmessage/index.html | 144 | ||||
| -rw-r--r-- | files/ja/web/api/messageport/onmessageerror/index.html | 53 | ||||
| -rw-r--r-- | files/ja/web/api/messageport/postmessage/index.html | 156 | ||||
| -rw-r--r-- | files/ja/web/api/messageport/start/index.html | 78 |
6 files changed, 680 insertions, 0 deletions
diff --git a/files/ja/web/api/messageport/close/index.html b/files/ja/web/api/messageport/close/index.html new file mode 100644 index 0000000000..05561c1404 --- /dev/null +++ b/files/ja/web/api/messageport/close/index.html @@ -0,0 +1,145 @@ +--- +title: MessagePort.close() +slug: Web/API/MessagePort/close +tags: + - API + - Channel messaging + - MessagePort + - Method + - Reference +translation_of: Web/API/MessagePort/close +--- +<div>{{APIRef("HTML DOM")}}</div> + +<p>{{domxref("MessagePort")}} インターフェイスの <code><strong>close()</strong></code> メソッドは、ポートの接続を切断し、ポートがアクティブではなくなります。これは、そのポートへのメッセージの送信を停止します。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">port.close()</pre> + +<h3 id="Returns" name="Returns">戻り値</h3> + +<p>無効。</p> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<p>なし。</p> + +<h2 id="Example" name="Example">例</h2> + +<p>次のコードブロックには、<code>handleMessage</code> ハンドラ関数があり、{{domxref("EventTarget.addEventListener")}} を使用してこのドキュメントにメッセージが返された時に実行されます。</p> + +<pre class="brush: js">channel.port1.addEventListener('message',handleMessage,false); +function handleMessage(e) { + para.innerHTML = e.data; + textInput.value = ''; +} + +channel.port1.start(); +</pre> + +<p>次のようにして、いつでもメッセージの送信を停止できます。</p> + +<pre class="brush: js">channel.port1.close();</pre> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様書</th> + <th scope="col">策定状況</th> + <th scope="col">備考</th> + </tr> + <tr> + <td>{{SpecName('HTML WHATWG', '#dom-messageport-close','close()')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td>{{SpecName("HTML5 Web Messaging")}} との差異なし。</td> + </tr> + <tr> + <td>{{SpecName('HTML5 Web Messaging', '#dom-messageport-close','close()')}}</td> + <td>{{Spec2('HTML5 Web Messaging')}}</td> + <td>仕様の W3C バージョン。</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザの実装状況</h2> + +<div>{{CompatibilityTable}}</div> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>機能</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari (WebKit)</th> + </tr> + <tr> + <td>基本サポート</td> + <td>4</td> + <td>{{CompatNo}}</td> + <td>10.0</td> + <td>10.6</td> + <td>5</td> + </tr> + <tr> + <td>Worker 内で利用可能</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoDesktop(41)}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>機能</th> + <th>Android</th> + <th>Chrome for Android</th> + <th>Firefox Mobile (Gecko)</th> + <th>Firefox OS (Gecko)</th> + <th>IE Phone</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>基本サポート</td> + <td>4.4</td> + <td>4</td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + <td>10.0</td> + <td>11.5</td> + <td>5.1</td> + </tr> + <tr> + <td>Worker 内で利用可能</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoMobile(41)}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/docs/Web/API/Channel_Messaging_API/Using_channel_messaging">Using channel messaging</a></li> +</ul> diff --git a/files/ja/web/api/messageport/index.html b/files/ja/web/api/messageport/index.html new file mode 100644 index 0000000000..c586aef559 --- /dev/null +++ b/files/ja/web/api/messageport/index.html @@ -0,0 +1,104 @@ +--- +title: MessagePort +slug: Web/API/MessagePort +tags: + - API + - Channel messaging + - HTML5 + - Interface + - MessagePort + - Reference +translation_of: Web/API/MessagePort +--- +<p>{{APIRef("HTML DOM")}}</p> + +<p><a href="/ja/docs/Web/API/Channel_Messaging_API">Channel Messaging API</a> の <strong><code>MessagePort</code></strong> インターフェースは、{{domxref("MessageChannel")}} の 2 つのポートの一方を表し、片方のポートから送信されるメッセージをもう片方のポートで受信待機できます。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Methods" name="Methods">メソッド</h2> + +<p><em>親である {{domxref("EventTarget")}} からのメソッドを継承します。</em></p> + +<dl> + <dt>{{domxref("MessagePort.postMessage")}}</dt> + <dd>ポートからメッセージを送信します。また、任意でオブジェクトの所有権を他のブラウジングコンテキストへ転送します。</dd> + <dt>{{domxref("MessagePort.start")}}</dt> + <dd>ポート上で順番待ちのメッセージの送信を開始します。({{domxref("EventTarget.addEventListener")}} を使用する場合のみ必要。これは、{{domxref("MessagePort.onmessage")}} を使用する場合を含みます)</dd> + <dt>{{domxref("MessagePort.close")}}</dt> + <dd>ポートとの接続を切断し、このポートはアクティブではなくなります。</dd> +</dl> + +<h2 id="Event_handlers" name="Event_handlers">イベントハンドラ</h2> + +<p><em>親である {{domxref("EventTarget")}} からのイベントハンドラを継承します。</em></p> + +<dl> + <dt>{{domxref("MessagePort.onmessage")}}</dt> + <dd>これは、<code>message</code> 型の {{domxref("MessageEvent")}} がポート上で発動した時に呼び出される {{domxref("EventListener")}} です。つまり、ポートがメッセージを受信した時に呼び出されます。</dd> + <dt>{{domxref("MessagePort.onmessageerror")}}</dt> + <dd>ポートで <code>messageerror</code> 型の {{domxref("MessageEvent")}} が発火すると呼び出されます。つまり、デシリアライズできないメッセージを受け取ったときです。</dd> +</dl> + +<h2 id="Example" name="Example">例</h2> + +<p>次のコードブロックには、{{domxref("MessageChannel()", "MessageChannel.MessageChannel")}} コンストラクタで作成された新しいチャンネルがあります。</p> + +<p>Iframe が読み込まれると、{{domxref("MessageChannel.port1")}} に <code>onmessage</code> ハンドラーを登録し、メッセージと共に {{domxref("window.postMessage")}} を使用して IFrame に {{domxref("MessageChannel.port2")}} を送信します。</p> + +<p>IFrame からメッセージが返却されると。<code>onMessage</code> 関数でメッセージをパラグラフに出力します。</p> + +<pre>var channel = new MessageChannel(); +var output = document.querySelector('.output'); +var iframe = document.querySelector('iframe'); + +// Wait for the iframe to load +iframe.addEventListener("load", onLoad); + +function onLoad() { + // Listen for messages on port1 + channel.port1.onmessage = onMessage; + + // Transfer port2 to the iframe + iframe.contentWindow.postMessage('Hello from the main page!', '*', [channel.port2]); +} + + +// Handle messages received on port1 +function onMessage(e) { + output.innerHTML = e.data; +} +</pre> + +<p>完全に動作する例は、Github 上の <a class="external external-icon" href="https://github.com/mdn/channel-messaging-basic-demo">channel messaging basic demo</a> を参照してください (<a class="external external-icon" href="http://mdn.github.io/channel-messaging-basic-demo/">実際のデモも実行できます</a>)。</p> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様書</th> + <th scope="col">策定状況</th> + <th scope="col">備考</th> + </tr> + <tr> + <td>{{SpecName('HTML WHATWG', 'web-messaging.html#message-ports','Message ports')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザの実装状況</h2> + +<div> + + +<p>{{Compat("api.MessagePort")}}</p> +</div> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/docs/Web/API/Channel_Messaging_API/Using_channel_messaging">Using channel messaging</a></li> +</ul> diff --git a/files/ja/web/api/messageport/onmessage/index.html b/files/ja/web/api/messageport/onmessage/index.html new file mode 100644 index 0000000000..81de5888cd --- /dev/null +++ b/files/ja/web/api/messageport/onmessage/index.html @@ -0,0 +1,144 @@ +--- +title: MessagePort.onmessage +slug: Web/API/MessagePort/onmessage +tags: + - API + - Channel messaging + - MessagePort + - Property + - Reference +translation_of: Web/API/MessagePort/onmessage +--- +<div>{{APIRef("HTML DOM")}}</div> + +<p>{{domxref("MessagePort")}} インターフェイスの <code><strong>onmessage</strong></code> イベントハンドラは、{{domxref("EventListener")}} であり、ポート上で <code>message</code> 型の {{domxref("MessageEvent")}} が発動した時に呼び出されます。つまり、ポートがメッセージを受信した時に呼び出されます。 +</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">channel.onmessage = function() { ... };</pre> + +<h2 id="Example" name="Example">例</h2> + +<p>次のコードブロックには、{{domxref("MessageChannel()", "MessageChannel.MessageChannel")}} コンストラクタで作成された新しいチャンネルがあります。IFrame が読み込まれた時、{{domxref("MessagePort.postMessage")}} を使用してメッセージと {{domxref("MessageChannel.port2")}} が IFrame へ渡されます。すると、<code>handleMessage</code> ハンドラが <code>onmessage</code> によって IFrame から返されたメッセージに応答し、そのメッセージを段落に出力します。ここで、{{domxref("MessageChannel.port1")}} は、メッセージが到着したときに確認するための待機状態にあります。</p> + +<pre class="brush: js">var channel = new MessageChannel(); +var para = document.querySelector('p'); + +var ifr = document.querySelector('iframe'); +var otherWindow = ifr.contentWindow; + +ifr.addEventListener("load", iframeLoaded, false); + +function iframeLoaded() { + otherWindow.postMessage('Hello from the main page!', '*', [channel.port2]); +} + +channel.port1.onmessage = handleMessage; +function handleMessage(e) { + para.innerHTML = e.data; +} </pre> + +<p>完全に動作する例は、Github 上の <a class="external external-icon" href="https://github.com/mdn/channel-messaging-basic-demo">チャンネルメッセージ送信の基本デモ</a> を見てください (<a class="external external-icon" href="http://mdn.github.io/channel-messaging-basic-demo/">実際の動作も確認できます</a>)。</p> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様書</th> + <th scope="col">策定状況</th> + <th scope="col">備考</th> + </tr> + <tr> + <td>{{SpecName('HTML WHATWG', '#handler-messageport-onmessage','onmessage')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td>{{SpecName("HTML5 Web Messaging")}} との差異なし。</td> + </tr> + <tr> + <td>{{SpecName('HTML5 Web Messaging', '#handler-messageport-onmessage','onmessage')}}</td> + <td>{{Spec2('HTML5 Web Messaging')}}</td> + <td>仕様の W3C バージョン。</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザの実装状況</h2> + +<div>{{CompatibilityTable}}</div> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>機能</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari (WebKit)</th> + </tr> + <tr> + <td>基本サポート</td> + <td>4</td> + <td>{{CompatNo}}</td> + <td>10.0</td> + <td>10.6</td> + <td>5</td> + </tr> + <tr> + <td>Worker 内で利用可能</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoDesktop(41)}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>機能</th> + <th>Android</th> + <th>Chrome for Android</th> + <th>Firefox Mobile (Gecko)</th> + <th>Firefox OS (Gecko)</th> + <th>IE Phone</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>基本サポート</td> + <td>4.4</td> + <td>4</td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + <td>10.0</td> + <td>11.5</td> + <td>5.1</td> + </tr> + <tr> + <td>Worker 内で利用可能</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoMobile(41)}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/docs/Web/API/Channel_Messaging_API/Using_channel_messaging">Using channel messaging</a></li> +</ul> diff --git a/files/ja/web/api/messageport/onmessageerror/index.html b/files/ja/web/api/messageport/onmessageerror/index.html new file mode 100644 index 0000000000..8265880f3b --- /dev/null +++ b/files/ja/web/api/messageport/onmessageerror/index.html @@ -0,0 +1,53 @@ +--- +title: MessagePort.onmessageerror +slug: Web/API/MessagePort/onmessageerror +tags: + - API + - Channel messaging + - MessagePort + - Property + - Reference + - events + - onmessageerror +translation_of: Web/API/MessagePort/onmessageerror +--- +<div>{{APIRef("HTML DOM")}}</div> + +<p>{{domxref("MessagePort")}} インターフェースの <code><strong>onmessageerror</strong></code> イベントハンドラーは、ポートで <code>messageerror</code> 型の {{domxref("MessageEvent")}} が発火すると呼び出されます。つまり、{{glossary("Deserialization", "deserialized")}} できないメッセージを受け取ったときです。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="構文">構文</h2> + +<pre class="syntaxbox">port.onmessageerror = function() { ... };</pre> + +<h2 id="仕様">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様</th> + <th scope="col">ステータス</th> + <th scope="col">コメント</th> + </tr> + <tr> + <td>{{SpecName('HTML WHATWG', 'web-messaging.html#handler-messageport-onmessageerror', 'onmessageerror')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="ブラウザー実装状況">ブラウザー実装状況</h2> + +<div> + + +<p>{{Compat("api.MessagePort.onmessageerror")}}</p> +</div> + +<h2 id="関連項目">関連項目</h2> + +<ul> + <li><a href="/ja/docs/Web/API/Channel_Messaging_API/Using_channel_messaging">Using channel messaging</a></li> +</ul> diff --git a/files/ja/web/api/messageport/postmessage/index.html b/files/ja/web/api/messageport/postmessage/index.html new file mode 100644 index 0000000000..f9e092b551 --- /dev/null +++ b/files/ja/web/api/messageport/postmessage/index.html @@ -0,0 +1,156 @@ +--- +title: MessagePort.postMessage() +slug: Web/API/MessagePort/postMessage +tags: + - API + - Channel messagging + - MessagePort + - Reference + - postMessage +translation_of: Web/API/MessagePort/postMessage +--- +<p>{{APIRef("HTML DOM")}}</p> + +<p>{{domxref("MessagePort")}} インターフェイスの <code><strong>postMessage()</strong></code> メソッドは、ポートからのメッセージを送信します。任意で、オブジェクトの所有権を他のブラウザコンテキストへ転送します。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">port.postMessage(message [,transfer]);</pre> + +<h3 id="Returns" name="Returns">戻り値</h3> + +<p>無効。</p> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt>message</dt> + <dd>チャンネル経由で送信するメッセージ。これは基本データタイプになります。複数のデータアイテムを配列として送信できます。</dd> + <dt>[, transfer]</dt> + <dd>(任意) 転送されるオブジェクト。これらのオブジェクトの所有権は、受信側のブラウザコンテキストへ転送されるため、送信側のブラウザコンテキストでは使用できなくなります。</dd> +</dl> + +<h2 id="Example" name="Example">例</h2> + +<p>次のコードブロックでは、{{domxref("MessageChannel()", "MessageChannel.MessageChannel")}} コンストラクタで新しいチャンネルを作成しています。IFrame が読み込まれた時、{{domxref("window.postMessage")}} メソッドによってメッセージと {{domxref("MessageChannel.port2")}} が IFrame へ渡されます。すると、<code>handleMessage</code> が <code>onmessage</code> によって IFrame から返されたメッセージに応答し、そのメッセージを段落に出力します。ここで、{{domxref("MessageChannel.port1")}} は、メッセージが到着したときに確認するための待機状態にあります。</p> + +<pre class="brush: js">var channel = new MessageChannel(); +var para = document.querySelector('p'); + +var ifr = document.querySelector('iframe'); +var otherWindow = ifr.contentWindow; + +ifr.addEventListener("load", iframeLoaded, false); + +function iframeLoaded() { + otherWindow.postMessage('Hello from the main page!', '*', [channel.port2]); +} + +channel.port1.onmessage = handleMessage; +function handleMessage(e) { + para.innerHTML = e.data; +} </pre> + +<p>完全に動作する例は、Github 上の <a class="external external-icon" href="https://github.com/mdn/channel-messaging-basic-demo">チャンネルメッセージ送信の基本デモ</a> を見てください (<a class="external external-icon" href="http://mdn.github.io/channel-messaging-basic-demo/">実際の動作も確認できます</a>)。</p> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様書</th> + <th scope="col">策定状況</th> + <th scope="col">備考</th> + </tr> + <tr> + <td>{{SpecName('HTML WHATWG', '#dom-messageport-postmessage','postMessage()')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td>{{SpecName("HTML5 Web Messaging")}} との差異なし。</td> + </tr> + <tr> + <td>{{SpecName('HTML5 Web Messaging', '#dom-messageport-postmessage','postMessage()')}}</td> + <td>{{Spec2('HTML5 Web Messaging')}}</td> + <td>仕様の W3C バージョン。</td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザの実装状況</h2> + +<div>{{CompatibilityTable}}</div> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>機能</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari (WebKit)</th> + </tr> + <tr> + <td>基本サポート</td> + <td>4</td> + <td>{{CompatNo}}</td> + <td>10.0</td> + <td>10.6</td> + <td>5</td> + </tr> + <tr> + <td>Worker 内で利用可能</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoDesktop(41)}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>機能</th> + <th>Android</th> + <th>Chrome for Android</th> + <th>Firefox Mobile (Gecko)</th> + <th>Firefox OS (Gecko)</th> + <th>IE Phone</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>基本サポート</td> + <td>4.4</td> + <td>4</td> + <td>{{CompatNo}}</td> + <td>{{CompatNo}}</td> + <td>10.0</td> + <td>11.5</td> + <td>5.1</td> + </tr> + <tr> + <td>Worker 内で利用可能</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoMobile(41)}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/docs/Web/API/Channel_Messaging_API/Using_channel_messaging">Using channel messaging</a></li> +</ul> diff --git a/files/ja/web/api/messageport/start/index.html b/files/ja/web/api/messageport/start/index.html new file mode 100644 index 0000000000..0117300fc0 --- /dev/null +++ b/files/ja/web/api/messageport/start/index.html @@ -0,0 +1,78 @@ +--- +title: MessagePort.start() +slug: Web/API/MessagePort/start +tags: + - API + - Channel messaging + - MessagePort + - Method + - Reference +translation_of: Web/API/MessagePort/start +--- +<div>{{APIRef("HTML DOM")}}</div> + +<p>{{domxref("MessagePort")}} インターフェイスの <code><strong>start()</strong></code> メソッドは、ポート上のキューに置かれたメッセージの送信を開始します。このメソッドは、{{domxref("EventTarget.addEventListener")}} を使用する場合のみ必要になります。これは、{{domxref("MessageChannel.onmessage")}} を使用する場合は包含されています。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox">port.start()</pre> + +<h3 id="Returns" name="Returns">戻り値</h3> + +<p>無効。</p> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<p>なし。</p> + +<h2 id="Example" name="Example">例</h2> + +<p>次のコードブロックには、<code>handleMessage</code> ハンドラ関数があり、<code>onmessage</code> を使用して、メッセージがこのドキュメントに送り返された時に実行されます:</p> + +<pre class="brush: js">channel.port1.onmessage = handleMessage; +function handleMessage(e) { + para.innerHTML = e.data; +} </pre> + +<p>これを行うもう一つの方法は、{{domxref("EventTarget.addEventListener")}} を使用します。しかし、このメソッドが使用された場合、明示的に <code>start()</code> を呼び出してメッセージの送信を開始する必要があります:</p> + +<pre class="brush: js">channel.port1.addEventListener('message', handleMessage, false); +function handleMessage(e) { + para.innerHTML = e.data; + textInput.value = ''; +} + +channel.port1.start();</pre> + +<h2 id="Specifications" name="Specifications">仕様</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">仕様書</th> + <th scope="col">策定状況</th> + <th scope="col">備考</th> + </tr> + <tr> + <td>{{SpecName('HTML WHATWG', 'web-messaging.html#dom-messageport-start', 'start()')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td> </td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザの実装状況</h2> + +<div> + + +<p>{{Compat("api.MessagePort.start")}}</p> +</div> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/docs/Web/API/Channel_Messaging_API/Using_channel_messaging">Using channel messaging</a></li> +</ul> |
