- From: poot <cvsmail@w3.org>
- Date: Tue, 11 Jan 2011 21:43:56 -0500
- To: public-html-diffs@w3.org
webstorage; hixie: Add references to HTML spec since structured clone is defined there. (whatwg r5770) http://dev.w3.org/cvsweb/html5/webstorage/Overview.html?r1=1.156&r2=1.157&f=h http://html5.org/tools/web-apps-tracker?from=5769&to=5770 =================================================================== RCS file: /sources/public/html5/webstorage/Overview.html,v retrieving revision 1.156 retrieving revision 1.157 diff -u -d -r1.156 -r1.157 --- Overview.html 1 Jan 2011 06:34:04 -0000 1.156 +++ Overview.html 11 Jan 2011 19:57:11 -0000 1.157 @@ -229,7 +229,7 @@ <p><a href="http://www.w3.org/"><img alt="W3C" height="48" src="http://www.w3.org/Icons/w3c_home" width="72"></a></p> <h1>Web Storage</h1> - <h2 class="no-num no-toc" id="editor-s-draft-1-january-2011">Editor's Draft 1 January 2011</h2> + <h2 class="no-num no-toc" id="editor-s-draft-11-january-2011">Editor's Draft 11 January 2011</h2> <dl><dt>Latest Published Version:</dt> <dd><a href="http://www.w3.org/TR/webstorage/">http://www.w3.org/TR/webstorage/</a></dd> <dt>Latest Editor's Draft:</dt> @@ -322,7 +322,7 @@ </dl><p>The W3C <a href="http://www.w3.org/2008/webapps/">Web Applications Working Group</a> is the W3C working group responsible for this specification's progress along the W3C Recommendation track. - This specification is the 1 January 2011 Editor's Draft. + This specification is the 11 January 2011 Editor's Draft. </p><!-- required patent boilerplate --><p>This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5 February 2004 W3C Patent Policy</a>. W3C maintains a <a href="http://www.w3.org/2004/01/pp-impl/42538/status" rel="disclosure">public list of any patent disclosures</a> made in connection with the deliverables @@ -512,7 +512,11 @@ key/value pairs, which are sometimes called items. Keys are strings. Any string (including the empty string) is a valid key. Values can be any data type supported by the <span>structured - clone</span> algorithm.<p>Each <code><a href="#storage-0">Storage</a></code> object is associated with a list of + clone</span> algorithm. + + <a href="#refsHTML">[HTML]</a> + + <p>Each <code><a href="#storage-0">Storage</a></code> object is associated with a list of key/value pairs when it is created, as defined in the sections on the <code title="dom-sessionStorage"><a href="#dom-sessionstorage">sessionStorage</a></code> and <code title="dom-localStorage"><a href="#dom-localstorage">localStorage</a></code> attributes. Multiple separate objects implementing the <code><a href="#storage-0">Storage</a></code> interface can @@ -538,12 +542,20 @@ currently present in the list associated with the object.<p>The <dfn id="dom-storage-getitem" title="dom-Storage-getItem"><code>getItem(<var title="">key</var>)</code></dfn> method must return a <span>structured clone</span> of the current value associated with the given <var title="">key</var>. If the given <var title="">key</var> does not exist in the list associated with the - object then this method must return null.<p>The <dfn id="dom-storage-setitem" title="dom-Storage-setItem"><code>setItem(<var title="">key</var>, <var title="">value</var>)</code></dfn> method + object then this method must return null. + + <a href="#refsHTML">[HTML]</a> + + <p>The <dfn id="dom-storage-setitem" title="dom-Storage-setItem"><code>setItem(<var title="">key</var>, <var title="">value</var>)</code></dfn> method must first create a <span>structured clone</span> of the given <var title="">value</var>. If this raises an exception, then the exception must be thrown and the list associated with the object is left unchanged. If constructing the stuctured clone would involve constructing a new <code>ImageData</code> object, then throw a - <code>NOT_SUPPORTED_ERR</code> exception instead.</p><!-- ImageData isn't supported because reading such objects is + <code>NOT_SUPPORTED_ERR</code> exception instead. + + <a href="#refsHTML">[HTML]</a> + + </p><!-- ImageData isn't supported because reading such objects is synchronous, and getData() is synchronous, and therefore if the stored data is in deep storage, it would be very painful to have a script grab the value and immediately try to read the image @@ -697,7 +709,11 @@ <span>structured clone</span> of the old value of the key in question, or null if the key is newly added, and its <code title="dom-StorageEvent-newValue"><a href="#dom-storageevent-newvalue">newValue</a></code> attribute set to a <span>structured clone</span> of the new value of the key in - question, or null if the key was removed.<p>Otherwise, if the event is being fired due to an invocation of + question, or null if the key was removed. + + <a href="#refsHTML">[HTML]</a> + + <p>Otherwise, if the event is being fired due to an invocation of the <code title="dom-Storage-clear"><a href="#dom-storage-clear">clear()</a></code> method, the event must have its <code title="dom-StorageEvent-key"><a href="#dom-storageevent-key">key</a></code>, <code title="dom-StorageEvent-oldValue"><a href="#dom-storageevent-oldvalue">oldValue</a></code>, and <code title="dom-StorageEvent-newValue"><a href="#dom-storageevent-newvalue">newValue</a></code> attributes set to null.<p>In addition, the event must have its <code title="dom-StorageEvent-url"><a href="#dom-storageevent-url">url</a></code> attribute set to <span title="the document's address">the address of the document</span>
Received on Wednesday, 12 January 2011 02:43:59 UTC