/[suikacvs]/markup/html/html5/spec-ja/workers-non-normative.ja.html.u8
Suika

Contents of /markup/html/html5/spec-ja/workers-non-normative.ja.html.u8

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.46 - (hide annotations) (download)
Tue Dec 16 06:19:04 2008 UTC (17 years, 7 months ago) by wakaba
Branch: MAIN
Changes since 1.45: +200 -256 lines
make

1 wakaba 1.1
2     <html lang=en-US-x-hixie>
3     <head>
4     <title>Web Workers</title>
5 wakaba 1.32 <link href=http://www.whatwg.org/style/specification rel=stylesheet>
6     <link href=ja-style rel=stylesheet>
7     <link href=only-ja-style rel="stylesheet" title="Show only Japanese text" id=style-only-ja>
8     <link href=both-en-ja-style rel="alternate stylesheet" title="Show both English and Japanese texts" id=style-both-en-ja>
9 wakaba 1.35 <script src=ja-script defer async></script>
10 wakaba 1.31 <link href="/images/icon" rel=icon>
11 wakaba 1.1
12 wakaba 1.16 <style>
13     p > span:not([title=""]):not([class="big-issue"]), li > span:not([title=""]):not([class="big-issue"]) { border-bottom: solid #99CC99; }
14     </style>
15    
16 wakaba 1.1 <body class=draft>
17     <div class=head>
18 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="b20329e0f615f58f17900e708fa8dbaf"><span class=en-original lang=en><a class=logo href="http://www.whatwg.org/" rel=home><img alt=WHATWG
19     src="/images/logo"></a></span></p>
20 wakaba 1.1
21 wakaba 1.42 <h1 class="no-ja-translation" data-ja-hash="6cb7eb9696d986359fa3a78c4b8e60dc"><span class=en-original lang=en>Web Workers</span></h1>
22 wakaba 1.1
23 wakaba 1.46 <h2 class="no-num no-toc has-ja-translation" data-ja-hash="8a7847394b9b718bd84c2d29d478640c" data-ja-real-hash="0c710f81c51332c8ed239f1a12ef5d86" id=draft><span class=en-original lang=en>Draft Recommendation &mdash; 16
24     December 2008</span><span class=ja-translation lang=ja>勧告案<ins class=ja-note>の非公式和訳</ins> &mdash;
25     <ins class=ja-note>(原文出版日)</ins> 16 December 2008</span></h2>
26 wakaba 1.1
27 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="54759c46800b2712dd15f6097ee6ed63"><span class=en-original lang=en>You can take part in this work. <a
28 wakaba 1.31 href="http://www.whatwg.org/mailing-list">Join the working group's
29 wakaba 1.36 discussion list.</a></span></p>
30 wakaba 1.31
31 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="6a0ea97471522df19cf042a8869d7c52"><span class=en-original lang=en><strong>Web designers!</strong> We have a <a
32 wakaba 1.31 href="http://blog.whatwg.org/faq/">FAQ</a>, a <a
33     href="http://forums.whatwg.org/">forum</a>, and a <a
34     href="http://www.whatwg.org/mailing-list#help">help mailing list</a> for
35 wakaba 1.33 you!</span><span class=ja-translation lang=ja><strong>Web デザイナーのみなさん!</strong> みなさんのための <a
36 wakaba 1.32 href=http://blog.whatwg.org/faq/ lang=en>FAQ</a>、<a
37     href=http://forums.whatwg.org/>掲示板</a>、<a
38     href=http://www.whatwg.org/mailing-list#help>ヘルプ用メイリング・リスト</a>があります!
39    
40     </span><p>
41    
42     <!-- Japanese-translation-only notes -->
43 wakaba 1.33 <ins class="ja-note cover-ja-note" lang=ja>
44 wakaba 1.38 <p>この文書は、 WHATWG 仕様書の日本語訳です。 正式な仕様書は英語版だけであり、この日本語訳はあくまで参考としてご利用ください。
45 wakaba 1.32
46 wakaba 1.38 <p lang=en>This document is a non-normative Japanese translation of the WHATWG specification. Only the original English version is normative and this Japanese translation is non‐normative.
47 wakaba 1.32
48 wakaba 1.38 <p>日本語訳は段落をダブルクリックすると編集できます。編集結果はおよそ3時間おきに反映されます。また、原文の変更には毎日自動的に追随しています。 (<a href=notes>詳細</a>)
49 wakaba 1.32
50 wakaba 1.38 <p lang=en>You can edit Japanese text by double-clicking the paragraph you'd like to edit. Any additions of and modifications to Japanese text will be applied to the document within about three hours. Any changes to the original English specification will automatically be incorporated to the document every day. (<a href=notes>Details</a>)
51 wakaba 1.32
52     <p><button type=button onclick="
53     document.getElementById ('style-only-ja').disabled = false;
54     document.getElementById ('style-both-en-ja').disabled = true;
55 wakaba 1.33 ">日本語訳だけ表示 <span lang=en>Show only Japanese translation</span></button>
56 wakaba 1.32 <p><button type=button onclick="
57     document.getElementById ('style-only-ja').disabled = true;
58     document.getElementById ('style-both-en-ja').disabled = false;
59 wakaba 1.33 ">英和対訳表示 <span lang=en>Show both English and Japanese texts</span></button>
60 wakaba 1.38
61     <p class=XXX>原文が更新されて新しい仕様書生成スクリプトを使うようになるまで、
62     この仕様書の訳文の追加・改訂はお控えください。
63 wakaba 1.32 </ins>
64    
65     <p><span><!-- dummy --></span></p>
66 wakaba 1.1
67     <dl>
68 wakaba 1.36 <dt class="has-ja-translation" data-ja-hash="87b044fafc6f01197a9a700e6fa28a69"><span class=en-original lang=en>This version:
69 wakaba 1.32
70 wakaba 1.36 </span><span class=ja-translation lang=ja><ins class=ja-note>原文の</ins>この版</span><dd class="no-ja-translation" data-ja-hash="a713841c83aed89ce71b7ee6b51cb2cb"><span class=en-original lang=en><a
71 wakaba 1.13 href="http://www.whatwg.org/specs/web-workers/current-work/">http://whatwg.org/ww</a>
72 wakaba 1.1
73 wakaba 1.36 </span><dt class="has-ja-translation" data-ja-hash="8866e8de2efa7275a5dc8e942c1613c2"><span class=en-original lang=en>Version history:
74 wakaba 1.32
75 wakaba 1.36 </span><span class=ja-translation lang=ja><ins class=ja-note>原文の</ins>改版履歴:</span><dd class="no-ja-translation" data-ja-hash="609cec19ff8d697eb0a9f7a0104e0bfb"><span class=en-original lang=en>Twitter messages (non-editorial changes only): <a
76 wakaba 1.31 href="http://twitter.com/WHATWG">http://twitter.com/WHATWG</a>
77    
78 wakaba 1.36 </span><dd class="no-ja-translation" data-ja-hash="abaab2a9b4d1bd0f43a2293e5d1fff4d"><span class=en-original lang=en>Commit-Watchers mailing list: <a
79 wakaba 1.31 href="http://lists.whatwg.org/listinfo.cgi/commit-watchers-whatwg.org">http://lists.whatwg.org/listinfo.cgi/commit-watchers-whatwg.org</a>
80    
81 wakaba 1.36 </span><dd class="has-ja-translation" data-ja-hash="5e1dbca74cface6f0d0ea523340e6a89" data-ja-real-hash="f82128f124c19a67cc2104420cc99c45"><span class=en-original lang=en>Interactive Web interface: <a
82 wakaba 1.32 href="http://html5.org/tools/web-workers-tracker">http://html5.org/tools/web-workers-tracker</a>
83    
84 wakaba 1.36 </span><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 class="has-ja-translation" data-ja-hash="ea5cbdd06bfb529e4a1bcfeac9cfbd61" data-ja-real-hash="ae455a827d3d1e5b15fd14df54502cf5"><span class=en-original lang=en>Subversion interface: <a
85 wakaba 1.32 href="http://svn.whatwg.org/webworkers/">http://svn.whatwg.org/webworkers/</a>
86    
87 wakaba 1.36 </span><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 class="has-ja-translation" data-ja-hash="8468b55db22971120cb71091ece7839e"><span class=en-original lang=en>Issues:
88 wakaba 1.32
89 wakaba 1.36 </span><span class=ja-translation lang=ja>問題:</span><dd class="no-ja-translation" data-ja-hash="72b4306377796146b832d635c9b791f4"><span class=en-original lang=en>To send feedback: <a
90 wakaba 1.31 href="http://www.whatwg.org/mailing-list">[email protected]</a>
91    
92 wakaba 1.36 </span><dd class="no-ja-translation" data-ja-hash="7e3aaf1187bd798f9f71dd7e6e4fa9fe"><span class=en-original lang=en>To view and vote on feedback: <a
93 wakaba 1.31 href="http://www.whatwg.org/issues/">http://www.whatwg.org/issues/</a>
94    
95 wakaba 1.36 </span><dt class="has-ja-translation" data-ja-hash="aa8d072dc59504320cfa92381f541a5f"><span class=en-original lang=en>Editor:
96 wakaba 1.32
97 wakaba 1.36 </span><span class=ja-translation lang=ja>編集者:</span><dd class="no-ja-translation" data-ja-hash="220fb2ab7924ad62bc8567b8b9c5f0f8"><span class=en-original lang=en>Ian Hickson, Google, [email protected]
98     </span></dl>
99 wakaba 1.1
100 wakaba 1.36 <p class="copyright no-ja-translation" data-ja-hash="01887da059d5ef35df4e1cc221f80391"><span class=en-original lang=en>&copy; Copyright 2004-2008 Apple Computer, Inc.,
101     Mozilla Foundation, and Opera Software ASA.</span></p>
102 wakaba 1.1
103 wakaba 1.36 <p class="copyright no-ja-translation" data-ja-hash="5419c8afab07265f61a6768f2680776d"><span class=en-original lang=en>You are granted a license to use, reproduce and create
104     derivative works of this document.</span></p>
105 wakaba 1.1 </div>
106    
107     <hr>
108    
109 wakaba 1.36 <h2 class="no-num no-toc has-ja-translation" data-ja-hash="e353dbe42c8654f33588d4da0b517469" id=abstract><span class=en-original lang=en>Abstract</span><span class=ja-translation lang=ja>概要</span></h2>
110 wakaba 1.1
111 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="a4f61aa99f0d87d5d87b6e07071a74da"><span class=en-original lang=en>This specification defines an API that allows Web application authors to
112 wakaba 1.32 spawn background workers running scripts in parallel to their main page.
113     This allows for thread-like operation with message-passing as the
114     coordination mechanism.
115    
116     </span><span class=ja-translation lang=ja>この仕様書は、 Web アプリケーションで、主たる頁とは並列に、
117 wakaba 1.14 背景労働者スクリプトを走らせるための API を定義します。
118 wakaba 1.36 これにより、メッセージ・パッシングによるスレッド的操作を協調機構として利用できるようになります。</span><h2 class="no-num no-toc has-ja-translation" data-ja-hash="c9bfd146532700356f3ff5ea6b1bf72e" id=status><span class=en-original lang=en>Status of this document</span><span class=ja-translation lang=ja>この文書の状態</span></h2>
119 wakaba 1.1
120 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="3f706d8337b443d9a959c36a9b3677a3"><span class=en-original lang=en><strong>This is a work in progress!</strong> This document is changing
121 wakaba 1.31 on a daily if not hourly basis in response to comments and as a general
122     part of its development process. Comments are very welcome, please send
123     them to <a href="mailto:[email protected]">[email protected]</a>. Thank
124     you.
125    
126 wakaba 1.36 </span><p class="has-ja-translation" data-ja-hash="5bb9ea777b965ca8d962ba2b6f663d46"><span class=en-original lang=en>The current focus is in developing a first draft proposal.
127 wakaba 1.32
128 wakaba 1.36 </span><span class=ja-translation lang=ja>現在の焦点は、第1案の開発です。</span><p class="no-ja-translation" data-ja-hash="75e78507b984cae37464af998b8dc8a2"><span class=en-original lang=en>Implementors should be aware that this specification is not stable.
129 wakaba 1.31 <strong>Implementors who are not taking part in the discussions are likely
130     to find the specification changing out from under them in incompatible
131     ways.</strong> Vendors interested in implementing this specification
132     before it eventually reaches the call for implementations should join the
133     <a href="/mailing-list">WHATWG mailing list</a> and take part in the
134     discussions.
135    
136 wakaba 1.44 </span><p class="no-ja-translation" data-ja-hash="bb77e82ccfbb3bd01ee25d2bf7243a07"><span class=en-original lang=en>This specification is also being produced by the <a
137     href="http://www.w3.org/2008/webapps/">W3C Web Apps WG</a>. The two
138     specifications are identical from the table of contents onwards.
139 wakaba 1.31
140 wakaba 1.36 </span><h2 class="no-num no-toc has-ja-translation" data-ja-hash="598b8ae10dfce818e73d3218daddbdae" id=contents><span class=en-original lang=en>Table of contents</span><span class=ja-translation lang=ja>目次
141 wakaba 1.1 </span></h2>
142     <!--begin-toc-->
143    
144     <ul class=toc>
145 wakaba 1.36 <li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="68d919e9ca0290e233107d49f2bd0973"><span class=en-original lang=en><a href="#introduction"><span class=secno>1. </span>Introduction</a>
146     </span><ul class=toc>
147 wakaba 1.42 <li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="f94143aeed3bb9197ca798364046d48d"><span class=en-original lang=en><a href="#scope"><span class=secno>1.1 </span>Scope</a>
148    
149     </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="cc8223ec55502c55628f56c7b446f30d"><span class=en-original lang=en><a href="#tutorial"><span class=secno>1.2 </span>Tutorial</a>
150 wakaba 1.36 </span><ul class=toc>
151 wakaba 1.42 <li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="0b86907a8660d3b6a1f8c570573c5d91"><span class=en-original lang=en><a href="#a-background"><span class=secno>1.2.1 </span>A
152 wakaba 1.23 background number-crunching worker</a>
153    
154 wakaba 1.42 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="b61c5d843d6ba7a4c8c70016e0204883"><span class=en-original lang=en><a href="#a-worker"><span class=secno>1.2.2 </span>A worker for
155 wakaba 1.23 updating a client-side database</a>
156    
157 wakaba 1.42 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="357d53d20d468842935342e9432d1d78"><span class=en-original lang=en><a href="#worker"><span class=secno>1.2.3 </span>Worker used for
158     background I/O</a>
159 wakaba 1.23
160 wakaba 1.42 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="abbe71ab70eaeb3035910c4b5987d1d5"><span class=en-original lang=en><a href="#shared"><span class=secno>1.2.4 </span>Shared
161 wakaba 1.23 workers</a>
162    
163 wakaba 1.42 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="ad63a3c0da0bfe49cb5391ca4539ddbc"><span class=en-original lang=en><a href="#delegation"><span class=secno>1.2.5
164 wakaba 1.23 </span>Delegation</a>
165    
166 wakaba 1.42 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="76e6c63eebe871d10886f8bac07ffa91"><span class=en-original lang=en><a href="#providing"><span class=secno>1.2.6 </span>Providing
167 wakaba 1.28 libraries</a>
168 wakaba 1.36 </span></ul>
169 wakaba 1.1
170 wakaba 1.42 <li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="f1dee0568312d45ee4fb42e24fbb33d7"><span class=en-original lang=en><a href="#conformance"><span class=secno>1.3 </span>Conformance
171 wakaba 1.1 requirements</a>
172 wakaba 1.36 </span><ul class=toc>
173 wakaba 1.42 <li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="9cf46931a24bdd95446cc0dc13d70962"><span class=en-original lang=en><a href="#dependencies"><span class=secno>1.3.1
174 wakaba 1.1 </span>Dependencies</a>
175 wakaba 1.36 </span></ul>
176 wakaba 1.1
177 wakaba 1.42 <li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="f14a8054db0709988c39b4986c4a8754"><span class=en-original lang=en><a href="#terminology"><span class=secno>1.4 </span>Terminology</a>
178 wakaba 1.36 </span></ul>
179 wakaba 1.9
180 wakaba 1.36 <li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="22339fde584025951d7cb7d24876d946"><span class=en-original lang=en><a href="#infrastructure"><span class=secno>2.
181 wakaba 1.13 </span>Infrastructure</a>
182 wakaba 1.36 </span><ul class=toc>
183     <li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="5763bf8b68038d9e7b7d492bd3ae7bab"><span class=en-original lang=en><a href="#the-global"><span class=secno>2.1 </span>The global
184 wakaba 1.29 scope</a>
185 wakaba 1.36 </span><ul class=toc>
186     <li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="efb0edfb19efd26410cb99ab1525f948"><span class=en-original lang=en><a href="#the-workerglobalscope"><span class=secno>2.1.1
187 wakaba 1.29 </span>The <code>WorkerGlobalScope</code> abstract interface</a>
188    
189 wakaba 1.36 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="5f99bbc9217feadbd07b63a59fb5f291"><span class=en-original lang=en><a href="#dedicated"><span class=secno>2.1.2 </span>Dedicated
190 wakaba 1.29 workers and the <code>DedicatedWorkerGlobalScope</code> interface</a>
191    
192    
193 wakaba 1.36 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="ba3044d55b8091a7410ee51a58225f09"><span class=en-original lang=en><a href="#shared0"><span class=secno>2.1.3 </span>Shared workers
194 wakaba 1.29 and the <code>SharedWorkerGlobalScope</code> inteface</a>
195 wakaba 1.36 </span></ul>
196 wakaba 1.9
197 wakaba 1.36 <li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="c2a16736e5155efbee09ceec52062868"><span class=en-original lang=en><a href="#base-urls"><span class=secno>2.2 </span>Base URLs and
198 wakaba 1.16 origins of workers</a>
199    
200 wakaba 1.46 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="22ee8106fe8009d8a712074798cd2f31"><span class=en-original lang=en><a href="#the-event"><span class=secno>2.3 </span>The event loop</a>
201    
202 wakaba 1.9
203 wakaba 1.36 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="9c88712c50f8e878f1e2900817520600"><span class=en-original lang=en><a href="#the-workers"><span class=secno>2.4 </span>The worker's
204 wakaba 1.11 ports</a>
205    
206 wakaba 1.36 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="a6149718eb643990db06957bc18edefd"><span class=en-original lang=en><a href="#processing"><span class=secno>2.5 </span>Processing
207 wakaba 1.9 model</a>
208 wakaba 1.13
209 wakaba 1.36 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="fdab759854cb648250afe4a81693b117"><span class=en-original lang=en><a href="#creating"><span class=secno>2.6 </span>Creating
210 wakaba 1.13 workers</a>
211 wakaba 1.36 </span><ul class=toc>
212     <li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="77dfb5f9a16bd5b77a73bdd3617c760e"><span class=en-original lang=en><a href="#the-abstractworker"><span class=secno>2.6.1 </span>The
213 wakaba 1.29 <code>AbstractWorker</code> abstract interface</a>
214    
215 wakaba 1.36 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="bbddb6f68afde611f94369aa5a0ad020"><span class=en-original lang=en><a href="#dedicated0"><span class=secno>2.6.2 </span>Dedicated
216 wakaba 1.29 workers and the <code>Worker</code> interface</a>
217    
218 wakaba 1.36 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="1f5bc4a5d6e1eb7e6293adfe42e9818c"><span class=en-original lang=en><a href="#shared1"><span class=secno>2.6.3 </span>Shared workers
219 wakaba 1.29 and the <code>SharedWorker</code> interface</a>
220 wakaba 1.36 </span></ul>
221 wakaba 1.9 </ul>
222    
223 wakaba 1.36 <li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="3d35781df14354dfc2fd4abccbffef0f"><span class=en-original lang=en><a href="#apis-available"><span class=secno>3. </span>APIs available
224 wakaba 1.13 to workers</a>
225 wakaba 1.36 </span><ul class=toc>
226     <li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="72f3123f6e8b15f48de8a349c9982513"><span class=en-original lang=en><a href="#importing"><span class=secno>3.1 </span>Importing scripts
227 wakaba 1.22 and libraries</a>
228    
229 wakaba 1.42 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="05a994c34b6bbbd32ecf8b83d319c68d"><span class=en-original lang=en><a href="#the-navigator"><span class=secno>3.2 </span>The
230     <code>Navigator</code> object</a>
231    
232     </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="23c1fe849cb20e56a903c0fc2b325b0c"><span class=en-original lang=en><a href="#apis-defined"><span class=secno>3.3 </span>APIs defined in
233 wakaba 1.22 other specifications</a>
234    
235 wakaba 1.42 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="ebb66d4419ae73eae722f90404b3c573"><span class=en-original lang=en><a href="#interface"><span class=secno>3.4 </span>Interface objects
236 wakaba 1.22 and constructors</a>
237 wakaba 1.23
238 wakaba 1.42 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="951dcfbf081177ae0184ead7e82074f7"><span class=en-original lang=en><a href="#worker0"><span class=secno>3.5 </span>Worker locations</a>
239 wakaba 1.23
240 wakaba 1.36 </span></ul>
241 wakaba 1.1
242 wakaba 1.36 <li class=no-num><p class="no-ja-translation ja-translation-inserted" data-ja-hash="e747237bceaf9dabea52363254fc5f16"><span class=en-original lang=en><a href="#references">References</a>
243 wakaba 1.1
244 wakaba 1.36 </span><li class=no-num><p class="no-ja-translation ja-translation-inserted" data-ja-hash="f440038177834afbee04ac5e84ec86fe"><span class=en-original lang=en><a href="#acknowledgements">Acknowledgements</a>
245     </span></ul>
246 wakaba 1.1 <!--end-toc-->
247    
248     <hr>
249    
250 wakaba 1.36 <h2 id=introduction class="has-ja-translation" data-ja-hash="0b79795d3efc95b9976c7c5b933afce2"><span class=en-original lang=en><span class=secno>1. </span>Introduction</span><span class=ja-translation lang=ja><span class=secno>1. </span>はじめに</span></h2>
251 wakaba 1.32
252 wakaba 1.42 <h3 id=scope class="has-ja-translation" data-ja-hash="5d113f2038d289f391614c39043629e8"><span class=en-original lang=en><span class=secno>1.1 </span>Scope</span><span class=ja-translation lang=ja><span class=secno>1.1 </span>適用範囲</span></h3>
253    
254     <p class="has-ja-translation" data-ja-hash="585b83d0801ae75a14554d8d2c737fb2"><span class=en-original lang=en><em>This section is non-normative.</em>
255    
256     </span><span class=ja-translation lang=ja><em>この節は規定の一部ではありません。</em></span><p class="no-ja-translation" data-ja-hash="2f78689edd39ccffc1a21b979c376f45"><span class=en-original lang=en>This specification defines an API for running scripts in the background
257     independently of any user interface scripts.
258    
259     </span><p class="no-ja-translation" data-ja-hash="f41b6868a33d2c4d265857efdf426694"><span class=en-original lang=en>This allows for long-running scripts that are not interrupted by scripts
260     that respond to clicks or other user interactions, and allows long tasks
261     to be executed without yielding to keep the page responsive.
262    
263     </span><p class="no-ja-translation" data-ja-hash="52e3c8127ee80a92ae3709986b8f2450"><span class=en-original lang=en>Workers (as these background scripts are called herein) are relatively
264     heavy-weight, and are not intended to be used in large numbers. For
265     example, it would be inappropriate to launch one worker for each pixel of
266     a four megapixel image. The examples below show some appropriate uses of
267     workers.
268    
269     </span><p class="no-ja-translation" data-ja-hash="497e60abbf38e141b92f7017f71dc302"><span class=en-original lang=en>Generally, workers are expected to be long-lived, have a high start-up
270     performance cost, and a high per-instance memory cost.
271    
272     </span><h3 id=tutorial class="has-ja-translation" data-ja-hash="368fe771261fcb18f7988833c9294a20"><span class=en-original lang=en><span class=secno>1.2 </span>Tutorial</span><span class=ja-translation lang=ja><span class=secno>1.2 </span>解説</span></h3>
273 wakaba 1.32
274 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="585b83d0801ae75a14554d8d2c737fb2"><span class=en-original lang=en><em>This section is non-normative.</em>
275 wakaba 1.32
276 wakaba 1.36 </span><span class=ja-translation lang=ja><em>この節は規定の一部ではありません。</em></span><p class="has-ja-translation" data-ja-hash="c98bec741e84294c9feae0d581f897b6"><span class=en-original lang=en>There are a variety of uses that workers can be put to. The following
277 wakaba 1.32 subsections show various examples of this use.
278    
279 wakaba 1.42 </span><span class=ja-translation lang=ja>労働者は色々なことに使えます。次の各節では、色々な使い方の例を示します。</span><h4 id=a-background class="has-ja-translation" data-ja-hash="03100d1ee403be709f47c37e6b55c758"><span class=en-original lang=en><span class=secno>1.2.1 </span>A background
280     number-crunching worker</span><span class=ja-translation lang=ja><span class=secno>1.2.1 </span>数値処理背景労働者</span></h4>
281 wakaba 1.32
282 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="585b83d0801ae75a14554d8d2c737fb2"><span class=en-original lang=en><em>This section is non-normative.</em>
283 wakaba 1.1
284 wakaba 1.36 </span><span class=ja-translation lang=ja><em>この節は規定の一部ではありません。</em></span><p class="has-ja-translation" data-ja-hash="6656ef1c2fd445878e165388d704a723"><span class=en-original lang=en>The simplest use of workers is for performing a computationally
285 wakaba 1.32 expensive task without interrupting the user interface.
286 wakaba 1.1
287 wakaba 1.36 </span><span class=ja-translation lang=ja>労働者の一番単純な用法は、計算的に高価な仕事を利用者界面を中断させずに実行するというものです。</span><p class="has-ja-translation" data-ja-hash="14941a1ddb566828a9181bcecf3a815a"><span class=en-original lang=en>In this example, the main document spawns a worker to (na&iuml;vely)
288 wakaba 1.32 compute prime numbers, and progressively displays the most recently found
289     prime number.
290 wakaba 1.23
291 wakaba 1.32 </span><span class=ja-translation lang=ja>この例では、主たる文書が労働者を作って素数を (素朴な方法で) 計算させ、
292 wakaba 1.36 新しく見つかった素数を順番に表示してゆきます。</span><p class="has-ja-translation" data-ja-hash="97bcf42c4070cbcef605cfa277d832fb"><span class=en-original lang=en>The main page is as follows:
293 wakaba 1.32
294 wakaba 1.42 </span><span class=ja-translation lang=ja>主たる頁は次の通りです。</span><pre class="no-ja-translation" data-ja-hash="537851d8b0d221cfefc798638131dbcd"><span class=en-original lang=en>&lt;!DOCTYPE HTML>
295 wakaba 1.23 &lt;html>
296     &lt;head>
297     &lt;title>Worker example: One-core computation&lt;/title>
298     &lt;/head>
299     &lt;body>
300     &lt;p>The highest prime number discovered so far is: &lt;output id="result">&lt;/output>&lt;/p>
301     &lt;script>
302 wakaba 1.29 var worker = new Worker('worker.js');
303     worker.onmessage = function (event) {
304 wakaba 1.42 document.getElementById('result').textContent = event.data;
305 wakaba 1.23 };
306     &lt;/script>
307     &lt;/body>
308 wakaba 1.36 &lt;/html></span></pre>
309 wakaba 1.23
310 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="e4adb9b72fb3bd211cbc81bffd5d4622"><span class=en-original lang=en>The <code title=dom-Worker><a href="#worker2">Worker()</a></code>
311 wakaba 1.30 constructor call creates a worker and returns a <code><a
312     href="#worker1">Worker</a></code> object representing that worker, which
313     is used to communicate with the worker. That object's <code
314     title=handler-Worker-onmessage><a href="#onmessage0">onmessage</a></code>
315     event handler attribute allows the code to receive messages from the
316     worker.
317 wakaba 1.23
318 wakaba 1.36 </span><p class="has-ja-translation" data-ja-hash="12a62a74d5156b6d85136f5fc41a4ee1"><span class=en-original lang=en>The worker itself is as follows:
319 wakaba 1.32
320 wakaba 1.36 </span><span class=ja-translation lang=ja>労働者自体は次の通りです。</span><pre class="no-ja-translation" data-ja-hash="35390f08d92125ad461fd6bb5969cb0c"><span class=en-original lang=en>var n = 1;
321 wakaba 1.23 search: while (true) {
322     n += 1;
323     for (var i = 2; i &lt;= Math.sqrt(n); i += 1)
324     if (n % i == 0)
325     continue search;
326     // found a prime!
327 wakaba 1.29 postMessage(n);
328 wakaba 1.36 }</span></pre>
329 wakaba 1.23
330 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="6cbc84e07a533681566aa4fdf838f852"><span class=en-original lang=en>The bulk of this code is simply an unoptimised search for a prime
331 wakaba 1.23 number. To send a message back to the page, the <code
332 wakaba 1.30 title=dom-DedicatedWorkerGlobalScope-postMessage><a
333     href="#postmessage">postMessage()</a></code> method is used to post a
334     message when a prime is found.
335 wakaba 1.23
336 wakaba 1.36 </span><p class="has-ja-translation" data-ja-hash="add583522732edb8aca6202c451ddb27" data-ja-real-hash="fb1b85e403d4ca967bb53b221e757de8"><span class=en-original lang=en><a href="http://www.whatwg.org/demos/workers/primes/page.html">View this
337 wakaba 1.32 example online</a>.
338    
339 wakaba 1.42 </span><span class=ja-translation lang=ja><a href="http://www.whatwg.org/demos/workers/primes/page.html">この例をオンラインで表示する</a>。</span><h4 id=a-worker class="has-ja-translation" data-ja-hash="be08cb921deb5e88f7dcb3edbd9f0274"><span class=en-original lang=en><span class=secno>1.2.2 </span>A worker for updating a
340     client-side database</span><span class=ja-translation lang=ja><span class=secno>1.2.2 </span>クライアント側データベースの更新のための労働者</span></h4>
341 wakaba 1.23
342 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="585b83d0801ae75a14554d8d2c737fb2"><span class=en-original lang=en><em>This section is non-normative.</em>
343 wakaba 1.32
344 wakaba 1.36 </span><span class=ja-translation lang=ja><em>この節は規定の一部ではありません。</em></span><p class="no-ja-translation" data-ja-hash="e8e4acfb27dabd6fd72aa5a4af7b7d25"><span class=en-original lang=en>In this example, the main document spawns a worker whose only task is to
345 wakaba 1.23 listen for notifications from the server, and, when appropriate, either
346     add or remove data from the client-side database.
347    
348 wakaba 1.36 </span><p class="has-ja-translation" data-ja-hash="88e890f11b614dc40f4d2453a66ec94f"><span class=en-original lang=en>Since no communication occurs between the worker and the main page, the
349 wakaba 1.23 main page can start the worker by just doing:
350    
351 wakaba 1.36 </span><span class=ja-translation lang=ja>労働者と主たる頁の間に通信は発生しませんので、
352     主たる頁は単に次のようにするだけで労働者を開始できます。</span><pre class="no-ja-translation" data-ja-hash="1fa3b8ca6e1be5ba6915c7164f359cf2"><span class=en-original lang=en>&lt;script>
353 wakaba 1.30 new Worker('worker.js');
354 wakaba 1.36 &lt;/script></span></pre>
355 wakaba 1.23
356 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="12a62a74d5156b6d85136f5fc41a4ee1"><span class=en-original lang=en>The worker itself is as follows:
357 wakaba 1.32
358 wakaba 1.42 </span><span class=ja-translation lang=ja>労働者自体は次の通りです。</span><pre class="no-ja-translation" data-ja-hash="cfd35229b68e597b6a21322a3e3c1aea"><span class=en-original lang=en>var server = new WebSocket('ws://whatwg.org/database');
359 wakaba 1.25 var database = openDatabase('demobase', '1.0', 'Demo Database', 10240);
360 wakaba 1.23 server.onmessage = function (event) {
361     // data is in the format "command key value"
362 wakaba 1.42 var data = event.data.split(' ');
363 wakaba 1.23 switch (data[0]) {
364     case '+':
365     database.transaction(function(tx) {
366     tx.executeSql('INSERT INTO pairs (key, value) VALUES (?, ?)', data[1], data[2]);
367     });
368     case '-':
369     database.transaction(function(tx) {
370     tx.executeSql('DELETE FROM pairs WHERE key=? AND value=?', data[1], data[2]);
371     });
372     }
373 wakaba 1.36 };</span></pre>
374 wakaba 1.23
375 wakaba 1.42 <p class="no-ja-translation" data-ja-hash="df7990f8fb4ac6850b65c14c08446f5c"><span class=en-original lang=en>This connects to the server using the <code>WebSocket</code> mechanism
376 wakaba 1.23 and opens the local database (which, we presume, has been created
377 wakaba 1.42 earlier). The worker then just listens for messages from the server and
378 wakaba 1.23 acts on them as appropriate, forever (or until the main page is closed).
379    
380 wakaba 1.36 </span><p class="no-ja-translation" data-ja-hash="d47c2ada69bdfebeb58219610105a1d7"><span class=en-original lang=en><a
381 wakaba 1.23 href="http://www.whatwg.org/demos/workers/database-updater/page.html">View
382     this example online</a>. (This example will not actually function, since
383     the server does not actually exist and the database is not created by this
384     sample code.)
385    
386 wakaba 1.42 </span><h4 id=worker class="no-ja-translation" data-ja-hash="26a2e24494eb4f94591467b79f68f6f2"><span class=en-original lang=en><span class=secno>1.2.3 </span>Worker used for background I/O</span></h4>
387 wakaba 1.32
388 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="585b83d0801ae75a14554d8d2c737fb2"><span class=en-original lang=en><em>This section is non-normative.</em>
389 wakaba 1.23
390 wakaba 1.36 </span><span class=ja-translation lang=ja><em>この節は規定の一部ではありません。</em></span><p class="has-ja-translation" data-ja-hash="eb288220a303d56acd4e151bca42fe6e"><span class=en-original lang=en>In this example, the main document uses two workers, one for fetching
391 wakaba 1.23 stock updates for at regular intervals, and one for fetching performing
392     search queries that the user requests.
393    
394 wakaba 1.36 </span><span class=ja-translation lang=ja>この例では、主たる文書は2つの労働者を使います。
395     1つは一定間隔で株価の更新を取得するためのもので、もう1つは利用者の要求した検索の照会を行う取得のためのものです。</span><p class="has-ja-translation" data-ja-hash="97bcf42c4070cbcef605cfa277d832fb"><span class=en-original lang=en>The main page is as follows:
396 wakaba 1.32
397 wakaba 1.42 </span><span class=ja-translation lang=ja>主たる頁は次の通りです。</span><pre class="no-ja-translation" data-ja-hash="ba58233c15e0292446559987f277f4a6"><span class=en-original lang=en>&lt;!DOCTYPE HTML>
398 wakaba 1.23 &lt;html>
399     &lt;head>
400     &lt;title>Worker example: Stock ticker&lt;/title>
401     &lt;script>
402     // TICKER
403     var symbol = 'GOOG'; // default symbol to watch
404 wakaba 1.29 var ticker = new Worker('ticker.js');
405 wakaba 1.23
406     // SEARCHER
407 wakaba 1.29 var searcher = new Worker('searcher.js');
408 wakaba 1.23 function search(query) {
409 wakaba 1.29 searcher.postMessage(query);
410 wakaba 1.23 }
411    
412     // SYMBOL SELECTION UI
413     function select(newSymbol) {
414     symbol = newSymbol;
415 wakaba 1.29 ticker.postMessage(symbol);
416 wakaba 1.23 }
417     &lt;/script>
418     &lt;/head>
419     &lt;body>
420     &lt;p>&lt;output id="symbol">&lt;/output> &lt;output id="value">&lt;/output>&lt;/p>
421     &lt;script>
422 wakaba 1.29 ticker.onmessage = function (event) {
423 wakaba 1.42 var data = event.data.split(' ');
424 wakaba 1.23 document.getElementById('symbol').textContent = data[0];
425     document.getElementById('value').textContent = data[1];
426     };
427 wakaba 1.29 ticker.postMessage(symbol);
428 wakaba 1.23 &lt;/script>
429     &lt;p>&lt;label>Search: &lt;input type="text" oninput="search(this.value)">&lt;/label>&lt;/p>
430     &lt;ul id="results">&lt;/ul>
431     &lt;script>
432 wakaba 1.29 searcher.onmessage = function (event) {
433 wakaba 1.42 var data = event.data.split(' ');
434 wakaba 1.23 var results = document.getElementById('results');
435     while (results.hasChildNodes()) // clear previous results
436     results.removeChild(results.firstChild);
437     for (var i = 0; i &lt; data.length; i += 1) {
438     // add a list item with a button for each result
439     var li = document.createElement('li');
440     var button = document.createElement('button');
441     button.value = data[i];
442     button.type = 'button';
443     button.onclick = function () { select(this.value); };
444     button.textContent = data[i];
445     li.appendChild(button);
446     results.appendChild(li);
447     }
448     };
449     &lt;/script>
450     &lt;p>(The data in this example is not real. Try searching for "Google" or "Apple".)&lt;/p>
451     &lt;/body>
452 wakaba 1.36 &lt;/html></span></pre>
453 wakaba 1.23
454 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="4cc7e781e44db82f8bd32020954bb94a"><span class=en-original lang=en>The two workers use a common library for performing the actual network
455 wakaba 1.23 calls. This library is as follows:
456    
457 wakaba 1.36 </span><span class=ja-translation lang=ja>両労働者は実際のネットワークの呼び出しを行う共通のライブラリーを使います。
458     このライブラリーは次の通りです。</span><pre class="no-ja-translation" data-ja-hash="764d750a19834bf904d276466724339c"><span class=en-original lang=en>function get(url) {
459 wakaba 1.29 try {
460     var xhr = new XMLHttpRequest();
461     xhr.open('GET', url, false);
462     xhr.send();
463     return xhr.responseText;
464     } catch (e) {
465     return ''; // turn all errors into empty results
466     }
467 wakaba 1.36 }</span></pre>
468 wakaba 1.23
469 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="ee10423864c33d68e8676bf88cb75046"><span class=en-original lang=en>The stock updater worker is as follows:
470 wakaba 1.23
471 wakaba 1.42 </span><span class=ja-translation lang=ja>株価更新者の労働者は次の通りです。</span><pre class="no-ja-translation" data-ja-hash="66ef47eaf421ea8066871b71807859be"><span class=en-original lang=en>importScripts('io.js');
472 wakaba 1.23 var timer;
473     var symbol;
474     function update() {
475 wakaba 1.29 postMessage(symbol + ' ' + get('stock.cgi?' + symbol));
476 wakaba 1.23 timer = setTimeout(update, 10000);
477     }
478 wakaba 1.29 onmessage = function (event) {
479 wakaba 1.23 if (timer)
480     clearTimeout(timer);
481 wakaba 1.42 symbol = event.data;
482 wakaba 1.23 update();
483 wakaba 1.36 };</span></pre>
484 wakaba 1.23
485 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="aa6a78ceb7b91cdf90925cc36c6c6676"><span class=en-original lang=en>The search query worker is as follows:
486 wakaba 1.23
487 wakaba 1.42 </span><span class=ja-translation lang=ja>検索の照会の労働者は次の通りです。</span><pre class="no-ja-translation" data-ja-hash="ac0353e2a69ae5ffdc861cca404ef9f0"><span class=en-original lang=en>importScripts('io.js');
488 wakaba 1.29 onmessage = function (event) {
489 wakaba 1.42 postMessage(get('search.cgi?' + event.data));
490 wakaba 1.36 };</span></pre>
491 wakaba 1.23
492 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="add583522732edb8aca6202c451ddb27" data-ja-real-hash="9b529b56f810a73a138b067e5dfe89cd"><span class=en-original lang=en><a href="http://www.whatwg.org/demos/workers/stocks/page.html">View this
493 wakaba 1.32 example online</a>.
494 wakaba 1.23
495 wakaba 1.42 </span><span class=ja-translation lang=ja><a href="http://www.whatwg.org/demos/workers/stocks/page.html">この例をオンラインで表示する</a>。</span><h4 id=shared class="has-ja-translation" data-ja-hash="634755c2f50b08b49a82f30428b1a961"><span class=en-original lang=en><span class=secno>1.2.4 </span>Shared workers</span><span class=ja-translation lang=ja><span class=secno>1.2.4 </span>共有労働者</span></h4>
496 wakaba 1.32
497 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="585b83d0801ae75a14554d8d2c737fb2"><span class=en-original lang=en><em>This section is non-normative.</em>
498 wakaba 1.32
499 wakaba 1.42 </span><span class=ja-translation lang=ja><em>この節は規定の一部ではありません。</em></span><p class="no-ja-translation" data-ja-hash="2ec2b66f1e8130c8e0552d348a633841"><span class=en-original lang=en>In this example, multiple windows (viewers) can be opened that are all
500 wakaba 1.23 viewing the same map. All the windows share the same map information, with
501     a single worker coordinating all the viewers. Each viewer can move around
502 wakaba 1.42 independently, but if they set any data on the map, all the viewers are
503 wakaba 1.23 updated.
504    
505 wakaba 1.42 </span><p class="has-ja-translation" data-ja-hash="2bf6969d7d27e56c707ae9970fdd476f"><span class=en-original lang=en>The main page isn't interesting, it merely provides a way to open the
506 wakaba 1.23 viewers:
507    
508 wakaba 1.36 </span><span class=ja-translation lang=ja>主たる頁は特に何もなく、単に表示器を開くためだけのものです。</span><pre class="no-ja-translation" data-ja-hash="55a104a8ba6c7596b2ca462c2ffb1f0a"><span class=en-original lang=en>&lt;!DOCTYPE HTML>
509 wakaba 1.23 &lt;html>
510     &lt;head>
511     &lt;title>Workers example: Multiviewer&lt;/title>
512     &lt;script>
513     function openViewer() {
514     window.open('viewer.html');
515     }
516     &lt;/script>
517     &lt;/head>
518     &lt;body>
519     &lt;p>&lt;button type=button onclick="openViewer()">Open a new
520     viewer&lt;/button>&lt;/p>
521     &lt;p>Each viewer opens in a new window. You can have as many viewers
522     as you like, they all view the same data.&lt;/p>
523     &lt;/body>
524 wakaba 1.36 &lt;/html></span></pre>
525 wakaba 1.23
526 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="cee02afe1e87e7182f5219ccf54757ca"><span class=en-original lang=en>The viewer is more involved:
527 wakaba 1.23
528 wakaba 1.42 </span><span class=ja-translation lang=ja>表示器はもっと色々しています。</span><pre class="no-ja-translation" data-ja-hash="99dd203a533b07b5af460448666b5a5e"><span class=en-original lang=en>&lt;!DOCTYPE HTML>
529 wakaba 1.23 &lt;html>
530     &lt;head>
531     &lt;title>Workers example: Multiviewer viewer&lt;/title>
532     &lt;script>
533 wakaba 1.29 var worker = new SharedWorker('worker.js', 'core');
534 wakaba 1.23
535     // CONFIGURATION
536     function configure(event) {
537 wakaba 1.42 if (event.data.substr(0, 4) != 'cfg ') return;
538     var name = event.data.substr(4).split(' ', 1);
539 wakaba 1.23 // update display to mention our name is name
540     document.getElementsByTagName('h1')[0].textContent += ' ' + name;
541     // no longer need this listener
542 wakaba 1.25 worker.port.removeEventListener('message', configure, false);
543 wakaba 1.23 }
544 wakaba 1.30 worker.port.addEventListener('message', configure, false);
545 wakaba 1.23
546     // MAP
547     function paintMap(event) {
548 wakaba 1.42 if (event.data.substr(0, 4) != 'map ') return;
549     var data = event.data.substr(4).split(',');
550 wakaba 1.23 // display tiles data[0] .. data[8]
551     var canvas = document.getElementById('map');
552     var context = canvas.getContext('2d');
553     for (var y = 0; y &lt; 3; y += 1) {
554     for (var x = 0; x &lt; 3; x += 1) {
555     var tile = data[y * 3 + x];
556     if (tile == '0')
557     context.fillStyle = 'green';
558     else
559     context.fillStyle = 'maroon';
560     fillRect(x * 50, y * 50, 50, 50);
561     }
562     }
563     }
564 wakaba 1.30 worker.port.addEventListener('message', paintMap, false);
565 wakaba 1.23
566     // PUBLIC CHAT
567     function updatePublicChat(event) {
568 wakaba 1.42 if (event.data.substr(0, 4) != 'txt ') return;
569     var name = event.data.substr(4).split(' ', 1);
570     var message = event.data.substr(4 + length(name) + 1);
571 wakaba 1.23 // display "&lt;name> message" in public chat
572     var dialog = document.getElementById('public');
573     var dt = document.createElement('dt');
574     dt.textContent = name;
575     dialog.appendChild(dt);
576     var dd = document.createElement('dd');
577     dd.textContent = message;
578     dialog.appendChild(dd);
579     }
580 wakaba 1.30 worker.port.addEventListener('message', updatePublicChat, false);
581 wakaba 1.23
582     // PRIVATE CHAT
583     function startPrivateChat(event) {
584 wakaba 1.42 if (event.data.substr(0, 4) != 'msg ') return;
585     var name = event.data.substr(4).split(' ', 1);
586 wakaba 1.23 var port = event.port;
587     // display a private chat UI
588     var ul = document.getElementById('private');
589     var li = document.createElement('li');
590     var h3 = document.createElement('h3');
591     h3.textContent = 'Private chat with ' + name;
592     li.appendChild(h3);
593     var dialog = document.createElement('dialog');
594     var addMessage = function(name, message) {
595     var dt = document.createElement('dt');
596     dt.textContent = name;
597     dialog.appendChild(dt);
598     var dd = document.createElement('dd');
599     dd.textContent = message;
600     dialog.appendChild(dd);
601     };
602     port.onmessage = function (event) {
603 wakaba 1.42 addMessage(name, event.data);
604 wakaba 1.23 };
605     li.appendChild(dialog);
606     var form = document.createElement('form');
607     var p = document.createElement('p');
608     var input = document.createElement('input');
609     input.size = 50;
610     p.appendChild(input);
611     p.appendChild(document.createTextNode(' '));
612     var button = document.createElement('button');
613     button.textContent = 'Post';
614     p.appendChild(button);
615     form.onsubmit = function () {
616     port.postMessage(input.value);
617     addMessage('me', input.value);
618     input.value = '';
619     return false;
620     };
621     form.appendChild(p);
622     li.appendChild(form);
623     }
624 wakaba 1.30 worker.port.addEventListener('message', startPrivateChat, false);
625 wakaba 1.23 &lt;/script>
626     &lt;/head>
627 wakaba 1.29 &lt;body>
628 wakaba 1.23 &lt;h1>Viewer&lt;/h1>
629     &lt;h2>Map&lt;/h2>
630     &lt;p>&lt;canvas id="map" height=150 width=150>&lt;/canvas>&lt;/p>
631     &lt;p>
632 wakaba 1.30 &lt;button type=button onclick="worker.port.postMessage('mov left')">Left&lt;/button>
633     &lt;button type=button onclick="worker.port.postMessage('mov up')">Up&lt;/button>
634     &lt;button type=button onclick="worker.port.postMessage('mov down')">Down&lt;/button>
635     &lt;button type=button onclick="worker.port.postMessage('mov right')">Right&lt;/button>
636     &lt;button type=button onclick="worker.port.postMessage('set 0')">Set 0&lt;/button>
637     &lt;button type=button onclick="worker.port.postMessage('set 1')">Set 1&lt;/button>
638 wakaba 1.23 &lt;/p>
639     &lt;h2>Public Chat&lt;/h2>
640     &lt;dialog id="public">&lt;/dialog>
641 wakaba 1.30 &lt;form onsubmit="worker.port.postMessage('txt ' + message.value); message.value = ''; return false;">
642 wakaba 1.23 &lt;p>
643     &lt;input type="text" name="message" size="50">
644     &lt;button>Post&lt;/button>
645     &lt;/p>
646     &lt;/form>
647     &lt;h2>Private Chat&lt;/h2>
648     &lt;ul id="private">&lt;/ul>
649     &lt;/body>
650 wakaba 1.25 &lt;/html>
651 wakaba 1.36 </span></pre>
652 wakaba 1.23
653 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="397850dab731150b72d5f0276dab0081"><span class=en-original lang=en>There are several key things worth noting about the way the viewer is
654 wakaba 1.23 written.
655    
656 wakaba 1.36 </span><span class=ja-translation lang=ja>表示器の書き方についていくつか注意したい重要な点があります。</span><p class="has-ja-translation" data-ja-hash="8bc9c1f9e0e102128838ea8c31c51306"><span class=en-original lang=en><strong>Multiple listeners</strong>. Instead of a single message
657 wakaba 1.23 processing function, the code here attaches multiple event listeners, each
658     one performing a quick check to see if it is relevant for the message. In
659     this example it doesn't make much difference, but if multiple authors
660     wanted to collaborate using a single port to communicate with a worker, it
661     would allow for independent code instead of changes having to all be made
662     to a single event handling function.
663    
664 wakaba 1.36 </span><span class=ja-translation lang=ja><strong>複数の聴取器</strong>。この符号では、メッセージ処理関数を1つ用意する代わりに、
665     複数の事象聴取器を付与し、それぞれが、それがメッセージに関連するかどうかを見るためにさらりと検査を行っています。
666     この例では大きな違いにはなりませんが、複数の著者が労働者と通信するために1つのポートを使って協調したい場合には、
667     独立した符号にできるので変更がある度に1つの事象取扱関数をいじらざるを得なくて済みます。</span><p class="no-ja-translation" data-ja-hash="ce2f17c1c25589a0d4507c6fa9c1f532"><span class=en-original lang=en>Registering event listeners in this way also allows you to unregister
668 wakaba 1.23 specific listeners when you are done with them, as is done with the <code
669     title="">configure()</code> method in this example.
670    
671 wakaba 1.36 </span><p class="has-ja-translation" data-ja-hash="4eb1fa2095f65662225da4c52db274f1"><span class=en-original lang=en>Finally, the worker:
672 wakaba 1.23
673 wakaba 1.42 </span><span class=ja-translation lang=ja>最後に、労働者は次のようになります。</span><pre class="no-ja-translation" data-ja-hash="70993f8765f69b748af6943ac4387c72"><span class=en-original lang=en>
674 wakaba 1.23 var nextName = 0;
675     function getNextName() {
676     // this could use more friendly names
677     // but for now just return a number
678     return nextName++;
679     }
680    
681     var map = [
682     [0, 0, 0, 0, 0, 0, 0],
683     [1, 1, 0, 1, 0, 1, 1],
684     [0, 1, 0, 1, 0, 0, 0],
685     [0, 1, 0, 1, 0, 1, 1],
686     [0, 0, 0, 1, 0, 0, 0],
687     [1, 0, 0, 1, 1, 1, 1],
688     [1, 1, 0, 1, 1, 0, 1],
689     ];
690    
691     function wrapX(x) {
692     if (x &lt; 0) return wrapX(x + map[0].length);
693     if (x >= map[0].length) return wrapX(x - map[0].length);
694     return x;
695     }
696    
697     function wrapY(y) {
698     if (y &lt; 0) return wrapY(y + map.length);
699     if (y >= map[0].length) return wrapY(y - map.length);
700     return y;
701     }
702    
703 wakaba 1.29 function sendMapData(callback) {
704 wakaba 1.23 var data = '';
705     for (var y = viewer.y-1; y &lt;= viewer.y+1; y += 1) {
706     for (var x = viewer.x-1; x &lt;= viewer.x+1; x += 1) {
707     if (data != '')
708     data += ',';
709     data += map[y][x];
710     }
711     }
712 wakaba 1.29 callback('map ' + data);
713 wakaba 1.23 }
714    
715     var viewers = {};
716     onconnect = function (event) {
717     event.port._name = getNextName();
718     event.port._data = { port: event.port, x: 0, y: 0, };
719     viewers[event.port._name] = event.port._data;
720     event.port.postMessage('cfg ' + name);
721     event.port.onmessage = getMessage;
722 wakaba 1.29 sendMapData(event.port.postMessage);
723 wakaba 1.23 };
724    
725     function getMessage(event) {
726 wakaba 1.42 switch (event.data.substr(0, 4)) {
727 wakaba 1.23 case 'mov ':
728 wakaba 1.42 var direction = event.data.substr(4);
729 wakaba 1.23 var dx = 0;
730     var dy = 0;
731     switch (direction) {
732     case 'up': dy = -1; break;
733     case 'down': dy = 1; break;
734     case 'left': dx = -1; break;
735     case 'right': dx = 1; break;
736     }
737     event.target._data.x = wrapX(event.target._data.x + dx);
738     event.target._data.y = wrapY(event.target._data.y + dy);
739 wakaba 1.29 sendMapData(event.target.postMessage);
740 wakaba 1.23 break;
741     case 'set ':
742 wakaba 1.42 var value = event.data.substr(4);
743 wakaba 1.23 map[event.target._data.y][event.target._data.x] = value;
744     for (var viewer in viewers)
745 wakaba 1.29 sendMapData(viewers[viewer].port.postMessage);
746 wakaba 1.23 break;
747     case 'txt ':
748     var name = event.target._name;
749 wakaba 1.42 var message = event.data.substr(4);
750 wakaba 1.23 for (var viewer in viewers)
751     viewers[viewer].port.postMessage('txt ' + name + ' ' + message);
752     break;
753     case 'msg ':
754     var party1 = event._data;
755 wakaba 1.42 var party2 = viewers[event.data.substr(4).split(' ', 1)];
756 wakaba 1.23 if (party2) {
757     var channel = new MessageChannel();
758     party1.port.postMessage('msg ' + party2.name, channel.port1);
759     party2.port.postMessage('msg ' + party1.name, channel.port2);
760     }
761     break;
762     }
763 wakaba 1.36 }</span></pre>
764 wakaba 1.23
765 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="b0014972506b918202f48b09f30424bd"><span class=en-original lang=en><strong>Connecting to multiple pages</strong>. The script uses the <code
766 wakaba 1.30 title=handler-SharedWorkerGlobalScope-onconnect><a
767     href="#onconnect">onconnect</a></code> event listener to listen for
768     multiple connections.
769 wakaba 1.23
770 wakaba 1.36 </span><p class="has-ja-translation" data-ja-hash="5ce666b6338718b46fb0dee22dbea88c"><span class=en-original lang=en><strong>Direct channels</strong>. When the worker receives a "msg"
771 wakaba 1.23 message from one viewer naming another viewer, it sets up a direct
772     connection between the two, so that the two viewers can communicate
773     directly without the worker having to proxy all the messages.
774    
775 wakaba 1.36 </span><span class=ja-translation lang=ja><strong>直接通信路</strong>。労働者がある閲覧器から他の閲覧器を名指した「msg」メッセージを受信した時は、
776     両者間の直接の接続を設定し、労働者がすべてのメッセージを仲介せずとも両閲覧器が直接通信できるようにします。</span><p class="has-ja-translation" data-ja-hash="add583522732edb8aca6202c451ddb27" data-ja-real-hash="4c5ed82f8da671a56292686cc3a60981"><span class=en-original lang=en><a href="http://www.whatwg.org/demos/workers/multiviewer/page.html">View
777 wakaba 1.32 this example online</a>.
778    
779 wakaba 1.42 </span><span class=ja-translation lang=ja><a href="http://www.whatwg.org/demos/workers/multiviewer/page.html">この例をオンラインで表示する</a>。</span><h4 id=delegation class="has-ja-translation" data-ja-hash="57b11d3816e9f83adb4dd2ecb2a311b5"><span class=en-original lang=en><span class=secno>1.2.5 </span>Delegation</span><span class=ja-translation lang=ja><span class=secno>1.2.5 </span>委譲</span></h4>
780 wakaba 1.23
781 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="585b83d0801ae75a14554d8d2c737fb2"><span class=en-original lang=en><em>This section is non-normative.</em>
782 wakaba 1.32
783 wakaba 1.36 </span><span class=ja-translation lang=ja><em>この節は規定の一部ではありません。</em></span><p class="no-ja-translation" data-ja-hash="318b797bf0c9a2cdaa476f36993911b4"><span class=en-original lang=en>With multicore CPUs becoming prevalent, one way to obtain better
784 wakaba 1.23 performance is to split computationally expensive tasks amongst multiple
785     workers. In this example, a computationally expensive task that is to be
786     performed for every number from 1 to 10,000,000 is farmed out to ten
787     subworkers.
788    
789 wakaba 1.37 </span><p class="has-ja-translation" data-ja-hash="c5074121435848ef6ad420f030cb5060"><span class=en-original lang=en>The main page is as follows, it just reports the result:
790 wakaba 1.23
791 wakaba 1.42 </span><span class=ja-translation lang=ja>主たる頁は次の通りで、単に結果を報告するだけです。</span><pre class="no-ja-translation" data-ja-hash="537851d8b0d221cfefc798638131dbcd"><span class=en-original lang=en>&lt;!DOCTYPE HTML>
792 wakaba 1.23 &lt;html>
793     &lt;head>
794     &lt;title>Worker example: One-core computation&lt;/title>
795     &lt;/head>
796     &lt;body>
797     &lt;p>The highest prime number discovered so far is: &lt;output id="result">&lt;/output>&lt;/p>
798     &lt;script>
799 wakaba 1.29 var worker = new Worker('worker.js');
800     worker.onmessage = function (event) {
801 wakaba 1.42 document.getElementById('result').textContent = event.data;
802 wakaba 1.23 };
803     &lt;/script>
804     &lt;/body>
805 wakaba 1.36 &lt;/html></span></pre>
806 wakaba 1.23
807 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="12a62a74d5156b6d85136f5fc41a4ee1"><span class=en-original lang=en>The worker itself is as follows:
808 wakaba 1.32
809 wakaba 1.42 </span><span class=ja-translation lang=ja>労働者自体は次の通りです。</span><pre class="no-ja-translation" data-ja-hash="c2f14df3c3648ecb143c9e271b6721df"><span class=en-original lang=en>// settings
810 wakaba 1.23 var num_workers = 10;
811     var items_per_worker = 1000000;
812    
813     // start the workers
814     var result = 0;
815     var pending_workers = num_workers;
816     for (var i = 0; i &lt; num_workers; i += 1) {
817 wakaba 1.29 var worker = new Worker('core.js');
818     worker.postMessage(i * items_per_worker);
819     worker.postMessage((i+1) * items_per_worker);
820     worker.onmessage = storeResult;
821 wakaba 1.23 }
822    
823     // handle the results
824     function storeResult(event) {
825 wakaba 1.42 result += 1*event.data;
826 wakaba 1.23 pending_workers -= 1;
827     if (pending_workers &lt;= 0)
828 wakaba 1.29 postMessage(result); // finished!
829 wakaba 1.36 }</span></pre>
830 wakaba 1.23
831 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="f9236b42d2a99d988b848353511797fc"><span class=en-original lang=en>It consists of a loop to start the subworkers, and then a handler that
832 wakaba 1.23 waits for all the subworkers to respond.
833    
834 wakaba 1.36 </span><span class=ja-translation lang=ja>これは部分労働者を開始するループと、
835     すべての部分労働者が応答するのを待つ取扱器から成っています。</span><p class="has-ja-translation" data-ja-hash="53f3483f6fffa25f7c6963e58d683f43"><span class=en-original lang=en>The subworkers are implemented as follows:
836 wakaba 1.23
837 wakaba 1.44 </span><span class=ja-translation lang=ja>部分労働者は次のように実装します。</span><pre class="no-ja-translation" data-ja-hash="90fc569c1c634a87b725ebbe4cc1e2f4"><span class=en-original lang=en>var start;
838 wakaba 1.23 onmessage = getStart;
839     function getStart(event) {
840 wakaba 1.42 start = 1*event.data;
841 wakaba 1.23 onmessage = getEnd;
842     }
843    
844     var end;
845     function getEnd(event) {
846 wakaba 1.42 end = 1*event.data;
847 wakaba 1.23 onmessage = null;
848 wakaba 1.44 work();
849 wakaba 1.23 }
850    
851 wakaba 1.44 function work() {
852 wakaba 1.23 var result = 0;
853     for (var i = start; i &lt; end; i += 1) {
854     // perform some complex calculation here
855     result += 1;
856     }
857 wakaba 1.29 postMessage(result);
858     close();
859 wakaba 1.36 }</span></pre>
860 wakaba 1.23
861 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="fbf1b083b03c85854a8e892ef8add172"><span class=en-original lang=en>They receive two numbers in two events, perform the computation for the
862 wakaba 1.23 range of numbers thus specified, and then report the result back to the
863     parent.
864    
865 wakaba 1.36 </span><span class=ja-translation lang=ja>部分労働者は2つの事象で2つの数を受信し、指定された数の範囲の計算を行った後、
866     結果を親に報告します。
867     </span><p class="has-ja-translation" data-ja-hash="add583522732edb8aca6202c451ddb27" data-ja-real-hash="c560664d07d84902d5e9e6c68ffc2f01"><span class=en-original lang=en><a href="http://www.whatwg.org/demos/workers/multicore/page.html">View
868 wakaba 1.32 this example online</a>.
869    
870 wakaba 1.42 </span><span class=ja-translation lang=ja><a href="http://www.whatwg.org/demos/workers/multicore/page.html">この例をオンラインで表示する</a>。</span><h4 id=providing class="has-ja-translation" data-ja-hash="6c37218e175bff77f69bd84b1ab5da58"><span class=en-original lang=en><span class=secno>1.2.6 </span>Providing libraries</span><span class=ja-translation lang=ja><span class=secno>1.2.6 </span>ライブラリーの提供</span></h4>
871 wakaba 1.28
872 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="585b83d0801ae75a14554d8d2c737fb2"><span class=en-original lang=en><em>This section is non-normative.</em>
873 wakaba 1.32
874 wakaba 1.36 </span><span class=ja-translation lang=ja><em>この節は規定の一部ではありません。</em></span><p class="no-ja-translation" data-ja-hash="12371907fb7e8389f76fabaf7a5f8303"><span class=en-original lang=en>Suppose that a cryptography library is made available that provides
875 wakaba 1.28 three tasks:
876    
877 wakaba 1.36 </span><dl>
878 wakaba 1.37 <dt class="has-ja-translation" data-ja-hash="6ea027035e660e254aba77f4bd9cb6e7"><span class=en-original lang=en>Generate a public/private key pair
879 wakaba 1.28
880 wakaba 1.37 </span><span class=ja-translation lang=ja>公開鍵・秘密鍵の組の生成</span><dd class="no-ja-translation" data-ja-hash="cf9020803baa896d8a183fe324563704"><span class=en-original lang=en>Takes a port, on which it will send two messages, first the public key
881 wakaba 1.28 and then the private key.
882    
883 wakaba 1.36 </span><dt class="no-ja-translation" data-ja-hash="fb7dd035a8141087578088ce61f9db22"><span class=en-original lang=en>Given a plaintext and a public key, return the corresponding
884 wakaba 1.28 cyphertext
885    
886 wakaba 1.36 </span><dd class="no-ja-translation" data-ja-hash="1d31efc883e22a218f807161c65291f0"><span class=en-original lang=en>Takes a port, to which any number of messages can be sent, the first
887 wakaba 1.28 giving the public key, and the remainder giving the plaintext, each of
888     which is encrypted and then sent on that same channel as the cyphertext.
889     The user can close the port when it is done encrypting content.
890    
891 wakaba 1.36 </span><dt class="no-ja-translation" data-ja-hash="11ea02c6f203744166e5a89e81a81337"><span class=en-original lang=en>Given a cyphertext and a private key, return the corresponding
892 wakaba 1.28 plaintext
893    
894 wakaba 1.36 </span><dd class="no-ja-translation" data-ja-hash="c157fe0e540c248dc1db29edbd80ff82"><span class=en-original lang=en>Takes a port, to which any number of messages can be sent, the first
895 wakaba 1.28 giving the private key, and the remainder giving the cyphertext, each of
896     which is decrypted and then sent on that same channel as the plaintext.
897     The user can close the port when it is done decrypting content.
898 wakaba 1.36 </span></dl>
899 wakaba 1.28
900 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="0e39ac88e71e60206c341926e3785dcd"><span class=en-original lang=en>The library itself is as follows:
901 wakaba 1.28
902 wakaba 1.42 </span><span class=ja-translation lang=ja>ライブラリー自体は次のようになります。</span><pre class="no-ja-translation" data-ja-hash="ece93540f76bf50f9d9ac650f14a714c"><span class=en-original lang=en>function handleMessage(e) {
903     if (e.data == "genkeys")
904 wakaba 1.28 genkeys(e.port);
905 wakaba 1.42 else if (e.data == "encrypt")
906 wakaba 1.28 encrypt(e.port);
907 wakaba 1.42 else if (e.data == "decrypt")
908 wakaba 1.28 decrypt(e.port);
909     }
910    
911     function genkeys(p) {
912     var keys = _generateKeyPair();
913     p.postMessage(keys[0]);
914     p.postMessage(keys[1]);
915     }
916    
917     function encrypt(p) {
918     var key, state = 0;
919     p.onmessage = function (e) {
920     if (state == 0) {
921 wakaba 1.42 key = e.data;
922 wakaba 1.28 state = 1;
923     } else {
924 wakaba 1.42 p.postMessage(_encrypt(key, e.data));
925 wakaba 1.28 }
926     };
927     }
928    
929     function decrypt(p) {
930     var key, state = 0;
931     p.onmessage = function (e) {
932     if (state == 0) {
933 wakaba 1.42 key = e.data;
934 wakaba 1.28 state = 1;
935     } else {
936 wakaba 1.42 p.postMessage(_decrypt(key, e.data));
937 wakaba 1.28 }
938     };
939     }
940    
941 wakaba 1.29 // support being used as a shared worker as well as a dedicated worker
942     if (this.onmessage) // dedicated worker
943     onmessage = handleMessage;
944     else // shared worker
945     onconnect = function (e) { e.port.onmessage = handleMessage; }
946 wakaba 1.28
947    
948     // the "crypto" functions:
949    
950     function _generateKeyPair() {
951     return [Math.random(), Math.random()];
952     }
953    
954     function _encrypt(k, s) {
955     return 'encrypted-' + k + ' ' + s;
956     }
957    
958     function _decrypt(k, s) {
959     return s.substr(s.indexOf(' ')+1);
960 wakaba 1.36 }</span></pre>
961 wakaba 1.28
962 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="e6e3003b829ed060f5926d1763f29c2e"><span class=en-original lang=en>Note that the crypto functions here are just stubs and don't do real
963 wakaba 1.28 cryptography.
964    
965 wakaba 1.36 </span><p class="has-ja-translation" data-ja-hash="76f1d5866d92bc1036d1198cf4eda428"><span class=en-original lang=en>This library could be used as follows:
966 wakaba 1.28
967 wakaba 1.42 </span><span class=ja-translation lang=ja>このライブラリーは次のように使うことができます。</span><pre class="no-ja-translation" data-ja-hash="02df9ec9921dac18bca9782664a47c5b"><span class=en-original lang=en>&lt;!DOCTYPE HTML>
968 wakaba 1.28 &lt;html>
969     &lt;head>
970     &lt;title>Worker example: Crypto library&lt;/title>
971     &lt;script>
972 wakaba 1.29 var crytoLib = new Worker('libcrypto-v1.js'); // or could use 'libcrypto-v2.js'
973 wakaba 1.28 function getKeys() {
974     var state = 0;
975 wakaba 1.29 cryptoLib.startConversation("genkeys").onmessage = function (e) {
976 wakaba 1.28 if (state == 0)
977 wakaba 1.42 document.getElementById('public').value = e.data;
978 wakaba 1.28 else if (state == 1)
979 wakaba 1.42 document.getElementById('private').value = e.data;
980 wakaba 1.28 state += 1;
981     };
982     }
983     function enc() {
984 wakaba 1.29 var port = cryptoLib.startConversation("encrypt");
985     port.postMessage(document.getElementById('public').value);
986     port.postMessage(document.getElementById('input').value);
987     port.onmessage = function (e) {
988 wakaba 1.42 document.getElementById('input').value = e.data;
989 wakaba 1.29 port.close();
990 wakaba 1.28 };
991     }
992     function dec() {
993 wakaba 1.29 var port = cryptoLib.startConversation("decrypt");
994     port.postMessage(document.getElementById('private').value);
995     port.postMessage(document.getElementById('input').value);
996     port.onmessage = function (e) {
997 wakaba 1.42 document.getElementById('input').value = e.data;
998 wakaba 1.29 port.close();
999 wakaba 1.28 };
1000     }
1001     &lt;/script>
1002     &lt;style>
1003     textarea { display: block; }
1004     &lt;/style>
1005     &lt;/head>
1006     &lt;body onload="getKeys()">
1007     &lt;fieldset>
1008     &lt;legend>Keys&lt;/legend>
1009 wakaba 1.29 &lt;p>&lt;label>Public Key: &lt;textarea id="public">&lt;/textarea>&lt;/label>&lt;/p>
1010     &lt;p>&lt;label>Private Key: &lt;textarea id="private">&lt;/textarea>&lt;/label>&lt;/p>
1011 wakaba 1.28 &lt;/fieldset>
1012 wakaba 1.29 &lt;p>&lt;label>Input: &lt;textarea id="input">&lt;/textarea>&lt;/label>&lt;/p>
1013 wakaba 1.28 &lt;p>&lt;button onclick="enc()">Encrypt&lt;/button> &lt;button onclick="dec()">Decrypt&lt;/button>&lt;/p>
1014     &lt;/body>
1015 wakaba 1.36 &lt;/html></span></pre>
1016 wakaba 1.28
1017 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="13181de825fa0e152c5a954e55715a15"><span class=en-original lang=en>A later version of the API, though, might want to offload all the crypto
1018 wakaba 1.28 work onto subworkers. This could be done as follows:
1019    
1020 wakaba 1.42 </span><pre class="no-ja-translation" data-ja-hash="12b84d4be6a7f7bdc55d6f3ea37a96b3"><span class=en-original lang=en>function handleMessage(e) {
1021     if (e.data == "genkeys")
1022 wakaba 1.28 genkeys(e.port);
1023 wakaba 1.42 else if (e.data == "encrypt")
1024 wakaba 1.28 encrypt(e.port);
1025 wakaba 1.42 else if (e.data == "decrypt")
1026 wakaba 1.28 decrypt(e.port);
1027     }
1028    
1029     function genkeys(p) {
1030 wakaba 1.29 var generator = new Worker('libcrypto-v2-generator.js');
1031 wakaba 1.28 generator.postMessage('', p);
1032     }
1033    
1034     function encrypt(p) {
1035     p.onmessage = function (e) {
1036 wakaba 1.42 var key = e.data;
1037 wakaba 1.29 var encryptor = new Worker('libcrypto-v2-encryptor.js');
1038 wakaba 1.28 encryptor.postMessage(key, p);
1039     };
1040     }
1041    
1042     function encrypt(p) {
1043     p.onmessage = function (e) {
1044 wakaba 1.42 var key = e.data;
1045 wakaba 1.29 var decryptor = new Worker('libcrypto-v2-decryptor.js');
1046 wakaba 1.28 decryptor.postMessage(key, p);
1047     };
1048     }
1049    
1050 wakaba 1.29 // support being used as a shared worker as well as a dedicated worker
1051     if (this.onmessage) // dedicated worker
1052     onmessage = handleMessage;
1053     else // shared worker
1054     onconnect = function (e) { e.port.onmessage = handleMessage; }
1055 wakaba 1.36 </span></pre>
1056 wakaba 1.28
1057 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="fc1d14c413a94a9015153067739845e7"><span class=en-original lang=en>The little subworkers would then be as follows.
1058 wakaba 1.28
1059 wakaba 1.36 </span><span class=ja-translation lang=ja>小部分労働者は次の通りです。</span><p class="has-ja-translation" data-ja-hash="66f9c4d246b0081919ced7e46c4a9db2"><span class=en-original lang=en>For generating key pairs:
1060 wakaba 1.28
1061 wakaba 1.36 </span><span class=ja-translation lang=ja>鍵組の生成用:</span><pre class="no-ja-translation" data-ja-hash="69e6e4b66305b1a92aee9fcc2372196d"><span class=en-original lang=en>onmessage = function (e) {
1062 wakaba 1.29 var k = _generateKeyPair();
1063     e.port.postMessage(k[0]);
1064     e.port.postMessage(k[1]);
1065 wakaba 1.28 close();
1066     }
1067 wakaba 1.29
1068     function _generateKeyPair() {
1069     return [Math.random(), Math.random()];
1070 wakaba 1.36 }</span></pre>
1071 wakaba 1.28
1072 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="1f07f24df05f20de47483db4dfde2017"><span class=en-original lang=en>For encrypting:
1073 wakaba 1.28
1074 wakaba 1.42 </span><span class=ja-translation lang=ja>暗号化用:</span><pre class="no-ja-translation" data-ja-hash="efa3d6d66bd704b621cb5c4562d9a3cf"><span class=en-original lang=en>onmessage = function (e) {
1075     var key = e.data;
1076 wakaba 1.28 e.port.onmessage = function (e) {
1077 wakaba 1.42 var s = e.data;
1078 wakaba 1.29 postMessage(_encrypt(key, s));
1079 wakaba 1.28 }
1080 wakaba 1.29 e.port.onclose = function (e) {
1081 wakaba 1.28 close();
1082     }
1083 wakaba 1.29 }
1084    
1085     function _encrypt(k, s) {
1086     return 'encrypted-' + k + ' ' + s;
1087 wakaba 1.36 }</span></pre>
1088 wakaba 1.28
1089 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="abf884f40593747f458e7d7400b1eb21"><span class=en-original lang=en>For decrypting:
1090 wakaba 1.28
1091 wakaba 1.42 </span><span class=ja-translation lang=ja>解読用:</span><pre class="no-ja-translation" data-ja-hash="854f6f4811f0f485f12e062b97d487ce"><span class=en-original lang=en>onmessage = function (e) {
1092     var key = e.data;
1093 wakaba 1.28 e.port.onmessage = function (e) {
1094 wakaba 1.42 var s = e.data;
1095 wakaba 1.29 postMessage(_decrypt(key, s));
1096 wakaba 1.28 }
1097 wakaba 1.29 e.port.onclose = function (e) {
1098 wakaba 1.28 close();
1099     }
1100 wakaba 1.29 }
1101    
1102     function _decrypt(k, s) {
1103     return s.substr(s.indexOf(' ')+1);
1104 wakaba 1.36 }</span></pre>
1105 wakaba 1.28
1106 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="c8da0ee0afd0a36dc51fa6bebbb8a3e9"><span class=en-original lang=en>Notice how the users of the API don't have to even know that this is
1107 wakaba 1.28 happening &mdash; the API hasn't changed; the library can delegate to
1108     subworkers without changing its API, even though it is accepting data
1109     using message channels.
1110    
1111 wakaba 1.36 </span><p class="has-ja-translation" data-ja-hash="add583522732edb8aca6202c451ddb27" data-ja-real-hash="268a742b1731b3f55fd4ab398fa56d34"><span class=en-original lang=en><a href="http://www.whatwg.org/demos/workers/crypto/page.html">View this
1112 wakaba 1.32 example online</a>.
1113    
1114 wakaba 1.42 </span><span class=ja-translation lang=ja><a href="http://www.whatwg.org/demos/workers/crypto/page.html">この例をオンラインで表示する</a>。</span><h3 id=conformance class="has-ja-translation" data-ja-hash="05644f41fb2fbf61aaab52464b2edf3b"><span class=en-original lang=en><span class=secno>1.3 </span>Conformance requirements</span><span class=ja-translation lang=ja><span class=secno>1.3 </span>適合性要件</span></h3>
1115 wakaba 1.1
1116 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="8b0f72fe04577949924ab1e2997e0d8b"><span class=en-original lang=en>All diagrams, examples, and notes in this specification are
1117 wakaba 1.32 non-normative, as are all sections explicitly marked non-normative.
1118     Everything else in this specification is normative.
1119    
1120     </span><span class=ja-translation lang=ja>この仕様書のすべての図、例示、注意書き、ならびに規定の一部ではないと明記したすべての節は、
1121 wakaba 1.1 規定の一部ではありません。
1122 wakaba 1.36 この仕様書のそれ以外の部分はすべて規定の一部です。</span><p class="no-ja-translation" data-ja-hash="6b9cae822cc27a0168c340eee0cff438"><span class=en-original lang=en>The key words "MUST", "MUST NOT", "REQUIRED", <!--"SHALL", "SHALL
1123 wakaba 1.31 NOT",-->
1124     "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in the
1125     normative parts of this document are to be interpreted as described in
1126     RFC2119. For readability, these words do not appear in all uppercase
1127 wakaba 1.46 letters in this specification. <a href="#refsRFC2119">[RFC2119]</a>
1128 wakaba 1.1
1129 wakaba 1.46 </span><p class="has-ja-translation" data-ja-hash="63dc4357c416e0e0f292a5f662ca71ab"><span class=en-original lang=en>Requirements phrased in the imperative as part of algorithms (such as
1130 wakaba 1.32 "strip any leading space characters" or "return false and abort these
1131     steps") are to be interpreted with the meaning of the key word ("must",
1132     "should", "may", etc) used in introducing the algorithm.
1133    
1134     </span><span class=ja-translation lang=ja>算法の一部として<ins class=ja-note>動作の指示の形で (原文では</ins>命令形で<ins class=ja-note>) </ins>記述された要件
1135 wakaba 1.1 (例えば「先頭の間隔文字をすべて除去します」や「偽を返し、これらの段階を停止します」)
1136 wakaba 1.24 は、算法を紹介するに当たって使われたキーワード (<em class=rfc2119 title="MUST">しなければなりません</em>、
1137 wakaba 1.36 <em class=rfc2119 title="SHOULD">するべきです</em>、<em class=rfc2119 title="MAY">して構いません</em>など) の意味により解釈します。</span><p class="has-ja-translation" data-ja-hash="a5a0db584980ce3f2448983d6188b2d1"><span class=en-original lang=en>Some conformance requirements are phrased as requirements on attributes,
1138 wakaba 1.32 methods or objects. Such requirements are to be interpreted as
1139     requirements on user agents.
1140    
1141     </span><span class=ja-translation lang=ja>いくつかの適合性要件は属性やメソッドやオブジェクトの要件として説明されています。
1142 wakaba 1.36 そのような要件は、利用者エージェントに関する要件として解釈します。</span><p class="has-ja-translation" data-ja-hash="27386c326b98d878b3c408c60b6095b0"><span class=en-original lang=en>Conformance requirements phrased as algorithms or specific steps may be
1143 wakaba 1.32 implemented in any manner, so long as the end result is equivalent. (In
1144     particular, the algorithms defined in this specification are intended to
1145     be easy to follow, and not intended to be performant.)
1146    
1147     </span><span class=ja-translation lang=ja>算法や特定の段階として説明されている適合性要件は、
1148 wakaba 1.1 最終的な結果が等価である限り、任意の方法で実装して<em class=rfc2119 title="MAY">構いません</em>。
1149     (特に、この仕様書で定義されている算法は追うのを簡単にしており、
1150 wakaba 1.36 高性能であることを目指してはいません。)</span><p class="has-ja-translation" data-ja-hash="e42931a32a5e7ad458e3ca1b87d741d9"><span class=en-original lang=en>The only conformance class defined by this specification is user agents.
1151 wakaba 1.32
1152 wakaba 1.36 </span><span class=ja-translation lang=ja>この仕様書で定義する唯一の適合性の級は利用者エージェントです。</span><p class="has-ja-translation" data-ja-hash="57959e6c42e8d5141b11e501bf60cc2f"><span class=en-original lang=en>User agents may impose implementation-specific limits on otherwise
1153 wakaba 1.32 unconstrained inputs, e.g. to prevent denial of service attacks, to guard
1154     against running out of memory, or to work around platform-specific
1155     limitations.
1156    
1157     </span><span class=ja-translation lang=ja>利用者エージェントは、サービス拒否攻撃を防ぐため、
1158 wakaba 1.1 記憶容量を使い尽くすことを防ぐため、
1159     あるいは環境特有の制限に対応するためなどの目的で、
1160 wakaba 1.42 別段の制約のない入力に対して実装特有の制限を設けて<em class=rfc2119 title="MAY">構いません</em>。</span><h4 id=dependencies class="has-ja-translation" data-ja-hash="896f4eaa4f12972b56ed9cdd9a90b949"><span class=en-original lang=en><span class=secno>1.3.1 </span>Dependencies</span><span class=ja-translation lang=ja><span class=secno>1.3.1 </span>依存性</span></h4>
1161 wakaba 1.1
1162 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="8dc27a34324d9e41d25c6bbbc2d2551c"><span class=en-original lang=en>This specification relies on several other underlying specifications.
1163 wakaba 1.32
1164     </span><span class=ja-translation lang=ja>この仕様書は、他のいくつかの下位の仕様書に依存しています。</span><dl>
1165 wakaba 1.36 <dt class="no-ja-translation" data-ja-hash="6bff62b10d884fb77428cfe168cd783d"><span class=en-original lang=en>HTML5
1166 wakaba 1.1
1167 wakaba 1.36 </span><dd>
1168     <p class="no-ja-translation" data-ja-hash="692ef0a750fa95ddb11f05608021ff02"><span class=en-original lang=en>Many fundamental concepts from HTML5 are used by this specification.
1169     <a href="#refsHTML5">[HTML5]</a></span></p>
1170 wakaba 1.1
1171 wakaba 1.36 <dt class="no-ja-translation" data-ja-hash="760145493119c1b42cb6fe0bbde08987"><span class=en-original lang=en>ECMAScript
1172 wakaba 1.1
1173 wakaba 1.36 </span><dd>
1174     <p class="no-ja-translation" data-ja-hash="9fbcf32dffdec6694cf4ea145ef5db36"><span class=en-original lang=en>This specification is intended to be used with JavaScript as the
1175     scripting language. <a href="#refsJS">[JS]</a></span></p>
1176 wakaba 1.1
1177 wakaba 1.36 <dt class="no-ja-translation" data-ja-hash="21838f6e93b1a2157b16dcb6281ff225"><span class=en-original lang=en>WebIDL
1178 wakaba 1.1
1179 wakaba 1.36 </span><dd>
1180     <p class="no-ja-translation" data-ja-hash="f0d2498c8bb497932f36ddf86e0cf1e4"><span class=en-original lang=en>The IDL blocks in this specification use the semantics of the WebIDL
1181     specification. <a href="#refsWebIDL">[WebIDL]</a></span></p>
1182 wakaba 1.1 </dl>
1183    
1184 wakaba 1.42 <h3 id=terminology class="has-ja-translation" data-ja-hash="e182a8a3f2adf774fb1c959df71b8600"><span class=en-original lang=en><span class=secno>1.4 </span>Terminology</span><span class=ja-translation lang=ja><span class=secno>1.4 </span>用語</span></h3>
1185 wakaba 1.32
1186 wakaba 1.46 <p class="has-ja-translation" data-ja-hash="f99630e4a7f12f2c4ecb88e02bf4a644"><span class=en-original lang=en>The construction "a <code title="">Foo</code> object", where <code
1187 wakaba 1.32 title="">Foo</code> is actually an interface, is sometimes used instead of
1188     the more accurate "an object implementing the interface <code
1189     title="">Foo</code>".
1190    
1191     </span><span class=ja-translation lang=ja>「<code title="">Foo</code> オブジェクト」という構文 (<code title="">Foo</code>
1192 wakaba 1.10 は実際には界面) を時々使いますが、より正確な「界面 <code title="">Foo</code>
1193 wakaba 1.36 を実装しているオブジェクト」の代わりに用いています。</span><p class="no-ja-translation" data-ja-hash="eb827c696acddeb1a8d0447095c94e07"><span class=en-original lang=en>The term DOM is used to refer to the API set made available to scripts
1194 wakaba 1.31 in Web applications, and does not necessarily imply the existence of an
1195     actual <code>Document</code> object or of any other <code>Node</code>
1196     objects as defined in the DOM Core specifications. <a
1197     href="#refsDOM3CORE">[DOM3CORE]</a>
1198    
1199 wakaba 1.36 </span><p class="has-ja-translation" data-ja-hash="5b9242da79aeab74bccc57781ac3103e"><span class=en-original lang=en>A DOM attribute is said to be <em>getting</em> when its value is being
1200 wakaba 1.32 retrieved (e.g. by author script), and is said to be <em>setting</em> when
1201     a new value is assigned to it.
1202    
1203     </span><span class=ja-translation lang=ja>DOM 属性は、その値が (例えば著者のスクリプトにより) 取り出される時<em>取得される</em>といい、
1204 wakaba 1.46 新しい値がその属性に割り当てられる時<em>設定される</em>といいます。</span><h2 id=infrastructure class="has-ja-translation" data-ja-hash="cba4f4cee5c6a3e6d8be8da68fa1234e"><span class=en-original lang=en><span class=secno>2. </span>Infrastructure</span><span class=ja-translation lang=ja><span class=secno>2. </span>基盤</span></h2>
1205 wakaba 1.9
1206 wakaba 1.42 <p class="no-ja-translation" data-ja-hash="f38a96d03c61f343169a402b5c779db8"><span class=en-original lang=en>There are two kinds of workers; dedicated workers, and shared workers.
1207 wakaba 1.29 Dedicated workers, once created, and are linked to their creator; but
1208     message ports can be used to communicate from a dedicated worker to
1209 wakaba 1.42 multiple other browsing contexts or workers. Shared workers, on the other
1210 wakaba 1.29 hand, are named, and once created any script running in the same
1211     <span>origin</span> can obtain a reference to that worker and communicate
1212     with it.
1213    
1214 wakaba 1.36 </span><h3 id=the-global class="has-ja-translation" data-ja-hash="16d7670f16b3aaf6130252e8f11702eb"><span class=en-original lang=en><span class=secno>2.1 </span>The global scope</span><span class=ja-translation lang=ja><span class=secno>2.1 </span>大域作用域</span></h3>
1215 wakaba 1.29
1216 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="216dee088449fef485a489ea8a7432f4"><span class=en-original lang=en>The global scope is the "inside" of a worker.
1217 wakaba 1.29
1218 wakaba 1.36 </span><span class=ja-translation lang=ja>大域作用域は労働者の「内側」です。</span><h4 id=the-workerglobalscope class="has-ja-translation" data-ja-hash="fe5227371e801f4ac588d0d07472a900" data-ja-real-hash="cc17376e4eee7e97d5ab420959bcac76"><span class=en-original lang=en><span class=secno>2.1.1 </span>The <code><a
1219     href="#workerglobalscope">WorkerGlobalScope</a></code> abstract interface</span><span class=ja-translation lang=ja><span class=secno>2.1.1 </span><code><a href="#workerglobalscope">WorkerGlobalScope</a></code> 抽象界面</span></h4>
1220 wakaba 1.9
1221     <pre
1222 wakaba 1.36 class="idl no-ja-translation" data-ja-hash="1f1989e0e082e4bbc1332cd5504df8d6"><span class=en-original lang=en>[NoInterfaceObject] interface <dfn id=workerglobalscope>WorkerGlobalScope</dfn> {
1223 wakaba 1.22 readonly attribute <a href="#workerglobalscope">WorkerGlobalScope</a> <a href="#self" title=dom-WorkerGlobalScope-self>self</a>;
1224 wakaba 1.23 readonly attribute <a href="#workerlocation">WorkerLocation</a> <a href="#location" title=dom-WorkerGlobalScope-location>location</a>;
1225 wakaba 1.29 // also implements everything on <a href="#workerutils">WorkerUtils</a>
1226    
1227 wakaba 1.22 void <a href="#close" title=dom-WorkerGlobalScope-close>close</a>();
1228 wakaba 1.29 attribute <span>EventListener</span> <a href="#onclose" title=handler-WorkerGlobalScope-onclose>onclose</a>;
1229 wakaba 1.36 };</span></pre>
1230 wakaba 1.9
1231 wakaba 1.42 <p class="no-ja-translation" data-ja-hash="1eaadf1fd34d0295b8799d73be1a9135"><span class=en-original lang=en>Objects implementing the <code><a
1232     href="#workerglobalscope">WorkerGlobalScope</a></code> interface must also
1233     implement the <code>EventTarget</code> interface.
1234 wakaba 1.23
1235 wakaba 1.36 </span><p class="no-ja-translation" data-ja-hash="087af626d2f79d49dcf366c0227c32c0"><span class=en-original lang=en>The <dfn id=self
1236 wakaba 1.22 title=dom-WorkerGlobalScope-self><code>self</code></dfn> attribute must
1237     return the <code><a href="#workerglobalscope">WorkerGlobalScope</a></code>
1238     object itself.
1239    
1240 wakaba 1.36 </span><p class="no-ja-translation" data-ja-hash="8e9bf18a7820b4401892ba71daf05527"><span class=en-original lang=en>The <dfn id=location
1241 wakaba 1.23 title=dom-WorkerGlobalScope-location><code>location</code></dfn> attribute
1242     must return the <code><a href="#workerlocation">WorkerLocation</a></code>
1243     object created for the <code><a
1244     href="#workerglobalscope">WorkerGlobalScope</a></code> object when the
1245     worker was created. It represents the <span>absolute URL</span> of the
1246     script that was used to initialize the worker.
1247 wakaba 1.22
1248 wakaba 1.36 </span><hr>
1249 wakaba 1.29
1250 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="4613c16766e1a2533e8acb2824c6f9fe"><span class=en-original lang=en>When a script invokes the <dfn id=close
1251 wakaba 1.29 title=dom-WorkerGlobalScope-close><code>close()</code></dfn> method on a
1252     <code><a href="#workerglobalscope">WorkerGlobalScope</a></code> object,
1253     the user agent must run the following steps:
1254    
1255 wakaba 1.36 </span><ol>
1256 wakaba 1.29 <li>
1257 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="60169fead4ccffa67d9a836cd2db0eda"><span class=en-original lang=en><span>Queue a task</span> to <span>fire a simple event</span> called
1258     <code title=event-close>close</code> at the <code><a
1259     href="#workerglobalscope">WorkerGlobalScope</a></code> object.
1260 wakaba 1.29
1261 wakaba 1.36 </span><li>
1262     <p class="no-ja-translation" data-ja-hash="6243c3e4951724a3633743634fccb06e"><span class=en-original lang=en>Set the worker's <code><a
1263 wakaba 1.29 href="#workerglobalscope">WorkerGlobalScope</a></code> object's <a
1264     href="#closing" title=dom-WorkerGlobalScope-closing>closing</a> flag to
1265     true.
1266    
1267 wakaba 1.36 </span><li>
1268 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="facd4a44e5a83273873024773bc8359e"><span class=en-original lang=en>For each <code>MessagePort</code> object that is entangled with
1269 wakaba 1.29 another port and that has one (but only one) port whose owner is the
1270     <code><a href="#workerglobalscope">WorkerGlobalScope</a></code> object
1271     on which the method was invoked (this would include, for instance, the
1272 wakaba 1.46 implicit port in used for dedicated workers), unentangle the two ports.
1273     </span></ol>
1274 wakaba 1.9
1275 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="3df99fd92cbc7213b4f00b8953997403"><span class=en-original lang=en>The following are the <span>event handler DOM attributes</span> that
1276 wakaba 1.22 must be supported by objects implementing the <code><a
1277     href="#workerglobalscope">WorkerGlobalScope</a></code> interface:
1278    
1279 wakaba 1.36 </span><dl>
1280     <dt class="no-ja-translation" data-ja-hash="96d62a92c59fca4cd2589c560425090f"><span class=en-original lang=en><dfn id=onclose
1281 wakaba 1.29 title=handler-WorkerGlobalScope-onclose><code>onclose</code></dfn>
1282 wakaba 1.11
1283 wakaba 1.36 </span><dd>
1284     <p class="has-ja-translation" data-ja-hash="91a2ce3a21f7ed687afe756baa5387d8" data-ja-real-hash="1388215c8f7c8c11b36e9c90d06b48e3"><span class=en-original lang=en>Must be invoked whenever a <code title=event-close>close</code> event
1285 wakaba 1.32 is targeted at or bubbles through the <code><a
1286     href="#workerglobalscope">WorkerGlobalScope</a></code> object.
1287     </span><span class=ja-translation lang=ja><code title=event-close>close</code> 事象が当該 <code><a href="#workerglobalscope">WorkerGlobalScope</a></code> オブジェクトを対象としているか、泡立って当該オブジェクトを通過する時に、
1288 wakaba 1.29 呼び出されなければなりません。</span></dl>
1289    
1290 wakaba 1.36 <h4 id=dedicated class="no-ja-translation" data-ja-hash="01e2b66319613f26fcb4ea361d2009e4"><span class=en-original lang=en><span class=secno>2.1.2 </span>Dedicated workers and the
1291 wakaba 1.29 <code><a
1292     href="#dedicatedworkerglobalscope">DedicatedWorkerGlobalScope</a></code>
1293 wakaba 1.36 interface</span></h4>
1294 wakaba 1.29
1295     <pre
1296 wakaba 1.42 class="idl no-ja-translation" data-ja-hash="2417974e77f12d3b3ace4550af00bd29"><span class=en-original lang=en>[NoInterfaceObject] interface <dfn id=dedicatedworkerglobalscope>DedicatedWorkerGlobalScope</dfn> : <a href="#workerglobalscope">WorkerGlobalScope</a> {
1297 wakaba 1.30 void <a href="#postmessage" title=dom-DedicatedWorkerGlobalScope-postMessage>postMessage</a>(in DOMString message);
1298 wakaba 1.42 void <a href="#postmessage" title=dom-DedicatedWorkerGlobalScope-postMessage>postMessage</a>(in DOMString message, in <span>MessagePort</span> messagePort);<!--
1299     <span>MessagePort</span> <span title="dom-DedicatedWorkerGlobalScope-startConversation">startConversation</span>(in DOMString message);-->
1300 wakaba 1.29 attribute <span>EventListener</span> <a href="#onmessage" title=handler-DedicatedWorkerGlobalScope-onmessage>onmessage</a>;
1301 wakaba 1.36 };</span></pre>
1302 wakaba 1.29
1303 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="c6ea7d83d489d6962a5dafa4cb9883ac"><span class=en-original lang=en><code><a
1304 wakaba 1.29 href="#dedicatedworkerglobalscope">DedicatedWorkerGlobalScope</a></code>
1305     objects act as if they had an implicit <code>MessagePort</code> associated
1306     with them. This port is part of a channel that is set up when the worker
1307     is created, but it is not exposed. This object must never be garbage
1308     collected before the <code><a
1309     href="#dedicatedworkerglobalscope">DedicatedWorkerGlobalScope</a></code>
1310     object.
1311    
1312 wakaba 1.36 </span><p class="no-ja-translation" data-ja-hash="cd46f0a484fa815888d26bffc00cd30a"><span class=en-original lang=en>All messages received by that port must immediately be retargetted at
1313 wakaba 1.29 the <code><a
1314     href="#dedicatedworkerglobalscope">DedicatedWorkerGlobalScope</a></code>
1315     object.
1316    
1317 wakaba 1.42 </span><p class="no-ja-translation" data-ja-hash="c343842e8ec7635e987fef78935dd0ae"><span class=en-original lang=en>The <dfn id=postmessage
1318     title=dom-DedicatedWorkerGlobalScope-postMessage><code>postMessage()</code></dfn><!--
1319     and <dfn
1320     title="dom-DedicatedWorkerGlobalScope-startConversation"><code>startConversation()</code></dfn>-->
1321     method<!--s (startConversation)--> on <code><a
1322 wakaba 1.29 href="#dedicatedworkerglobalscope">DedicatedWorkerGlobalScope</a></code>
1323 wakaba 1.42 objects must act as if, when invoked, it<!--/they (startConversation)-->
1324     immediately invoked the method of the same name on the port, with the same
1325     arguments, and returned the same return value.
1326 wakaba 1.29
1327 wakaba 1.36 </span><p class="no-ja-translation" data-ja-hash="a1ce69c9e43bed80103920cd0e52253e"><span class=en-original lang=en>The following are the <span>event handler DOM attributes</span> that
1328 wakaba 1.29 must be supported by objects implementing the <code><a
1329     href="#dedicatedworkerglobalscope">DedicatedWorkerGlobalScope</a></code>
1330     interface:
1331    
1332 wakaba 1.36 </span><dl>
1333     <dt class="no-ja-translation" data-ja-hash="160334ee188f54bd11cad6927542df5d"><span class=en-original lang=en><dfn id=onmessage
1334 wakaba 1.29 title=handler-DedicatedWorkerGlobalScope-onmessage><code>onmessage</code></dfn>
1335 wakaba 1.11
1336 wakaba 1.36 </span><dd>
1337     <p class="has-ja-translation" data-ja-hash="91a2ce3a21f7ed687afe756baa5387d8" data-ja-real-hash="693bf14ecd01b81e9953c2197c4ce97b"><span class=en-original lang=en>Must be invoked whenever a <code
1338 wakaba 1.32 title=event-DedicatedWorkerGlobalScope-message>message</code> event is
1339     targeted at or bubbles through the <code><a
1340     href="#dedicatedworkerglobalscope">DedicatedWorkerGlobalScope</a></code>
1341     object.
1342     </span><span class=ja-translation lang=ja><code title=event-DedicatedWorkerGlobalScope-message>message</code> 事象が当該 <code><a href="#dedicatedworkerglobalscope">DedicatedWorkerGlobalScope</a></code> オブジェクトを対象としているか、泡立って当該オブジェクトを通過する時に、
1343 wakaba 1.12 呼び出されなければなりません。</span></dl>
1344 wakaba 1.11
1345 wakaba 1.36 <h4 id=shared0 class="no-ja-translation" data-ja-hash="da49a2eed6f0ff2e53a41e7fe6e36a3a"><span class=en-original lang=en><span class=secno>2.1.3 </span>Shared workers and the
1346 wakaba 1.29 <code><a
1347     href="#sharedworkerglobalscope">SharedWorkerGlobalScope</a></code>
1348 wakaba 1.36 inteface</span></h4>
1349 wakaba 1.29
1350     <pre
1351 wakaba 1.36 class="idl no-ja-translation" data-ja-hash="186ecc4f854426c568d67e4a78529172"><span class=en-original lang=en>[NoInterfaceObject] interface <dfn id=sharedworkerglobalscope>SharedWorkerGlobalScope</dfn> : <a href="#workerglobalscope">WorkerGlobalScope</a> {
1352 wakaba 1.29 readonly attribute DOMString <a href="#name" title=dom-SharedWorkerGlobalScope-name>name</a>;
1353     attribute <span>EventListener</span> <a href="#onconnect" title=handler-SharedWorkerGlobalScope-onconnect>onconnect</a>;
1354 wakaba 1.36 };</span></pre>
1355 wakaba 1.29
1356 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="9d344498c69a5ed60029b76fb274beb2"><span class=en-original lang=en>Shared workers receive message ports through <code
1357 wakaba 1.29 title=event-WorkerGlobalScope-connect>connect</code> events on their
1358     global object for each connection.
1359    
1360 wakaba 1.36 </span><span class=ja-translation lang=ja>共有労働者は、各接続について大域オブジェクトの <code
1361     title=event-WorkerGlobalScope-connect>connect</code> 事象を通じてメッセージ・ポートを受信します。</span><p class="no-ja-translation" data-ja-hash="2cefcb206282ea1a0a38229d76567b14"><span class=en-original lang=en>The <dfn id=name
1362 wakaba 1.29 title=dom-SharedWorkerGlobalScope-name><code>name</code></dfn> attribute
1363     must return the value it was assigned when the <code><a
1364     href="#sharedworkerglobalscope">SharedWorkerGlobalScope</a></code> object
1365     was created by the "<a href="#run-a">run a worker</a>" algorithm. Its
1366     value represents the name that can be used to obtain a reference to the
1367     worker using the <code><a href="#sharedworker">SharedWorker</a></code>
1368     constructor.
1369    
1370 wakaba 1.36 </span><p class="no-ja-translation" data-ja-hash="586e890e429389a63f2656c2d194935f"><span class=en-original lang=en>The following are the <span>event handler DOM attributes</span> that
1371 wakaba 1.29 must be supported by objects implementing the <code><a
1372     href="#sharedworkerglobalscope">SharedWorkerGlobalScope</a></code>
1373     interface:
1374    
1375 wakaba 1.36 </span><dl>
1376     <dt class="no-ja-translation" data-ja-hash="bb403ab8991a4f893a1ad1d0ffad30b0"><span class=en-original lang=en><dfn id=onconnect
1377 wakaba 1.29 title=handler-SharedWorkerGlobalScope-onconnect><code>onconnect</code></dfn>
1378    
1379 wakaba 1.36 </span><dd>
1380     <p class="has-ja-translation" data-ja-hash="91a2ce3a21f7ed687afe756baa5387d8" data-ja-real-hash="848b5a001778cd88e138b16d00959122"><span class=en-original lang=en>Must be invoked whenever a <code
1381 wakaba 1.32 title=event-SharedWorkerGlobalScope-connect>connect</code> event is
1382     targeted at or bubbles through the <code><a
1383     href="#sharedworkerglobalscope">SharedWorkerGlobalScope</a></code>
1384     object.
1385     </span><span class=ja-translation lang=ja><code title=event-SharedWorkerGlobalScope-connect>connect</code> 事象が当該 <code><a href="#sharedworkerglobalscope">SharedWorkerGlobalScope</a></code> オブジェクトを対象としているか、泡立って当該オブジェクトを通過する時に、
1386 wakaba 1.29 呼び出されなければなりません。</span></dl>
1387 wakaba 1.23
1388 wakaba 1.36 <h3 id=base-urls class="has-ja-translation" data-ja-hash="87cf5066db3fe786def6b713cf422c90"><span class=en-original lang=en><span class=secno>2.2 </span>Base URLs and origins of
1389 wakaba 1.32 workers</span><span class=ja-translation lang=ja><span class=secno>2.2 </span>労働者の基底 URL と起源</span></h3>
1390 wakaba 1.16
1391 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="7f0ec0a21b0d5485348f47fb8c3ac07a"><span class=en-original lang=en>Both the <span>origin</span> and <span>effective script origin</span> of
1392 wakaba 1.22 scripts running in workers are the <span>origin</span> of the
1393 wakaba 1.46 <span>absolute URL</span> given in that the worker's <code
1394 wakaba 1.23 title=dom-WorkerGlobalScope-location><a
1395     href="#location">location</a></code> attribute represents.
1396 wakaba 1.22
1397 wakaba 1.46 </span><h3 id=the-event class="no-ja-translation" data-ja-hash="96715962ce61ea28085d7e170ec30e73"><span class=en-original lang=en><span class=secno>2.3 </span>The event loop</span></h3>
1398 wakaba 1.22
1399 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="8046b35e9604831cd24f5fd09bb3b9de"><span class=en-original lang=en>Each <code><a href="#workerglobalscope">WorkerGlobalScope</a></code>
1400     object is asssociated with a <span>event loop</span>. This <span>event
1401     loop</span> has no associated <span>browsing context</span>, and its <span
1402     title="task queue">task queues</span> only have events, callbacks, and
1403     networking activity as <span title=concept-task>tasks</span>. The
1404     processing model of these <span title="event loop">event loops</span> is
1405     defined below in the <a href="#run-a">run a worker</a> algorithm.
1406 wakaba 1.31
1407 wakaba 1.36 </span><p class="no-ja-translation" data-ja-hash="3c5a8b0b9b710969e93d11ed5ae2ce7e"><span class=en-original lang=en>Each <code><a href="#workerglobalscope">WorkerGlobalScope</a></code>
1408 wakaba 1.29 object also has a <dfn id=closing
1409     title=dom-WorkerGlobalScope-closing>closing</dfn> flag, which must
1410     initially be false, but which can get set to true by the algorithms in the
1411     processing model section below.
1412    
1413 wakaba 1.46 </span><p class="no-ja-translation" data-ja-hash="f6e75a83e42204ac3c8508f490737285"><span class=en-original lang=en>Once the <code><a
1414 wakaba 1.29 href="#workerglobalscope">WorkerGlobalScope</a></code>'s <a
1415     href="#closing" title=dom-WorkerGlobalScope-closing>closing</a> flag is
1416 wakaba 1.46 set to true, the <span>event loop</span>'s <span title="task queue">task
1417     queues</span> must discard any further <span
1418     title=concept-task>tasks</span> that would be added to them (tasks already
1419     on the queue are unaffected unless otherwise specified). Effectively, once
1420     the <a href="#closing" title=dom-WorkerGlobalScope-closing>closing</a>
1421     flag is true, timers stop firing, notifications for all pending
1422     asynchronous operations are dropped, etc.
1423 wakaba 1.22
1424 wakaba 1.36 </span><h3 id=the-workers class="has-ja-translation" data-ja-hash="b0a758845322b24463d7ebe35160f526"><span class=en-original lang=en><span class=secno>2.4 </span>The worker's ports</span><span class=ja-translation lang=ja><span class=secno>2.4 </span>労働者のポート</span></h3>
1425 wakaba 1.11
1426 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="15eb0638e0de7d0e159c1214c48ba569"><span class=en-original lang=en>Workers communicate with other workers and with <span title="browsing
1427 wakaba 1.32 context">browsing contexts</span> through <span title="channel
1428     messaging">message channels</span> and their <code>MessagePort</code>
1429     objects.
1430    
1431     </span><span class=ja-translation lang=ja>労働者は、メッセージ通信路とその <code>MessagePort</code>
1432 wakaba 1.46 オブジェクトを通じて、他の労働者や閲覧文脈と通信します。</span><p class="no-ja-translation" data-ja-hash="ccdafdb171657866dab61ba28a500549"><span class=en-original lang=en>Each <code><a href="#workerglobalscope">WorkerGlobalScope</a></code>
1433 wakaba 1.29 <var title="">worker global scope</var> has a list of <dfn
1434     id=the-workers0>the worker's ports</dfn>, which consists of all the
1435     <code>MessagePort</code> objects that are entangled with another port and
1436     that have one (but only one) port owned by <var title="">worker global
1437 wakaba 1.43 scope</var>. This list includes
1438     <!--all the <code>MessagePort</code> objects that are in events
1439 wakaba 1.46 pending in the <span>event loop</span>, as well as (commented out
1440     because in practice it makes no difference either way as far as I
1441     can tell, and it would be hard to strictly implement since these
1442 wakaba 1.43 ports might not yet be across the thread boundary)-->
1443     the implicit <code>MessagePort</code> in the case of <a
1444 wakaba 1.29 href="#dedicatedworkerglobalscope"
1445     title=DedicatedWorkerGlobalScope>dedicated workers</a>.
1446 wakaba 1.16
1447 wakaba 1.36 </span><hr>
1448 wakaba 1.16
1449 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="26f978b46778a94d4ba398e774af8b16"><span class=en-original lang=en>A worker is said to be a <dfn id=permissible>permissible worker</dfn> if
1450 wakaba 1.23 either:
1451    
1452 wakaba 1.36 </span><ul>
1453     <li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="1408e830059dcfb69df672a38b4b1286"><span class=en-original lang=en>at some point past or present a <code>MessagePort</code> owned by the
1454 wakaba 1.23 worker was entangled with a <code>MessagePort</code> <var
1455     title="">p</var> whose owner is a <code>Window</code> object whose
1456     <span>active document</span> is the <code>Document</code> that was that
1457     <span>browsing context</span>'s <span>active document</span> when <var
1458     title="">p</var> was created, and that <code>Document</code> is
1459     <span>fully active</span>, or
1460    
1461 wakaba 1.36 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="d7437726a136144eb08d9f005783cfee"><span class=en-original lang=en>at some point past or present a <code>MessagePort</code> owned by the
1462 wakaba 1.23 worker was entangled with a <code>MessagePort</code> owned by another
1463     worker that is currently a <a href="#permissible">permissible worker</a>.
1464 wakaba 1.36 </span></ul>
1465 wakaba 1.23
1466     <hr>
1467    
1468 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="236c5cb878bfd9b9303cc296c82764ac"><span class=en-original lang=en>A worker is said to be a <dfn id="en-protected">protected worker</dfn> if
1469 wakaba 1.23 either:
1470    
1471 wakaba 1.36 </span><span class=ja-translation lang=ja>労働者は、次のいずれかの場合、<dfn id=protected>保護労働者</dfn>であるといいます。</span><ul>
1472 wakaba 1.42 <li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="5b3798d7af8069986d09b7dc915cbf47"><span class=en-original lang=en>it has outstanding timers, database transactions, or network
1473     connections, and is a <a href="#permissible">permissible worker</a>, or
1474 wakaba 1.23
1475 wakaba 1.36 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="d7509b8da81775bedb5ee6522497f03d"><span class=en-original lang=en>there is a <a href="#protected">protected worker</a> that at some
1476 wakaba 1.23 point past or present owned a <code>MessagePort</code> that was entangled
1477     with a <code>MessagePort</code> owned by this worker.
1478 wakaba 1.36 </span></ul>
1479 wakaba 1.23
1480     <hr>
1481    
1482 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="dfc82489e5358f7b62384576218af90c"><span class=en-original lang=en>A worker is said to be an <dfn id=active>active needed worker</dfn> if
1483 wakaba 1.23 either:
1484    
1485 wakaba 1.36 </span><ul>
1486     <li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="96d00b9fb7eefe6bb33e07260d2353f9"><span class=en-original lang=en>the worker is a <a href="#protected">protected worker</a>, or
1487 wakaba 1.23
1488 wakaba 1.36 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="2699a98205d3a6b47ed37910f9896717"><span class=en-original lang=en>at least one of the <a href="#the-workers0">the worker's ports</a> is
1489 wakaba 1.23 entangled with a <code>MessagePort</code> <var title="">p</var> whose
1490     owner is a <code>Window</code> object whose <span>active document</span>
1491     is the <code>Document</code> that was that <span>browsing
1492     context</span>'s <span>active document</span> when that
1493     <code>MessagePort</code> <var title="">p</var> was created, and that
1494     <code>Document</code> is <span>fully active</span>, or
1495 wakaba 1.22
1496 wakaba 1.36 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="67f1204baba1d8bcbbfab28233d2b0d9"><span class=en-original lang=en>at least one of the <a href="#the-workers0">the worker's ports</a> has
1497 wakaba 1.22 an entangled <code>MessagePort</code> owned by a <code><a
1498     href="#workerglobalscope">WorkerGlobalScope</a></code> object that is
1499 wakaba 1.23 itself an <a href="#active">active needed worker</a>.
1500 wakaba 1.36 </span></ul>
1501 wakaba 1.22
1502     <hr>
1503    
1504 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="7642aaede09c23a089220c1421edcbec"><span class=en-original lang=en>A worker is said to be a <dfn id=suspendable>suspendable worker</dfn> if
1505 wakaba 1.23 it is not an <a href="#active">active needed worker</a> but either:
1506 wakaba 1.22
1507 wakaba 1.36 </span><ul>
1508     <li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="960ae661864050c379756482359cf786"><span class=en-original lang=en>at least one of the <a href="#the-workers0">the worker's ports</a> has
1509 wakaba 1.23 an entangled <code>MessagePort</code> owned by a <code>Window</code>
1510     object, or
1511    
1512 wakaba 1.36 </span><li><p class="no-ja-translation ja-translation-inserted" data-ja-hash="c6381c6ecda2bf8a5113dcf88b55f65f"><span class=en-original lang=en>at least one of the <a href="#the-workers0">the worker's ports</a> has
1513 wakaba 1.22 an entangled <code>MessagePort</code> owned by a <code><a
1514     href="#workerglobalscope">WorkerGlobalScope</a></code> object that is
1515 wakaba 1.23 itself a <span>needed worker</span>.
1516 wakaba 1.36 </span></ul>
1517 wakaba 1.16
1518 wakaba 1.36 <h3 id=processing class="has-ja-translation" data-ja-hash="4eeffb677544f6c8799408c6b9021b4c"><span class=en-original lang=en><span class=secno>2.5 </span>Processing model</span><span class=ja-translation lang=ja><span class=secno>2.5 </span>処理モデル</span></h3>
1519 wakaba 1.12
1520 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="6c621932d8bc183c82dfb194ec31737c"><span class=en-original lang=en>When a user agent is to <dfn id=run-a>run a worker</dfn> for a script
1521 wakaba 1.29 with <span>URL</span> <var title="">url</var>, a browsing context <var
1522 wakaba 1.46 title="">owner browsing context</var>, and with global scope <var
1523     title="">worker global scope</var>, it must run the following steps:
1524    
1525     </span><ol>
1526 wakaba 1.12 <li>
1527 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="6fdced8613c508a9db62b2a4bec3fba3"><span class=en-original lang=en>Create a completely separate and parallel execution environment (i.e.
1528 wakaba 1.30 a separate thread or process or equivalent construct), and run the rest
1529 wakaba 1.36 of these steps asychronously in that context.</span><span class=ja-translation lang=ja>完全に分離された並列の実行環境 (すなわち、別のスレッドやプロセスや等価な構造体) を作り、
1530     その文脈で非同期にこれらの段階の残りを走らせます。</span></p>
1531 wakaba 1.30
1532     <li>
1533 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="83920af54821d7c307267e9565d86ea3"><span class=en-original lang=en>Attempt to <span>fetch</span> the resource identified by <var
1534     title="">url</var>.</span></p>
1535 wakaba 1.12
1536 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="bcdbb2d404cc07bab9cf5d4d7c39f469"><span class=en-original lang=en>If the attempt fails, then for each <code><a
1537     href="#worker1">Worker</a></code> or <code><a
1538     href="#sharedworker">SharedWorker</a></code> object associated with <var
1539     title="">worker global scope</var>, <span>queue a task</span> to
1540     <span>fire a simple event</span> called <code
1541     title=event-error>error</code> at that object. Abort these steps.</span></p>
1542    
1543     <p class="no-ja-translation" data-ja-hash="5f99e80db6dd85e61521ca081da0a897"><span class=en-original lang=en>If the attempt succeeds, then let <var title="">source</var> be the
1544     text of the resource that was obtained.</span></p>
1545     <!-- XXX do we need
1546     to define character encoding decoding here? -->
1547     <p class="no-ja-translation" data-ja-hash="c880bce97c5a1aadccd8989fc4ec8551"><span class=en-original lang=en>Let <var title="">language</var> be JavaScript.</span></p>
1548 wakaba 1.12
1549 wakaba 1.36 <p class="note has-ja-translation" data-ja-hash="5ba762159d9de3f8bd326fe0bcfac206"><span class=en-original lang=en>As with <code>script</code> elements, the MIME type of the
1550 wakaba 1.32 script is ignored. Unlike with <code>script</code> elements, there is no
1551     way to override the type. It's always assumed to be JavaScript.</span><span class=ja-translation lang=ja><code>script</code> 要素と同様に、スクリプトの MIME 型は無視します。
1552 wakaba 1.12 <code>script</code> 要素とは異なり、
1553     型を上書きする方法はありません。スクリプトは常に JavaScript
1554     と仮定します。</span></p>
1555 wakaba 1.11 <!-- XXX people will complain about
1556     this. I guess we might want to examine the MIME type... -->
1557    
1558    
1559     <li>
1560 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="604d3f52a6756f627f0e747b0d06e6ae"><span class=en-original lang=en>A new <span title=concept-script>script</span> is now created, as
1561     follows.</span></p>
1562 wakaba 1.23
1563 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="2dfcd0f76cde607de6cc88d70f390825"><span class=en-original lang=en>Create a new <span>script execution environment</span> set up as
1564     appropriate for the scripting language <var title="">language</var>.</span></p>
1565    
1566     <p class="no-ja-translation" data-ja-hash="fdf8b5f9ba18a31a8f48670142f51442"><span class=en-original lang=en>Parse/compile/initialize <var title="">source</var> using that
1567     <span>script execution environment</span>, as appropriate for <var
1568     title="">language</var>, and thus obtain a <span>list of code
1569     entry-points</span>; set the <i>initial code entry-point</i> to the
1570     entry-point for any executable code to be immediately run.</span></p>
1571    
1572     <p class="no-ja-translation" data-ja-hash="129927904de4572e52f5bc380711aa10"><span class=en-original lang=en>Set the <span>script's global object</span> to <var title="">worker
1573 wakaba 1.36 global scope</var>.</span></p>
1574 wakaba 1.9
1575 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="02eeb9a0f925368a93666886c94bf9bf"><span class=en-original lang=en>Set the <span>script's browsing context</span> to <var title="">owner
1576     browsing context</var>.</span></p>
1577    
1578     <p class="no-ja-translation" data-ja-hash="99ad90cb28611ed3165f61e920e91176"><span class=en-original lang=en>Set the <span>script's character encoding</span> to UTF-8. (This is
1579     just used for encoding non-ASCII characters in the query component of
1580     URLs.)</span></p>
1581    
1582     <p class="no-ja-translation" data-ja-hash="7570c80d1bbf45f73eb74befed51740d"><span class=en-original lang=en>Set the <span>script's base URL</span> to <var title="">url</var>.</span></p>
1583 wakaba 1.9
1584 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="9f54fba41a34171b216a6a1d3c585815"><span class=en-original lang=en>Create a new <span>script group</span> and add the <span
1585     title=concept-script>script</span> to it.</span></p>
1586 wakaba 1.9
1587     <li>
1588 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="f548a19eebea0d9f12ddb68a933793f7"><span class=en-original lang=en><strong>Closing orphan workers</strong>: Start monitoring the worker
1589 wakaba 1.29 such that as soon as it stops being either an <a href="#active">active
1590     needed worker</a> or a <a href="#suspendable">suspendable worker</a>,
1591 wakaba 1.46 <var title="">worker global scope</var>'s <a href="#closing"
1592 wakaba 1.29 title=dom-WorkerGlobalScope-closing>closing</a> flag is set to true and
1593 wakaba 1.46 <span title="queue a task">a task is queued</span> to <span>fire a
1594     simple event</span> called <code title=event-close>close</code> at <var
1595     title="">worker global scope</var>.</span></p>
1596 wakaba 1.29
1597     <li>
1598 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="b95907577fdce09e85f276964e7aff6b"><span class=en-original lang=en><strong>Suspending workers</strong>: Start monitoring the worker, such
1599     that whenever <var title="">worker global scope</var>'s <a
1600 wakaba 1.29 href="#closing" title=dom-WorkerGlobalScope-closing>closing</a> flag is
1601     false and the worker is a <a href="#suspendable">suspendable worker</a>,
1602     the user agent suspends execution of script in that worker until such
1603     time as either the <a href="#closing"
1604     title=dom-WorkerGlobalScope-closing>closing</a> flag switches to true or
1605 wakaba 1.36 the worker stops being a <a href="#suspendable">suspendable worker</a>.</span></p>
1606 wakaba 1.29
1607     <li>
1608 wakaba 1.11
1609 wakaba 1.46 <li>
1610     <p class="no-ja-translation" data-ja-hash="80776610bb705112feb2564b4496fe2f"><span class=en-original lang=en><span title="jump to a code entry-point">Jump</span> to the <span
1611     title=concept-script>script</span>'s <i>initial code entry-point</i>,
1612     and let that run until it either returns, fails to catch an exception,
1613     or gets prematurely aborted by the "<a href="#kill-a">kill a worker</a>"
1614     or "<a href="#terminate">terminate a worker</a>" algorithms defined
1615     below.</span></p>
1616    
1617     <p class="note no-ja-translation" data-ja-hash="76ad23661ba827d4b68ad1fc3a138902"><span class=en-original lang=en>If the script gets aborted by the "<a href="#kill-a">kill a
1618 wakaba 1.23 worker</a>" algorithm, then that same algorithm will cause there to only
1619 wakaba 1.46 be a single <span title=concept-task>task</span> in the <span>event
1620     loop</span> at the next step, namely the task for the <code
1621     title=message-close>close</code> event. The "<a
1622     href="#terminate">terminate a worker</a>" algorithm removes all the
1623 wakaba 1.36 events.</span></p>
1624 wakaba 1.9
1625     <li>
1626 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="6e519912f34fcb58933d31516eec2c61"><span class=en-original lang=en><i title="">Event loop</i>: Wait until either there is a <span
1627     title=concept-task>task</span> in one of the <span>event loop</span>'s
1628     <span title="task queue">task queues</span> or <var title="">worker
1629     global scope</var>'s <a href="#closing"
1630     title=dom-WorkerGlobalScope-closing>closing</a> flag is set to true.</span></p>
1631    
1632     <li>
1633     <p class="no-ja-translation" data-ja-hash="bcc803e78dd6f07ff20eaa1ca0d23303"><span class=en-original lang=en>Run the oldest task on one of the <span>event loop</span>'s <span
1634     title="task queue">task queues</span>, if any. The user agent may pick
1635     any <span>task queue</span>.</span></p>
1636    
1637     <p class="note no-ja-translation" data-ja-hash="5fb6077bc30bf5b7fb16c61195f68ec4"><span class=en-original lang=en>The handling of events or the execution of callbacks might
1638     get prematurely aborted by the "<a href="#kill-a">kill a worker</a>" or
1639     "<a href="#terminate">terminate a worker</a>" algorithms defined below.</span></p>
1640 wakaba 1.9
1641     <li>
1642 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="0a62cf7225c4d215f05940236b695d05"><span class=en-original lang=en>Remove the task run in the previous step, if any, from its <span>task
1643     queue</span>.</span></p>
1644 wakaba 1.9
1645     <li>
1646 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="1e197805331dfc3aa6f8583697d9d623"><span class=en-original lang=en>If there are any more events in the <span>event loop</span>'s <span
1647     title="task queue">task queues</span> or if <var title="">worker global
1648     scope</var>'s <a href="#closing"
1649     title=dom-WorkerGlobalScope-closing>closing</a> flag is set to false,
1650     then jump back to the step above labeled <i>event loop</i>.</span></p>
1651 wakaba 1.9
1652     <li>
1653 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="76aff645037fb93242c0b3e0ed29b90b"><span class=en-original lang=en>Freeze the <span>script group</span>.</span></p>
1654    
1655     <p class="note no-ja-translation" data-ja-hash="d32bd424c711e966967069f368ca26ad"><span class=en-original lang=en>This kills timers, database transactions, etc.</span></p>
1656 wakaba 1.25
1657     <li>
1658 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="b39a2b11a64a8558d8c9ae5c739879a1"><span class=en-original lang=en>For each <code><a href="#worker1">Worker</a></code> or <code><a
1659     href="#sharedworker">SharedWorker</a></code> object associated with <var
1660     title="">worker global scope</var>, <span>queue a task</span> to
1661     <span>fire a simple event</span> called <code
1662     title=event-close>close</code> at that object.</span></p>
1663 wakaba 1.9 </ol>
1664    
1665     <hr>
1666    
1667 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="f73768ff3e63480f0df2f7a5a6b8f919"><span class=en-original lang=en>When a user agent is to <dfn id=kill-a>kill a worker</dfn> it must run
1668 wakaba 1.29 the following steps in parallel with the worker's main loop (the "<a
1669     href="#run-a">run a worker</a>" processing model defined above):
1670    
1671 wakaba 1.36 </span><ol>
1672 wakaba 1.14 <li>
1673 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="a76ddc03676d95e40e0240ba3be551c8"><span class=en-original lang=en>If the worker's <code><a
1674 wakaba 1.22 href="#workerglobalscope">WorkerGlobalScope</a></code> object's <a
1675 wakaba 1.46 href="#closing" title=dom-WorkerGlobalScope-closing>closing</a> flag is
1676     false, <span>queue a task</span> to <span>fire a simple event</span>
1677     called <code title=event-close>close</code> at the worker's <code><a
1678     href="#workerglobalscope">WorkerGlobalScope</a></code> object.
1679 wakaba 1.22
1680 wakaba 1.46 </span><li>
1681 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="6243c3e4951724a3633743634fccb06e"><span class=en-original lang=en>Set the worker's <code><a
1682 wakaba 1.29 href="#workerglobalscope">WorkerGlobalScope</a></code> object's <a
1683     href="#closing" title=dom-WorkerGlobalScope-closing>closing</a> flag to
1684     true.
1685 wakaba 1.22
1686 wakaba 1.36 </span><li>
1687     <p class="no-ja-translation" data-ja-hash="922d3b59e2016de5b33298ba10ada993"><span class=en-original lang=en>Wait a user-agent-defined amount of time. If the "<a href="#run-a">run
1688 wakaba 1.23 a worker</a>" processing model defined above immediately starts running
1689 wakaba 1.29 event listeners registered for the <code title=event-close>close</code>
1690     event, this time should not be zero &mdash; the idea is that the <code
1691     title=event-close>close</code> event can be used to clean up when
1692     shutting down unexpectedly.
1693    
1694 wakaba 1.36 </span><li>
1695 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="e062300b1a0b646e14e0f8d084f3ab6a"><span class=en-original lang=en>If there are any <span title=concept-task>tasks</span> queued in the
1696     <span>event loop</span>'s <span title="task queue">task queues</span>
1697 wakaba 1.29 other than the <code title=event-close>close</code> event that this
1698 wakaba 1.46 algorithm just added, discard them without processing them.
1699 wakaba 1.29
1700 wakaba 1.36 </span><li>
1701 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="e9d30d31f5050c8a6a15b9c403a3573a"><span class=en-original lang=en>If the <code title=event-close>close</code> event that this algorithm
1702     just queued hasn't yet been dispatched, then abort the script currently
1703 wakaba 1.29 running in the worker.
1704 wakaba 1.23
1705 wakaba 1.46 </span><li>
1706 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="a53f0acde0e4a21781c4b31d5a0f110a"><span class=en-original lang=en>Wait a user-agent-defined amount of time.
1707 wakaba 1.32
1708     </span><span class=ja-translation lang=ja>利用者エージェント定義の時間、待ちます。</span><li>
1709 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="6f55d58072eaadf9aaac96514d919df8"><span class=en-original lang=en>Abort the script currently running in the worker (if any script is
1710 wakaba 1.29 running, then it will be a handler for the <code
1711     title=event-close>close</code> event).
1712 wakaba 1.36 </span><span class=ja-translation lang=ja>労働者中で現在走っているスクリプトを停止します
1713     (何かスクリプトが走っているとすれば、それは <code
1714     title=event-close>close</code>
1715     事象の取扱器のはずです)。</span></ol>
1716 wakaba 1.9
1717 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="dbf283f17afc05f538d29f85dc0a52bf"><span class=en-original lang=en>User agents may invoke the "<a href="#kill-a">kill a worker</a>"
1718 wakaba 1.22 processing model on a worker at any time, e.g. in response to user
1719     requests, in response to CPU quota management, or when a worker stops
1720 wakaba 1.23 being an <a href="#active">active needed worker</a> if the worker
1721 wakaba 1.29 continues executing even after its <a href="#closing"
1722     title=dom-WorkerGlobalScope-closing>closing</a> flag was set to true.
1723 wakaba 1.16
1724 wakaba 1.36 </span><hr>
1725 wakaba 1.11
1726 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="6e6259fd5536a6ce6726b7f1f7ec2c72"><span class=en-original lang=en>When a user agent is to <dfn id=terminate>terminate a worker</dfn> it
1727 wakaba 1.30 must run the following steps in parallel with the worker's main loop (the
1728     "<a href="#run-a">run a worker</a>" processing model defined above):
1729 wakaba 1.22
1730 wakaba 1.36 </span><ol>
1731 wakaba 1.22 <li>
1732 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="6243c3e4951724a3633743634fccb06e"><span class=en-original lang=en>Set the worker's <code><a
1733 wakaba 1.22 href="#workerglobalscope">WorkerGlobalScope</a></code> object's <a
1734 wakaba 1.29 href="#closing" title=dom-WorkerGlobalScope-closing>closing</a> flag to
1735     true.
1736 wakaba 1.22
1737 wakaba 1.36 </span><li>
1738 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="a9cf50df3de2e3788a3125ace8cf61f5"><span class=en-original lang=en>If there are any <span title=concept-task>tasks</span> queued in the
1739     <span>event loop</span>'s <span title="task queue">task queues</span>,
1740     discard them without processing them.
1741 wakaba 1.22
1742 wakaba 1.36 </span><li>
1743     <p class="has-ja-translation" data-ja-hash="fcb471f3c8cace3a86095dcb29d25515"><span class=en-original lang=en>Abort the script currently running in the worker.
1744     </span><span class=ja-translation lang=ja>労働者中で現在走っているスクリプトを停止します。</span></ol>
1745 wakaba 1.11
1746 wakaba 1.36 <h3 id=creating class="has-ja-translation" data-ja-hash="f0a4732d38d01e3d103b68468f9fe234"><span class=en-original lang=en><span class=secno>2.6 </span>Creating workers</span><span class=ja-translation lang=ja><span class=secno>2.6 </span>労働者の作成</span></h3>
1747 wakaba 1.9
1748 wakaba 1.36 <h4 id=the-abstractworker class="has-ja-translation" data-ja-hash="fe5227371e801f4ac588d0d07472a900" data-ja-real-hash="9a7040b26903cb67873e70582b2e3a5b"><span class=en-original lang=en><span class=secno>2.6.1 </span>The <code><a
1749     href="#abstractworker">AbstractWorker</a></code> abstract interface</span><span class=ja-translation lang=ja><span class=secno>2.6.1 </span><code><a href="#abstractworker">AbstractWorker</a></code> 抽象界面</span></h4>
1750 wakaba 1.29
1751 wakaba 1.9 <pre
1752 wakaba 1.36 class="idl no-ja-translation" data-ja-hash="ca053e27763a221f744b59e28b9f1149"><span class=en-original lang=en>[NoInterfaceObject] interface <dfn id=abstractworker>AbstractWorker</dfn> {
1753 wakaba 1.29 attribute <span>EventListener</span> <a href="#onerror" title=handler-AbstractWorker-onerror>onerror</a>;
1754     attribute <span>EventListener</span> <a href="#onclose0" title=handler-AbstractWorker-onclose>onclose</a>;
1755 wakaba 1.36 };</span></pre>
1756 wakaba 1.29
1757 wakaba 1.42 <p class="no-ja-translation" data-ja-hash="e39a76d762bfd9fb1a4ef6442ded36b3"><span class=en-original lang=en>Objects implementing the <code><a
1758     href="#abstractworker">AbstractWorker</a></code> interface must also
1759     implement the <code>EventTarget</code> interface.
1760    
1761     </span><p class="no-ja-translation" data-ja-hash="4f7356effb9eccb6268b11a363b0c51d"><span class=en-original lang=en>The following are the <span>event handler DOM attributes</span> that
1762 wakaba 1.29 must be supported by objects implementing the <code><a
1763     href="#abstractworker">AbstractWorker</a></code> interface:
1764    
1765 wakaba 1.36 </span><dl>
1766     <dt class="no-ja-translation" data-ja-hash="ca77fdf585a46daf6ec6823b345faf98"><span class=en-original lang=en><dfn id=onerror
1767 wakaba 1.29 title=handler-AbstractWorker-onerror><code>onerror</code></dfn>
1768    
1769 wakaba 1.36 </span><dd>
1770     <p class="no-ja-translation" data-ja-hash="3998f6cd6a9193846f5e07b04202500c"><span class=en-original lang=en>Must be invoked whenever an <code title=event-error>error</code> event
1771 wakaba 1.29 is targeted at or bubbles through the <code><a
1772     href="#abstractworker">AbstractWorker</a></code> object.
1773    
1774 wakaba 1.36 </span><dt class="no-ja-translation" data-ja-hash="a66f8d800a45cc2273dc71888c78ecd0"><span class=en-original lang=en><dfn id=onclose0
1775 wakaba 1.29 title=handler-AbstractWorker-onclose><code>onclose</code></dfn>
1776    
1777 wakaba 1.36 </span><dd>
1778     <p class="no-ja-translation" data-ja-hash="90325fa5f5171b4f558eabaeac83bba8"><span class=en-original lang=en>Must be invoked whenever an <code title=event-close>close</code> event
1779 wakaba 1.29 is targeted at or bubbles through the <code><a
1780     href="#abstractworker">AbstractWorker</a></code> object.
1781 wakaba 1.36 </span></dl>
1782 wakaba 1.25
1783 wakaba 1.36 <h4 id=dedicated0 class="no-ja-translation" data-ja-hash="a19aaade72c8a5d27a02c8d16642f277"><span class=en-original lang=en><span class=secno>2.6.2 </span>Dedicated workers and the
1784     <code><a href="#worker1">Worker</a></code> interface</span></h4>
1785 wakaba 1.25
1786 wakaba 1.42 <pre class="idl no-ja-translation" data-ja-hash="32d3d5044c9b55b10e14109dbfa650ff"><span class=en-original lang=en>[NoInterfaceObject,
1787 wakaba 1.29 <a href="#worker2" title=dom-Worker>Constructor</a>(in DOMString scriptURL)]
1788     interface <dfn id=worker1>Worker</dfn> : <a href="#abstractworker">AbstractWorker</a> {
1789 wakaba 1.42 void <a href="#terminate0" title=dom-Worker-terminate>terminate</a>();
1790 wakaba 1.29
1791 wakaba 1.30 void <a href="#postmessage0" title=dom-Worker-postMessage>postMessage</a>(in DOMString message);
1792 wakaba 1.42 void <a href="#postmessage0" title=dom-Worker-postMessage>postMessage</a>(in DOMString message, in <span>MessagePort</span> messagePort);<!--
1793     <span>MessagePort</span> <span title="dom-Worker-startConversation">startConversation</span>(in DOMString message);-->
1794 wakaba 1.29 attribute <span>EventListener</span> <a href="#onmessage0" title=handler-Worker-onmessage>onmessage</a>;
1795 wakaba 1.36 };</span></pre>
1796 wakaba 1.9
1797 wakaba 1.42 <p class="no-ja-translation" data-ja-hash="de30b8d41bcd89009d2aef1d62ea0b46"><span class=en-original lang=en>The <dfn id=terminate0
1798     title=dom-Worker-terminate><code>terminate()</code></dfn> method, when
1799     invoked, must cause the "<a href="#terminate">terminate a worker</a>"
1800     algorithm to be run on the worker with with the object is associated.
1801 wakaba 1.29
1802 wakaba 1.36 </span><p class="no-ja-translation" data-ja-hash="5bc910b7c194db663b68f5a7d4c10a61"><span class=en-original lang=en><code><a href="#worker1">Worker</a></code> objects act as if they had an
1803 wakaba 1.29 implicit <code>MessagePort</code> associated with them. This port is part
1804     of a channel that is set up when the worker is created, but it is not
1805     exposed. This object must never be garbage collected before the <code><a
1806     href="#worker1">Worker</a></code> object.
1807    
1808 wakaba 1.36 </span><p class="no-ja-translation" data-ja-hash="6913e4a1e1b8f864b65900e6b4f480ed"><span class=en-original lang=en>All messages received by that port must immediately be retargetted at
1809 wakaba 1.29 the <code><a href="#worker1">Worker</a></code> object.
1810    
1811 wakaba 1.42 </span><p class="no-ja-translation" data-ja-hash="5e032d219f702b8b96f218aacfba4c26"><span class=en-original lang=en>The <dfn id=postmessage0
1812     title=dom-Worker-postMessage><code>postMessage()</code></dfn><!--
1813     and <dfn
1814     title="dom-Worker-startConversation"><code>startConversation()</code></dfn>-->
1815     method<!--s (startConversation)--> on <code><a
1816     href="#worker1">Worker</a></code> objects must act as if, when invoked,
1817     it<!--/they (startConversation)--> immediately invoked the method of the
1818     same name on the port, with the same arguments, and returned the same
1819     return value.
1820 wakaba 1.29
1821 wakaba 1.36 </span><p class="no-ja-translation" data-ja-hash="e5b4a11fecaff5acef7e63837606f9a6"><span class=en-original lang=en>The following are the <span>event handler DOM attributes</span> that
1822 wakaba 1.29 must be supported by objects implementing the <code><a
1823     href="#worker1">Worker</a></code> interface:
1824    
1825 wakaba 1.36 </span><dl>
1826     <dt class="no-ja-translation" data-ja-hash="1e7efb7f0b77ed1e6f543f6c9cc3387e"><span class=en-original lang=en><dfn id=onmessage0
1827 wakaba 1.29 title=handler-Worker-onmessage><code>onmessage</code></dfn>
1828    
1829 wakaba 1.36 </span><dd>
1830     <p class="has-ja-translation" data-ja-hash="91a2ce3a21f7ed687afe756baa5387d8" data-ja-real-hash="c68f92321aa3d122a0022259f645a1d2"><span class=en-original lang=en>Must be invoked whenever a <code
1831 wakaba 1.32 title=event-Worker-message>message</code> event is targeted at or
1832     bubbles through the <code><a href="#worker1">Worker</a></code> object.
1833     </span><span class=ja-translation lang=ja><code title=event-Worker-message>message</code> 事象が当該 <code><a href="#worker1">Worker</a></code> オブジェクトを対象としているか、泡立って当該オブジェクトを通過する時に、
1834 wakaba 1.29 呼び出されなければなりません。</span></dl>
1835 wakaba 1.22
1836     <hr>
1837 wakaba 1.13
1838 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="82fcc98f85490bca63805a347135340d"><span class=en-original lang=en>When the <dfn id=worker2 title=dom-Worker><code>Worker(<var
1839 wakaba 1.29 title="">scriptURL</var>)</code></dfn> constructor is invoked, the user
1840     agent must run the following steps:
1841    
1842 wakaba 1.36 </span><ol>
1843 wakaba 1.13 <li>
1844 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="3219e42f1040482201a693e248f580cb"><span class=en-original lang=en><span title="resolve a url">Resolve</span> the <var
1845 wakaba 1.32 title="">scriptURL</var> argument.
1846    
1847     </span><span class=ja-translation lang=ja><var
1848 wakaba 1.15 title="">scriptURL</var> 引数を<span title="resolve a url">解決</span>します。</span><li>
1849 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="160444b5a61c1e71f39825a01936237f"><span class=en-original lang=en>If this fails, throw a <code>SYNTAX_ERR</code> exception.
1850 wakaba 1.32
1851     </span><span class=ja-translation lang=ja>これが失敗した場合、 <code>SYNTAX_ERR</code>
1852 wakaba 1.15 例外を投げます。</span><li>
1853 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="b087dd24bd7b57655bef9f719db30b9a"><span class=en-original lang=en>If the <span>origin</span> of the resulting <span>absolute URL</span>
1854 wakaba 1.29 is not the <span title="same origin">same</span> as the origin of the
1855     script that invoked the constructor, then throw a <span>security
1856     exception</span>.
1857    
1858 wakaba 1.36 </span><li>
1859 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="1b3db8a7e7ece473ac900f50243dc62c"><span class=en-original lang=en><span>Create a new <code><a
1860 wakaba 1.29 href="#dedicatedworkerglobalscope">DedicatedWorkerGlobalScope</a></code>
1861 wakaba 1.46 object</span>. Let <var title="">worker global scope</var> be this new
1862     object.
1863 wakaba 1.29
1864 wakaba 1.36 </span><li>
1865 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="ed81333a6158bdeffac41bdff6ec3c5a"><span class=en-original lang=en>Create a new <code><a href="#worker1">Worker</a></code> object,
1866     associated with <var title="">worker global scope</var>. Let <var
1867     title="">worker</var> be this new object.
1868 wakaba 1.29
1869 wakaba 1.36 </span><li>
1870     <p class="no-ja-translation" data-ja-hash="07cc057567324a83e25ec6344dc011a7"><span class=en-original lang=en><span>Create a <code>MessagePort</code> object</span> owned by the
1871 wakaba 1.29 <span>script execution context</span> of the script that invoked the
1872     method. Let this be the <var title="">outside port</var>.
1873    
1874 wakaba 1.36 </span><li>
1875     <p class="has-ja-translation" data-ja-hash="91024eaaebdc23ea683ace1b3e316962"><span class=en-original lang=en>Associate the <var title="">outside port</var> with <var
1876 wakaba 1.29 title="">worker</var>.
1877    
1878 wakaba 1.36 </span><span class=ja-translation lang=ja><var title="">outside port</var> を <var
1879     title="">worker</var> に関連付けます。</span><li>
1880 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="2d1b035dbaad3feca57eb124d161b034"><span class=en-original lang=en><span>Create a <code>MessagePort</code> object</span> owned by <var
1881     title="">worker global scope</var>. Let <var title="">inside port</var>
1882     be this new object.
1883 wakaba 1.29
1884 wakaba 1.46 </span><li>
1885     <p class="no-ja-translation" data-ja-hash="c7df111ebbfeab4bffdbe80d19fdb0ba"><span class=en-original lang=en>Associate <var title="">inside port</var> with <var title="">worker
1886     global scope</var>.
1887 wakaba 1.29
1888 wakaba 1.46 </span><li>
1889 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="bf2642ced659847cb4402165d2ab3a8e"><span class=en-original lang=en><span>Entangle</span> <var title="">outside port</var> and <var
1890 wakaba 1.29 title="">inside port</var>.
1891    
1892 wakaba 1.36 </span><li>
1893     <p class="has-ja-translation" data-ja-hash="2c5bd80faeda34c67a2533f32a477c51"><span class=en-original lang=en>Return <var title="">worker</var>, and run the following steps
1894 wakaba 1.29 asynchronously.
1895    
1896 wakaba 1.36 </span><span class=ja-translation lang=ja><var title="">worker</var> を返し、以降の段階を非同期に走らせます。</span><li>
1897     <p class="has-ja-translation" data-ja-hash="faa1ae1399f8e4f6b212fe45bba07893"><span class=en-original lang=en>Open <var title="">inside port</var>'s <span>port message
1898 wakaba 1.29 queue</span>.
1899    
1900 wakaba 1.36 </span><span class=ja-translation lang=ja><var title="">inside port</var> の<span>ポート・メッセージ待ち行列</span>を開きます。</span><li>
1901     <p class="has-ja-translation" data-ja-hash="5eaa92a75cbbf580809052327262059a"><span class=en-original lang=en>Open <var title="">outside port</var>'s <span>port message
1902 wakaba 1.30 queue</span>.
1903    
1904 wakaba 1.36 </span><span class=ja-translation lang=ja><var title="">outside port</var> の<span>ポート・メッセージ待ち行列</span>を開きます。</span><li>
1905 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="13490b80df7f929a817aaedc342318df"><span class=en-original lang=en><a href="#run-a">Run a worker</a> for the resulting <span>absolute
1906     URL</span>, with the <span>script browsing context</span> of the script
1907     that invoked the method as the <var title="">owner browsing
1908     context</var>, and with <var title="">worker global scope</var> as the
1909     global scope.</span></p>
1910 wakaba 1.25 </ol>
1911 wakaba 1.11
1912 wakaba 1.36 <h4 id=shared1 class="no-ja-translation" data-ja-hash="660755479f7743bee608286560e94bfd"><span class=en-original lang=en><span class=secno>2.6.3 </span>Shared workers and the
1913     <code><a href="#sharedworker">SharedWorker</a></code> interface</span></h4>
1914 wakaba 1.29
1915 wakaba 1.36 <pre class="idl no-ja-translation" data-ja-hash="e9f64514cc5486960acf6e0d6fda83c8"><span class=en-original lang=en>[NoInterfaceObject,
1916 wakaba 1.29 <a href="#sharedworker0" title=dom-SharedWorker>Constructor</a>(in DOMString scriptURL, in DOMString name)]
1917     interface <dfn id=sharedworker>SharedWorker</dfn> : <a href="#abstractworker">AbstractWorker</a> {
1918     readonly attribute <code>MessagePort</code> <a href="#port" title=dom-SharedWorker-port>port</a>;
1919 wakaba 1.36 };</span></pre>
1920 wakaba 1.29
1921 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="fa90f278bf10ccc803f16340cb3454f3"><span class=en-original lang=en>The <dfn id=port title=dom-SharedWorker-port><code>port</code></dfn>
1922 wakaba 1.29 attribute must return the value it was assigned by the object's
1923     constructor. It represents the <code>MessagePort</code> for communicating
1924     with the shared worker.
1925    
1926 wakaba 1.36 </span><p class="no-ja-translation" data-ja-hash="ec56f4c5071ac285686586d381295796"><span class=en-original lang=en>When the <dfn id=sharedworker0
1927 wakaba 1.29 title=dom-SharedWorker><code>SharedWorker(<var title="">scriptURL</var>,
1928     <var title="">name</var>)</code></dfn> constructor is invoked, the user
1929     agent must run the following steps:
1930 wakaba 1.11
1931 wakaba 1.36 </span><ol>
1932 wakaba 1.13 <li>
1933 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="3219e42f1040482201a693e248f580cb"><span class=en-original lang=en><span title="resolve a url">Resolve</span> the <var
1934 wakaba 1.32 title="">scriptURL</var> argument.
1935    
1936     </span><span class=ja-translation lang=ja><var
1937 wakaba 1.15 title="">scriptURL</var> 引数を<span title="resolve a url">解決</span>します。</span><li>
1938 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="160444b5a61c1e71f39825a01936237f"><span class=en-original lang=en>If this fails, throw a <code>SYNTAX_ERR</code> exception.
1939 wakaba 1.32
1940     </span><span class=ja-translation lang=ja>これが失敗した場合、 <code>SYNTAX_ERR</code>
1941 wakaba 1.15 例外を投げます。</span><li>
1942 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="b087dd24bd7b57655bef9f719db30b9a"><span class=en-original lang=en>If the <span>origin</span> of the resulting <span>absolute URL</span>
1943 wakaba 1.29 is not the <span title="same origin">same</span> as the origin of the
1944     script that invoked the constructor, then throw a <span>security
1945     exception</span>.
1946    
1947 wakaba 1.36 </span><li>
1948     <p class="has-ja-translation" data-ja-hash="683a2c0080e014b9eae98b884ccaf7e4"><span class=en-original lang=en>Execute the following substeps atomically:</span><span class=ja-translation lang=ja>次の部分段階群を原子的に実行します。</span></p>
1949 wakaba 1.13
1950     <ol>
1951     <li>
1952 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="2800d1a8667906afc331a67e21d9ea29"><span class=en-original lang=en>Create a new <code><a href="#sharedworker">SharedWorker</a></code>
1953 wakaba 1.29 object, which will shortly be associated with a <code><a
1954     href="#sharedworkerglobalscope">SharedWorkerGlobalScope</a></code>
1955     object. Let this <code><a href="#sharedworker">SharedWorker</a></code>
1956     object be <var title="">worker</var>.
1957 wakaba 1.22
1958 wakaba 1.36 </span><li>
1959     <p class="no-ja-translation" data-ja-hash="07cc057567324a83e25ec6344dc011a7"><span class=en-original lang=en><span>Create a <code>MessagePort</code> object</span> owned by the
1960 wakaba 1.29 <span>script execution context</span> of the script that invoked the
1961     method. Let this be the <var title="">outside port</var>.
1962 wakaba 1.25
1963 wakaba 1.36 </span><li>
1964     <p class="no-ja-translation" data-ja-hash="95cd5e27932141432ed9ff6323032568"><span class=en-original lang=en>Assign <var title="">outside port</var> to the <code
1965 wakaba 1.29 title=dom-SharedWorker-port><a href="#port">port</a></code> attribute
1966     of <var title="">worker</var>.
1967 wakaba 1.25
1968 wakaba 1.36 </span><li>
1969     <p class="no-ja-translation" data-ja-hash="5aec0369bd40bfd0f0ff2dc70f75b9f5"><span class=en-original lang=en>If there exists a <code><a
1970 wakaba 1.29 href="#sharedworkerglobalscope">SharedWorkerGlobalScope</a></code>
1971     object whose <a href="#closing"
1972     title=dom-WorkerGlobalScope-closing>closing</a> flag is false, whose
1973     <code title=dom-WorkerGlobalScope-name>name</code> attribute is
1974     exactly equal to the <var title="">name</var> argument, and whose
1975     <code title=dom-WorkerGlobalScope-location><a
1976     href="#location">location</a></code> attribute represents an
1977     <span>absolute URL</span> that has the <span>same origin</span> as the
1978 wakaba 1.36 resulting <span>absolute URL</span>, then run these substeps:</span></p>
1979 wakaba 1.25
1980 wakaba 1.29 <ol>
1981     <li>
1982 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="826754f668578065470b1f9de24553bc"><span class=en-original lang=en>Let <var title="">worker global scope</var> be that <code><a
1983 wakaba 1.29 href="#sharedworkerglobalscope">SharedWorkerGlobalScope</a></code>
1984     object.
1985    
1986 wakaba 1.36 </span><li>
1987     <p class="no-ja-translation" data-ja-hash="7b6f8fa4ae92ed20dd16a2fb90c3e618"><span class=en-original lang=en>If <var title="">worker global scope</var>'s <code
1988 wakaba 1.29 title=dom-WorkerGlobalScope-location><a
1989     href="#location">location</a></code> attribute represents an
1990     <span>absolute URL</span> that is not exactly equal to the resulting
1991     <span>absolute URL</span>, then throw a
1992     <code>URL_MISMATCH_ERR</code> exception and abort all these steps.
1993     <span class=big-issue>code 21</span>
1994    
1995 wakaba 1.36 </span><li>
1996     <p class="has-ja-translation" data-ja-hash="9c4f87efaa1e868cd6bf63dbffa749c0"><span class=en-original lang=en>Associate <var title="">worker</var> with <var title="">worker
1997 wakaba 1.29 global scope</var>.
1998    
1999 wakaba 1.36 </span><span class=ja-translation lang=ja><var title="">worker</var> を <var title="">worker
2000     global scope</var> に関連付けます。</span><li>
2001 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="bab9c8cea075e0f3614c731f09b49892"><span class=en-original lang=en><span>Create a <code>MessagePort</code> object</span> owned by
2002 wakaba 1.29 <var title="">worker global scope</var>. Let this be the <var
2003     title="">inside port</var>.
2004    
2005 wakaba 1.46 </span><li>
2006 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="bf2642ced659847cb4402165d2ab3a8e"><span class=en-original lang=en><span>Entangle</span> <var title="">outside port</var> and <var
2007 wakaba 1.29 title="">inside port</var>.
2008    
2009 wakaba 1.36 </span><li>
2010     <p class="has-ja-translation" data-ja-hash="ebb713e9e29aab450d79b533c42b67ae"><span class=en-original lang=en>Return <var title="">worker</var> and perform the next step
2011 wakaba 1.29 asynchronously.
2012    
2013 wakaba 1.36 </span><span class=ja-translation lang=ja><var title="">worker</var> を返し、
2014     次の段階を非同期に実行します。</span><li>
2015 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="59d27c5ea77ba33df367bcf4df580a15"><span class=en-original lang=en>Create an event that uses the <code>MessageEvent</code> interface,
2016 wakaba 1.29 with the name <code title=event-connect>connect</code>, which does
2017     not bubble, is cancelable, has no default action, has a <code
2018     title=dom-MessageEvent-data>data</code> attribute whose value is the
2019     empty string and has a <code
2020     title=dom-MessageEvent-messagePort>messagePort</code> attribute
2021 wakaba 1.46 whose value is the newly created port, and <span>queue a task</span>
2022     to dispatch the event at <var title="">worker global scope</var>.
2023 wakaba 1.29
2024 wakaba 1.36 </span><li>
2025     <p class="has-ja-translation" data-ja-hash="dd866391287c967d4799df78a7249911"><span class=en-original lang=en>Abort all these steps.
2026     </span><span class=ja-translation lang=ja>これらの段階をすべて停止します。</span></ol>
2027 wakaba 1.11
2028 wakaba 1.29 <li>
2029 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="3431d32f7d58431abbb9fd0e6f63d6a1"><span class=en-original lang=en><span>Create a new <code><a
2030 wakaba 1.29 href="#sharedworkerglobalscope">SharedWorkerGlobalScope</a></code>
2031 wakaba 1.46 object</span>. Let <var title="">worker global scope</var> be this new
2032     object.
2033 wakaba 1.11
2034 wakaba 1.36 </span><li>
2035     <p class="has-ja-translation" data-ja-hash="9c4f87efaa1e868cd6bf63dbffa749c0"><span class=en-original lang=en>Associate <var title="">worker</var> with <var title="">worker
2036 wakaba 1.29 global scope</var>.
2037 wakaba 1.23
2038 wakaba 1.36 </span><span class=ja-translation lang=ja><var title="">worker</var> を <var title="">worker
2039     global scope</var> に関連付けます。</span><li>
2040 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="c285d8b77f24f839bfaaa69b872159c8"><span class=en-original lang=en>Set the <code title=dom-SharedWorkerGlobalScope-name><a
2041 wakaba 1.29 href="#name">name</a></code> attribute of <var title="">worker global
2042 wakaba 1.46 scope</var> to <var title="">name</var>.
2043 wakaba 1.11
2044 wakaba 1.36 </span><li>
2045 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="2d1b035dbaad3feca57eb124d161b034"><span class=en-original lang=en><span>Create a <code>MessagePort</code> object</span> owned by <var
2046     title="">worker global scope</var>. Let <var title="">inside
2047     port</var> be this new object.
2048 wakaba 1.11
2049 wakaba 1.46 </span><li>
2050 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="bf2642ced659847cb4402165d2ab3a8e"><span class=en-original lang=en><span>Entangle</span> <var title="">outside port</var> and <var
2051 wakaba 1.29 title="">inside port</var>.
2052 wakaba 1.36 </span></ol>
2053 wakaba 1.13
2054     <li>
2055 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="ebb713e9e29aab450d79b533c42b67ae"><span class=en-original lang=en>Return <var title="">worker</var> and perform the next step
2056 wakaba 1.29 asynchronously.
2057 wakaba 1.25
2058 wakaba 1.36 </span><span class=ja-translation lang=ja><var title="">worker</var> を返し、
2059     次の段階を非同期に実行します。</span><li>
2060 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="59d27c5ea77ba33df367bcf4df580a15"><span class=en-original lang=en>Create an event that uses the <code>MessageEvent</code> interface,
2061 wakaba 1.22 with the name <code title=event-connect>connect</code>, which does not
2062     bubble, is cancelable, has no default action, has a <code
2063     title=dom-MessageEvent-data>data</code> attribute whose value is the
2064     empty string and has a <code
2065     title=dom-MessageEvent-messagePort>messagePort</code> attribute whose
2066 wakaba 1.46 value is the newly created port, and <span>queue a task</span> to
2067     dispatch the event at <var title="">worker global scope</var>.
2068 wakaba 1.23
2069 wakaba 1.36 </span><li>
2070 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="13490b80df7f929a817aaedc342318df"><span class=en-original lang=en><a href="#run-a">Run a worker</a> for the resulting <span>absolute
2071     URL</span>, with the <span>script browsing context</span> of the script
2072     that invoked the method as the <var title="">owner browsing
2073     context</var>, and with <var title="">worker global scope</var> as the
2074     global scope.</span></p>
2075 wakaba 1.22 </ol>
2076 wakaba 1.15
2077 wakaba 1.36 <h2 id=apis-available class="has-ja-translation" data-ja-hash="4fce100e6a2eccbb2df8631a438feeb6"><span class=en-original lang=en><span class=secno>3. </span>APIs available to workers</span><span class=ja-translation lang=ja><span class=secno>3. </span>労働者が利用可能な API</span></h2>
2078 wakaba 1.15
2079 wakaba 1.22 <pre
2080 wakaba 1.42 class="idl no-ja-translation" data-ja-hash="3182eceee661d96bf5db761b66eb5082"><span class=en-original lang=en>[NoInterfaceObject] interface <dfn id=workerutils>WorkerUtils</dfn> {
2081 wakaba 1.25 void <a href="#importscripts" title=dom-WorkerGlobalScope-importScripts>importScripts</a>([Variadic] in DOMString urls);
2082 wakaba 1.22 readonly attribute <span>Storage</span> <a href="#localstorage" title=dom-localStorage>localStorage</a>;
2083 wakaba 1.42 readonly attribute <a href="#navigator0">Navigator</a> <a href="#navigator" title=dom-navigator>navigator</a>;
2084 wakaba 1.22 <span>Database</span> <a href="#opendatabase" title=dom-opendatabase>openDatabase</a>(in DOMString name, in DOMString version, in DOMString displayName, in unsigned long estimatedSize);
2085     void <a href="#shownotification" title=dom-showNotification>showNotification</a>(in DOMString title, in DOMString subtitle, in DOMString description);
2086     void <a href="#shownotification" title=dom-showNotification>showNotification</a>(in DOMString title, in DOMString subtitle, in DOMString description, in VoidCallback onclick);
2087 wakaba 1.36 };</span></pre>
2088 wakaba 1.16
2089 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="fc1e0d30e2c0869e54fb2487a7dd6836" data-ja-real-hash="43ee0f4f7856a9484e5ed892bc4ab914"><span class=en-original lang=en>Objects that implement the <code><a
2090 wakaba 1.32 href="#workerglobalscope">WorkerGlobalScope</a></code> interface must also
2091     implement the <code><a href="#workerutils">WorkerUtils</a></code>
2092     interface.
2093    
2094 wakaba 1.42 </span><span class=ja-translation lang=ja><code><a href="#workerglobalscope">WorkerGlobalScope</a></code> 界面を実装するオブジェクトは、 <code><a href="#workerutils">WorkerUtils</a></code> 界面も実装しなければ<em class=rfc2119 title="MUST">なりません</em>。</span><p class="no-ja-translation" data-ja-hash="ee5c969b7e5c71d39f0fe9919b1173fe"><span class=en-original lang=en>Objects that implement the <code><a
2095     href="#workerutils">WorkerUtils</a></code> interface must also implement
2096     the <code>WindowTimers</code> interface. (This interface provides the
2097     <code title="">setTimeout()</code> method and its friends.)
2098 wakaba 1.16
2099 wakaba 1.42 </span><p class="big-issue no-ja-translation" data-ja-hash="fffa5f76ab27c1602edf28b5c8fbcc6d"><span class=en-original lang=en>Need to define a sync database API.</span></p>
2100 wakaba 1.16 <!-- XXX ApplicationCache -->
2101     <!-- XXX a way to set cookies on the URL for the script -->
2102     <!-- XXX debugging: void log(in DOMString s); // log to console -->
2103     <!-- XXX debugging: onerror -->
2104    
2105     <hr>
2106    
2107 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="59b28734296c1cd390d156b0e8e5fb94"><span class=en-original lang=en>The DOM APIs (<code>Node</code> objects, <code>Document</code> objects,
2108 wakaba 1.32 etc) are not available to workers in this version of this specification.
2109    
2110     </span><span class=ja-translation lang=ja>DOM API (<code>Node</code> オブジェクト、 <code>Document</code>
2111 wakaba 1.36 オブジェクト、その他) は、この版のこの仕様書では労働者に利用可能ではありません。</span><h3 id=importing class="has-ja-translation" data-ja-hash="e7522d998689dc52be80feeff81470ca"><span class=en-original lang=en><span class=secno>3.1 </span>Importing scripts and
2112     libraries</span><span class=ja-translation lang=ja><span class=secno>3.1 </span>スクリプトとライブラリーの輸入</span></h3>
2113 wakaba 1.22
2114 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="a50ee5d5d404f735326c6d0cb9ede11c"><span class=en-original lang=en>When a script invokes the <dfn id=importscripts
2115 wakaba 1.25 title=dom-WorkerGlobalScope-importScripts><code>importScripts(<var
2116     title="">urls</var>)</code></dfn> method on a <code><a
2117 wakaba 1.22 href="#workerglobalscope">WorkerGlobalScope</a></code> object, the user
2118     agent must run the following steps:
2119    
2120 wakaba 1.36 </span><ol>
2121 wakaba 1.22 <li>
2122 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="143a8bb07f4501807d2bbf2d2d2b345a"><span class=en-original lang=en>If there are no arguments, return without doing anything. Abort these
2123 wakaba 1.25 steps.
2124    
2125 wakaba 1.36 </span><span class=ja-translation lang=ja>引数がない場合、何も返さずに返ります。
2126     これらの段階を停止します。</span><li>
2127     <p class="has-ja-translation" data-ja-hash="b89818b453add85fbb5ec1e963e3072c"><span class=en-original lang=en><span title="resolve a url">Resolve</span> each argument.
2128 wakaba 1.22
2129 wakaba 1.36 </span><span class=ja-translation lang=ja>各引数を<span title="resolve a url">解決</span>します。</span><li>
2130     <p class="has-ja-translation" data-ja-hash="54adea3a3a07dd8833ad87eb937142f1"><span class=en-original lang=en>If any fail, throw a <code>SYNTAX_ERR</code> exception.
2131 wakaba 1.45 </span><span class=ja-translation lang=ja>いずれかが失敗した場合、 <code>SYNTAX_ERR</code> 例外を投げます。</span></li>
2132     <!--
2133     <li><p class="has-ja-translation" data-ja-hash="952d7bd44378695378ddf1084a1c5347"><span class=en-original lang=en>If any of the resulting <span title="absolute URL">absolute
2134     URLs</span> have an <span>origin</span> that is not the <span
2135     title="same origin">same</span> as the origin of the script that
2136     invoked the method, then throw a <span>security
2137     exception</span>.</span><span class=ja-translation lang=ja>結果として得られた<span title="absolute URL">絶対
2138 wakaba 1.36 URL</span>
2139     のいずれかが、メソッドを呼び出したスクリプトの<span>origin</span>と<span
2140     title="same origin">同じ</span>ではない起源を持つ場合、
2141 wakaba 1.45 <span>保安性例外</span>を投げます。</span></p></li>
2142     -->
2143 wakaba 1.42
2144     <li>
2145 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="9a0a1930525c4231da8248d6b7847c8d"><span class=en-original lang=en>Attempt to <span>fetch</span> each resource identified by the
2146     resulting <span title="absolute URLs">absolute URL</span>.</span><span class=ja-translation lang=ja>結果として得られた<span title="absolute URLs">絶対 URL</span>
2147     によって識別される資源をそれぞれ<span>取得</span>しようと試みます。</span></p>
2148 wakaba 1.22
2149     <li>
2150 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="4fc5f1898eb20e4c8da603b91c1ae884"><span class=en-original lang=en>For each argument in turn, in the order given, starting with the first
2151     one, run these substeps:</span><span class=ja-translation lang=ja>各引数について、与えられた順に最初のものから、次の部分段階群を走らせます。</span></p>
2152 wakaba 1.25
2153     <ol>
2154     <li>
2155 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="a5cd8fb5d75985afdc62f7ac228329d4"><span class=en-original lang=en>Wait for the fetching attempt for the corresponding resource to
2156     complete.</span><span class=ja-translation lang=ja>対応する資源を取得しようとする試みが完了するのを待ちます。</span></p>
2157 wakaba 1.25
2158 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="c821b5a32a4316df06e95e2117d4d21a"><span class=en-original lang=en>If the fetching attempt failed, throw a <code>NETWORK_ERR</code>
2159     exception and abort all these steps.</span></p>
2160    
2161     <p class="no-ja-translation" data-ja-hash="d6801f59b2563b0c5b83889b85620faa"><span class=en-original lang=en>If the fetching attempt succeeded, then let <var
2162     title="">source</var> be the text of the resource that was obtained,
2163     and let <var title="">language</var> be JavaScript.</span></p>
2164 wakaba 1.36
2165     <p class="note has-ja-translation" data-ja-hash="9d495d7b0fa2439cfa3470c4af977171"><span class=en-original lang=en>As with the worker's script, the script here is always
2166     assumed to be JavaScript, regardless of the MIME type.</span><span class=ja-translation lang=ja>労働者のスクリプトと同じく、ここでのスクリプトも、 MIME 型に関わらず常に
2167     JavaScript であるとみなします。</span></p>
2168 wakaba 1.25 <!-- XXX -->
2169    
2170     <li>
2171 wakaba 1.46 <p class="no-ja-translation" data-ja-hash="cf414ab741fec06cd9788dadd0849790"><span class=en-original lang=en><span>Create a script</span>, using <var title="">source</var> as
2172     the script source and <var title="">language</var> as the scripting
2173     language, using the same global object, browsing context, character
2174     encoding, base URL, and script group as the <span
2175     title=concept-script>script</span> that was created by the worker's <a
2176     href="#run-a">run a worker</a> algorithm.</span></p>
2177    
2178     <p class="no-ja-translation" data-ja-hash="c33e5168b4feb73106bd20c058fe035e"><span class=en-original lang=en>Let the newly created <span title=concept-script>script</span> run
2179     until it either returns, fails to parse, fails to catch an exception,
2180     or gets prematurely aborted by the "<a href="#kill-a">kill a
2181     worker</a>" or "<a href="#terminate">terminate a worker</a>"
2182     algorithms defined above.</span></p>
2183 wakaba 1.42
2184     <p class="no-ja-translation" data-ja-hash="41014f4a697396a3e02475a4d61a7472"><span class=en-original lang=en>If it failed to parse, then throw a
2185     <code>SyntaxError</code><!-- XXX ref? --> exception and abort all
2186     these steps.</span></p>
2187 wakaba 1.25
2188 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="c7d543d741a3d731cce1fac38ebfcb64"><span class=en-original lang=en>If an exception was raised or if the script was prematurely aborted,
2189 wakaba 1.25 then abort all these steps, letting the exception or aborting continue
2190     to be processed by the script that called the <code
2191     title=dom-WorkerGlobalScope-importScripts><a
2192 wakaba 1.36 href="#importscripts">importScripts()</a></code> method.</span></p>
2193 wakaba 1.22
2194 wakaba 1.42 <p class="no-ja-translation" data-ja-hash="468ae33f57bcaf9bf43e2113273491a6"><span class=en-original lang=en>If the "<a href="#kill-a">kill a worker</a>" or "<a
2195     href="#terminate">terminate a worker</a>" algorithms abort the script
2196 wakaba 1.36 then abort all these steps.</span></p>
2197 wakaba 1.25 </ol>
2198 wakaba 1.22 </ol>
2199    
2200 wakaba 1.42 <h3 id=the-navigator class="no-ja-translation" data-ja-hash="920dd52a11144ff4776fa357ce6245e1"><span class=en-original lang=en><span class=secno>3.2 </span>The <code><a
2201     href="#navigator0">Navigator</a></code> object</span></h3>
2202    
2203     <p class="no-ja-translation" data-ja-hash="2affbf4546661b0d28c37da361b1cf65"><span class=en-original lang=en>The <dfn id=navigator title=dom-navigator><code>navigator</code></dfn>
2204     attribute of the <code><a href="#workerutils">WorkerUtils</a></code>
2205     interface must return an instance of the <code><a
2206     href="#navigator0">Navigator</a></code> interface, which represents the
2207     identity and state of the user agent (the client):
2208    
2209     </span><pre
2210     class="idl no-ja-translation" data-ja-hash="bec6e4722ba670204ba345972b2f5b62"><span class=en-original lang=en>[NoInterfaceObject] interface <dfn id=navigator0>Navigator</dfn> {
2211     // objects implementing this interface also implement the interfaces listed below
2212     };</span></pre>
2213    
2214     <p class="no-ja-translation" data-ja-hash="cc1c14039bdbf516ffffc18ed475544f"><span class=en-original lang=en>Objects implementing the <code><a
2215     href="#navigator0">Navigator</a></code> interface must also implement the
2216     <span>NavigatorID</span> and <span>NavigatorOnLine</span> interfaces
2217     specified in the HTML5 specification. <a href="#refsHTML5">[HTML5]</a>
2218    
2219     </span><p class="note no-ja-translation" data-ja-hash="0b5a83138f5e72c3cbeff9a2b59e9920"><span class=en-original lang=en>The <code><a href="#navigator0">Navigator</a></code>
2220     interface defined in this specification is different than the one defined
2221     in the HTML5 specification.
2222    
2223     </span><h3 id=apis-defined class="has-ja-translation" data-ja-hash="d6d6885373ce92bfa8857f5a375a9c8f"><span class=en-original lang=en><span class=secno>3.3 </span>APIs defined in other
2224     specifications</span><span class=ja-translation lang=ja><span class=secno>3.3 </span>他の仕様書で定義されている API</span></h3>
2225 wakaba 1.22
2226 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="3c9a0dcc3dbfc7283eea34202de4d321"><span class=en-original lang=en>The <dfn id=localstorage
2227 wakaba 1.22 title=dom-localStorage><code>localStorage</code></dfn>, <dfn
2228     id=opendatabase title=dom-opendatabase><code>openDatabase()</code></dfn>
2229     must act as defined for the APIs with the same names on the
2230     <code>Window</code> object in the HTML5 specification, with the exception
2231     that where the API would use the <span>origin</span> of the <span>active
2232     document</span> of the <span>browsing context</span> of the
2233     <code>Window</code> object on which the method was supposedly invoked, it
2234     must instead use the <span>origin</span> of the script that invoked the
2235     method. <a href="#refsHTML5">[HTML5]</a>
2236    
2237 wakaba 1.36 </span><p class="no-ja-translation" data-ja-hash="6563db877bfe3b57772fed7dedbfc84b"><span class=en-original lang=en>The <dfn id=shownotification
2238 wakaba 1.22 title=dom-showNotification><code>showNotification()</code></dfn> methods
2239     must act as defined for the APIs with the same names on the
2240     <code>Window</code> object in the HTML5 specification. <a
2241     href="#refsHTML5">[HTML5]</a>
2242    
2243 wakaba 1.42 </span><h3 id=interface class="has-ja-translation" data-ja-hash="78e75b89c304218ef77a66cd9efdf398"><span class=en-original lang=en><span class=secno>3.4 </span>Interface objects and
2244     constructors</span><span class=ja-translation lang=ja><span class=secno>3.4 </span>界面オブジェクトと構築器</span></h3>
2245 wakaba 1.22
2246 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="2135421a70c368c728d0af40f99cee55"><span class=en-original lang=en>There must be no interface objects and constructors available in the
2247 wakaba 1.22 global scope of scripts whose <span>script execution context</span> is a
2248     <code><a href="#workerglobalscope">WorkerGlobalScope</a></code> object
2249     except for the following:
2250    
2251 wakaba 1.36 </span><ul>
2252 wakaba 1.22 <li>
2253 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="ee396bbb3d32ae2d31fc0a108ea3389c"><span class=en-original lang=en><code>XMLHttpRequest</code> and all interface objects and constructors
2254 wakaba 1.31 defined by the XMLHttpRequest specifications, except that the
2255     <span>document response entity body</span> must always be null. <a
2256     href="#refsXHR">[XHR]</a>
2257    
2258 wakaba 1.36 </span><li>
2259     <p class="has-ja-translation" data-ja-hash="3a205f7812c3029dcecfcbbd61199f90"><span class=en-original lang=en>The <code>WebSocket</code> interface object and constructor.
2260 wakaba 1.23
2261 wakaba 1.32 </span><span class=ja-translation lang=ja><code>WebSocket</code> 界面オブジェクトと構築器</span><li>
2262 wakaba 1.36 <p class="has-ja-translation" data-ja-hash="c537145c77e1103c3a76557f40172a5a"><span class=en-original lang=en>The <code>MessageChannel</code> interface object and constructor.
2263 wakaba 1.32
2264 wakaba 1.42 </span><span class=ja-translation lang=ja><code>MessageChannel</code> 界面オブジェクトと構築器</span><li>
2265     <p class="no-ja-translation" data-ja-hash="0b577152dfe727cea2b187ff18e26a57"><span class=en-original lang=en>The <code title=dom-Worker><a href="#worker2">Worker()</a></code> and
2266     <code title=dom-SharedWorker><a href="#sharedworker0">SharedWorker(<var
2267     title="">url</var>)</a></code> constructors.
2268     </span></ul>
2269    
2270     <h3 id=worker0 class="has-ja-translation" data-ja-hash="ae4aa0f882fcbd2ee8252e59113ec205"><span class=en-original lang=en><span class=secno>3.5 </span>Worker locations</span><span class=ja-translation lang=ja><span class=secno>3.5 </span>労働者の所在</span></h3>
2271 wakaba 1.23
2272     <pre
2273 wakaba 1.36 class="idl no-ja-translation" data-ja-hash="cf592219c4e6cd8a917cbb3071aebfd5"><span class=en-original lang=en>[NoInterfaceObject] interface <dfn id=workerlocation>WorkerLocation</dfn> {
2274 wakaba 1.23 readonly attribute DOMString <a href="#href" title=dom-WorkerLocation-href>href</a>;
2275     readonly attribute DOMString <a href="#protocol" title=dom-WorkerLocation-protocol>protocol</a>;
2276     readonly attribute DOMString <a href="#host" title=dom-WorkerLocation-host>host</a>;
2277     readonly attribute DOMString <a href="#hostname" title=dom-WorkerLocation-hostname>hostname</a>;
2278 wakaba 1.29 readonly attribute DOMString <a href="#port0" title=dom-WorkerLocation-port>port</a>;
2279 wakaba 1.23 readonly attribute DOMString <a href="#pathname" title=dom-WorkerLocation-pathname>pathname</a>;
2280     readonly attribute DOMString <a href="#search" title=dom-WorkerLocation-search>search</a>;
2281     readonly attribute DOMString <a href="#hash" title=dom-WorkerLocation-hash>hash</a>;
2282 wakaba 1.36 };</span></pre>
2283 wakaba 1.23
2284 wakaba 1.36 <p class="no-ja-translation" data-ja-hash="36debbc2eb6f1156c1bae8ade6331936"><span class=en-original lang=en>A <code><a href="#workerlocation">WorkerLocation</a></code> object
2285 wakaba 1.23 represents an <span>absolute URL</span> set at its creation.
2286    
2287 wakaba 1.36 </span><p class="no-ja-translation" data-ja-hash="2d034b308d5fd16e5cf88da132b7ecb7"><span class=en-original lang=en>The <dfn id=href title=dom-WorkerLocation-href><code>href</code></dfn>
2288 wakaba 1.23 attribute must return the <span>absolute URL</span> that the object
2289     represents.
2290    
2291 wakaba 1.36 </span><p class="no-ja-translation" data-ja-hash="f2d3c1ea8523c84f8de83e432d4ecb8e"><span class=en-original lang=en>The <code><a href="#workerlocation">WorkerLocation</a></code> interface
2292 wakaba 1.23 also has the complement of <span>URL decomposition attributes</span>, <dfn
2293     id=protocol title=dom-WorkerLocation-protocol><code>protocol</code></dfn>,
2294     <dfn id=host title=dom-WorkerLocation-host><code>host</code></dfn>, <dfn
2295 wakaba 1.29 id=port0 title=dom-WorkerLocation-port><code>port</code></dfn>, <dfn
2296 wakaba 1.23 id=hostname title=dom-WorkerLocation-hostname><code>hostname</code></dfn>,
2297     <dfn id=pathname
2298     title=dom-WorkerLocation-pathname><code>pathname</code></dfn>, <dfn
2299     id=search title=dom-WorkerLocation-search><code>search</code></dfn>, and
2300     <dfn id=hash title=dom-WorkerLocation-hash><code>hash</code></dfn>. These
2301     must follow the rules given for URL decomposition attributes, with the
2302     <span title=concept-uda-input>input</span> being the <span>absolute
2303     URL</span> that the object represents (same as the <code
2304     title=dom-WorkerLocation-href><a href="#href">href</a></code> attribute),
2305     and the <span title=concept-uda-setter>common setter action</span> being a
2306     no-op, since the attributes are defined to be readonly. <a
2307     href="#refsHTML5">[HTML5]</a>
2308 wakaba 1.22
2309 wakaba 1.37 </span><h2 class="no-num has-ja-translation" data-ja-hash="d95867deadfe690e40f42068d6b59df8" id=references><span class=en-original lang=en>References</span><span class=ja-translation lang=ja>参照</span></h2>
2310 wakaba 1.32
2311 wakaba 1.39 <p class="big-issue no-ja-translation" data-ja-hash="683a8b064076b13e2c36958afe8b9897"><span class=en-original lang=en>This section will be written in a future
2312 wakaba 1.32 draft.<!--XXX-->
2313 wakaba 1.1
2314 wakaba 1.39 </span><h2 class="no-num has-ja-translation" data-ja-hash="0407c27180c9b019e644e8ad4c6a9324" id=acknowledgements><span class=en-original lang=en>Acknowledgements</span><span class=ja-translation lang=ja>謝辞</span></h2>
2315 wakaba 1.1 <!-- ACKS -->
2316    
2317 wakaba 1.42 <p class="has-ja-translation" data-ja-hash="a17a0feb6f58a31040d51121e80bc233" data-ja-real-hash="fe2b84b2e6d45d1e2eefd38ed17d8ac4"><span class=en-original lang=en>Thanks to Aaron Boodman, Dmitry Titov, Jonas Sicking, Justin James,
2318     Kevin Hakanson, Maciej Stachowiak, Michael Nordman, Mike Smith, and Philip
2319     Taylor for their useful and substantial comments.
2320 wakaba 1.32
2321 wakaba 1.42 </span><span class=ja-translation lang=ja>Aaron Boodman, Dmitry Titov, Jonas Sicking, Justin James, Kevin Hakanson, Maciej Stachowiak, Michael Nordman, Mike Smith, Philip Taylor の有用かつ重要なコメントに感謝します。</span><p class="has-ja-translation" data-ja-hash="7c6875278ecf56df193c33c553856fac"><span class=en-original lang=en>Huge thanks to the whole Gears team, who pioneered this technology and
2322 wakaba 1.32 whose experience has been a huge influence on this specification.
2323     </span><span class=ja-translation lang=ja>Gears チームの方々にも非常に感謝します。
2324 wakaba 1.14 Gears チームの方々はこの技術を開拓し、その経験はこの仕様書にも多大な影響を与えています。
2325     </span>

[email protected]
ViewVC Help
Powered by ViewVC 1.1.24