Skip to content
Permalink
Browse files

[e] (0) Upgrade Web IDL terminology.

Fixing https://www.w3.org/Bugs/Public/show_bug.cgi?id=15158
Affected topics: DOM APIs, HTML, Web Workers

git-svn-id: http://svn.whatwg.org/webapps@7226 340c8d12-0b0e-0410-8428-c7bf67bfef74
  • Loading branch information...
Hixie committed Aug 9, 2012
1 parent 6ac696d commit d57fc922a9b31febec637c4548508c1d49a7d0d9
Showing with 159 additions and 112 deletions.
  1. +50 −37 complete.html
  2. +50 −37 index
  3. +59 −38 source

<header class=head id=head><p><a class=logo href=http://www.whatwg.org/><img alt=WHATWG height=101 src=/images/logo width=101></a></p>
<hgroup><h1 class=allcaps>HTML</h1>
<h2 class="no-num no-toc">Living Standard &mdash; Last Updated 7 August 2012</h2>
<h2 class="no-num no-toc">Living Standard &mdash; Last Updated 9 August 2012</h2>
</hgroup><dl><dt><strong>Web developer edition:</strong></dt>
<dd><strong><a href=http://developers.whatwg.org/>http://developers.whatwg.org/</a></strong></dd>
<dt>Multiple-page version:</dt>
required for conforming IDL fragments, as described in the Web IDL
specification. <a href=#refsWEBIDL>[WEBIDL]</a></p>

<p>The terms <dfn id=relevant-namespace-object>relevant namespace object</dfn>, <dfn id=supported-property-indices>supported
property indices</dfn>, <dfn id=determine-the-value-of-an-indexed-property>determine the value of an indexed
<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 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
being an officially obsoleted type</a> according to RFC
4329. <a href=#refsRFC4329>[RFC4329]</a></p>

<p>The term <dfn id=javascript-global-environment>JavaScript global environment</dfn> refers to the
<i title="">global environment</i> concept defined in the
ECMAScript specification.</p>

</dd>

<!--TOPIC:HTML-->

</dl><div class=impl>

<p>The <code><a href=#window>Window</a></code> interface must not exist if the
interface's <a href=#relevant-namespace-object>relevant namespace object</a> is not a
<code><a href=#window>Window</a></code> object. <a href=#refsWEBIDL>[WEBIDL]</a></p>
<p>The <code><a href=#window>Window</a></code> interface must only be <a href=#expose title=expose>exposed</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> IDL attributes must all
return the <code><a href=#window>Window</a></code> object's <a href=#browsing-context>browsing

<h5 id=definitions-0><span class=secno>7.1.3.1 </span>Definitions</h5>

<p>A <dfn id=concept-script title=concept-script>script</dfn> has:</p>
<p>This specification describes three kinds of <a href=#javascript-global-environment title="JavaScript global environment">JavaScript global
environments</a>: the <dfn id=document-environment>document environment</dfn>, the
<dfn id=dedicated-worker-environment>dedicated worker environment</dfn>, and the <dfn id=shared-worker-environment>shared worker
environment</dfn>. The <a href=#dedicated-worker-environment>dedicated worker environment</a> and
the <a href=#shared-worker-environment>shared worker environment</a> are both types of <dfn id=worker-environment title="worker environment">worker environments</dfn>.</p>

<p>Except where otherwise specified, a <a href=#javascript-global-environment>JavaScript global
environment</a> is a <a href=#document-environment>document environment</a>.</p> <!--
note that we never actually say where one of these is created... -->

<hr><p>A <dfn id=concept-script title=concept-script>script</dfn> has:</p>

<dl><dt>A <dfn id=script-execution-environment>script execution environment</dfn></dt>

handler</a> <var title="">onerror</var>, it must run these steps,
after which the error is either <dfn id=concept-error-handled title=concept-error-handled><i>handled</i></dfn> or <dfn id=concept-error-nothandled title=concept-error-nothandled><i>not handled</i></dfn>:</p>

<dl class=switch><dt>If the value of <var title="">onerror</var> is a
<dl class=switch><dt>If the value of <var title="">onerror</var> is an
<code><a href=#onerroreventhandler>OnErrorEventHandler</a></code></dt>

<dd>
attribute <a href=#eventhandler>EventHandler</a> <a href=#handler-dedicatedworkerglobalscope-onmessage title=handler-DedicatedWorkerGlobalScope-onmessage>onmessage</a>;
};</pre>

<p>The <code><a href=#dedicatedworkerglobalscope>DedicatedWorkerGlobalScope</a></code> interface must not
exist if the interface's <a href=#relevant-namespace-object>relevant namespace object</a> is
not a <code><a href=#dedicatedworkerglobalscope>DedicatedWorkerGlobalScope</a></code> object. <a href=#refsWEBIDL>[WEBIDL]</a></p>
<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
global environment</a> is a <a href=#dedicated-worker-environment>dedicated worker
environment</a>.</p>

<p><code><a href=#dedicatedworkerglobalscope>DedicatedWorkerGlobalScope</a></code> objects act as if they
had an implicit <code><a href=#messageport>MessagePort</a></code> associated with them. This
attribute <a href=#eventhandler>EventHandler</a> <a href=#handler-sharedworkerglobalscope-onconnect title=handler-SharedWorkerGlobalScope-onconnect>onconnect</a>;
};</pre>

<p>The <code><a href=#sharedworkerglobalscope>SharedWorkerGlobalScope</a></code> interface must not
exist if the interface's <a href=#relevant-namespace-object>relevant namespace object</a> is
not a <code><a href=#sharedworkerglobalscope>SharedWorkerGlobalScope</a></code> object. <a href=#refsWEBIDL>[WEBIDL]</a></p>
<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
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
their global object for each connection.</p>

</li>

<li><p>In the newly created execution environment, create a
<a href=#javascript-global-environment>JavaScript global environment</a> whose <i>global
object</i> is <var title="">worker global scope</var>. If <var title="">worker global scope</var> is a
<code><a href=#dedicatedworkerglobalscope>DedicatedWorkerGlobalScope</a></code> object, then this is a
<a href=#dedicated-worker-environment>dedicated worker environment</a>. Otherwise, <var title="">worker global scope</var> is a
<code><a href=#sharedworkerglobalscope>SharedWorkerGlobalScope</a></code> object, and this is a
<a href=#shared-worker-environment>shared worker environment</a>. (In either case, by
definition, it is a <a href=#worker-environment>worker environment</a>.)</li>

<li>

<p>A new <a href=#concept-script title=concept-script>script</a> is now
<code><a href=#navigatoronline>NavigatorOnLine</a></code> interfaces.
</p>

<p>This <code><a href=#workernavigator>WorkerNavigator</a></code> interface must not exist if the
interface's <a href=#relevant-namespace-object>relevant namespace object</a> is a
<code><a href=#window>Window</a></code> object. <a href=#refsWEBIDL>[WEBIDL]</a></p>
<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
environment</a> is a <a href=#worker-environment>worker environment</a>.</p>




<h4 id=interface-objects-and-constructors><span class=secno>9.3.3 </span>Interface objects and constructors</h4>

<p>There must be no interface objects and constructors available in
the global scope of scripts whose <a href="#script's-global-object">script's global
object</a> is a <code><a href=#workerglobalscope>WorkerGlobalScope</a></code> object except for
the following:</p>
<p>Nothing must be <a href=#expose title=expose>exposed</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><code>XMLHttpRequest</code> and all interface objects and
constructors defined by the XMLHttpRequest specifications, except
<a href=#origin>origin</a>. <a href=#refsXHR>[XHR]</a></li>

<li><p>The interface objects and constructors defined by this
specification.</li>

<li><p>Constructors defined by specifications that explicitly say
that they should be visible when the <a href="#script's-global-object">script's global
object</a> is a <code><a href=#dedicatedworkerglobalscope>DedicatedWorkerGlobalScope</a></code>, a
<code><a href=#sharedworkerglobalscope>SharedWorkerGlobalScope</a></code>, or an object implementing the
<code><a href=#workerutils>WorkerUtils</a></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 <a href="#script's-global-object">script's global
object</a> implements the <code><a href=#workerutils>WorkerUtils</a></code>
interface.</li>
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>

</ul><p class=note>These requirements do not override the requirements
defined by the Web IDL specification, in particular concerning the
no-op, since the attributes are defined to be readonly.
</p>

<p>The <code><a href=#workerlocation>WorkerLocation</a></code> interface must not exist if the
interface's <a href=#relevant-namespace-object>relevant namespace object</a> is a
<code><a href=#window>Window</a></code> object. <a href=#refsWEBIDL>[WEBIDL]</a></p>
<p>The <code><a href=#workerlocation>WorkerLocation</a></code> interface must only be <a href=#expose title=expose>exposed</a> if the <a href=#javascript-global-environment>JavaScript global
environment</a> is a <a href=#worker-environment>worker environment</a>.</p>



0 comments on commit d57fc92

Please sign in to comment.
You can’t perform that action at this time.