[html5] r6349 - [giow] (0) Add an abort() method to appcache to allow scripts to provide an abor [...]

whatwg at whatwg.org whatwg at whatwg.org
Tue Aug 2 15:19:23 PDT 2011


Author: ianh
Date: 2011-08-02 15:19:22 -0700 (Tue, 02 Aug 2011)
New Revision: 6349

Modified:
   complete.html
   index
   source
Log:
[giow] (0) Add an abort() method to appcache to allow scripts to provide an abort UI when caching a site.

Modified: complete.html
===================================================================
--- complete.html	2011-08-02 22:02:22 UTC (rev 6348)
+++ complete.html	2011-08-02 22:19:22 UTC (rev 6349)
@@ -66452,7 +66452,11 @@
 
     <p>For each URL in <var title="">file list</var>, run the
     following steps. These steps may be run in parallel for two or
-    more of the URLs at a time.</p>
+    more of the URLs at a time. If, while running these steps, the
+    <code><a href=#applicationcache>ApplicationCache</a></code> object's <code title=dom-appcache-abort><a href=#dom-appcache-abort>abort()</a></code> method <a href=#send-a-signal title="send
+    a signal">sends a signal</a> to this instance of the
+    <a href=#application-cache-download-process>application cache download process</a> algorithm, then
+    run the <a href=#cache-failure-steps>cache failure steps</a> instead.</p>
 
     <ol><li>
 
@@ -66529,7 +66533,10 @@
 
        <dd>
 
-        <p>Run the <a href=#cache-failure-steps>cache failure steps</a>.</p>
+        <p>If these steps are being run in parallel for any other URLs
+        in <var title="">file list</var>, then abort these steps for
+        those other URLs. Run the <a href=#cache-failure-steps>cache failure
+        steps</a>.</p>
 
         <p class=note>Redirects are fatal because they are either
         indicative of a network problem (e.g. a captive portal); or
@@ -67082,6 +67089,7 @@
 
   // updates
   void <a href=#dom-appcache-update title=dom-appcache-update>update</a>();
+  void <a href=#dom-appcache-abort title=dom-appcache-abort>abort</a>();
   void <a href=#dom-appcache-swapcache title=dom-appcache-swapCache>swapCache</a>();
 
   // events
@@ -67230,6 +67238,15 @@
   <a href=#application-cache>application cache</a>, or if it is marked as <a href=#concept-appcache-obsolete title=concept-appcache-obsolete>obsolete</a>, then the method
   must raise an <code><a href=#invalid_state_err>INVALID_STATE_ERR</a></code> exception instead.</p>
 
+  <p>If the <dfn id=dom-appcache-abort title=dom-appcache-abort><code>abort()</code></dfn>
+  method is invoked, the user agent must <dfn id=send-a-signal>send a signal</dfn> to
+  the current <a href=#application-cache-download-process>application cache download process</a> for the
+  <a href=#application-cache>application cache</a> with which the
+  <code><a href=#applicationcache>ApplicationCache</a></code> object's <a href=#cache-host>cache host</a> is
+  associated, if any. If there is no such <a href=#application-cache>application
+  cache</a>, or if does not have a current <a href=#application-cache-download-process>application cache
+  download process</a>, then do nothing.</p>
+
   <p>If the <dfn id=dom-appcache-swapcache title=dom-appcache-swapCache><code>swapCache()</code></dfn> method
   is invoked, the user agent must run the following steps:
 

Modified: index
===================================================================
--- index	2011-08-02 22:02:22 UTC (rev 6348)
+++ index	2011-08-02 22:19:22 UTC (rev 6349)
@@ -66333,7 +66333,11 @@
 
     <p>For each URL in <var title="">file list</var>, run the
     following steps. These steps may be run in parallel for two or
-    more of the URLs at a time.</p>
+    more of the URLs at a time. If, while running these steps, the
+    <code><a href=#applicationcache>ApplicationCache</a></code> object's <code title=dom-appcache-abort><a href=#dom-appcache-abort>abort()</a></code> method <a href=#send-a-signal title="send
+    a signal">sends a signal</a> to this instance of the
+    <a href=#application-cache-download-process>application cache download process</a> algorithm, then
+    run the <a href=#cache-failure-steps>cache failure steps</a> instead.</p>
 
     <ol><li>
 
@@ -66410,7 +66414,10 @@
 
        <dd>
 
-        <p>Run the <a href=#cache-failure-steps>cache failure steps</a>.</p>
+        <p>If these steps are being run in parallel for any other URLs
+        in <var title="">file list</var>, then abort these steps for
+        those other URLs. Run the <a href=#cache-failure-steps>cache failure
+        steps</a>.</p>
 
         <p class=note>Redirects are fatal because they are either
         indicative of a network problem (e.g. a captive portal); or
@@ -66963,6 +66970,7 @@
 
   // updates
   void <a href=#dom-appcache-update title=dom-appcache-update>update</a>();
+  void <a href=#dom-appcache-abort title=dom-appcache-abort>abort</a>();
   void <a href=#dom-appcache-swapcache title=dom-appcache-swapCache>swapCache</a>();
 
   // events
@@ -67117,6 +67125,15 @@
   <a href=#application-cache>application cache</a>, or if it is marked as <a href=#concept-appcache-obsolete title=concept-appcache-obsolete>obsolete</a>, then the method
   must raise an <code><a href=#invalid_state_err>INVALID_STATE_ERR</a></code> exception instead.</p>
 
+  <p>If the <dfn id=dom-appcache-abort title=dom-appcache-abort><code>abort()</code></dfn>
+  method is invoked, the user agent must <dfn id=send-a-signal>send a signal</dfn> to
+  the current <a href=#application-cache-download-process>application cache download process</a> for the
+  <a href=#application-cache>application cache</a> with which the
+  <code><a href=#applicationcache>ApplicationCache</a></code> object's <a href=#cache-host>cache host</a> is
+  associated, if any. If there is no such <a href=#application-cache>application
+  cache</a>, or if does not have a current <a href=#application-cache-download-process>application cache
+  download process</a>, then do nothing.</p>
+
   <p>If the <dfn id=dom-appcache-swapcache title=dom-appcache-swapCache><code>swapCache()</code></dfn> method
   is invoked, the user agent must run the following steps:
 

Modified: source
===================================================================
--- source	2011-08-02 22:02:22 UTC (rev 6348)
+++ source	2011-08-02 22:19:22 UTC (rev 6349)
@@ -75547,7 +75547,12 @@
 
     <p>For each URL in <var title="">file list</var>, run the
     following steps. These steps may be run in parallel for two or
-    more of the URLs at a time.</p>
+    more of the URLs at a time. If, while running these steps, the
+    <code>ApplicationCache</code> object's <code
+    title="dom-appcache-abort">abort()</code> method <span title="send
+    a signal">sends a signal</span> to this instance of the
+    <span>application cache download process</span> algorithm, then
+    run the <span>cache failure steps</span> instead.</p>
 
     <ol>
 
@@ -75633,7 +75638,10 @@
 
        <dd>
 
-        <p>Run the <span>cache failure steps</span>.</p>
+        <p>If these steps are being run in parallel for any other URLs
+        in <var title="">file list</var>, then abort these steps for
+        those other URLs. Run the <span>cache failure
+        steps</span>.</p>
 
         <p class="note">Redirects are fatal because they are either
         indicative of a network problem (e.g. a captive portal); or
@@ -76282,6 +76290,7 @@
 
   // updates
   void <span title="dom-appcache-update">update</span>();
+  void <span title="dom-appcache-abort">abort</span>();
   void <span title="dom-appcache-swapCache">swapCache</span>();
 
   // events
@@ -76460,6 +76469,15 @@
   title="concept-appcache-obsolete">obsolete</span>, then the method
   must raise an <code>INVALID_STATE_ERR</code> exception instead.</p>
 
+  <p>If the <dfn title="dom-appcache-abort"><code>abort()</code></dfn>
+  method is invoked, the user agent must <dfn>send a signal</dfn> to
+  the current <span>application cache download process</span> for the
+  <span>application cache</span> with which the
+  <code>ApplicationCache</code> object's <span>cache host</span> is
+  associated, if any. If there is no such <span>application
+  cache</span>, or if does not have a current <span>application cache
+  download process</span>, then do nothing.</p>
+
   <p>If the <dfn
   title="dom-appcache-swapCache"><code>swapCache()</code></dfn> method
   is invoked, the user agent must run the following steps:




More information about the Commit-Watchers mailing list