- From: poot <cvsmail@w3.org>
- Date: Sat, 28 Mar 2009 09:36:11 +0900 (JST)
- To: public-html-diffs@w3.org
Rephrase the appcache section to talk about 'cache hosts' instead of documents and browsing contexts. (whatwg r2919) cache attempt http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#concept-appcache-cache cache failure steps http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#cache-failure-steps applicationCache http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#dom-applicationcache status http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#dom-appcache-status cache host http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#cache-host OBSOLETE http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#dom-appcache-obsolete application cache selection algorithm http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#concept-appcache-init UNCACHED http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#dom-appcache-uncached 5.8.7 Application cache API http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#application-cache-api DOWNLOADING http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#dom-appcache-downloading W3C Working Draft 12 February 2009 http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#w3c-working-draft-12-february-year UPDATEREADY http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#dom-appcache-updateready CHECKING http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#dom-appcache-checking IDLE http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#dom-appcache-idle applicationCache http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#dom-worker-applicationcache obsolete http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#concept-appcache-obsolete application cache update process http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#application-cache-update-process 5.8.6.1 Changes to the networking model http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#changesToNetworkingModel Status of this document http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#status-of-this-document A vocabulary and associated APIs for HTML and XHTML http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#a-vocabulary-and-associated-apis-for-html-and-xhtml update() http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#dom-appcache-update swapCache() http://people.w3.org/mike/diffs/html5/spec/Overview.1.2084.html#dom-appcache-swapcache http://people.w3.org/mike/diffs/html5/spec/Overview.diff.html http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.2083&r2=1.2084&f=h http://html5.org/tools/web-apps-tracker?from=2918&to=2919 =================================================================== RCS file: /sources/public/html5/spec/Overview.html,v retrieving revision 1.2083 retrieving revision 1.2084 diff -u -d -r1.2083 -r1.2084 --- Overview.html 27 Mar 2009 00:48:42 -0000 1.2083 +++ Overview.html 28 Mar 2009 00:35:13 -0000 1.2084 @@ -146,7 +146,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>HTML 5</h1> <h2 class="no-num no-toc" id=a-vocabulary-and-associated-apis-for-html-and-xhtml>A vocabulary and associated APIs for HTML and XHTML</h2> - <h2 class="no-num no-toc" id=w3c-working-draft-12-february-year><!--ZZZ:--> W3C Working Draft 12 February 2009<!-- fix date ZZZ --><!-- Editor's Draft 27 March 2009 --><!--:ZZZ--></h2> + <h2 class="no-num no-toc" id=w3c-working-draft-12-february-year><!--ZZZ:--> W3C Working Draft 12 February 2009<!-- fix date ZZZ --><!-- Editor's Draft 28 March 2009 --><!--:ZZZ--></h2> <dl><!-- ZZZ: update the month/day (twice), uncomment out --><dt>This Version:</dt> <dd><a href=http://www.w3.org/TR/2009/WD-html5-20090212/>http://www.w3.org/TR/2009/WD-html5-20090212/</a></dd> <!-- :ZZZ --> @@ -236,7 +236,7 @@ track. <!--ZZZ:--> This specification is the 12 February 2009 Working Draft. - <!-- This specification is the 27 March 2009 Editor's Draft. --> + <!-- This specification is the 28 March 2009 Editor's Draft. --> <!--:ZZZ--> </p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- relationship to other work (required) --><p>This specification is also being produced by the <a href=http://www.whatwg.org/>WHATWG</a>. The two specifications are identical from the table of contents onwards.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><!-- context and rationale (required) --><p>This specification is intended to replace (be a new version of) @@ -37670,11 +37670,22 @@ must be ignored when looking at what <a href=#application-cache-group title="application cache group">application cache groups</a> exist.</p> - <hr><p>A <code>Document</code> initially is not associated with an - <a href=#application-cache>application cache</a>, but steps <a href=#parser-appcache>in the parser</a> and in the <a href=#navigate title=navigate>navigation</a> sections cause <a href=#concept-appcache-init title=concept-appcache-init>cache selection</a> to occur early - in the page load process.</p> + <hr><p>A <dfn id=cache-host>cache host</dfn> is a <code>Document</code> or a + <code>SharedWorkerGlobalScope</code> object. A <a href=#cache-host>cache + host</a> can be associated with an <a href=#application-cache>application + cache</a>.</p> - <p>Multiple <a href=#application-cache title="application cache">application + <p>A <code>Document</code> initially is not associated with an + <a href=#application-cache>application cache</a>, buu can become associated with one + early during the page load process, when steps <a href=#parser-appcache>in the parser</a> and in the <a href=#navigate title=navigate>navigation</a> sections that cause <a href=#concept-appcache-init title=concept-appcache-init>cache selection</a> to occur.</p> + + <p>A <code>SharedWorkerGlobalScope</code> is can be associated with + an <a href=#application-cache>application cache</a> when it is created.</p> + + <p>Each <a href=#cache-host>cache host</a> has an associated + <code><a href=#applicationcache>ApplicationCache</a></code> object.</p> + + <hr><p>Multiple <a href=#application-cache title="application cache">application caches</a> in different <a href=#application-cache-group title="application cache group">application cache groups</a> can contain the same resource, e.g. if the manifests all reference that resource. If the @@ -38060,7 +38071,7 @@ process</dfn> for an <a href=#absolute-url>absolute URL</a> purported to identify a <a href=#concept-appcache-manifest title=concept-appcache-manifest>manifest</a>, or for an <a href=#application-cache-group>application cache group</a>, potentially given a particular - <a href=#browsing-context>browsing context</a>, and potentially given a new <a href=#concept-appcache-master title=concept-appcache-master>master</a> resource, the user + <a href=#cache-host>cache host</a>, and potentially given a new <a href=#concept-appcache-master title=concept-appcache-master>master</a> resource, the user agent must run the following steps:</p> <ol><li> @@ -38110,19 +38121,19 @@ <var title="">cache group</var>'s <a href=#concept-appcache-pending-masters title=concept-appcache-pending-masters>list of pending master entries</a>.</li> - <li><p>If these steps were invoked with a <a href=#browsing-context>browsing - context</a>, and the <a href=#concept-appcache-status title=concept-appcache-status>status</a> of <var title="">cache group</var> is <i>checking</i> or + <li><p>If these steps were invoked with a <a href=#cache-host>cache + host</a>, and the <a href=#concept-appcache-status title=concept-appcache-status>status</a> of <var title="">cache group</var> is <i>checking</i> or <i>downloading</i>, then <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-checking>checking</code> at the - <code><a href=#applicationcache>ApplicationCache</a></code> singleton of that <a href=#browsing-context>browsing - context</a>.</li> + <code><a href=#applicationcache>ApplicationCache</a></code> singleton of that <a href=#cache-host>cache + host</a>.</li> - <li><p>If these steps were invoked with a <a href=#browsing-context>browsing - context</a>, and the <a href=#concept-appcache-status title=concept-appcache-status>status</a> of <var title="">cache group</var> is <i>downloading</i>, then also + <li><p>If these steps were invoked with a <a href=#cache-host>cache + host</a>, and the <a href=#concept-appcache-status title=concept-appcache-status>status</a> of <var title="">cache group</var> is <i>downloading</i>, then also <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-downloading>downloading</code> at the - <code><a href=#applicationcache>ApplicationCache</a></code> singleton of that <a href=#browsing-context>browsing - context</a>.</li> + <code><a href=#applicationcache>ApplicationCache</a></code> singleton of that <a href=#cache-host>cache + host</a>.</li> <li><p>If the <a href=#concept-appcache-status title=concept-appcache-status>status</a> of the <var title="">cache group</var> is either <i>checking</i> @@ -38131,12 +38142,12 @@ <li><p>Set the <a href=#concept-appcache-status title=concept-appcache-status>status</a> of <var title="">cache group</var> to <i>checking</i>.</p> - <li><p>For each <a href=#browsing-context>browsing context</a> whose <a href=#active-document>active - document</a> is associated with an <a href=#application-cache>application - cache</a> in <var title="">cache group</var>, <a href=#queue-a-task>queue a - task</a> to <a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-checking>checking</code> at the - <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#browsing-context>browsing - context</a>. The default action of these events should be the + <li><p>For each <a href=#cache-host>cache host</a> associated with an + <a href=#application-cache>application cache</a> in <var title="">cache + group</var>, <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple + event</a> called <code title=event-checking>checking</code> + at the <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#cache-host>cache + host</a>. The default action of these events should be the display of some sort of user interface indicating to the user that the user agent is checking for the availability of updates.</li> @@ -38151,11 +38162,11 @@ </li> <li><p>If this is a <a href=#concept-appcache-cache title=concept-appcache-cache>cache - attempt</a>, then this algorithm was invoked with a - <a href=#browsing-context>browsing context</a>; <a href=#queue-a-task>queue a task</a> to - <a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-checking>checking</code> at the - <code><a href=#applicationcache>ApplicationCache</a></code> singleton of that <a href=#browsing-context>browsing - context</a>.</li> + attempt</a>, then this algorithm was invoked with a <a href=#cache-host>cache + host</a>; <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple + event</a> called <code title=event-checking>checking</code> at + the <code><a href=#applicationcache>ApplicationCache</a></code> singleton of that <a href=#cache-host>cache + host</a>.</li> <li> @@ -38182,12 +38193,12 @@ than the processing of <code>Document</code> objects already associated with an <a href=#application-cache>application cache</a> in the <var title="">cache group</var>.</li> - <li><p>For each <a href=#browsing-context>browsing context</a> whose <a href=#active-document>active - document</a> is associated with an <a href=#application-cache>application - cache</a> in <var title="">cache group</var>, <a href=#queue-a-task>queue a - task</a> to <a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-obsolete>obsolete</code> at the - <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#browsing-context>browsing - context</a>. The default action of these events should be the + <li><p>For each <a href=#cache-host>cache host</a> associated with an + <a href=#application-cache>application cache</a> in <var title="">cache + group</var>, <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple + event</a> called <code title=event-obsolete>obsolete</code> + at the <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#cache-host>cache + host</a>. The default action of these events should be the display of some sort of user interface indicating to the user that the application is no longer available for offline use.</li> @@ -38196,12 +38207,12 @@ entries</a>, <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-error><a href=#event-error>error</a></code> (not <code title=event-obsolete>obsolete</code>!) at the - <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#browsing-context>browsing - context</a> whose <a href=#active-document>active document</a> is the - <code>Document</code> for this entry, if there still is one. The - default action of this event should be the display of some sort - of user interface indicating to the user that the user agent - failed to save the application for offline use.</li> + <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#cache-host>cache + host</a> the <code>Document</code> for this entry, if there + still is one. The default action of this event should be the + display of some sort of user interface indicating to the user + that the user agent failed to save the application for offline + use.</li> <li><p>If <var title="">cache group</var> has an <a href=#application-cache>application cache</a> whose <a href=#concept-appcache-completeness title=concept-appcache-completeness>completeness flag</a> is @@ -38251,12 +38262,12 @@ <p>If the download failed (e.g. the connection times out, or the user cancels the download), then <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-error><a href=#event-error>error</a></code> at the - <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#browsing-context>browsing - context</a> whose <a href=#active-document>active document</a> is the - <code>Document</code> for this entry, if there still is one. The - default action of this event should be the display of some sort - of user interface indicating to the user that the user agent - failed to save the application for offline use.</p> + <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#cache-host>cache + host</a> the <code>Document</code> for this entry, if there + still is one. The default action of this event should be the + display of some sort of user interface indicating to the user + that the user agent failed to save the application for offline + use.</p> <p>Otherwise, associate the <code>Document</code> for this entry with <var title="">cache</var>; store the resource for this @@ -38269,12 +38280,12 @@ </li> - <li><p>For each <a href=#browsing-context>browsing context</a> whose <a href=#active-document>active - document</a> is associated with an <a href=#application-cache>application - cache</a> in <var title="">cache group</var>, <a href=#queue-a-task>queue a - task</a> to <a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-noupdate>noupdate</code> at the - <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#browsing-context>browsing - context</a>. The default action of these events should be the + <li><p>For each <a href=#cache-host>cache host</a> associated with an + <a href=#application-cache>application cache</a> in <var title="">cache + group</var>, <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple + event</a> called <code title=event-noupdate>noupdate</code> + at the <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#cache-host>cache + host</a>. The default action of these events should be the display of some sort of user interface indicating to the user that the application is up to date.</li> @@ -38302,12 +38313,12 @@ <li><p>Set the <a href=#concept-appcache-status title=concept-appcache-status>status</a> of <var title="">cache group</var> to <i>downloading</i>.</li> - <li><p>For each <a href=#browsing-context>browsing context</a> whose <a href=#active-document>active - document</a> is associated with an <a href=#application-cache>application - cache</a> in <var title="">cache group</var>, <a href=#queue-a-task>queue a - task</a> to <a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-downloading>downloading</code> at the - <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#browsing-context>browsing - context</a>. The default action of these events should be the + <li><p>For each <a href=#cache-host>cache host</a> associated with an + <a href=#application-cache>application cache</a> in <var title="">cache group</var>, + <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> + called <code title=event-downloading>downloading</code> at the + <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#cache-host>cache + host</a>. The default action of these events should be the display of some sort of user interface indicating to the user that a new version is being downloaded.</li> @@ -38352,12 +38363,12 @@ </li> - <li><p>For each <a href=#browsing-context>browsing context</a> whose <a href=#active-document>active - document</a> is associated with an <a href=#application-cache>application - cache</a> in <var title="">cache group</var>, <a href=#queue-a-task>queue a - task</a> to <a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-progress><a href=#event-progress>progress</a></code> at the - <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#browsing-context>browsing - context</a>. The default action of these events should be the + <li><p>For each <a href=#cache-host>cache host</a> associated with an + <a href=#application-cache>application cache</a> in <var title="">cache + group</var>, <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple + event</a> called <code title=event-progress><a href=#event-progress>progress</a></code> + at the <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#cache-host>cache + host</a>. The default action of these events should be the display of some sort of user interface indicating to the user that a file is being downloaded in preparation for updating the application.</li> <!-- XXX need to include progress @@ -38490,10 +38501,9 @@ <ol><li><p>Unassociate the <code>Document</code> for this entry from <var title="">new cache</var>.</li> - <li><p><a href=#queue-a-task>Queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> - called <code title=event-error><a href=#event-error>error</a></code> at the - <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#browsing-context>browsing - context</a> whose <a href=#active-document>active document</a> is the + <li><p><a href=#queue-a-task>Queue a task</a> to <a href=#fire-a-simple-event>fire a simple + event</a> called <code title=event-error><a href=#event-error>error</a></code> at the + <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <code>Document</code> for this entry, if there still is one. The default action of this event should be the display of some sort of user interface indicating to the user that the user agent @@ -38557,26 +38567,24 @@ <li> <p>If this is a <a href=#concept-appcache-cache title=concept-appcache-cache>cache - attempt</a>, then for each <a href=#browsing-context>browsing context</a> - whose <a href=#active-document>active document</a> is associated with an - <a href=#application-cache>application cache</a> in <var title="">cache + attempt</a>, then for each <a href=#cache-host>cache host</a> associated + with an <a href=#application-cache>application cache</a> in <var title="">cache group</var>, <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-cached>cached</code> at - the <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the - <a href=#browsing-context>browsing context</a>. The default action of these - events should be the display of some sort of user interface - indicating to the user that the application has been cached and - that they can now use it offline.</p> + the <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#cache-host>cache + host</a>. The default action of these events should be the + display of some sort of user interface indicating to the user that + the application has been cached and that they can now use it + offline.</p> - <p>Otherwise, it is an <a href=#concept-appcache-upgrade title=concept-appcache-upgrade>upgrade attempt</a>. For - each <a href=#browsing-context>browsing context</a> whose <a href=#active-document>active - document</a> is associated with an <a href=#application-cache>application + <p>Otherwise, it is an <a href=#concept-appcache-upgrade title=concept-appcache-upgrade>upgrade attempt</a>. For each + <a href=#cache-host>cache host</a> associated with an <a href=#application-cache>application cache</a> in <var title="">cache group</var>, <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-updateready>updateready</code> at the - <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#browsing-context>browsing - context</a>. The default action of these events should be the - display of some sort of user interface indicating to the user - that a new version is available and that they can activate it by + <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#cache-host>cache + host</a>. The default action of these events should be the + display of some sort of user interface indicating to the user that + a new version is available and that they can activate it by reloading the page.</p> </li> @@ -38604,8 +38612,7 @@ <li><p><a href=#queue-a-task>Queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-error><a href=#event-error>error</a></code> at the - <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#browsing-context>browsing - context</a> whose <a href=#active-document>active document</a> is the + <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <code>Document</code> for this entry, if there still is one. The default action of these events should be the display of some sort of user interface indicating to the user that the user agent @@ -38613,12 +38620,12 @@ </ol></li> - <li><p>For each <a href=#browsing-context>browsing context</a> whose <a href=#active-document>active - document</a> is still associated with an <a href=#application-cache>application - cache</a> in <var title="">cache group</var>, <a href=#queue-a-task>queue a - task</a> to <a href=#fire-a-simple-event>fire a simple event</a> called <code title=event-error><a href=#event-error>error</a></code> at the - <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#browsing-context>browsing - context</a>. The default action of these events should be the + <li><p>For each <a href=#cache-host>cache host</a> still associated with an + <a href=#application-cache>application cache</a> in <var title="">cache group</var>, + <a href=#queue-a-task>queue a task</a> to <a href=#fire-a-simple-event>fire a simple event</a> + called <code title=event-error><a href=#event-error>error</a></code> at the + <code><a href=#applicationcache>ApplicationCache</a></code> singleton of the <a href=#cache-host>cache + host</a>. The default action of these events should be the display of some sort of user interface indicating to the user that the user agent failed to save the application for offline use.</li> @@ -38634,7 +38641,8 @@ <li><p>If appropriate, remove any user interface indicating that an update for this cache is in progress.</li> - <li><p>Let the <a href=#concept-appcache-status title=concept-appcache-status>status</a> of <var title="">cache group</var> be <i>idle</i>.</li> + <li><p>Let the <a href=#concept-appcache-status title=concept-appcache-status>status</a> + of <var title="">cache group</var> be <i>idle</i>.</li> <li><p>If this was a <a href=#concept-appcache-cache title=concept-appcache-cache>cache attempt</a>, discard <var title="">cache group</var> @@ -38649,9 +38657,9 @@ <hr><p>User agents may invoke the <a href=#application-cache-update-process>application cache update process</a>, in the background, for any <a href=#application-cache>application - cache</a>, at any time (with no <a href=#browsing-context>browsing - context</a>). This allows user agents to keep caches primed and - to update caches even before the user visits a site.</p> + cache</a>, at any time (with no <a href=#cache-host>cache host</a>). This + allows user agents to keep caches primed and to update caches even + before the user visits a site.</p> @@ -38769,13 +38777,13 @@ </dl><h5 id=changesToNetworkingModel><span class=secno>5.8.6.1 </span>Changes to the networking model</h5> - <p>When a <a href=#browsing-context>browsing context</a>'s <a href=#active-document>active - document</a> is associated with an <a href=#application-cache>application cache</a> - whose <a href=#concept-appcache-completeness title=concept-appcache-completeness>completeness - flag</a> is <i>complete</i>, any and all loads for resources in - that <a href=#browsing-context>browsing context</a> other than those for <a href=#child-browsing-context title="child browsing context">child browsing contexts</a> must - go through the following steps instead of immediately invoking the - mechanisms appropriate to that resource's scheme:</p> + <p>When a <a href=#cache-host>cache host</a> is associated with an + <a href=#application-cache>application cache</a> whose <a href=#concept-appcache-completeness title=concept-appcache-completeness>completeness flag</a> is + <i>complete</i>, any and all loads for resources related to that + <a href=#cache-host>cache host</a> other than those for <a href=#child-browsing-context title="child + browsing context">child browsing contexts</a> must go through the + following steps instead of immediately invoking the mechanisms + appropriate to that resource's scheme:</p> <ol><li><p>If the resource is not to be fetched using the HTTP GET mechanism <a href=#concept-http-equivalent-get title=concept-http-equivalent-get>or @@ -38847,14 +38855,28 @@ attribute <a href=#function>Function</a> <a href=#handler-appcache-oncached title=handler-appcache-oncached>oncached</a>; attribute <a href=#function>Function</a> <a href=#handler-appcache-onobsolete title=handler-appcache-onobsolete>onobsolete</a>; -};</pre><dl class=domintro><dt><var title="">window</var> . <code title=dom-applicationCache><a href=#dom-applicationcache>applicationCache</a></code> . <code title=dom-appcache-status><a href=#dom-appcache-status>status</a></code></dt> +};</pre><dl class=domintro><dt><var title="">cache</var> = <var title="">window</var> . <code title=dom-applicationCache><a href=#dom-applicationcache>applicationCache</a></code></dt> + <dd> + + <p>(In a window.) Returns the <code><a href=#applicationcache>ApplicationCache</a></code> object that applies to the <a href=#active-document>active document</a> of that <code><a href=#window>Window</a></code>.</p> + + </dd> + + <dt><var title="">cache</var> = <var title="">self</var> . <code title=dom-applicationCache><a href=#dom-applicationcache>applicationCache</a></code></dt> + <dd> + + <p>(In a shared worker.) Returns the <code><a href=#applicationcache>ApplicationCache</a></code> object that applies to the current shared worker.</p> + + </dd> + + <dt><var title="">cache</var> . <code title=dom-appcache-status><a href=#dom-appcache-status>status</a></code></dt> <dd> <p>Returns the current status of the application cache, as given by the constants defined below.</p> </dd> - <dt><var title="">window</var> . <code title=dom-applicationCache><a href=#dom-applicationcache>applicationCache</a></code> . <code title=dom-appcache-update><a href=#dom-appcache-update>update</a></code>()</dt> + <dt><var title="">cache</var> . <code title=dom-appcache-update><a href=#dom-appcache-update>update</a></code>()</dt> <dd> <p>Invokes the application cache update process.</p> @@ -38863,7 +38885,7 @@ </dd> - <dt><var title="">window</var> . <code title=dom-applicationCache><a href=#dom-applicationcache>applicationCache</a></code> . <code title=dom-appcache-swapCache><a href=#dom-appcache-swapcache>swapCache</a></code>()</dt> + <dt><var title="">cache</var> . <code title=dom-appcache-swapCache><a href=#dom-appcache-swapcache>swapCache</a></code>()</dt> <dd> <p>Switches to the most recent application cache, if there is a newer one. If there isn't, throws an <code><a href=#invalid_access_err>INVALID_ACCESS_ERR</a></code> exception.</p> @@ -38875,108 +38897,103 @@ <p>Objects implementing the <code><a href=#applicationcache>ApplicationCache</a></code> interface must also implement the <code>EventTarget</code> interface.</p> - <p>There is a one-to-one mapping from <code><a href=#window>Window</a></code> objects to - <code><a href=#applicationcache>ApplicationCache</a></code> objects. The <dfn id=dom-applicationcache title=dom-applicationCache><code>applicationCache</code></dfn> + <p>There is a one-to-one mapping from <a href=#cache-host title="cache host">cache + hosts</a> to <code><a href=#applicationcache>ApplicationCache</a></code> objects. The <dfn id=dom-applicationcache title=dom-applicationCache><code>applicationCache</code></dfn> attribute on <code><a href=#window>Window</a></code> objects must return the <code><a href=#applicationcache>ApplicationCache</a></code> object associated with the - <code><a href=#window>Window</a></code> object.</p> - - <p>An <code><a href=#applicationcache>ApplicationCache</a></code> object might be associated with - an <a href=#application-cache>application cache</a>. When the <code>Document</code> - object that the <code><a href=#applicationcache>ApplicationCache</a></code> object maps to is - associated with an application cache, then that is the application - cache with which the <code><a href=#applicationcache>ApplicationCache</a></code> object is - associated.</p> + <code><a href=#window>Window</a></code> object's <a href=#active-document>active document</a>. The <dfn id=dom-worker-applicationcache title=dom-worker-applicationCache><code>applicationCache</code></dfn> + attribute on <code>SharedWorkerGlobalScope</code> objects must + return the <code><a href=#applicationcache>ApplicationCache</a></code> object associated with the + worker.</p> <p>The <dfn id=dom-appcache-status title=dom-appcache-status><code>status</code></dfn> attribute, on getting, must return the current state of the - <a href=#application-cache>application cache</a> <code><a href=#applicationcache>ApplicationCache</a></code> object - is associated with, if any. This must be the appropriate value from - the following list:</p> + <a href=#application-cache>application cache</a> that the + <code><a href=#applicationcache>ApplicationCache</a></code> object's <a href=#cache-host>cache host</a> is + associated with, if any. This must be the appropriate value from the + following list:</p> </div><dl><dt><dfn id=dom-appcache-uncached title=dom-appcache-UNCACHED><code>UNCACHED</code></dfn> (numeric value 0)</dt> - <dd><p>The <code><a href=#applicationcache>ApplicationCache</a></code> object is not associated - with an <a href=#application-cache>application cache</a> at this time.</dd> + <dd><p>The <code><a href=#applicationcache>ApplicationCache</a></code> object's <a href=#cache-host>cache + host</a> is not associated with an <a href=#application-cache>application + cache</a> at this time.</dd> <dt><dfn id=dom-appcache-idle title=dom-appcache-IDLE><code>IDLE</code></dfn> (numeric value 1)</dt> - <dd><p>The <code><a href=#applicationcache>ApplicationCache</a></code> object is associated with - an <a href=#application-cache>application cache</a> whose <a href=#application-cache-group>application cache - group</a>'s <a href=#concept-appcache-status title=concept-appcache-status>update - status</a> is <i>idle</i>, and that <a href=#application-cache>application - cache</a> is the <a href=#concept-appcache-newer title=concept-appcache-newer>newest</a> cache in its + <dd><p>The <code><a href=#applicationcache>ApplicationCache</a></code> object's <a href=#cache-host>cache + host</a> is associated with an <a href=#application-cache>application cache</a> + whose <a href=#application-cache-group>application cache group</a>'s <a href=#concept-appcache-status title=concept-appcache-status>update status</a> is + <i>idle</i>, and that <a href=#application-cache>application cache</a> is the <a href=#concept-appcache-newer title=concept-appcache-newer>newest</a> cache in its <a href=#application-cache-group>application cache group</a>, and the <a href=#application-cache-group>application cache group</a> is not marked as <a href=#concept-appcache-obsolete title=concept-appcache-obsolete>obsolete</a>.</dd> <dt><dfn id=dom-appcache-checking title=dom-appcache-CHECKING><code>CHECKING</code></dfn> (numeric value 2)</dt> - <dd><p>The <code><a href=#applicationcache>ApplicationCache</a></code> object is associated with - an <a href=#application-cache>application cache</a> whose <a href=#application-cache-group>application cache - group</a>'s <a href=#concept-appcache-status title=concept-appcache-status>update - status</a> is <i>checking</i>.</dd> + <dd><p>The <code><a href=#applicationcache>ApplicationCache</a></code> object's <a href=#cache-host>cache + host</a> is associated with an <a href=#application-cache>application cache</a> + whose <a href=#application-cache-group>application cache group</a>'s <a href=#concept-appcache-status title=concept-appcache-status>update status</a> is + <i>checking</i>.</dd> <dt><dfn id=dom-appcache-downloading title=dom-appcache-DOWNLOADING><code>DOWNLOADING</code></dfn> (numeric value 3)</dt> - <dd><p>The <code><a href=#applicationcache>ApplicationCache</a></code> object is associated with - an <a href=#application-cache>application cache</a> whose <a href=#application-cache-group>application cache - group</a>'s <a href=#concept-appcache-status title=concept-appcache-status>update - status</a> is <i>downloading</i>.</dd> + <dd><p>The <code><a href=#applicationcache>ApplicationCache</a></code> object's <a href=#cache-host>cache + host</a> is associated with an <a href=#application-cache>application cache</a> + whose <a href=#application-cache-group>application cache group</a>'s <a href=#concept-appcache-status title=concept-appcache-status>update status</a> is + <i>downloading</i>.</dd> <dt><dfn id=dom-appcache-updateready title=dom-appcache-UPDATEREADY><code>UPDATEREADY</code></dfn> (numeric value 4)</dt> - <dd><p>The <code><a href=#applicationcache>ApplicationCache</a></code> object is associated with - an <a href=#application-cache>application cache</a> whose <a href=#application-cache-group>application cache - group</a>'s <a href=#concept-appcache-status title=concept-appcache-status>update - status</a> is <i>idle</i>, and whose <a href=#application-cache-group>application cache - group</a> is not marked as <a href=#concept-appcache-obsolete title=concept-appcache-obsolete>obsolete</a>, but that - <a href=#application-cache>application cache</a> is <em>not</em> the <a href=#concept-appcache-newer title=concept-appcache-newer>newest</a> cache in its + <dd><p>The <code><a href=#applicationcache>ApplicationCache</a></code> object's <a href=#cache-host>cache + host</a> is associated with an <a href=#application-cache>application cache</a> + whose <a href=#application-cache-group>application cache group</a>'s <a href=#concept-appcache-status title=concept-appcache-status>update status</a> is + <i>idle</i>, and whose <a href=#application-cache-group>application cache group</a> is not + marked as <a href=#concept-appcache-obsolete title=concept-appcache-obsolete>obsolete</a>, + but that <a href=#application-cache>application cache</a> is <em>not</em> the <a href=#concept-appcache-newer title=concept-appcache-newer>newest</a> cache in its group.</dd> <dt><dfn id=dom-appcache-obsolete title=dom-appcache-OBSOLETE><code>OBSOLETE</code></dfn> (numeric value 5)</dt> - <dd><p>The <code><a href=#applicationcache>ApplicationCache</a></code> object is associated with - an <a href=#application-cache>application cache</a> whose <a href=#application-cache-group>application cache - group</a> is marked as <a href=#concept-appcache-obsolete title=concept-appcache-obsolete>obsolete</a>.</dd> + <dd><p>The <code><a href=#applicationcache>ApplicationCache</a></code> object's <a href=#cache-host>cache + host</a> is associated with an <a href=#application-cache>application cache</a> + whose <a href=#application-cache-group>application cache group</a> is marked as <a href=#concept-appcache-obsolete title=concept-appcache-obsolete>obsolete</a>.</dd> </dl><div class=impl> <hr><p>If the <dfn id=dom-appcache-update title=dom-appcache-update><code>update()</code></dfn> method is invoked, the user agent must invoke the <a href=#application-cache-update-process>application cache update process</a>, in the background, for the <a href=#application-cache>application - cache</a> with which the <code><a href=#applicationcache>ApplicationCache</a></code> object is - associated, but with no <a href=#browsing-context>browsing context</a>. If there is - no such application cache, or if it is marked as <a href=#concept-appcache-obsolete title=concept-appcache-obsolete>obsolete</a>, then the method + cache</a> with which the <code><a href=#applicationcache>ApplicationCache</a></code> object's + <a href=#cache-host>cache host</a> is associated, but without giving that + <a href=#cache-host>cache host</a> to the algorithm. If there is no such + <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-swapcache title=dom-appcache-swapCache><code>swapCache()</code></dfn> method is invoked, the user agent must run the following steps: - <ol><li><p>Let <var title="">document</var> be the - <code>Document</code> with which the <code><a href=#applicationcache>ApplicationCache</a></code> - object is associated.</li> - - <li><p>Check that <var title="">document</var> is associated with - an <a href=#application-cache>application cache</a>. If it is not, then raise an + <ol><li><p>Check that <code><a href=#applicationcache>ApplicationCache</a></code> object's + <a href=#cache-host>cache host</a> is associated with an <a href=#application-cache>application + cache</a>. If it is not, then raise an <code><a href=#invalid_state_err>INVALID_STATE_ERR</a></code> exception and abort these steps.</li> <li><p>Let <var title="">cache</var> be the <a href=#application-cache>application - cache</a> with which the <code><a href=#applicationcache>ApplicationCache</a></code> object is - associated. (By definition, this is the same as the one that was - found in the previous step.)</li> + cache</a> with which the <code><a href=#applicationcache>ApplicationCache</a></code> object's + <a href=#cache-host>cache host</a> is associated. (By definition, this is the + same as the one that was found in the previous step.)</li> <li><p>If <var title="">cache</var>'s <a href=#application-cache-group>application cache group</a> is marked as <a href=#concept-appcache-obsolete title=concept-appcache-obsolete>obsolete</a>, then unassociate - <var title="">document</var> from <var title="">cache</var> and - abort these steps. (Resources will now load from the network - instead of the cache.)</li> + the <code><a href=#applicationcache>ApplicationCache</a></code> object's <a href=#cache-host>cache host</a> + from <var title="">cache</var> and abort these steps. (Resources + will now load from the network instead of the cache.)</li> <li><p>Check that there is an application cache in the same <a href=#application-cache-group>application cache group</a> as <var title="">cache</var> @@ -38990,7 +39007,9 @@ <var title="">cache</var> whose <a href=#concept-appcache-completeness title=concept-appcache-completeness>completeness flag</a> is <i>complete</i>.</li> - <li><p>Unassociate <var title="">document</var> from <var title="">cache</var> and instead associate it with <var title="">new cache</var>.</li> + <li><p>Unassociate the <code><a href=#applicationcache>ApplicationCache</a></code> object's + <a href=#cache-host>cache host</a> from <var title="">cache</var> and instead + associate it with <var title="">new cache</var>.</li> </ol><p>The following are the <a href=#event-handler-attributes-0>event handler attributes</a> that must be supported, as DOM attributes, by all objects implementing
Received on Saturday, 28 March 2009 00:36:56 UTC