spec-ja/data/workers.dat

#en
This specification defines an API that allows Web application authors to
   spawn background workers running scripts in parallel to their main page.
   This allows for thread-like operation with message-passing as the
   coordination mechanism.
#ja
この仕様書は、 Web アプリケーションで、主たる頁とは並列に、
背景労働者スクリプトを走らせるための API を定義します。
これにより、メッセージ・パッシングによるスレッド的操作を協調機構として利用できるようになります。

#en
The current focus is in developing a first draft proposal.
#ja
現在の焦点は、第1案の開発です。

#pattern
<span class=secno>* </span>Tutorial
#ja
<span class=secno>$1 </span>解説

#pattern
<span class=secno>* </span>Requirements
#ja
<span class=secno>$1 </span>要件

#en
This specification aims to address the following use cases and
   requirements:
#ja
この仕様書は、次に示す利用事例と要件に取り組むことを目指します。

#en
Background workers: A Web application needs to keep its data
    synchronised with the server, both sending updates to the server and
    receiving updates from the server, including handling buffering of
    updates for when the application goes offline. The code to do this would
    ideally be independent of the UI code.
#ja
背景労働者: Web アプリケーションは、そのデータを鯖と同期しておく必要があります。
これは、鯖への更新の送信と鯖からの更新の両方を含み、
アプリケーションがオフラインとなった時の更新のバッファリングの取扱いも含みます。
そのための符号は利用者界面の符号とは独立しているのが理想でしょう。

#en
URLs: Workers should be spawned from URLs, not from strings, since
    script rarely has access to its own source.
#ja
URL: 労働者は、文字列からではなく、 URL から生み出される[[SHOULD:べきです]]。
スクリプトはそれ自体の出典へのアクセスを滅多に有しないからです。

#en
Message queuing: Messages sent to a worker before the worker has
    initialised should not be lost.
#ja
メッセージ・キューイング: 労働者が初期化される前に送信されたメッセージが失われるべきでは[[SHOULD NOT:ありません]]。

#en
Workers should have access to timers.
#ja
労働者はタイマーへのアクセスを有する[[SHOULD:べきです]]。

#en
Workers should have access to the network.
#ja
労働者はネットワークへのアクセスを有する[[SHOULD:べきです]]。

#en
Workers should be able to use libraries.
#ja
労働者はライブラリを使える[[SHOULD:べきです]]。

#en
Implementations should not have to expose <code>Node</code> or
    <code>Document</code> objects to workers.
#ja
実装は労働者に <code>Node</code> オブジェクトや
    <code>Document</code> オブジェクトを晒さなければならない[[SHOULD NOT:べきではありません]]。

#en
Workers should not share anything with the outside world. The objects
    representing the worker in the worker itself and in the context that
    created the worker should be different, for instance.
#ja
労働者は外界と何も共有する[[SHOULD NOT:べきではありません]]。
例えば、労働者自体の中で労働者を現すオブジェクトと労働者を作成した文脈で労働者を表すオブジェクトは異なる[[SHOULD:べきです]]。

#en
Shared workers: Multiple instances of the same Web application would
    want to keep just one connection back to the server.
#ja
共有労働者: 同じ Web アプリケーションの複数の実現値は鯖に対する接続を1つだけ維持したいでしょう。

#en
Capabilities granting: It should be possible for code running in one
    iframe to negotiate a connection to another iframe, with that connection
    granting certain rights (e.g. adding to an address book but not reading
    from it).
#ja
能力保証: ある iframe で走っている符号が他の iframe と何らかの権限 (例えば、
住所録へは追加するが読まない) を保証する接続を折衝することが可能である[[SHOULD:べきです]]。

#en
Delegation: It should be possible for one worker to spawn another
    worker and efficiently delagate a request to that worker, without the
    caller being aware of the delagate and without the original worker having
    to proxy all the messages.
#ja
委譲: ある労働者が別の労働者を生み出した上で、呼び出し元が委譲に気づかず、
かつ元の労働者がすべてのメッセージを仲介せずに、
元の労働者に対する要求を効率的に委譲することができる[[SHOULD:べきです]]。

#pattern
<span class=secno>* </span>Infrastructure
#ja
<span class=secno>$1 </span>基盤

#en
The <dfn id=url title=dom-WindowWorker-URL><code>URL</code></dfn>
   attribute must return the value it was assigned when the <code><a
   href="#windowworker">WindowWorker</a></code> object was created by the "<a
   href="#run-a">run a worker</a>" algorithm. It gives the <span>absolute
   URL</span> of the script that was used to initialize the worker.
#ja
<dfn id=url title=dom-WindowWorker-URL><code>URL</code></dfn>
属性は、 <code><a
   href="#windowworker">WindowWorker</a></code>
オブジェクトが「<a
   href="#run-a">労働者を走らせる</a>」算法で作成された時に割り当てられた値を返さなければ[[MUST:なりません]]。
その値は、労働者を初期化するために使用されたスクリプトの絶対 URL を表します。

#en
The <dfn id=name title=dom-WindowWorker-name><code>name</code></dfn>
   attribute must return the value it was assigned when the <code><a
   href="#windowworker">WindowWorker</a></code> object was created by the "<a
   href="#run-a">run a worker</a>" algorithm. If it has a value that isn't
   the empty string, its value represents the name that can be used to obtain
   a reference to the worker using the <code
   title=dom-WindowWorkerCreators-createNamedWorker><a
   href="#createnamedworker">createNamedWorker()</a></code> method.
#ja
<dfn id=name title=dom-windowworker-name><code>name</code></dfn>
属性は、<code><a
   href="#windowworker">WindowWorker</a></code> オブジェクトが「<a
   href="#run-a">労働者を走らせる</a>」算法で作成された時に割り当てられた値を返さなければ[[MUST:なりません]]。この値が空文字列でなければ、
その値は、 <code
   title=dom-WindowWorkerCreators-createNamedWorker><a
   href="#createnamedworker">createNamedWorker()</a></code>
メソッドを使って労働者への参照を得るために使うことができる名前を表します。

#en
The <dfn id=closing
   title=dom-windowworker-closing><code>closing</code></dfn> attribute must
   return false until the "<a href="#kill-a">kill a worker</a>" processing
   model defined below sets it to true.
#ja
<dfn id=closing
   title=dom-windowworker-closing><code>closing</code></dfn>
属性は、後述の「<a href="#kill-a">労働者を殺す</a>」処理モデルがこれを真に設定するまで、
偽を返さなければ[[MUST:なりません]]。

#en
The following are the <span>event handler DOM attributes</span> that
   must be supported by objects implementing the <code><a
   href="#windowworker">WindowWorker</a></code> interface:
#ja
次に示すのは、 <code><a
   href="#windowworker">WindowWorker</a></code>
界面を実装するオブジェクトが対応しなければ[[MUST:ならない]]事象取扱器 DOM 属性です。

#pattern
Must be invoked whenever a * event is targeted at or
     bubbles through the * object.
#ja
$1 事象が当該 $2 オブジェクトを対象としているか、泡立って当該オブジェクトを通過する時に、
呼び出されなければなりません。

#pattern
<span class=secno>* </span>The queue of events
#ja
<span class=secno>$1 </span>事象の待ち行列

#en
Each <code><a href="#windowworker">WindowWorker</a></code> object is
   asssociated with a <dfn id=queue>queue of events</dfn>, which is initially
   empty.
#ja
各 <code><a href="#windowworker">WindowWorker</a></code> オブジェクトは、
<dfn id=queue>事象の待ち行列</dfn> (はじめは空) と関連付けられています。

#en
An event in the queue can be a DOM event or a timeout callback.
#ja
待ち行列中の事象は、 DOM 事象か小休止呼び戻しのいずれかです。

#en
All asynchronous callbacks and events that would be called or dispatched
   in the worker must be added to the worker's queue, with the "<a
   href="#run-a">run a worker</a>" processing model below taking care of
   actually calling the callbacks or dispatching the events.
#ja
労働者中で呼び出しまたは発送されるすべての非同期の呼び戻しと事象は、
作業者の待ち行列に追加されなければなりません。
ただし、実際の呼び戻しの呼び出しや事象の発送は、後述の「<a
   href="#run-a">労働者を走らせる</a>」処理モデルに従い処理されます。

#en
Once the <code><a href="#windowworker">WindowWorker</a></code>'s <code
   title=dom-WindowWorker-closing><a href="#closing">closing</a></code>
   attribute is set to true, the queue must discard anything else that would
   be added to it. Effectively, once the <code
   title=dom-WindowWorker-closing><a href="#closing">closing</a></code>
   attribute is true, timers stop firing, notifications for all pending
   asynchronous operations are dropped, etc.
#ja
一旦 <code><a href="#windowworker">WindowWorker</a></code> の <code
   title=dom-windowworker-closing><a href="#closing">closing</a></code>
属性が真に設定されると、待ち行列は、以後追加されるべきものがあっても、
すべて捨てなければ[[MUST:なりません]]。実効的には、一旦 <code
   title=dom-windowworker-closing><a href="#closing">closing</a></code>
属性が真となると、タイマーが発火を停止したり、
すべての未決の非同期処理に関する通知は捨てられたりするようになるなどします。

#pattern
<span class=secno>* </span>The worker's ports
#ja
<span class=secno>$1 </span>労働者のポート

#en
Workers communicate with other workers and with <span title="browsing
   context">browsing contexts</span> through <span title="channel
   messaging">message channels</span> and their <code>MessagePort</code>
   objects.
#ja
労働者は、メッセージ通信路とその <code>MessagePort</code>
オブジェクトを通じて、他の労働者や閲覧文脈と通信します。

#en
Each <code><a href="#windowworker">WindowWorker</a></code> <var
   title="">worker</var> has a list of <dfn id=the-workers0>the worker's
   ports</dfn>, which consists of all the <code>MessagePort</code> objects
   that are entangled with another port and that have one (but only one) port
   whose <code title=dom-MessagePort-ownerWindow>ownerWindow</code> is <var
   title="">worker</var>. This list includes all the <code>MessagePort</code>
   objects that are in events pending in the <a href="#queue">queue of
   events</a>.
#ja
各 <code><a href="#windowworker">WindowWorker</a></code> <var
   title="">worker</var> は、<dfn id=the-workers0>労働者のポート</dfn>の並びを持ちます。
これは、他のポートと絡められており、かつ <code title=dom-MessagePort-ownerWindow>ownerWindow</code>
が <var
   title="">worker</var> であるポートを1つ (だけ) 持つような <code>MessagePort</code>
オブジェクトすべてを含むものです。この並びは<a href="#queue">事象の待ち行列</a>中で未決の事象中にある
<code>MessagePort</code> オブジェクトすべてを含みます。

#pattern
<span class=secno>* </span>Processing model
#ja
<span class=secno>$1 </span>処理モデル

#en
When a user agent is to <dfn id=run-a>run a worker</dfn> named <var
   title="">name</var> for a script with <span>URL</span> <var
   title="">url</var>, a browsing context <var title="">owner browsing
   context</var> and a <code>Document</code> <var title="">owner
   document</var>, it must run the following steps in a completely separate
   and parallel execution environment:
#ja
利用者エージェントが、<span>URL</span> <var
   title="">url</var>、閲覧文脈 <var title="">owner browsing
   context</var>、<code>Document</code> <var title="">owner
   document</var> のスクリプトに対する、 <var
   title="">name</var> と名付けられた<dfn id=run-a>労働者を走らせる</dfn>、
という時には、利用者エージェントは、次の段階を、完全に分離された並列実行環境で実行しなければ[[MUST:なりません]]。

#en
Attempt to <span>fetch</span><!-- XXX --> the resource identified by
     <var title="">url</var>.
#ja
<var title="">url</var> で識別される資源を取って来ようと試みます。

#en
If the attempt fails, then abort these steps and invoke the <a
     href="#worker" title="worker creation failed">error handling steps</a>
     defined by the algorithm that called this one.
#ja
この試みが失敗した場合、これらの段階を停止し、この段階を呼び出した算法が定義する<a
     href="#worker" title="worker creation failed">誤り取扱段階</a>を呼び出します。

#en
If the attempt succeeds, then let <var title="">script</var> be the
     resource that was obtained.
#ja
この試みが成功した場合、 <var title="">script</var>
を得られた資源とします。

#en
As with <code>script</code> elements, the MIME type of the
     script is ignored. Unlike with <code>script</code> elements, there is no
     way to override the type. It's always assumed to be JavaScript.
#ja
<code>script</code> 要素と同様に、スクリプトの MIME 型は無視します。
<code>script</code> 要素とは異なり、
型を上書きする方法はありません。スクリプトは常に JavaScript
と仮定します。

#en
Create a new <code><a href="#windowworker">WindowWorker</a></code>
     object, <var title="">window</var>.
#ja
新しい <code><a href="#windowworker">WindowWorker</a></code>
オブジェクト <var title="">window</var> を作成します。

#en
Set the <code title=dom-WindowWorker-URL><a href="#url">URL</a></code>
     attribute of <var title="">window</var> to the value of <var
     title="">url</var>.
#ja
<var title="">window</var> の
<code title=dom-WindowWorker-URL><a href="#url">URL</a></code>
属性を <var
     title="">url</var> の値に設定します。

#en
Set the <code title=dom-WindowWorker-name><a
     href="#name">name</a></code> attribute of <var title="">window</var> to
     the value of <var title="">name</var>.
#ja
<var title="">window</var> の <code title=dom-WindowWorker-name><a
     href="#name">name</a></code>
属性を <var title="">name</var> の値に設定します。

#en
Let <var title="">script</var>'s <span>script execution context</span>
     (and thus also <span>global object</span>) be <var
     title="">window</var>.
#ja
<var title="">script</var> のスクリプト実行文脈 (と大域オブジェクトも)
を <var
     title="">window</var> とします。

#en
Let <var title="">script</var>'s <span>script browsing context</span>
     be <var title="">owner browsing context</var>.
#ja
<var title="">script</var> のスクリプト閲覧文脈を <var title="">owner browsing context</var>
とします。

#en
Let <var title="">script</var>'s <span>script document context</span>

     be <var title="">owner document</var>.
#ja
<var title="">script</var> のスクリプト文書文脈を <var title="">owner document</var>
とします。

#en
Invoke the <a href="#success" title="worker creation
     succeeded">success steps</a> defined by the algorithm that called this
     one. (This will add an event to the <a href="#queue">queue of
     events</a>.)
#ja
この段階を呼び出す算法が定義する<a href="#success" title="worker creation
     succeeded">成功段階</a>を呼び出します。
(これは、<a href="#queue">事象の待ち行列</a>)
に事象を追加します。)

#en
Start monitoring <var title="">worker</var>, such that whenever the
     <var title="">window</var> object's <code
     title=dom-WindowWorker-closing><a href="#closing">closing</a></code>
     attribute is false and all <a href="#the-workers0">the worker's
     ports</a> have their <code title=dom-MessagePort-active>active</code>
     attributes set to false, the user agent suspends execution of script in
     that worker until such time as either the <code
     title=dom-WindowWorker-closing><a href="#closing">closing</a></code>
     attribute switches to true or one of the <code>MessagePort</code>
     objects in the list of <a href="#the-workers0">the worker's ports</a>
     has an <code title=dom-MessagePort-active>active</code> attribute with
     the value true.
#ja
<var title="">worker</var> の監視を開始し、
<var title="">window</var> オブジェクトの <code
     title=dom-WindowWorker-closing><a href="#closing">closing</a></code>
属性が偽で<a href="#the-workers0">労働者のポート</a>のすべてが 
<code title=dom-MessagePort-active>active</code>
属性が偽に設定されているという時には常に、利用者エージェントがスクリプトの実行を、 <code
     title=dom-WindowWorker-closing><a href="#closing">closing</a></code>
属性が真に切り替わるまでか または<a href="#the-workers0">労働者のポート</a>の並びのいずれか1つの
<code>MessagePort</code> オブジェクトの <code title=dom-MessagePort-active>active</code>
属性が値として真を持つようになるまでのいずれかの間、
一時停止するようにします。

#en
Start monitoring <var title="">worker</var>, such that as soon as the
     list of <a href="#the-workers0">the worker's ports</a> becomes empty,
     the <var title="">window</var> object's <code
     title=dom-WindowWorker-closing><a href="#closing">closing</a></code>
     attribute is set to true.
#ja
<var title="">worker</var> の監視を開始し、<a href="#the-workers0">労働者のポート</a>の並びが空になると即座に
<var title="">window</var> オブジェクトの <code
     title=dom-WindowWorker-closing><a href="#closing">closing</a></code>
属性が真に設定されるようにします。

#en
Run <var title="">script</var> until it either returns, fails to catch
     an exception, or gets prematurely aborted by the "<a href="#kill-a">kill
     a worker</a>" algorithm below.
#ja
<var title="">script</var> を、返るか、例外の捕獲に失敗するか、後述の「<a href="#kill-a">労働者を殺す</a>」算法により早々に停止させられるかのいずれかまで走らせます。

#en
If the script gets aborted by the "<a href="#kill-a">kill a
     worker</a>" algorithm, then that same algorithm will cause there to only
     be a single event in the <a href="#queue">queue of events</a> at the
     next step, namely the <code title=message-unload>unload</code> event.
     However, if the event is ignored then it will become true as soon as
     that port is garbage collected.
#ja
スクリプトが「<a href="#kill-a">労働者を殺す</a>」算法で停止させられる場合には、
その同じ算法が、次の段階で、<a href="#queue">事象の待ち行列</a>には唯一
<code title=message-unload>unload</code> 事象だけが含まれるようにします。
しかし、この事象が無視された場合には、これは、ポートがごみ収集される際に真となります。

#en
<i>Event loop</i>: Wait until either there is an event in the <a
     href="#queue">queue of events</a> associated with <var
     title="">window</var> or the <var title="">window</var> object's <code
     title=dom-WindowWorker-closing><a href="#closing">closing</a></code>
     attribute is set to true.
#ja
<i>事象ループ</i>: <var
     title="">window</var> に関連付けられた<a
     href="#queue">事象の待ち行列</a>に事象が存在するようになるか、または 
<var title="">window</var> オブジェクトの <code
     title=dom-WindowWorker-closing><a href="#closing">closing</a></code>
属性が真に設定されるまで待ちます。

#en
Dispatch the oldest event or callback in the <a href="#queue">queue of
     events</a>, if any. The handling of this event or the execution of this
     callback might get prematurely aborted by the "<a href="#kill-a">kill a
     worker</a>" algorithm below.
#ja
<a href="#queue">事象の待ち行列</a>中で最古の事象か呼び戻しがあれば、
これを発送します。この事象の取扱いや呼び戻しの実行は、後述の「<a href="#kill-a">労働者を殺す</a>」
算法により、早々に停止させられるかもしれません。

#en
If there are any more events in the <a href="#queue">queue of
     events</a> or if the <var title="">window</var> object's <code
     title=dom-WindowWorker-closing><a href="#closing">closing</a></code>
     attribute is set to false, then jump back to the step above labeled
     <i>event loop</i>.
#ja
<a href="#queue">事象の待ち行列</a>中に更に事象が存在する場合、
または <var title="">window</var> オブジェクトの <code
     title=dom-WindowWorker-closing><a href="#closing">closing</a></code>
属性が偽に設定されている場合、前述の<i>事象ループ</i>との名札のある段階に飛んで戻ります。

#en
timers, intervals, XMLHttpRequests, database
     transactions, etc, must be killed; ports must be deactivated and
     unentangled (do not send unload)
#ja
タイマー、休憩、 XMLHttpRequest、データベース取引、その他を殺さなければ[[MUST:なりません]]。
ポートを非活性化し、ほどかなければ[[MUST:なりません]] (unload を送りません)。

#en
When a user agent is to <dfn id=kill-a>kill a worker</dfn>, it must run
   the following steps in parallel with the worker's main loop (the "<a
   href="#run-a">run a worker</a>" processing model defined above):
#ja
利用者エージェントが<dfn id=kill-a>労働者を殺す</dfn>という時には、
利用者エージェントは、次の段階を労働者の主たるループ (先に定義した「<a
   href="#run-a">労働者を走らせる</a>」処理モデル) と並列に走らせなければ[[MUST:なりません]]。

#en
Create an <code>Event</code> object with the event name <code
     title=event-unload>unload</code>, which does not bubble and is not
     cancelable, and add it to the worker's <code><a
     href="#windowworker">WindowWorker</a></code> object's <a
     href="#queue">queue of events</a>, targetted at the <code><a
     href="#windowworker">WindowWorker</a></code> object itself.
#ja
事象名が <code
     title=event-unload>unload</code> であり、
泡立たず、取消可能ではない
<code>Event</code> オブジェクトを作成し、労働者の <code><a
     href="#windowworker">WindowWorker</a></code>
オブジェクトの<a
     href="#queue">事象の待ち行列</a>に追加し、 <code><a
     href="#windowworker">WindowWorker</a></code>
オブジェクト自体を対象とします。

#en
Set the worker's <code><a href="#windowworker">WindowWorker</a></code>
     object's <code title=dom-WindowWorker-closing><a
     href="#closing">closing</a></code> attribute to true.
#ja
労働者の <code><a href="#windowworker">WindowWorker</a></code>
オブジェクトの 
<code title=dom-WindowWorker-closing><a
     href="#closing">closing</a></code> 
属性を真に設定します。

#en
Wait a user-agent-defined amount of time. If the "<a href="#run-a">run
     a worker</a>" processing model defined above immediately starts running
     event listeners registered for <code title=event-unload>unload</code>
     event, this time should not be zero &mdash; the idea is that the <code
     title=event-unload>unload</code> event can be used to clean up when
     shutting down unexpectedly.
#ja
利用者エージェント定義の時間、待ちます。先に定義した「<a href="#run-a">労働者を走らせる</a>」
処理モデルが <code title=event-unload>unload</code>
事象に登録された事象聴取器を即座に走らせ始める場合には、この時間は零である[[SHOULD NOT:べきではありません]]。
というのは、予期せず停止させる時に浄化するために <code
     title=event-unload>unload</code> 事象を使えるようにするのが目的だからです。

#en
If there are any events in the <a href="#queue">queue of events</a>
     other than the <code title=event-unload>unload</code> event that this
     algorithm just added, discard them without dispatching them.
#ja
<a href="#queue">事象の待ち行列</a>中にこの算法が追加した 
<code title=event-unload>unload</code>
事象以外の事象が存在する場合には、それらを発送せずに捨てます。

#en
If the <code title=event-unload>unload</code> event that this
     algorithm just added hasn't yet been dispatched, then abort the script
     currently running in the worker.
#ja
この算法が追加した <code title=event-unload>unload</code>
事象がまだ発送されていなければ、現在労働者中で走っているスクリプトを停止します。

#en
Wait a user-agent-defined amount of time.
#ja
利用者エージェント定義の時間、待ちます。

#en
Abort the script currently running in the worker (if any script is
     running, then it will be a handler for the <code
     title=event-unload>unload</code> event).
#ja
現在労働者中で走っているスクリプト (スクリプトが走っているとすると、
これは <code
     title=event-unload>unload</code>
事象の取扱器です。) を停止します。

#en
When a script invokes the <dfn id=close
   title=dom-WindowWorker-close><code>close()</code></dfn> method on a
   <code><a href="#windowworker">WindowWorker</a></code> object, the user
   agent must run the following steps:
#ja
スクリプトが <code><a href="#windowworker">WindowWorker</a></code> 
オブジェクトで <dfn id=close
   title=dom-WindowWorker-close><code>close()</code></dfn>
メソッドを呼び出した場合、利用者エージェントは、次の段階を走らせなければ[[MUST:なりません]]。
