[whatwg] Clarification on applicationCache events

Nicholas Zakas nzakas at yahoo-inc.com
Mon May 23 11:14:38 PDT 2011


The spec currently states this about the obsolete and error events on window.applicationCache (5.6.1.1):


 *   Obsolete - The manifest was found to have become a 404 or 410 page, so the application cache is being deleted.
 *   Error - The manifest was a 404 or 410 page, so the attempt to cache the application has been aborted.

Later on (5.6.4), the spec states about 404 or 410 manifest files:


 *   For each cache host associated with an application cache in cache group, create a task to fire a simple event named obsolete that is cancelable at the ApplicationCache singleton of the cache host, and append it to task list. The default action of these events must be, if the user agent shows caching progress, the display of some sort of user interface indicating to the user that the application is no longer available for offline use.
 *   For each entry in cache group's list of pending master entries, create a task to fire a simple event that is cancelable named error (not obsolete!) at the ApplicationCache singleton of the cache host the Document for this entry, if there still is one, and append it to task list. The default action of this event must be, if the user agent shows caching progress, the display of some sort of user interface indicating to the user that the user agent failed to save the application for offline use.

This seems to indicate that the obsolete event is always fired and the error event may optionally fire afterward. If that's correct, then I think the table in section 5.6.1.1 needs some updating to better reflect the expected behavior.

-N


More information about the whatwg mailing list