[html5] r7919 - [e] (0) Cleanup Affected topics: DOM APIs
whatwg at whatwg.org
whatwg at whatwg.org
Thu Jun 6 13:01:21 PDT 2013
Author: ianh
Date: 2013-06-06 13:01:19 -0700 (Thu, 06 Jun 2013)
New Revision: 7919
Modified:
complete.html
index
source
Log:
[e] (0) Cleanup
Affected topics: DOM APIs
Modified: complete.html
===================================================================
--- complete.html 2013-06-06 19:56:34 UTC (rev 7918)
+++ complete.html 2013-06-06 20:01:19 UTC (rev 7919)
@@ -7998,75 +7998,67 @@
<h4 id=safe-passing-of-structured-data><span class=secno>2.7.6 </span>Safe passing of structured data</h4>
-<!--CLEANUP-->
- <p>When a user agent is required to obtain a <dfn id=structured-clone>structured
- clone</dfn> of a value, optionally with a <i>transfer map</i>, it
- must run the following algorithm, which either returns a separate
- value, or throws an exception. If a <i>transfer map</i> is provided,
- it consists of an association list of <code><a href=#transferable>Transferable</a></code>
- objects to placeholder objects.</p>
+ <p>When a user agent is required to obtain a <dfn id=structured-clone>structured clone</dfn> of a value, optionally
+ with a <i>transfer map</i>, it must run the following algorithm, which either returns a separate
+ value, or throws an exception. If a <i>transfer map</i> is provided, it consists of an association
+ list of <code><a href=#transferable>Transferable</a></code> objects to placeholder objects.</p>
- <ol><li><p>Let <var title="">input</var> be the value being
- cloned.</li>
+ <ol><li><p>Let <var title="">input</var> be the value being cloned.</li>
- <li><p>Let <var title="">transfer map</var> be the <i>transfer
- map</i> passed to the algorithm, if any, or the empty list
- otherwise.</li>
+ <li><p>Let <var title="">transfer map</var> be the <i>transfer map</i> passed to the algorithm,
+ if any, or the empty list otherwise.</li>
- <li><p>Let <var title="">memory</var> be an association list of
- pairs of objects, initially empty. This is used to handle duplicate
- references. In each pair of objects, one is called the
- <em>source</em> object and the other the <em>destination</em>
- object.</li>
+ <li><p>Let <var title="">memory</var> be an association list of pairs of objects, initially
+ empty. This is used to handle duplicate references. In each pair of objects, one is called the
+ <em>source</em> object and the other the <em>destination</em> object.</li>
- <li><p>For each mapping in <var title="">transfer map</var>, add a
- mapping from the <code><a href=#transferable>Transferable</a></code> object (the source
- object) to the placeholder object (the destination object) to <var title="">memory</var>.</li>
+ <li><p>For each mapping in <var title="">transfer map</var>, add a mapping from the
+ <code><a href=#transferable>Transferable</a></code> object (the source object) to the placeholder object (the destination
+ object) to <var title="">memory</var>.</li>
- <li><p>Let <var title="">output</var> be the value resulting from
- calling the <a href=#internal-structured-cloning-algorithm>internal structured cloning algorithm</a> with
- <var title="">input</var> as the "<var title="">input</var>"
- argument, and <var title="">memory</var> as the "<var title="">memory</var>" argument.</li>
+ <li><p>Let <var title="">output</var> be the value resulting from calling the <a href=#internal-structured-cloning-algorithm>internal
+ structured cloning algorithm</a> with <var title="">input</var> as the "<var title="">input</var>" argument, and <var title="">memory</var> as the "<var title="">memory</var>" argument.</li>
<li><p>Return <var title="">output</var>.</li>
- </ol><p>The <dfn id=internal-structured-cloning-algorithm>internal structured cloning algorithm</dfn> is always
- called with two arguments, <var title="">input</var> and <var title="">memory</var>, and its behavior is as follows:</p>
+ </ol><p>The <dfn id=internal-structured-cloning-algorithm>internal structured cloning algorithm</dfn> is always called with two arguments, <var title="">input</var> and <var title="">memory</var>, and its behavior is as follows:</p>
- <ol><li><p>If <var title="">input</var> is the source object of a pair
- of objects in <var title="">memory</var>, then return the
- destination object in that pair of objects and abort these
+ <ol><li><p>If <var title="">input</var> is the source object of a pair of objects in <var title="">memory</var>, then return the destination object in that pair of objects and abort these
steps.</li>
- <li><p>If <var title="">input</var> is a primitive value, then
- return that value and abort these steps.</li>
+ <li><p>If <var title="">input</var> is a primitive value, then return that value and abort these
+ steps.</li>
<li>
- <p>The <var title="">input</var> value is an object. Jump to the
- appropriate step below:</p>
+ <p>The <var title="">input</var> value is an object. Jump to the appropriate step below:</p>
<dl class=switch><dt>If <var title="">input</var> is a <code>Boolean</code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed Boolean object with the same value as <var title="">input</var>.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed Boolean object with the same value
+ as <var title="">input</var>.</dd>
<dt>If <var title="">input</var> is a <code>Number</code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed Number object with the same value as <var title="">input</var>.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed Number object with the same value
+ as <var title="">input</var>.</dd>
<dt>If <var title="">input</var> is a <code>String</code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed String object with the same value as <var title="">input</var>.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed String object with the same value
+ as <var title="">input</var>.</dd>
<dt>If <var title="">input</var> is a <code>Date</code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed <code>Date</code> object with the same value as <var title="">input</var>.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed <code>Date</code> object with the
+ same value as <var title="">input</var>.</dd>
<dt>If <var title="">input</var> is a <code>RegExp</code> object</dt>
<dd>
- <p>Let <var title="">output</var> be a newly constructed <code>RegExp</code> object with the same pattern and flags as <var title="">input</var>.</p>
+ <p>Let <var title="">output</var> be a newly constructed <code>RegExp</code> object with the
+ same pattern and flags as <var title="">input</var>.</p>
<p class=note>The value of the <code title="">lastIndex</code> property is not copied.</p>
@@ -8074,24 +8066,27 @@
<dt>If <var title="">input</var> is a <code><a href=#file>File</a></code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed <code><a href=#file>File</a></code> object corresponding to the same underlying data.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed <code><a href=#file>File</a></code> object
+ corresponding to the same underlying data.</dd>
<dt>If <var title="">input</var> is a <code><a href=#blob>Blob</a></code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed <code><a href=#blob>Blob</a></code> object corresponding to the same underlying data.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed <code><a href=#blob>Blob</a></code> object
+ corresponding to the same underlying data.</dd>
<dt>If <var title="">input</var> is a <code><a href=#filelist>FileList</a></code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed <code><a href=#filelist>FileList</a></code> object containing a list of newly constructed <code><a href=#file>File</a></code> objects corresponding to the same underlying data as those in <var title="">input</var>, maintaining their relative order.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed <code><a href=#filelist>FileList</a></code> object
+ containing a list of newly constructed <code><a href=#file>File</a></code> objects corresponding to the same
+ underlying data as those in <var title="">input</var>, maintaining their relative
+ order.</dd>
<dt>If <var title="">input</var> is an <code><a href=#imagedata>ImageData</a></code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed
- <code><a href=#imagedata>ImageData</a></code> object whose <code title=dom-imagedata-width><a href=#dom-imagedata-width>width</a></code>, <code title=dom-imagedata-height><a href=#dom-imagedata-height>height</a></code>, and <code title=dom-imagedata-resolution><a href=#dom-imagedata-resolution>resolution</a></code> attributes have values
- equal to the corresponding attributes on <var title="">input</var>, and whose <code title=dom-imagedata-data><a href=#dom-imagedata-data>data</a></code> attribute has the value
- obtained from invoking the <a href=#internal-structured-cloning-algorithm>internal structured cloning
- algorithm</a> recursively with the value of the <code title=dom-imagedata-data><a href=#dom-imagedata-data>data</a></code> attribute on <var title="">input</var> as the new "<var title="">input</var>"
- argument and <var title="">memory</var> as the new "<var title="">memory</var>" argument.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed <code><a href=#imagedata>ImageData</a></code> object
+ whose <code title=dom-imagedata-width><a href=#dom-imagedata-width>width</a></code>, <code title=dom-imagedata-height><a href=#dom-imagedata-height>height</a></code>, and <code title=dom-imagedata-resolution><a href=#dom-imagedata-resolution>resolution</a></code> attributes have values equal to the
+ corresponding attributes on <var title="">input</var>, and whose <code title=dom-imagedata-data><a href=#dom-imagedata-data>data</a></code> attribute has the value obtained from invoking the
+ <a href=#internal-structured-cloning-algorithm>internal structured cloning algorithm</a> recursively with the value of the <code title=dom-imagedata-data><a href=#dom-imagedata-data>data</a></code> attribute on <var title="">input</var> as the new "<var title="">input</var>" argument and <var title="">memory</var> as the new "<var title="">memory</var>" argument.</dd>
<dt>If <var title="">input</var> is an <code><a href=#imagebitmap>ImageBitmap</a></code> object</dt>
@@ -8112,28 +8107,28 @@
<dd>
- <p>Let <var title="">output</var> be a newly constructed empty
- <code>Array</code> object whose <code title="">length</code> is
- equal to the <code title="">length</code> of <var title="">input</var>.</p>
+ <p>Let <var title="">output</var> be a newly constructed empty <code>Array</code> object whose
+ <code title="">length</code> is equal to the <code title="">length</code> of <var title="">input</var>.</p>
- <p class=note>This means that the length of sparse arrays is
- preserved.</p>
+ <p class=note>This means that the length of sparse arrays is preserved.</p>
</dd>
<dt>If <var title="">input</var> is an <code><a href=#the-object-element>Object</a></code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed empty <code title="">Object</code> object.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed empty <code title="">Object</code>
+ object.</dd>
<dt>If <var title="">input</var> is an object that another specification defines how to clone</dt>
- <dd><p>Let <var title="">output</var> be a clone of the object as defined by the other specification.</dd>
+ <dd><p>Let <var title="">output</var> be a clone of the object as defined by the other
+ specification.</dd>
<dt>If <var title="">input</var> is another native object type (e.g. <code>Error</code>, <code>Function</code>)</dt>
<dt>If <var title="">input</var> is a host object (e.g. a DOM node)</dt>
- <dd><p>Throw a <code><a href=#datacloneerror>DataCloneError</a></code> exception and abort
- the overall <a href=#structured-clone>structured clone</a> algorithm.</dd>
+ <dd><p>Throw a <code><a href=#datacloneerror>DataCloneError</a></code> exception and abort the overall <a href=#structured-clone>structured
+ clone</a> algorithm.</dd>
</dl><p>For the purposes of the algorithm above, an object is a particular type of object <var title="">class</var> if its [[Class]] internal property is equal to <var title="">class</var>.</p>
@@ -8142,9 +8137,7 @@
</li>
- <li><p>Add a mapping from <var title="">input</var> (the source
- object) to <var title="">output</var> (the destination object) to
- <var title="">memory</var>.</li>
+ <li><p>Add a mapping from <var title="">input</var> (the source object) to <var title="">output</var> (the destination object) to <var title="">memory</var>.</li>
<li>
@@ -8173,22 +8166,20 @@
<p class=note>This does not walk the prototype chain.</p>
- <p class=note>Property descriptors, setters, getters, and
- analogous features are not copied in this process. For example,
- the property in the input could be marked as read-only, but in the
- output it would just have the default state (typically read-write,
- though that could depend on the scripting environment).</p>
+ <p class=note>Property descriptors, setters, getters, and analogous features are not copied in
+ this process. For example, the property in the input could be marked as read-only, but in the
+ output it would just have the default state (typically read-write, though that could depend on
+ the scripting environment).</p>
- <p class=note>Properties of Array objects are not treated any
- differently than those of other Objects. In particular, this means
- that non-index properties of arrays are copied as well.</p>
+ <p class=note>Properties of Array objects are not treated any differently than those of other
+ Objects. In particular, this means that non-index properties of arrays are copied as well.</p>
</li>
<li><p>Return <var title="">output</var>.</li>
- </ol><p class=note>This algorithm preserves cycles and preserves the
- identity of duplicate objects in graphs.</p>
+ </ol><p class=note>This algorithm preserves cycles and preserves the identity of duplicate objects in
+ graphs.</p>
</div>
@@ -82405,8 +82396,8 @@
<p>Associate the two ports to be entangled, so that they form the two parts of a new channel.
(There is no <code><a href=#messagechannel>MessageChannel</a></code> object that represents this channel.)</p>
- <p>Two ports A and B that have gone through this step are now said to be entangled; one is
- entangled to the other, and vice versa.</p>
+ <p>Two ports <var title="">A</var> and <var title="">B</var> that have gone through this step
+ are now said to be entangled; one is entangled to the other, and vice versa.</p>
<p class=note>While this specification describes this process as instantaneous,
implementations are more likely to implement it via message passing. As with all algorithms, the
Modified: index
===================================================================
--- index 2013-06-06 19:56:34 UTC (rev 7918)
+++ index 2013-06-06 20:01:19 UTC (rev 7919)
@@ -7998,75 +7998,67 @@
<h4 id=safe-passing-of-structured-data><span class=secno>2.7.6 </span>Safe passing of structured data</h4>
-<!--CLEANUP-->
- <p>When a user agent is required to obtain a <dfn id=structured-clone>structured
- clone</dfn> of a value, optionally with a <i>transfer map</i>, it
- must run the following algorithm, which either returns a separate
- value, or throws an exception. If a <i>transfer map</i> is provided,
- it consists of an association list of <code><a href=#transferable>Transferable</a></code>
- objects to placeholder objects.</p>
+ <p>When a user agent is required to obtain a <dfn id=structured-clone>structured clone</dfn> of a value, optionally
+ with a <i>transfer map</i>, it must run the following algorithm, which either returns a separate
+ value, or throws an exception. If a <i>transfer map</i> is provided, it consists of an association
+ list of <code><a href=#transferable>Transferable</a></code> objects to placeholder objects.</p>
- <ol><li><p>Let <var title="">input</var> be the value being
- cloned.</li>
+ <ol><li><p>Let <var title="">input</var> be the value being cloned.</li>
- <li><p>Let <var title="">transfer map</var> be the <i>transfer
- map</i> passed to the algorithm, if any, or the empty list
- otherwise.</li>
+ <li><p>Let <var title="">transfer map</var> be the <i>transfer map</i> passed to the algorithm,
+ if any, or the empty list otherwise.</li>
- <li><p>Let <var title="">memory</var> be an association list of
- pairs of objects, initially empty. This is used to handle duplicate
- references. In each pair of objects, one is called the
- <em>source</em> object and the other the <em>destination</em>
- object.</li>
+ <li><p>Let <var title="">memory</var> be an association list of pairs of objects, initially
+ empty. This is used to handle duplicate references. In each pair of objects, one is called the
+ <em>source</em> object and the other the <em>destination</em> object.</li>
- <li><p>For each mapping in <var title="">transfer map</var>, add a
- mapping from the <code><a href=#transferable>Transferable</a></code> object (the source
- object) to the placeholder object (the destination object) to <var title="">memory</var>.</li>
+ <li><p>For each mapping in <var title="">transfer map</var>, add a mapping from the
+ <code><a href=#transferable>Transferable</a></code> object (the source object) to the placeholder object (the destination
+ object) to <var title="">memory</var>.</li>
- <li><p>Let <var title="">output</var> be the value resulting from
- calling the <a href=#internal-structured-cloning-algorithm>internal structured cloning algorithm</a> with
- <var title="">input</var> as the "<var title="">input</var>"
- argument, and <var title="">memory</var> as the "<var title="">memory</var>" argument.</li>
+ <li><p>Let <var title="">output</var> be the value resulting from calling the <a href=#internal-structured-cloning-algorithm>internal
+ structured cloning algorithm</a> with <var title="">input</var> as the "<var title="">input</var>" argument, and <var title="">memory</var> as the "<var title="">memory</var>" argument.</li>
<li><p>Return <var title="">output</var>.</li>
- </ol><p>The <dfn id=internal-structured-cloning-algorithm>internal structured cloning algorithm</dfn> is always
- called with two arguments, <var title="">input</var> and <var title="">memory</var>, and its behavior is as follows:</p>
+ </ol><p>The <dfn id=internal-structured-cloning-algorithm>internal structured cloning algorithm</dfn> is always called with two arguments, <var title="">input</var> and <var title="">memory</var>, and its behavior is as follows:</p>
- <ol><li><p>If <var title="">input</var> is the source object of a pair
- of objects in <var title="">memory</var>, then return the
- destination object in that pair of objects and abort these
+ <ol><li><p>If <var title="">input</var> is the source object of a pair of objects in <var title="">memory</var>, then return the destination object in that pair of objects and abort these
steps.</li>
- <li><p>If <var title="">input</var> is a primitive value, then
- return that value and abort these steps.</li>
+ <li><p>If <var title="">input</var> is a primitive value, then return that value and abort these
+ steps.</li>
<li>
- <p>The <var title="">input</var> value is an object. Jump to the
- appropriate step below:</p>
+ <p>The <var title="">input</var> value is an object. Jump to the appropriate step below:</p>
<dl class=switch><dt>If <var title="">input</var> is a <code>Boolean</code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed Boolean object with the same value as <var title="">input</var>.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed Boolean object with the same value
+ as <var title="">input</var>.</dd>
<dt>If <var title="">input</var> is a <code>Number</code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed Number object with the same value as <var title="">input</var>.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed Number object with the same value
+ as <var title="">input</var>.</dd>
<dt>If <var title="">input</var> is a <code>String</code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed String object with the same value as <var title="">input</var>.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed String object with the same value
+ as <var title="">input</var>.</dd>
<dt>If <var title="">input</var> is a <code>Date</code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed <code>Date</code> object with the same value as <var title="">input</var>.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed <code>Date</code> object with the
+ same value as <var title="">input</var>.</dd>
<dt>If <var title="">input</var> is a <code>RegExp</code> object</dt>
<dd>
- <p>Let <var title="">output</var> be a newly constructed <code>RegExp</code> object with the same pattern and flags as <var title="">input</var>.</p>
+ <p>Let <var title="">output</var> be a newly constructed <code>RegExp</code> object with the
+ same pattern and flags as <var title="">input</var>.</p>
<p class=note>The value of the <code title="">lastIndex</code> property is not copied.</p>
@@ -8074,24 +8066,27 @@
<dt>If <var title="">input</var> is a <code><a href=#file>File</a></code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed <code><a href=#file>File</a></code> object corresponding to the same underlying data.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed <code><a href=#file>File</a></code> object
+ corresponding to the same underlying data.</dd>
<dt>If <var title="">input</var> is a <code><a href=#blob>Blob</a></code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed <code><a href=#blob>Blob</a></code> object corresponding to the same underlying data.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed <code><a href=#blob>Blob</a></code> object
+ corresponding to the same underlying data.</dd>
<dt>If <var title="">input</var> is a <code><a href=#filelist>FileList</a></code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed <code><a href=#filelist>FileList</a></code> object containing a list of newly constructed <code><a href=#file>File</a></code> objects corresponding to the same underlying data as those in <var title="">input</var>, maintaining their relative order.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed <code><a href=#filelist>FileList</a></code> object
+ containing a list of newly constructed <code><a href=#file>File</a></code> objects corresponding to the same
+ underlying data as those in <var title="">input</var>, maintaining their relative
+ order.</dd>
<dt>If <var title="">input</var> is an <code><a href=#imagedata>ImageData</a></code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed
- <code><a href=#imagedata>ImageData</a></code> object whose <code title=dom-imagedata-width><a href=#dom-imagedata-width>width</a></code>, <code title=dom-imagedata-height><a href=#dom-imagedata-height>height</a></code>, and <code title=dom-imagedata-resolution><a href=#dom-imagedata-resolution>resolution</a></code> attributes have values
- equal to the corresponding attributes on <var title="">input</var>, and whose <code title=dom-imagedata-data><a href=#dom-imagedata-data>data</a></code> attribute has the value
- obtained from invoking the <a href=#internal-structured-cloning-algorithm>internal structured cloning
- algorithm</a> recursively with the value of the <code title=dom-imagedata-data><a href=#dom-imagedata-data>data</a></code> attribute on <var title="">input</var> as the new "<var title="">input</var>"
- argument and <var title="">memory</var> as the new "<var title="">memory</var>" argument.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed <code><a href=#imagedata>ImageData</a></code> object
+ whose <code title=dom-imagedata-width><a href=#dom-imagedata-width>width</a></code>, <code title=dom-imagedata-height><a href=#dom-imagedata-height>height</a></code>, and <code title=dom-imagedata-resolution><a href=#dom-imagedata-resolution>resolution</a></code> attributes have values equal to the
+ corresponding attributes on <var title="">input</var>, and whose <code title=dom-imagedata-data><a href=#dom-imagedata-data>data</a></code> attribute has the value obtained from invoking the
+ <a href=#internal-structured-cloning-algorithm>internal structured cloning algorithm</a> recursively with the value of the <code title=dom-imagedata-data><a href=#dom-imagedata-data>data</a></code> attribute on <var title="">input</var> as the new "<var title="">input</var>" argument and <var title="">memory</var> as the new "<var title="">memory</var>" argument.</dd>
<dt>If <var title="">input</var> is an <code><a href=#imagebitmap>ImageBitmap</a></code> object</dt>
@@ -8112,28 +8107,28 @@
<dd>
- <p>Let <var title="">output</var> be a newly constructed empty
- <code>Array</code> object whose <code title="">length</code> is
- equal to the <code title="">length</code> of <var title="">input</var>.</p>
+ <p>Let <var title="">output</var> be a newly constructed empty <code>Array</code> object whose
+ <code title="">length</code> is equal to the <code title="">length</code> of <var title="">input</var>.</p>
- <p class=note>This means that the length of sparse arrays is
- preserved.</p>
+ <p class=note>This means that the length of sparse arrays is preserved.</p>
</dd>
<dt>If <var title="">input</var> is an <code><a href=#the-object-element>Object</a></code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed empty <code title="">Object</code> object.</dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed empty <code title="">Object</code>
+ object.</dd>
<dt>If <var title="">input</var> is an object that another specification defines how to clone</dt>
- <dd><p>Let <var title="">output</var> be a clone of the object as defined by the other specification.</dd>
+ <dd><p>Let <var title="">output</var> be a clone of the object as defined by the other
+ specification.</dd>
<dt>If <var title="">input</var> is another native object type (e.g. <code>Error</code>, <code>Function</code>)</dt>
<dt>If <var title="">input</var> is a host object (e.g. a DOM node)</dt>
- <dd><p>Throw a <code><a href=#datacloneerror>DataCloneError</a></code> exception and abort
- the overall <a href=#structured-clone>structured clone</a> algorithm.</dd>
+ <dd><p>Throw a <code><a href=#datacloneerror>DataCloneError</a></code> exception and abort the overall <a href=#structured-clone>structured
+ clone</a> algorithm.</dd>
</dl><p>For the purposes of the algorithm above, an object is a particular type of object <var title="">class</var> if its [[Class]] internal property is equal to <var title="">class</var>.</p>
@@ -8142,9 +8137,7 @@
</li>
- <li><p>Add a mapping from <var title="">input</var> (the source
- object) to <var title="">output</var> (the destination object) to
- <var title="">memory</var>.</li>
+ <li><p>Add a mapping from <var title="">input</var> (the source object) to <var title="">output</var> (the destination object) to <var title="">memory</var>.</li>
<li>
@@ -8173,22 +8166,20 @@
<p class=note>This does not walk the prototype chain.</p>
- <p class=note>Property descriptors, setters, getters, and
- analogous features are not copied in this process. For example,
- the property in the input could be marked as read-only, but in the
- output it would just have the default state (typically read-write,
- though that could depend on the scripting environment).</p>
+ <p class=note>Property descriptors, setters, getters, and analogous features are not copied in
+ this process. For example, the property in the input could be marked as read-only, but in the
+ output it would just have the default state (typically read-write, though that could depend on
+ the scripting environment).</p>
- <p class=note>Properties of Array objects are not treated any
- differently than those of other Objects. In particular, this means
- that non-index properties of arrays are copied as well.</p>
+ <p class=note>Properties of Array objects are not treated any differently than those of other
+ Objects. In particular, this means that non-index properties of arrays are copied as well.</p>
</li>
<li><p>Return <var title="">output</var>.</li>
- </ol><p class=note>This algorithm preserves cycles and preserves the
- identity of duplicate objects in graphs.</p>
+ </ol><p class=note>This algorithm preserves cycles and preserves the identity of duplicate objects in
+ graphs.</p>
</div>
@@ -82405,8 +82396,8 @@
<p>Associate the two ports to be entangled, so that they form the two parts of a new channel.
(There is no <code><a href=#messagechannel>MessageChannel</a></code> object that represents this channel.)</p>
- <p>Two ports A and B that have gone through this step are now said to be entangled; one is
- entangled to the other, and vice versa.</p>
+ <p>Two ports <var title="">A</var> and <var title="">B</var> that have gone through this step
+ are now said to be entangled; one is entangled to the other, and vice versa.</p>
<p class=note>While this specification describes this process as instantaneous,
implementations are more likely to implement it via message passing. As with all algorithms, the
Modified: source
===================================================================
--- source 2013-06-06 19:56:34 UTC (rev 7918)
+++ source 2013-06-06 20:01:19 UTC (rev 7919)
@@ -7641,86 +7641,79 @@
<h4>Safe passing of structured data</h4>
-<!--CLEANUP-->
- <p>When a user agent is required to obtain a <dfn>structured
- clone</dfn> of a value, optionally with a <i>transfer map</i>, it
- must run the following algorithm, which either returns a separate
- value, or throws an exception. If a <i>transfer map</i> is provided,
- it consists of an association list of <code>Transferable</code>
- objects to placeholder objects.</p>
+ <p>When a user agent is required to obtain a <dfn>structured clone</dfn> of a value, optionally
+ with a <i>transfer map</i>, it must run the following algorithm, which either returns a separate
+ value, or throws an exception. If a <i>transfer map</i> is provided, it consists of an association
+ list of <code>Transferable</code> objects to placeholder objects.</p>
<ol>
- <li><p>Let <var title="">input</var> be the value being
- cloned.</p></li>
+ <li><p>Let <var title="">input</var> be the value being cloned.</p></li>
- <li><p>Let <var title="">transfer map</var> be the <i>transfer
- map</i> passed to the algorithm, if any, or the empty list
- otherwise.</p></li>
+ <li><p>Let <var title="">transfer map</var> be the <i>transfer map</i> passed to the algorithm,
+ if any, or the empty list otherwise.</p></li>
- <li><p>Let <var title="">memory</var> be an association list of
- pairs of objects, initially empty. This is used to handle duplicate
- references. In each pair of objects, one is called the
- <em>source</em> object and the other the <em>destination</em>
- object.</p></li>
+ <li><p>Let <var title="">memory</var> be an association list of pairs of objects, initially
+ empty. This is used to handle duplicate references. In each pair of objects, one is called the
+ <em>source</em> object and the other the <em>destination</em> object.</p></li>
- <li><p>For each mapping in <var title="">transfer map</var>, add a
- mapping from the <code>Transferable</code> object (the source
- object) to the placeholder object (the destination object) to <var
- title="">memory</var>.</p></li>
+ <li><p>For each mapping in <var title="">transfer map</var>, add a mapping from the
+ <code>Transferable</code> object (the source object) to the placeholder object (the destination
+ object) to <var title="">memory</var>.</p></li>
- <li><p>Let <var title="">output</var> be the value resulting from
- calling the <span>internal structured cloning algorithm</span> with
- <var title="">input</var> as the "<var title="">input</var>"
- argument, and <var title="">memory</var> as the "<var
+ <li><p>Let <var title="">output</var> be the value resulting from calling the <span>internal
+ structured cloning algorithm</span> with <var title="">input</var> as the "<var
+ title="">input</var>" argument, and <var title="">memory</var> as the "<var
title="">memory</var>" argument.</p></li>
<li><p>Return <var title="">output</var>.</p></li>
</ol>
- <p>The <dfn>internal structured cloning algorithm</dfn> is always
- called with two arguments, <var title="">input</var> and <var
- title="">memory</var>, and its behavior is as follows:</p>
+ <p>The <dfn>internal structured cloning algorithm</dfn> is always called with two arguments, <var
+ title="">input</var> and <var title="">memory</var>, and its behavior is as follows:</p>
<ol>
- <li><p>If <var title="">input</var> is the source object of a pair
- of objects in <var title="">memory</var>, then return the
- destination object in that pair of objects and abort these
+ <li><p>If <var title="">input</var> is the source object of a pair of objects in <var
+ title="">memory</var>, then return the destination object in that pair of objects and abort these
steps.</p></li>
- <li><p>If <var title="">input</var> is a primitive value, then
- return that value and abort these steps.</p></li>
+ <li><p>If <var title="">input</var> is a primitive value, then return that value and abort these
+ steps.</p></li>
<li>
- <p>The <var title="">input</var> value is an object. Jump to the
- appropriate step below:</p>
+ <p>The <var title="">input</var> value is an object. Jump to the appropriate step below:</p>
<dl class="switch">
<dt>If <var title="">input</var> is a <code>Boolean</code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed Boolean object with the same value as <var title="">input</var>.</p></dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed Boolean object with the same value
+ as <var title="">input</var>.</p></dd>
<dt>If <var title="">input</var> is a <code>Number</code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed Number object with the same value as <var title="">input</var>.</p></dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed Number object with the same value
+ as <var title="">input</var>.</p></dd>
<dt>If <var title="">input</var> is a <code>String</code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed String object with the same value as <var title="">input</var>.</p></dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed String object with the same value
+ as <var title="">input</var>.</p></dd>
<dt>If <var title="">input</var> is a <code>Date</code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed <code>Date</code> object with the same value as <var title="">input</var>.</p></dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed <code>Date</code> object with the
+ same value as <var title="">input</var>.</p></dd>
<dt>If <var title="">input</var> is a <code>RegExp</code> object</dt>
<dd>
- <p>Let <var title="">output</var> be a newly constructed <code>RegExp</code> object with the same pattern and flags as <var title="">input</var>.</p>
+ <p>Let <var title="">output</var> be a newly constructed <code>RegExp</code> object with the
+ same pattern and flags as <var title="">input</var>.</p>
<p class="note">The value of the <code title="">lastIndex</code> property is not copied.</p>
@@ -7728,31 +7721,32 @@
<dt>If <var title="">input</var> is a <code>File</code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed <code>File</code> object corresponding to the same underlying data.</p></dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed <code>File</code> object
+ corresponding to the same underlying data.</p></dd>
<dt>If <var title="">input</var> is a <code>Blob</code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed <code>Blob</code> object corresponding to the same underlying data.</p></dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed <code>Blob</code> object
+ corresponding to the same underlying data.</p></dd>
<dt>If <var title="">input</var> is a <code>FileList</code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed <code>FileList</code> object containing a list of newly constructed <code>File</code> objects corresponding to the same underlying data as those in <var title="">input</var>, maintaining their relative order.</p></dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed <code>FileList</code> object
+ containing a list of newly constructed <code>File</code> objects corresponding to the same
+ underlying data as those in <var title="">input</var>, maintaining their relative
+ order.</p></dd>
<dt>If <var title="">input</var> is an <code>ImageData</code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed
- <code>ImageData</code> object whose <code
- title="dom-imagedata-width">width</code>, <code
+ <dd><p>Let <var title="">output</var> be a newly constructed <code>ImageData</code> object
+ whose <code title="dom-imagedata-width">width</code>, <code
title="dom-imagedata-height">height</code>, and <code
- title="dom-imagedata-resolution">resolution</code> attributes have values
- equal to the corresponding attributes on <var
- title="">input</var>, and whose <code
- title="dom-imagedata-data">data</code> attribute has the value
- obtained from invoking the <span>internal structured cloning
- algorithm</span> recursively with the value of the <code
- title="dom-imagedata-data">data</code> attribute on <var
- title="">input</var> as the new "<var title="">input</var>"
- argument and <var title="">memory</var> as the new "<var
+ title="dom-imagedata-resolution">resolution</code> attributes have values equal to the
+ corresponding attributes on <var title="">input</var>, and whose <code
+ title="dom-imagedata-data">data</code> attribute has the value obtained from invoking the
+ <span>internal structured cloning algorithm</span> recursively with the value of the <code
+ title="dom-imagedata-data">data</code> attribute on <var title="">input</var> as the new "<var
+ title="">input</var>" argument and <var title="">memory</var> as the new "<var
title="">memory</var>" argument.</p></dd>
<dt>If <var title="">input</var> is an <code>ImageBitmap</code> object</dt>
@@ -7774,29 +7768,29 @@
<dd>
- <p>Let <var title="">output</var> be a newly constructed empty
- <code>Array</code> object whose <code title="">length</code> is
- equal to the <code title="">length</code> of <var
+ <p>Let <var title="">output</var> be a newly constructed empty <code>Array</code> object whose
+ <code title="">length</code> is equal to the <code title="">length</code> of <var
title="">input</var>.</p>
- <p class="note">This means that the length of sparse arrays is
- preserved.</p>
+ <p class="note">This means that the length of sparse arrays is preserved.</p>
</dd>
<dt>If <var title="">input</var> is an <code>Object</code> object</dt>
- <dd><p>Let <var title="">output</var> be a newly constructed empty <code title="">Object</code> object.</p></dd>
+ <dd><p>Let <var title="">output</var> be a newly constructed empty <code title="">Object</code>
+ object.</p></dd>
<dt>If <var title="">input</var> is an object that another specification defines how to clone</dt>
- <dd><p>Let <var title="">output</var> be a clone of the object as defined by the other specification.</p></dd>
+ <dd><p>Let <var title="">output</var> be a clone of the object as defined by the other
+ specification.</p></dd>
<dt>If <var title="">input</var> is another native object type (e.g. <code>Error</code>, <code>Function</code>)</dt>
<dt>If <var title="">input</var> is a host object (e.g. a DOM node)</dt>
- <dd><p>Throw a <code>DataCloneError</code> exception and abort
- the overall <span>structured clone</span> algorithm.</p></dd>
+ <dd><p>Throw a <code>DataCloneError</code> exception and abort the overall <span>structured
+ clone</span> algorithm.</p></dd>
</dl>
@@ -7810,9 +7804,8 @@
</li>
- <li><p>Add a mapping from <var title="">input</var> (the source
- object) to <var title="">output</var> (the destination object) to
- <var title="">memory</var>.</p></li>
+ <li><p>Add a mapping from <var title="">input</var> (the source object) to <var
+ title="">output</var> (the destination object) to <var title="">memory</var>.</p></li>
<li>
@@ -7847,15 +7840,13 @@
<p class="note">This does not walk the prototype chain.</p>
- <p class="note">Property descriptors, setters, getters, and
- analogous features are not copied in this process. For example,
- the property in the input could be marked as read-only, but in the
- output it would just have the default state (typically read-write,
- though that could depend on the scripting environment).</p>
+ <p class="note">Property descriptors, setters, getters, and analogous features are not copied in
+ this process. For example, the property in the input could be marked as read-only, but in the
+ output it would just have the default state (typically read-write, though that could depend on
+ the scripting environment).</p>
- <p class="note">Properties of Array objects are not treated any
- differently than those of other Objects. In particular, this means
- that non-index properties of arrays are copied as well.</p>
+ <p class="note">Properties of Array objects are not treated any differently than those of other
+ Objects. In particular, this means that non-index properties of arrays are copied as well.</p>
</li>
@@ -7863,8 +7854,8 @@
</ol>
- <p class="note">This algorithm preserves cycles and preserves the
- identity of duplicate objects in graphs.</p>
+ <p class="note">This algorithm preserves cycles and preserves the identity of duplicate objects in
+ graphs.</p>
</div>
@@ -91922,8 +91913,8 @@
<p>Associate the two ports to be entangled, so that they form the two parts of a new channel.
(There is no <code>MessageChannel</code> object that represents this channel.)</p>
- <p>Two ports A and B that have gone through this step are now said to be entangled; one is
- entangled to the other, and vice versa.</p>
+ <p>Two ports <var title="">A</var> and <var title="">B</var> that have gone through this step
+ are now said to be entangled; one is entangled to the other, and vice versa.</p>
<p class="note">While this specification describes this process as instantaneous,
implementations are more likely to implement it via message passing. As with all algorithms, the
More information about the Commit-Watchers
mailing list