[giow] (0) Add an abort() method to appcache to allow scripts to prov…

…ide an abort UI when caching a site. git-svn-id: http://svn.whatwg.org/webapps@6349 340c8d12-0b0e-0410-8428-c7bf67bfef74
whatwg · Aug 2, 2011 · 1c67649 · 1c67649
1 parent 58245ea
commit 1c67649
Show file tree

Hide file tree

Showing 3 changed files with 58 additions and 6 deletions.
diff --git a/complete.html b/complete.html
@@ -66452,7 +66452,11 @@ <h4 id=downloading-or-updating-an-application-cache><span class=secno>6.6.4 </sp
 
     <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 @@ <h4 id=downloading-or-updating-an-application-cache><span class=secno>6.6.4 </sp
 
        <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 @@ <h4 id=application-cache-api><span class=secno>6.6.9 </span>Application cache AP
 
   // 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 @@ <h4 id=application-cache-api><span class=secno>6.6.9 </span>Application cache AP
   <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:
 

diff --git a/index b/index
@@ -66333,7 +66333,11 @@ NETWORK:
 
     <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 @@ NETWORK:
 
        <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 @@ NETWORK:
 
   // 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 @@ NETWORK:
   <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:
 

diff --git a/source b/source
@@ -75547,7 +75547,12 @@ NETWORK:
 
     <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 @@ NETWORK:
 
        <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 @@ NETWORK:
 
   // 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 @@ NETWORK:
   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: