html5/spec-ja/workers-non-normative.ja.html.u8


<html lang=en-US-x-hixie>
 <head>
  <title>Web Workers</title>
  <link href="http://www.whatwg.org/style/specification" rel=stylesheet>
<!-- Japanese-translation-only style rules -->
<style>
  em {
    text-decoration: underline;
  }
  ins.ja-note {
    background-color: #EEFFFF;
    color: black;
  }
</style>
  <link href="http://www.whatwg.org/images/icon" rel=icon>

 <body class=draft>
  <div class=head>
   <p><span class=ja-translation lang=ja><a class=logo href="http://www.whatwg.org/" rel=home><img lang=en alt=WHATWG
    src="http://www.whatwg.org/images/logo"></a></span></p>

   <h1 id=web-workers>Web Workers</h1>

   <h2 class="no-num no-toc" id=draft><span class=ja-translation lang=ja>勧告案<ins class=ja-note>の非公式和訳</ins> &mdash; 
<ins class=ja-note>(原文出版日)</ins> 2008年7月16日</span></h2>

   <p><span class=ja-translation lang=ja>みなさんにも作業にご参加いただけます。 <a
    href="http://www.whatwg.org/mailing-list">作業部会の議論用メイリング・リストに参加してください。</a></span></p>

   <p><span class=ja-translation lang=ja><strong>Web デザイナー!</strong> みなさんのための <a
    href="http://blog.whatwg.org/faq/" lang=en>FAQ</a>、<a
    href="http://forums.whatwg.org/">掲示板</a>、<a
    href="http://www.whatwg.org/mailing-list#help">ヘルプ用メイリング・リスト</a>があります!

</span><p>

<!-- Japanese-translation-only notes -->
<ins class=ja-note style="display: block" lang=ja>
<p>この文書は、 WHATWG HTML5 仕様書の日本語訳です。
HTML5 の正式な仕様書は英語版だけであり、
この日本語訳はあくまで参考としてご利用ください。

<p lang=en>This document is a Japanese translation of
the WHATWG HTML5 specification.  Note that the only normative specification
for the HTML5 is the original English version and this Japanese
translation is non‐normative.

<p>日本語訳は <a href="edit/" rel=edit>Web 界面</a>を使って編集できます。
編集結果はおよそ3時間おきに反映されます。
また、原文の変更には毎日自動的に追随しています。

<p lang=en>The Japanese text can be edited using the <a href="edit/" rel=edit>Web
interface</a>.  Any modifications will be reflected to this translation
in about three hours.  Note that any changes to the original specification
will automatically be incorporated to this translation every day.
</ins>

<p><span><!-- dummy --></span></p>

   <dl>
    <dt><span class=ja-translation lang=ja><ins class=ja-note>原文の</ins>この版</span><dd><a
     href="http://www.whatwg.org/specs/web-workers/current-work/">http://www.whatwg.org/specs/web-workers/current-work/</a>

    <dt><span class=ja-translation lang=ja><ins class=ja-note>原文の</ins>改版履歴:</span><dd><span class=ja-translation lang=ja><span lang=en>Twitter</span> メッセージ (編集上の変更以外): <a
     href="http://twitter.com/WHATWG">http://twitter.com/WHATWG</a></span><dd>Commit-Watchers mailing list: <a
     href="http://lists.whatwg.org/listinfo.cgi/commit-watchers-whatwg.org">http://lists.whatwg.org/listinfo.cgi/commit-watchers-whatwg.org</a>

    <dd><span class=ja-translation lang=ja>対話的 <span lang=en>Web</span> 界面: <a href="http://html5.org/tools/web-workers-tracker">http://html5.org/tools/web-workers-tracker</a></span><dd><span class=ja-translation lang=ja><span lang=en>Subversion</span> 界面: <a href="http://svn.whatwg.org/webworkers/">http://svn.whatwg.org/webworkers/</a></span><dt><span class=ja-translation lang=ja>問題:</span><dd><span class=ja-translation lang=ja>フィードバックの送信先: <a
     href="http://www.whatwg.org/mailing-list">[email protected]</a></span><dd><span class=ja-translation lang=ja>フィードバックの閲覧・投票: <a
     href="http://www.whatwg.org/issues/">http://www.whatwg.org/issues/</a></span><dt><span class=ja-translation lang=ja>編集者:</span><dd>Ian Hickson, Google, [email protected]
   </dl>

   <p class=copyright>&copy; Copyright 2004-2008 Apple Computer, Inc.,
    Mozilla Foundation, and Opera Software ASA.</p>

   <p class=copyright>You are granted a license to use, reproduce and create
    derivative works of this document.</p>
  </div>

  <hr>

  <h2 class="no-num no-toc" id=abstract><span class=ja-translation lang=ja>概要</span></h2>

  <p><span class=ja-translation lang=ja>この仕様書は、 Web アプリケーションで主たる頁と並列に背景労働者スクリプトを動作させることを可能とする
API を定義します。
これによって、メッセージ・パッシングによるスレッド的操作を協調機構として利用できるようになります。</span><h2 class="no-num no-toc" id=status><span class=ja-translation lang=ja>この文書の状態</span></h2>

  <p><span class=ja-translation lang=ja><strong>この文書は作業中です!</strong>
この文書は、コメントへの対応や通常の開発の過程として、
毎時毎分とは言い過ぎですが毎日のペースで変更されています。
コメントは非常に歓迎していますので、
<a href="mailto:[email protected]">[email protected]</a>
へお送りください。よろしくお願いします。</span><p><span class=ja-translation lang=ja>現在の焦点は、第1案の開発です。</span><p><span class=ja-translation lang=ja>実装者は、この仕様書が安定していないことに注意するべきです。
<strong>実装者は議論に参加しておかないと、
仕様がその実装とは非互換に変更されてしまうかもしれません。</strong>
この仕様書がいずれ実装呼び掛けの段階に達するのよりも前にこの仕様を実装したい販売者は、
<a href="http://www.whatwg.org/mailing-list">WHATWG メイリング・リスト</a>に参加し、
議論に加わるべきです。</span><p><span class=ja-translation lang=ja>この仕様書は <a
   href="http://www.w3.org/html/wg">W3C HTML WG</a>
によっても出版されています。2つの仕様書の目次以降は同一です。</span><h2 class="no-num no-toc" id=contents><span class=ja-translation lang=ja>目次
</span></h2>
  <!--begin-toc-->

  <ul class=toc>
   <li><a href="#introduction"><span class=secno>1. </span>Introduction</a>
    <ul class=toc>
     <li><a href="#tutorial"><span class=secno>1.1 </span>Tutorial</a>

     <li><a href="#requirements"><span class=secno>1.2
      </span>Requirements</a>

     <li><a href="#conformance"><span class=secno>1.3 </span>Conformance
      requirements</a>
      <ul class=toc>
       <li><a href="#dependencies"><span class=secno>1.3.1
        </span>Dependencies</a>
      </ul>

     <li><a href="#terminology"><span class=secno>1.4 </span>Terminology</a>
    </ul>

   <li><a href="#inside"><span class=secno>2. </span>Inside workers</a>
    <ul class=toc>
     <li><a href="#the-windowworker"><span class=secno>2.1 </span>The
      <code>WindowWorker</code> interface</a>

     <li><a href="#the-queue"><span class=secno>2.2 </span>The queue of
      events</a>

     <li><a href="#processing"><span class=secno>2.3 </span>Processing
      model</a>
    </ul>

   <li><a href="#creating"><span class=secno>3. </span>Creating workers</a>
    <ul class=toc>
     <li><a href="#the-windowworkercreators"><span class=secno>3.1 </span>The
      <code>WindowWorkerCreators</code> interface</a>
    </ul>

   <li class=no-num><a href="#references">References</a>

   <li class=no-num><a href="#acknowledgements">Acknowledgements</a>
  </ul>
  <!--end-toc-->

  <hr>

  <h2 id=introduction><span class=ja-translation lang=ja><span class=secno>1. </span>はじめに</span></h2>

  <h3 id=tutorial><span class=secno>1.1 </span>Tutorial</h3>

  <p><span class=ja-translation lang=ja><em>この節は規定の一部ではありません。</em></span><p class=big-issue>This section is missing.

  <h3 id=requirements><span class=ja-translation lang=ja><span class=secno>1.2 </span>要件</span></h3>

  <p><span class=ja-translation lang=ja><em>この節は規定の一部ではありません。</em></span><p><span class=ja-translation lang=ja>この仕様書は、次に示す利用事例と要件に取り組むことを目指します。</span><ul>
   <li><span class=ja-translation lang=ja>背景労働者: Web アプリケーションは、そのデータを鯖と同期しておく必要があります。
これは、鯖への更新の送信と鯖からの更新の両方を含み、
アプリケーションがオフラインとなった時の更新のバッファリングの取扱いも含みます。
そのための符号は利用者界面の符号とは独立しているのが理想でしょう。</span><li><span class=ja-translation lang=ja>URL: 労働者は、文字列からではなく、 URL から生み出される<em class=rfc2119 title="SHOULD">べきです</em>。
スクリプトはその出典へのアクセスを滅多に有しないからです。</span><li><span class=ja-translation lang=ja>メッセージ・キューイング: 労働者が初期化される前に送信されたメッセージが失われるべきでは<em class=rfc2119 title="SHOULD NOT">ありません</em>。</span><li><span class=ja-translation lang=ja>労働者はタイマーへのアクセスを有する<em class=rfc2119 title="SHOULD">べきです</em>。</span><li><span class=ja-translation lang=ja>労働者はネットワークへのアクセスを有する<em class=rfc2119 title="SHOULD">べきです</em>。</span><li><span class=ja-translation lang=ja>労働者はライブラリを使える<em class=rfc2119 title="SHOULD">べきです</em>。</span><li><span class=ja-translation lang=ja>実装は労働者に <code>Node</code> オブジェクトや
    <code>Document</code> オブジェクトを晒さなければならない<em class=rfc2119 title="SHOULD NOT">べきではありません</em>。</span><li><span class=ja-translation lang=ja>労働者は外界と何も共有する<em class=rfc2119 title="SHOULD NOT">べきではありません</em>。
例えば、労働者自体の中で労働者を現すオブジェクトと労働者を作成した文脈で労働者を表すオブジェクトは異なる<em class=rfc2119 title="SHOULD">べきです</em>。</span><li><span class=ja-translation lang=ja>共有労働者: 同じ Web アプリケーションの複数の実現値は鯖に対する接続を1つだけ維持したいでしょう。</span><li><span class=ja-translation lang=ja>能力保証: ある iframe で動作している符号が他の iframe と何らかの権限 (例えば、
住所録へは追加するが読まない) を保証する接続を折衝することが可能である<em class=rfc2119 title="SHOULD">べきです</em>。</span><li><span class=ja-translation lang=ja>委譲: ある労働者が別の労働者を生み出し、呼び出し元が委譲に気づかず、
かつ元の労働者がすべてのメッセージを仲介せずに、
当該労働者に対する要求を効率的に委譲できる<em class=rfc2119 title="SHOULD">べきです</em>。</span><li><span class=ja-translation lang=ja>親が有用ではなくなった労働者は殺される<em class=rfc2119 title="SHOULD">べきです</em>。
労働者はこれが起こることを検知して華麗に終了することができる<em class=rfc2119 title="SHOULD">べきです</em>。</span></ul>

  <h3 id=conformance><span class=ja-translation lang=ja><span class=secno>1.3 </span>適合性要件</span></h3>

  <p><span class=ja-translation lang=ja>この仕様書のすべての図、例、注意書きは、
規定の一部ではないと明記された節すべてと同様に、
規定の一部ではありません。
この仕様書のそれ以外のすべては規定の一部です。</span><p><span class=ja-translation lang=ja>この文書の規定の部分にあるキーワード「<em class=rfc2119 title="MUST">しなければなりません</em>」、
「<em class=rfc2119 title="MUST NOT">してはなりません</em>」、
「<em class=rfc2119 title="REQUIRED">必須です</em>」、「<em class=rfc2119 title="SHOULD">するべきです</em>」、
「<em class=rfc2119 title="SHOULD NOT">するべきではありません</em>」、
「<em class=rfc2119 title="RECOMMENDED">推奨します</em>」、「<em class=rfc2119 title="MAY">して構いません</em>」、
「<em class=rfc2119 title="OPTIONAL">任意です</em>」は、 RFC 2119 で説明されているように解釈します。
可読性の観点から、この仕様書<ins class=ja-note>の原文</ins>では、
これらの語<ins class=ja-note>の原語</ins>はすべて大文字では表記しません。
<a href="#refsRFC2119">[RFC2119]</a></span></p>
  <!-- XXX but they should be
  marked up -->

  <p><span class=ja-translation lang=ja>算法の一部として<ins class=ja-note>動作の指示の形で (原文では</ins>命令形で<ins class=ja-note>) </ins>記述された要件
(例えば「先頭の間隔文字をすべて除去します」や「偽を返し、これらの段階を停止します」)
は、算法の紹介で使われたキーワード (<em class=rfc2119 title="MUST">しなければなりません</em>、
<em class=rfc2119 title="SHOULD">するべきです</em>、<em class=rfc2119 title="MAY">して構いません</em>など) の意味により解釈します。</span><p><span class=ja-translation lang=ja>いくつかの適合性要件は属性やメソッドやオブジェクトの要件として説明されています。
そのような要件は、利用者エージェントに関する要件として解釈します。</span><p><span class=ja-translation lang=ja>算法や特定の段階として説明されている適合性要件は、
最終的な結果が等価である限り、任意の方法で実装して<em class=rfc2119 title="MAY">構いません</em>。
(特に、この仕様書で定義されている算法は追うのを簡単にしており、
高性能であることを目指してはいません。)</span><p><span class=ja-translation lang=ja>この仕様書で定義される適合性の級は、利用者エージェントのみです。</span><p><span class=ja-translation lang=ja>利用者エージェントは、サービス拒否攻撃を防ぐため、
記憶容量を使い尽くすことを防ぐため、
あるいは環境特有の制限に対応するためなどの目的で、
別段の制約のない入力に対して実装特有の制限を設けて<em class=rfc2119 title="MAY">構いません</em>。</span><h4 id=dependencies><span class=ja-translation lang=ja><span class=secno>1.3.1 </span>依存性</span></h4>

  <p><span class=ja-translation lang=ja>この仕様書は他のいくつかの下位仕様書に依存しています。</span><dl>
   <dt>HTML5

   <dd>
    <p><span class=ja-translation lang=ja>HTML5 の多くの基礎的な概念をこの仕様書で使用します。
<a href="#refsHTML5">[HTML5]</a></span></p>

   <dt>ECMAScript

   <dd>
    <p><span class=ja-translation lang=ja>この仕様書はスクリプト言語として JavaScript
を使うことを想定しています。 <a href="#refsJS">[JS]</a></span></p>

   <dt>WebIDL

   <dd>
    <p><span class=ja-translation lang=ja>この仕様書の IDL ブロックは WebIDL 仕様書における意味を用います。 <a href="#refsWebIDL">[WebIDL]</a></span></p>
  </dl>

  <h3 id=terminology><span class=ja-translation lang=ja><span class=secno>1.4 </span>用語</span></h3>

  <p><span class=ja-translation lang=ja>簡単のため、<em>示す</em>、<em>表示する</em>、
<em>可視</em>などの用語を文書が利用者に対してレンダリングされる方法に言及する時に使うことがあります。
これらの語は視覚媒体を暗示することを意図していません。
これらの語は他の媒体にも等価な方法で適用されると考えなければ<em class=rfc2119 title="MUST">なりません</em>。</span><p>The construction "a <code title="">Foo</code> object", where <code
   title="">Foo</code> is actually an interface, is sometimes used instead of
   the more accurate "an object implementing the interface <code
   title="">Foo</code>".

  <p><span class=ja-translation lang=ja>DOM という語は、 Web アプリケーションでスクリプトに利用可能とされている API
の集合を指して用い、必ずしも DOM 中核仕様書で定義されている実際の 
<code>Document</code> オブジェクトその他の <code>Node</code>
オブジェクトの存在を暗示してはいません。<a
   href="#refsDOM3CORE">[DOM3CORE]</a></span><p><span class=ja-translation lang=ja>DOM 属性は、その値が (例えば著者のスクリプトにより) 取り出される時<em>取得される</em>といい、
新しい値がその属性に割り当てられる時<em>設定される</em>といいます。</span><p><span class=ja-translation lang=ja>DOM オブジェクトが<dfn id=live>生きている</dfn>という場合、
そのオブジェクトを返す属性は常に同じオブジェクトを返さなければ<em class=rfc2119 title="MUST">ならない</em>
(毎回新しいオブジェクトを返すのではなく) 上に、
そのオブジェクトの属性やメソッドがそのオブジェクトの裏にある実際のデータのスナップ写真ではなく、
データそのものに対して操作されなければ<em class=rfc2119 title="MUST">ならない</em>ことを意味します。</span><h2 id=inside><span class=secno>2. </span>Inside workers</h2>

  <h3 id=the-windowworker><span class=secno>2.1 </span>The <code><a
   href="#windowworker">WindowWorker</a></code> interface</h3>

  <pre
   class=idl>[NoInterfaceObject] interface <dfn id=windowworker>WindowWorker</dfn> {
  readonly attribute boolean <a href="#name" title=dom-windowworker-name>name</a>;
  readonly attribute boolean <a href="#closing" title=dom-windowworker-closing>closing</a>;
};</pre>

  <p>Objects that implement the <code><a
   href="#windowworker">WindowWorker</a></code> interface must also implement
   the <code>Window</code> interface (and thus also the
   <code>WindowTimers</code> and <code><a
   href="#windowworkercreators">WindowWorkerCreators</a></code> interfaces)
   and the <code>EventTarget</code> interface.

  <p>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.

  <p>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 false.

  <h3 id=the-queue><span class=secno>2.2 </span>The queue of events</h3>

  <p>Each <code><a href="#windowworker">WindowWorker</a></code> object is
   asssociated with a <dfn id=queue>queue of events</dfn>, which is initially
   empty.

  <p>An event in the queue can be a DOM event or a timeout callback.

  <h3 id=processing><span class=secno>2.3 </span>Processing model</h3>

  <p>When a user agent is to <dfn id=run-a>run a worker</dfn> named <var
   title="">name</var> for a script <var title="">script</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:

  <ol>
   <li>
    <p>Create a new <code><a href="#windowworker">WindowWorker</a></code>
     object, <var title="">window</var>.</p>

   <li>
    <p>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>.</p>

   <li>
    <p>Let <var title="">script</var>'s <span>script execution context</span>
     (and thus also <span>global object</span>) be <var
     title="">window</var>.</p>

   <li>
    <p>Let <var title="">script</var>'s <span>script browsing context</span>
     be <var title="">owner browsing context</var>.</p>

   <li>
    <p>Let <var title="">script</var>'s <span>script document context</span>
     be <var title="">owner document</var>.</p>

   <li>
    <p>Run <var title="">script</var> until it returns.</p>

   <li>
    <p><i>Event loop</i>: Wait until there is an event in the <a
     href="#queue">queue of events</a> associated with <var
     title="">window</var>.</p>

   <li>
    <p>Dispatch the oldest event or callback in the <a href="#queue">queue of
     events</a>. Events must be targetted at the <code><a
     href="#windowworker">WindowWorker</a></code> object.</p>

   <li>
    <p>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>.</p>

   <li>
    <p class=big-issue>timers, intervals, XMLHttpRequests, database
     transactions, etc, must be killed; ports must be deactivated and
     unentangled</p>
  </ol>

  <hr>

  <p>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):

  <ol>
   <li>
    <p>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.

   <li>
    <p>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>.

   <li>
    <p>Wait a user-agent-defined amount of time.

   <li>
    <p>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.

   <li>
    <p>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.

   <li>
    <p>Wait a user-agent-defined amount of time.

   <li>
    <p>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).
  </ol>

  <h2 id=creating><span class=secno>3. </span>Creating workers</h2>

  <h3 id=the-windowworkercreators><span class=secno>3.1 </span>The <code><a
   href="#windowworkercreators">WindowWorkerCreators</a></code> interface</h3>

  <pre
   class=idl>[NoInterfaceObject] interface <dfn id=windowworkercreators>WindowWorkerCreators</dfn> {
  <span>MessagePort</span> <span title=dom-WindowWorkerCreators-createWorker>createWorker</span>(in DOMString scriptURI);
  <span>MessagePort</span> <span title=dom-WindowWorkerCreators-createNamedWorker>createNamedWorker</span>(in DOMString name, in DOMString scriptURI);
};</pre>

  <p>Objects that implement the <code>Window</code> interface must also
   implement the <code><a
   href="#windowworkercreators">WindowWorkerCreators</a></code> interface.

  <p class=big-issue>...

  <h2 class=no-num id=references><span class=ja-translation lang=ja>参考文献</span></h2>

  <p class=big-issue><span class=ja-translation lang=ja>この章は将来の仕様案で執筆します。</span><h2 class=no-num id=acknowledgements><span class=ja-translation lang=ja>謝辞</span></h2>
  <!-- ACKS -->

  <p><span class=ja-translation lang=ja>Maciej Stachowiak, Mike Smith の有用かつ重要なコメントに感謝します。</span><p>Huge thanks to the whole Gears team, who pioneered this technology and
   whose experience has been a huge influence on this specification.