Short URL: http://html5.org/r/7226
| SVN | Bug | Comment | Time (UTC) |
|---|---|---|---|
| 7226 | 15158 | Upgrade Web IDL terminology. | 2012-08-09 00:21 |
Index: source
===================================================================
--- source (revision 7225)
+++ source (revision 7226)
@@ -1,4 +1,4 @@
-<!-- EDITOR NOTES
+<<!-- EDITOR NOTES
!
! Adding a new element involves editing the following sections:
! - section for the element itself
@@ -3053,8 +3053,8 @@
required for conforming IDL fragments, as described in the Web IDL
specification. <a href="#refsWEBIDL">[WEBIDL]</a></p>
- <p>The terms <dfn>relevant namespace object</dfn>, <dfn>supported
- property indices</dfn>, <dfn>determine the value of an indexed
+ <p>The terms <dfn>expose</dfn>, <dfn>supported property
+ indices</dfn>, <dfn>determine the value of an indexed
property</dfn>, <dfn>support named properties</dfn>,
<dfn>supported property names</dfn>, <dfn>determine the value of a
named property</dfn>, <dfn>platform array objects</dfn>, and <dfn
@@ -3110,6 +3110,10 @@
being an officially obsoleted type</span> according to RFC
4329. <a href="#refsRFC4329">[RFC4329]</a></p>
+ <p>The term <dfn>JavaScript global environment</dfn> refers to the
+ <i title="">global environment</i> concept defined in the
+ ECMAScript specification.</p>
+
</dd>
<!--TOPIC:HTML-->
@@ -78790,9 +78794,9 @@
<div class="impl">
- <p>The <code>Window</code> interface must not exist if the
- interface's <span>relevant namespace object</span> is not a
- <code>Window</code> object. <a href="#refsWEBIDL">[WEBIDL]</a></p>
+ <p>The <code>Window</code> interface must only be <span
+ title="expose">exposed</span> if the <span>JavaScript global
+ environment</span> is a <span>document environment</span>.</p>
<p>The <dfn title="dom-window"><code>window</code></dfn>, <dfn
title="dom-frames"><code>frames</code></dfn>, and <dfn
@@ -86137,6 +86141,20 @@
<h5>Definitions</h5>
+ <p>This specification describes three kinds of <span
+ title="JavaScript global environment">JavaScript global
+ environments</span>: the <dfn>document environment</dfn>, the
+ <dfn>dedicated worker environment</dfn>, and the <dfn>shared worker
+ environment</dfn>. The <span>dedicated worker environment</span> and
+ the <span>shared worker environment</span> are both types of <dfn
+ title="worker environment">worker environments</dfn>.</p>
+
+ <p>Except where otherwise specified, a <span>JavaScript global
+ environment</span> is a <span>document environment</span>.</p> <!--
+ note that we never actually say where one of these is created... -->
+
+ <hr>
+
<p>A <dfn title="concept-script">script</dfn> has:</p>
<dl>
@@ -86466,7 +86484,7 @@
<dl class="switch">
- <dt>If the value of <var title="">onerror</var> is a
+ <dt>If the value of <var title="">onerror</var> is an
<code>OnErrorEventHandler</code></dt>
<dd>
@@ -95021,10 +95039,10 @@
attribute <span>EventHandler</span> <span title="handler-DedicatedWorkerGlobalScope-onmessage">onmessage</span>;
};</pre>
- <p>The <code>DedicatedWorkerGlobalScope</code> interface must not
- exist if the interface's <span>relevant namespace object</span> is
- not a <code>DedicatedWorkerGlobalScope</code> object. <a
- href="#refsWEBIDL">[WEBIDL]</a></p>
+ <p>The <code>DedicatedWorkerGlobalScope</code> interface must only
+ be <span title="expose">exposed</span> if the <span>JavaScript
+ global environment</span> is a <span>dedicated worker
+ environment</span>.</p>
<p><code>DedicatedWorkerGlobalScope</code> objects act as if they
had an implicit <code>MessagePort</code> associated with them. This
@@ -95072,10 +95090,9 @@
attribute <span>EventHandler</span> <span title="handler-SharedWorkerGlobalScope-onconnect">onconnect</span>;
};</pre>
- <p>The <code>SharedWorkerGlobalScope</code> interface must not
- exist if the interface's <span>relevant namespace object</span> is
- not a <code>SharedWorkerGlobalScope</code> object. <a
- href="#refsWEBIDL">[WEBIDL]</a></p>
+ <p>The <code>SharedWorkerGlobalScope</code> interface must only be
+ <span title="expose">exposed</span> if the <span>JavaScript global
+ environment</span> is a <span>shared worker environment</span>.</p>
<p>Shared workers receive message ports through <code
title="event-WorkerGlobalScope-connect">connect</code> events on
@@ -95311,6 +95328,17 @@
</li>
+ <li><p>In the newly created execution environment, create a
+ <span>JavaScript global environment</span> whose <i>global
+ object</i> is <var title="">worker global scope</var>. If <var
+ title="">worker global scope</var> is a
+ <code>DedicatedWorkerGlobalScope</code> object, then this is a
+ <span>dedicated worker environment</span>. Otherwise, <var
+ title="">worker global scope</var> is a
+ <code>SharedWorkerGlobalScope</code> object, and this is a
+ <span>shared worker environment</span>. (In either case, by
+ definition, it is a <span>worker environment</span>.)</p></li>
+
<li>
<p>A new <span title="concept-script">script</span> is now
@@ -96309,19 +96337,18 @@
<!--START complete-->
</p>
- <p>This <code>WorkerNavigator</code> interface must not exist if the
- interface's <span>relevant namespace object</span> is a
- <code>Window</code> object. <a href="#refsWEBIDL">[WEBIDL]</a></p>
+ <p>The <code>WorkerNavigator</code> interface must only be <span
+ title="expose">exposed</span> if the <span>JavaScript global
+ environment</span> is a <span>worker environment</span>.</p>
<h4>Interface objects and constructors</h4>
- <p>There must be no interface objects and constructors available in
- the global scope of scripts whose <span>script's global
- object</span> is a <code>WorkerGlobalScope</code> object except for
- the following:</p>
+ <p>Nothing must be <span title="expose">exposed</span> when the
+ <span>JavaScript global environment</span> is a <span>worker
+ environment</span> except for the following:</p>
<ul>
@@ -96334,19 +96361,13 @@
<span>origin</span>. <a href="#refsXHR">[XHR]</a></p></li>
<li><p>The interface objects and constructors defined by this
- specification.</p></li>
+ specification, except where is further restricted by explicit
+ requirements in this specification.</p></li>
- <li><p>Constructors defined by specifications that explicitly say
- that they should be visible when the <span>script's global
- object</span> is a <code>DedicatedWorkerGlobalScope</code>, a
- <code>SharedWorkerGlobalScope</code>, or an object implementing the
- <code>WorkerUtils</code> interface; the interfaces of any objects
- with such constructors; and the interfaces of any objects made
- accessible through APIs exposed by those constructors or made
- accessible through interfaces to be implemented by any objects that
- are themselves accessible to scripts whose <span>script's global
- object</span> implements the <code>WorkerUtils</code>
- interface.</p></li>
+ <li><p>The interface objects of any objects made accessible through
+ interfaces implemented by any objects that are themselves <span
+ title="expose">exposed</span> (i.e. this requirement is
+ transitive).</p></li>
</ul>
@@ -96399,9 +96420,9 @@
<!--START complete-->
</p>
- <p>The <code>WorkerLocation</code> interface must not exist if the
- interface's <span>relevant namespace object</span> is a
- <code>Window</code> object. <a href="#refsWEBIDL">[WEBIDL]</a></p>
+ <p>The <code>WorkerLocation</code> interface must only be <span
+ title="expose">exposed</span> if the <span>JavaScript global
+ environment</span> is a <span>worker environment</span>.</p>