W3C home > Mailing lists > Public > public-html-commits@w3.org > May 2009

html5/webstorage Overview.html,1.41,1.42

From: Ian Hickson via cvs-syncmail <cvsmail@w3.org>
Date: Mon, 11 May 2009 23:52:05 +0000
To: public-html-commits@w3.org
Message-Id: <E1M3fHx-0008Hg-M1@lionel-hutz.w3.org>
Update of /sources/public/html5/webstorage
In directory hutz:/tmp/cvs-serv31830

Modified Files:
	Overview.html 
Log Message:
Note about performance characteristics of SQLResultSetRowList. (credit: ap) (whatwg r3091)

Index: Overview.html
===================================================================
RCS file: /sources/public/html5/webstorage/Overview.html,v
retrieving revision 1.41
retrieving revision 1.42
diff -u -d -r1.41 -r1.42
--- Overview.html	10 May 2009 11:20:25 -0000	1.41
+++ Overview.html	11 May 2009 23:52:03 -0000	1.42
@@ -151,7 +151,7 @@
    <h1>Web Storage</h1>
    <!--ZZZ:-->
    <!--<h2 class="no-num no-toc">W3C Working Draft 23 April 2009</h2>-->
-   <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 10 May 2009</h2>
+   <h2 class="no-num no-toc" id="editor-s-draft-date-1-january-1970">Editor's Draft 11 May 2009</h2>
    <!--:ZZZ-->
    <dl><!-- ZZZ: update the month/day (twice), (un)comment out
     <dt>This Version:</dt>
@@ -219,7 +219,7 @@
   specification's progress along the W3C Recommendation track.
   <!--ZZZ:-->
   <!--This specification is the 23 April 2009 Working Draft.-->
-  This specification is the 10 May 2009 Editor's Draft.
+  This specification is the 11 May 2009 Editor's Draft.
   <!--:ZZZ-->
   </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
@@ -1086,9 +1086,14 @@
   be zero).<pre class="idl">interface <dfn id="sqlresultsetrowlist">SQLResultSetRowList</dfn> {
   readonly attribute unsigned long <a href="#dom-sqlresultsetrowlist-length" title="dom-SQLResultSetRowList-length">length</a>;
   [IndexGetter] <span>any</span> <a href="#dom-sqlresultsetrowlist-item" title="dom-SQLResultSetRowList-item">item</a>(in unsigned long index);
-};</pre><p><code><a href="#sqlresultsetrowlist">SQLResultSetRowList</a></code> objects have a <dfn id="dom-sqlresultsetrowlist-length" title="dom-SQLResultSetRowList-length"><code>length</code></dfn>
+};</pre><p class="note">Implementors are encouraged to implement
+  <code><a href="#sqlresultsetrowlist">SQLResultSetRowList</a></code> objects lazily, or at least
+  asynchronously, for better performance.<p><code><a href="#sqlresultsetrowlist">SQLResultSetRowList</a></code> objects have a <dfn id="dom-sqlresultsetrowlist-length" title="dom-SQLResultSetRowList-length"><code>length</code></dfn>
   attribute that must return the number of rows it represents (the
-  number of rows returned by the database). This is the <var title="dom-SQLResultSetRowList-length"><a href="#dom-sqlresultsetrowlist-length">length</a></var>.<p>The object's <span>indices of the supported indexed
+  number of rows returned by the database). This is the <var title="dom-SQLResultSetRowList-length"><a href="#dom-sqlresultsetrowlist-length">length</a></var>.<p class="note">Fetching the <code title="dom-SQLResultSetRowList-length"><a href="#dom-sqlresultsetrowlist-length">length</a></code> might be
+  expensive, and authors are thus encouraged to avoid using it (or
+  enumerating over the object, which implicitly uses it) where
+  possible.<p>The object's <span>indices of the supported indexed
   properties</span> are the numbers in the range zero to <span title=""><var title="dom-SQLResultSetRowList-length"><a href="#dom-sqlresultsetrowlist-length">length</a></var>-1</span>, unless
   the <var title="dom-SQLResultSetRowList-length"><a href="#dom-sqlresultsetrowlist-length">length</a></var> is
   zero, in which case there are no <span>supported indexed
Received on Monday, 11 May 2009 23:52:18 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 11 May 2009 23:52:26 GMT