- From: CVS User ihickson <cvsmail@w3.org>
- Date: Sun, 30 Dec 2012 19:45:31 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/webstorage
In directory roscoe:/tmp/cvs-serv693
Modified Files:
Overview.html
Log Message:
Try to clarify when 'storage' even fires. (whatwg r7615)
--- /sources/public/html5/webstorage/Overview.html 2012/12/18 22:29:51 1.210
+++ /sources/public/html5/webstorage/Overview.html 2012/12/30 19:45:31 1.211
@@ -215,7 +215,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-18-december-2012">Editor's Draft 18 December 2012</h2>
+ <h2 class="no-num no-toc" id="editor-s-draft-30-december-2012">Editor's Draft 30 December 2012</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>
@@ -351,7 +351,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 18 December 2012 Editor's Draft.
+ This specification is the 30 December 2012 Editor's Draft.
</p>
@@ -647,8 +647,9 @@
list, with the given <var title="">key</var> and with its value set
to <var title="">value</var>.</p>
- <p>If the given <var title="">key</var> <em>does</em> exist in the
- list, then it must have its value updated to <var title="">value</var>.</p>
+ <p>If the given <var title="">key</var> <em>does</em> exist in the list, and its value is not
+ equal to <var title="">value</var>, then it must have its value updated to <var title="">value</var>. If its previous value <em>is</em> equal to <var title="">value</var>, then
+ the method must do nothing.</p>
<p>If it couldn't set the new value, the method must throw an
<code>QuotaExceededError</code> exception. (Setting could fail if,
@@ -672,7 +673,7 @@
none, then the method must do nothing.</p>
<p class="note">When the <code title="dom-Storage-setItem"><a href="#dom-storage-setitem">setItem()</a></code>, <code title="dom-Storage-removeItem"><a href="#dom-storage-removeitem">removeItem()</a></code>, and <code title="dom-Storage-clear"><a href="#dom-storage-clear">clear()</a></code> methods are invoked, events are fired on the
- <code>Window</code> objecys of other <code>Document</code>s that can access the newly stored or
+ <code>Window</code> objects of other <code>Document</code>s that can access the newly stored or
removed data, 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.</p>
<p class="note">This specification does not require that the above
@@ -750,10 +751,10 @@
on, however, the two session storage areas must be considered
separate, not affecting each other in any way.</p>
- <p id="sessionStorageEvent">When the <code title="dom-Storage-setItem"><a href="#dom-storage-setitem">setItem()</a></code>, <code title="dom-Storage-removeItem"><a href="#dom-storage-removeitem">removeItem()</a></code>, and <code title="dom-Storage-clear"><a href="#dom-storage-clear">clear()</a></code> methods are called on a <code><a href="#storage-0">Storage</a></code> object <var title="">x</var> that is associated with a session storage area, if the methods did something,
- then for every <code>Document</code> object whose <code>Window</code> object's <code title="dom-sessionStorage"><a href="#dom-sessionstorage">sessionStorage</a></code> attribute's <code><a href="#storage-0">Storage</a></code> object is
- associated with the same storage area, other than <var title="">x</var>, <a href="#send-a-storage-notification">send a storage
- notification</a>.
+ <p id="sessionStorageEvent">When the <code title="dom-Storage-setItem"><a href="#dom-storage-setitem">setItem()</a></code>, <code title="dom-Storage-removeItem"><a href="#dom-storage-removeitem">removeItem()</a></code>, and <code title="dom-Storage-clear"><a href="#dom-storage-clear">clear()</a></code> methods are called on a <code><a href="#storage-0">Storage</a></code> object <var title="">x</var> that is associated with a session storage area, if the methods did not throw an
+ exception or "do nothing" as defined above, then for every <code>Document</code> object whose
+ <code>Window</code> object's <code title="dom-sessionStorage"><a href="#dom-sessionstorage">sessionStorage</a></code> attribute's
+ <code><a href="#storage-0">Storage</a></code> object is associated with the same storage area, other than <var title="">x</var>, <a href="#send-a-storage-notification">send a storage notification</a>.</p>
<h3 id="the-localstorage-attribute"><span class="secno">4.3 </span>The <code title="dom-localStorage"><a href="#dom-localstorage">localStorage</a></code> attribute</h3>
@@ -802,14 +803,10 @@
origin's local storage area. Each <code>Document</code> object must
have a separate object for its <code>Window</code>'s <code title="dom-localStorage"><a href="#dom-localstorage">localStorage</a></code> attribute.</p>
- </ol><p id="localStorageEvent">When the <code title="dom-Storage-setItem"><a href="#dom-storage-setitem">setItem()</a></code>, <code title="dom-Storage-removeItem"><a href="#dom-storage-removeitem">removeItem()</a></code>, and <code title="dom-Storage-clear"><a href="#dom-storage-clear">clear()</a></code> methods are called on a
- <code><a href="#storage-0">Storage</a></code> object <var title="">x</var> that is associated
- with a local storage area, if the methods did something, then for
- every <code>Document</code> object whose <code>Window</code>
- object's <code title="dom-localStorage"><a href="#dom-localstorage">localStorage</a></code>
- attribute's <code><a href="#storage-0">Storage</a></code> object is associated with the same
- storage area, other than <var title="">x</var>, <a href="#send-a-storage-notification">send a storage
- notification</a>.
+ </ol><p id="localStorageEvent">When the <code title="dom-Storage-setItem"><a href="#dom-storage-setitem">setItem()</a></code>, <code title="dom-Storage-removeItem"><a href="#dom-storage-removeitem">removeItem()</a></code>, and <code title="dom-Storage-clear"><a href="#dom-storage-clear">clear()</a></code> methods are called on a <code><a href="#storage-0">Storage</a></code> object <var title="">x</var> that is associated with a local storage area, if the methods did not throw an
+ exception or "do nothing" as defined above, then for every <code>Document</code> object whose
+ <code>Window</code> object's <code title="dom-localStorage"><a href="#dom-localstorage">localStorage</a></code> attribute's
+ <code><a href="#storage-0">Storage</a></code> object is associated with the same storage area, other than <var title="">x</var>, <a href="#send-a-storage-notification">send a storage notification</a>.
<p id="localStorageMutex">Whenever the properties of a <code title="dom-localStorage"><a href="#dom-localstorage">localStorage</a></code> attribute's
<code><a href="#storage-0">Storage</a></code> object are to be examined, returned, set, or
Received on Sunday, 30 December 2012 19:45:33 UTC