[html5] r7851 - [e] (0) Try to clarify use of the term 'expose' in the WebIDL sense. Affected to [...]
whatwg at whatwg.org
whatwg at whatwg.org
Tue Apr 23 15:51:40 PDT 2013
Author: ianh
Date: 2013-04-23 15:51:39 -0700 (Tue, 23 Apr 2013)
New Revision: 7851
Modified:
complete.html
index
source
Log:
[e] (0) Try to clarify use of the term 'expose' in the WebIDL sense.
Affected topics: DOM APIs, HTML, Workers
Modified: complete.html
===================================================================
--- complete.html 2013-04-23 21:08:19 UTC (rev 7850)
+++ complete.html 2013-04-23 22:51:39 UTC (rev 7851)
@@ -3495,13 +3495,17 @@
<p>The IDL fragments in this specification must be interpreted as required for conforming IDL
fragments, as described in the Web IDL specification. <a href=#refsWEBIDL>[WEBIDL]</a></p>
- <p>The terms <dfn id=expose>expose</dfn>, <dfn id=supported-property-indices>supported property indices</dfn>, <dfn id=determine-the-value-of-an-indexed-property>determine the value
+ <p>The terms <dfn id=supported-property-indices>supported property indices</dfn>, <dfn id=determine-the-value-of-an-indexed-property>determine the value
of an indexed property</dfn>, <dfn id=support-named-properties>support named properties</dfn>, <dfn id=supported-property-names>supported property
names</dfn>, <dfn id=determine-the-value-of-a-named-property>determine the value of a named property</dfn>, <dfn id=platform-array-objects>platform array
objects</dfn>, and <dfn id=dfn-read-only-array title=dfn-read-only-array>read only</dfn> (when applied to arrays) are
used as defined in the Web IDL specification. The algorithm to <dfn id=convert-a-domstring-to-a-sequence-of-unicode-characters>convert a DOMString to a
sequence of Unicode characters</dfn> is similarly that defined in the Web IDL specification.</p>
+ <p>Where this specification says an interface or exception is <dfn id=exposed-to-javascript>exposed to JavaScript</dfn>,
+ it refers to the manner, described in the Web IDL specification, in which an ECMAScript global
+ environment <i title=dfn-expose>exposes</i> interfaces and exceptions.</p>
+
<p>When this specification requires a user agent to <dfn id=create-a-date-object>create a <code>Date</code> object</dfn>
representing a particular time (which could be the special value Not-a-Number), the milliseconds
component of that time, if any, must be truncated to an integer and the time value of the newly
@@ -64640,7 +64644,7 @@
</dl><div class=impl>
- <p>The <code><a href=#window>Window</a></code> interface must only be <a href=#expose title=expose>exposed</a> if the
+ <p>The <code><a href=#window>Window</a></code> interface must only be <a href=#exposed-to-javascript>exposed to JavaScript</a> if the
<a href=#javascript-global-environment>JavaScript global environment</a> is a <a href=#document-environment>document environment</a>.</p>
<p>The <dfn id=dom-window title=dom-window><code>window</code></dfn>, <dfn id=dom-frames title=dom-frames><code>frames</code></dfn>, and <dfn id=dom-self title=dom-self><code>self</code></dfn>
@@ -78740,7 +78744,7 @@
};</pre>
<p>The <code><a href=#dedicatedworkerglobalscope>DedicatedWorkerGlobalScope</a></code> interface must only
- be <a href=#expose title=expose>exposed</a> if the <a href=#javascript-global-environment>JavaScript
+ be <a href=#exposed-to-javascript>exposed to JavaScript</a> if the <a href=#javascript-global-environment>JavaScript
global environment</a> is a <a href=#dedicated-worker-environment>dedicated worker
environment</a>.</p>
@@ -78789,7 +78793,7 @@
};</pre>
<p>The <code><a href=#sharedworkerglobalscope>SharedWorkerGlobalScope</a></code> interface must only be
- <a href=#expose title=expose>exposed</a> if the <a href=#javascript-global-environment>JavaScript global
+ <a href=#exposed-to-javascript>exposed to JavaScript</a> if the <a href=#javascript-global-environment>JavaScript global
environment</a> is a <a href=#shared-worker-environment>shared worker environment</a>.</p>
<p>Shared workers receive message ports through <code title=event-WorkerGlobalScope-connect>connect</code> events on
@@ -79569,7 +79573,7 @@
<p>The DOM APIs — specifically, all the interfaces defind in the DOM specification other
- than exceptions — must not be <a href=#expose title=expose>exposed</a> if the <a href=#javascript-global-environment>JavaScript
+ than exceptions — must not be <a href=#exposed-to-javascript>exposed to JavaScript</a> if the <a href=#javascript-global-environment>JavaScript
global environment</a> is a <a href=#worker-environment>worker environment</a>. <a href=#refsDOM>[DOM]</a></p>
@@ -79672,7 +79676,8 @@
<a href=#workernavigator>WorkerNavigator</a> implements <a href=#navigatorlanguage>NavigatorLanguage</a>;
<a href=#workernavigator>WorkerNavigator</a> implements <a href=#navigatoronline>NavigatorOnLine</a>;</pre>
- <p>The <code><a href=#workernavigator>WorkerNavigator</a></code> interface must only be <a href=#expose title=expose>exposed</a> if the <a href=#javascript-global-environment>JavaScript global
+ <p>The <code><a href=#workernavigator>WorkerNavigator</a></code> interface must only be <a href=#exposed-to-javascript>exposed
+ to JavaScript</a> if the <a href=#javascript-global-environment>JavaScript global
environment</a> is a <a href=#worker-environment>worker environment</a>.</p>
@@ -79680,16 +79685,20 @@
<h4 id=interface-objects-and-constructors><span class=secno>9.3.3 </span>Interface objects and constructors</h4>
- <p>Nothing must be <a href=#expose title=expose>exposed</a> when the <a href=#javascript-global-environment>JavaScript global
+ <p>Nothing must be <a href=#exposed-to-javascript>exposed to JavaScript</a> when the <a href=#javascript-global-environment>JavaScript global
environment</a> is a <a href=#worker-environment>worker environment</a> except for the following:</p>
- <ul><li><p>The interface objects and constructors defined by this specification, except where is
- further restricted by explicit requirements in this specification.</li>
+ <ul><li><p>The interfaces and exceptions defined by this specification, except where is further
+ restricted by explicit requirements in this specification.</li>
- <li><p>The interface objects of any objects made accessible through interfaces implemented by any
- objects that are themselves <a href=#expose title=expose>exposed</a> (i.e. this requirement is
- transitive).</li>
+ <li><p>Any interfaces and exceptions defined by a specification that explicitly specifies that
+ they are <a href=#exposed-to-javascript>exposed to JavaScript</a> when the <a href=#javascript-global-environment>JavaScript global environment</a>
+ is a <a href=#worker-environment>worker environment</a>.</li>
+ <li><p>The interfaces of any objects made accessible through, and the exceptions thrown by any,
+ interfaces implemented by any interfaces or objects of interfaces that are themselves
+ <a href=#exposed-to-javascript>exposed to JavaScript</a> (i.e. this requirement is transitive).</li>
+
</ul><p class=note>These requirements do not override the requirements defined by the Web IDL
specification, in particular concerning the visibility of interfaces annotated with the <code title="">[NoInterfaceObject]</code> extended attribute.</p>
@@ -79712,7 +79721,7 @@
<p>The element's <code><a href=#urlutilsreadonly>URLUtilsReadOnly</a></code> interface's <a href=#concept-uu-get-the-base title=concept-uu-get-the-base>get the base</a> algorithm must return null.</p>
- <p>The <code><a href=#workerlocation>WorkerLocation</a></code> interface must only be <a href=#expose title=expose>exposed</a> if
+ <p>The <code><a href=#workerlocation>WorkerLocation</a></code> interface must only be <a href=#exposed-to-javascript>exposed to JavaScript</a> if
the <a href=#javascript-global-environment>JavaScript global environment</a> is a <a href=#worker-environment>worker environment</a>.</p>
Modified: index
===================================================================
--- index 2013-04-23 21:08:19 UTC (rev 7850)
+++ index 2013-04-23 22:51:39 UTC (rev 7851)
@@ -3495,13 +3495,17 @@
<p>The IDL fragments in this specification must be interpreted as required for conforming IDL
fragments, as described in the Web IDL specification. <a href=#refsWEBIDL>[WEBIDL]</a></p>
- <p>The terms <dfn id=expose>expose</dfn>, <dfn id=supported-property-indices>supported property indices</dfn>, <dfn id=determine-the-value-of-an-indexed-property>determine the value
+ <p>The terms <dfn id=supported-property-indices>supported property indices</dfn>, <dfn id=determine-the-value-of-an-indexed-property>determine the value
of an indexed property</dfn>, <dfn id=support-named-properties>support named properties</dfn>, <dfn id=supported-property-names>supported property
names</dfn>, <dfn id=determine-the-value-of-a-named-property>determine the value of a named property</dfn>, <dfn id=platform-array-objects>platform array
objects</dfn>, and <dfn id=dfn-read-only-array title=dfn-read-only-array>read only</dfn> (when applied to arrays) are
used as defined in the Web IDL specification. The algorithm to <dfn id=convert-a-domstring-to-a-sequence-of-unicode-characters>convert a DOMString to a
sequence of Unicode characters</dfn> is similarly that defined in the Web IDL specification.</p>
+ <p>Where this specification says an interface or exception is <dfn id=exposed-to-javascript>exposed to JavaScript</dfn>,
+ it refers to the manner, described in the Web IDL specification, in which an ECMAScript global
+ environment <i title=dfn-expose>exposes</i> interfaces and exceptions.</p>
+
<p>When this specification requires a user agent to <dfn id=create-a-date-object>create a <code>Date</code> object</dfn>
representing a particular time (which could be the special value Not-a-Number), the milliseconds
component of that time, if any, must be truncated to an integer and the time value of the newly
@@ -64640,7 +64644,7 @@
</dl><div class=impl>
- <p>The <code><a href=#window>Window</a></code> interface must only be <a href=#expose title=expose>exposed</a> if the
+ <p>The <code><a href=#window>Window</a></code> interface must only be <a href=#exposed-to-javascript>exposed to JavaScript</a> if the
<a href=#javascript-global-environment>JavaScript global environment</a> is a <a href=#document-environment>document environment</a>.</p>
<p>The <dfn id=dom-window title=dom-window><code>window</code></dfn>, <dfn id=dom-frames title=dom-frames><code>frames</code></dfn>, and <dfn id=dom-self title=dom-self><code>self</code></dfn>
@@ -78740,7 +78744,7 @@
};</pre>
<p>The <code><a href=#dedicatedworkerglobalscope>DedicatedWorkerGlobalScope</a></code> interface must only
- be <a href=#expose title=expose>exposed</a> if the <a href=#javascript-global-environment>JavaScript
+ be <a href=#exposed-to-javascript>exposed to JavaScript</a> if the <a href=#javascript-global-environment>JavaScript
global environment</a> is a <a href=#dedicated-worker-environment>dedicated worker
environment</a>.</p>
@@ -78789,7 +78793,7 @@
};</pre>
<p>The <code><a href=#sharedworkerglobalscope>SharedWorkerGlobalScope</a></code> interface must only be
- <a href=#expose title=expose>exposed</a> if the <a href=#javascript-global-environment>JavaScript global
+ <a href=#exposed-to-javascript>exposed to JavaScript</a> if the <a href=#javascript-global-environment>JavaScript global
environment</a> is a <a href=#shared-worker-environment>shared worker environment</a>.</p>
<p>Shared workers receive message ports through <code title=event-WorkerGlobalScope-connect>connect</code> events on
@@ -79569,7 +79573,7 @@
<p>The DOM APIs — specifically, all the interfaces defind in the DOM specification other
- than exceptions — must not be <a href=#expose title=expose>exposed</a> if the <a href=#javascript-global-environment>JavaScript
+ than exceptions — must not be <a href=#exposed-to-javascript>exposed to JavaScript</a> if the <a href=#javascript-global-environment>JavaScript
global environment</a> is a <a href=#worker-environment>worker environment</a>. <a href=#refsDOM>[DOM]</a></p>
@@ -79672,7 +79676,8 @@
<a href=#workernavigator>WorkerNavigator</a> implements <a href=#navigatorlanguage>NavigatorLanguage</a>;
<a href=#workernavigator>WorkerNavigator</a> implements <a href=#navigatoronline>NavigatorOnLine</a>;</pre>
- <p>The <code><a href=#workernavigator>WorkerNavigator</a></code> interface must only be <a href=#expose title=expose>exposed</a> if the <a href=#javascript-global-environment>JavaScript global
+ <p>The <code><a href=#workernavigator>WorkerNavigator</a></code> interface must only be <a href=#exposed-to-javascript>exposed
+ to JavaScript</a> if the <a href=#javascript-global-environment>JavaScript global
environment</a> is a <a href=#worker-environment>worker environment</a>.</p>
@@ -79680,16 +79685,20 @@
<h4 id=interface-objects-and-constructors><span class=secno>9.3.3 </span>Interface objects and constructors</h4>
- <p>Nothing must be <a href=#expose title=expose>exposed</a> when the <a href=#javascript-global-environment>JavaScript global
+ <p>Nothing must be <a href=#exposed-to-javascript>exposed to JavaScript</a> when the <a href=#javascript-global-environment>JavaScript global
environment</a> is a <a href=#worker-environment>worker environment</a> except for the following:</p>
- <ul><li><p>The interface objects and constructors defined by this specification, except where is
- further restricted by explicit requirements in this specification.</li>
+ <ul><li><p>The interfaces and exceptions defined by this specification, except where is further
+ restricted by explicit requirements in this specification.</li>
- <li><p>The interface objects of any objects made accessible through interfaces implemented by any
- objects that are themselves <a href=#expose title=expose>exposed</a> (i.e. this requirement is
- transitive).</li>
+ <li><p>Any interfaces and exceptions defined by a specification that explicitly specifies that
+ they are <a href=#exposed-to-javascript>exposed to JavaScript</a> when the <a href=#javascript-global-environment>JavaScript global environment</a>
+ is a <a href=#worker-environment>worker environment</a>.</li>
+ <li><p>The interfaces of any objects made accessible through, and the exceptions thrown by any,
+ interfaces implemented by any interfaces or objects of interfaces that are themselves
+ <a href=#exposed-to-javascript>exposed to JavaScript</a> (i.e. this requirement is transitive).</li>
+
</ul><p class=note>These requirements do not override the requirements defined by the Web IDL
specification, in particular concerning the visibility of interfaces annotated with the <code title="">[NoInterfaceObject]</code> extended attribute.</p>
@@ -79712,7 +79721,7 @@
<p>The element's <code><a href=#urlutilsreadonly>URLUtilsReadOnly</a></code> interface's <a href=#concept-uu-get-the-base title=concept-uu-get-the-base>get the base</a> algorithm must return null.</p>
- <p>The <code><a href=#workerlocation>WorkerLocation</a></code> interface must only be <a href=#expose title=expose>exposed</a> if
+ <p>The <code><a href=#workerlocation>WorkerLocation</a></code> interface must only be <a href=#exposed-to-javascript>exposed to JavaScript</a> if
the <a href=#javascript-global-environment>JavaScript global environment</a> is a <a href=#worker-environment>worker environment</a>.</p>
Modified: source
===================================================================
--- source 2013-04-23 21:08:19 UTC (rev 7850)
+++ source 2013-04-23 22:51:39 UTC (rev 7851)
@@ -2303,13 +2303,17 @@
<p>The IDL fragments in this specification must be interpreted as required for conforming IDL
fragments, as described in the Web IDL specification. <a href="#refsWEBIDL">[WEBIDL]</a></p>
- <p>The terms <dfn>expose</dfn>, <dfn>supported property indices</dfn>, <dfn>determine the value
+ <p>The terms <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 title="dfn-read-only-array">read only</dfn> (when applied to arrays) are
used as defined in the Web IDL specification. The algorithm to <dfn>convert a DOMString to a
sequence of Unicode characters</dfn> is similarly that defined in the Web IDL specification.</p>
+ <p>Where this specification says an interface or exception is <dfn>exposed to JavaScript</dfn>,
+ it refers to the manner, described in the Web IDL specification, in which an ECMAScript global
+ environment <i title="dfn-expose">exposes</i> interfaces and exceptions.</p>
+
<p>When this specification requires a user agent to <dfn>create a <code>Date</code> object</dfn>
representing a particular time (which could be the special value Not-a-Number), the milliseconds
component of that time, if any, must be truncated to an integer and the time value of the newly
@@ -72250,7 +72254,7 @@
<div class="impl">
- <p>The <code>Window</code> interface must only be <span title="expose">exposed</span> if the
+ <p>The <code>Window</code> interface must only be <span>exposed to JavaScript</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
@@ -87814,7 +87818,7 @@
};</pre>
<p>The <code>DedicatedWorkerGlobalScope</code> interface must only
- be <span title="expose">exposed</span> if the <span>JavaScript
+ be <span>exposed to JavaScript</span> if the <span>JavaScript
global environment</span> is a <span>dedicated worker
environment</span>.</p>
@@ -87868,7 +87872,7 @@
};</pre>
<p>The <code>SharedWorkerGlobalScope</code> interface must only be
- <span title="expose">exposed</span> if the <span>JavaScript global
+ <span>exposed to JavaScript</span> if the <span>JavaScript global
environment</span> is a <span>shared worker environment</span>.</p>
<p>Shared workers receive message ports through <code
@@ -88781,7 +88785,7 @@
<!--START complete-->
<p>The DOM APIs — specifically, all the interfaces defind in the DOM specification other
- than exceptions — must not be <span title="expose">exposed</span> if the <span>JavaScript
+ than exceptions — must not be <span>exposed to JavaScript</span> if the <span>JavaScript
global environment</span> is a <span>worker environment</span>. <a
href="#refsDOM">[DOM]</a></p>
@@ -88903,8 +88907,8 @@
<span>WorkerNavigator</span> implements <span>NavigatorLanguage</span>;
<span>WorkerNavigator</span> implements <span>NavigatorOnLine</span>;</pre>
- <p>The <code>WorkerNavigator</code> interface must only be <span
- title="expose">exposed</span> if the <span>JavaScript global
+ <p>The <code>WorkerNavigator</code> interface must only be <span>exposed
+ to JavaScript</span> if the <span>JavaScript global
environment</span> is a <span>worker environment</span>.</p>
@@ -88912,18 +88916,22 @@
<h4>Interface objects and constructors</h4>
- <p>Nothing must be <span title="expose">exposed</span> when the <span>JavaScript global
+ <p>Nothing must be <span>exposed to JavaScript</span> when the <span>JavaScript global
environment</span> is a <span>worker environment</span> except for the following:</p>
<ul>
- <li><p>The interface objects and constructors defined by this specification, except where is
- further restricted by explicit requirements in this specification.</p></li>
+ <li><p>The interfaces and exceptions defined by this specification, except where is further
+ restricted by explicit requirements in this specification.</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>
+ <li><p>Any interfaces and exceptions defined by a specification that explicitly specifies that
+ they are <span>exposed to JavaScript</span> when the <span>JavaScript global environment</span>
+ is a <span>worker environment</span>.</p></li>
+ <li><p>The interfaces of any objects made accessible through, and the exceptions thrown by any,
+ interfaces implemented by any interfaces or objects of interfaces that are themselves
+ <span>exposed to JavaScript</span> (i.e. this requirement is transitive).</p></li>
+
</ul>
<p class="note">These requirements do not override the requirements defined by the Web IDL
@@ -88950,7 +88958,7 @@
<p>The element's <code>URLUtilsReadOnly</code> interface's <span
title="concept-uu-get-the-base">get the base</span> algorithm must return null.</p>
- <p>The <code>WorkerLocation</code> interface must only be <span title="expose">exposed</span> if
+ <p>The <code>WorkerLocation</code> interface must only be <span>exposed to JavaScript</span> if
the <span>JavaScript global environment</span> is a <span>worker environment</span>.</p>
More information about the Commit-Watchers
mailing list