The nsIDOMOfflineResourceList
interface provides access to the application cache that allows web content's resources to be cached locally for use while offline. It includes methods for adding resources to and removing resources from the cache, as well as for enumerating the dynamically managed resource list.
Inherits from: nsISupports
Method overview
void mozAdd(in DOMString uri); |
boolean mozHasItem(in DOMString uri); |
DOMString mozItem(in unsigned long index); |
void mozRemove(in DOMString uri); |
void swapCache(); |
void update(); |
Attributes
Attribute | Type | Description |
mozItems | nsIDOMOfflineResourceList | The list of dynamically-managed entries in the offline resource list. Read only. |
mozLength | unsigned long | The number of entries in the dynamically managed offline resource list. Read only. |
onchecking | nsIDOMEventListener | An event listener to be called when fetching the application cache manifest and checking for updates. |
onerror | nsIDOMEventListener | An event listener to be called when an error occurs during the caching process. |
onnoupdate | nsIDOMEventListener | An event listener to be called when there is no update to download. |
ondownloading | nsIDOMEventListener | An event listener to be called when resources are being downloaded into the cache. |
onprogress | nsIDOMEventListener | An event listener to be called periodically throughout the download process. |
onupdateready | nsIDOMEventListener | An event listener to be called when a resource update is ready; this event is not currently used since versioned application caches aren't supported yet. |
oncached | nsIDOMEventListener | An event listener to be called when caching is complete. |
status | unsigned short | One of the Application cache state constants indicating the status of the application cache. |
Constants
Application cache state constants
Constant | Value | Description |
UNCACHED | 0 | The object isn't associated with an application cache. |
IDLE | 1 | The application cache is not in the process of being updated. |
CHECKING | 2 | The application cache manifest is being fetched and checked for updates. |
DOWNLOADING | 3 | Resources are being downloaded to be added to the cache. |
UPDATEREADY | 4 | There is a new version of the application cache available. |
OBSOLETE | 5 | The application cache group is now obsolete. |
Methods
mozAdd()
Adds an item to the dynamically managed entries. The resource will be fetched and added to the application cache.
void mozAdd( in DOMString uri );
Parameters
uri
- The URI of the resource to add to the list.
mozHasItem
Returns a Boolean value indicating whether or not the specified URI represents a resource that's in the application cache's list.
mozItems
attribute instead.void mozHasItem( in DOMString uri );
Parameters
uri
- The URI of the resource to check.
Return value
true
if the resource is in the list, otherwise false
.
mozItem
Returns the URI of the item at the specific offset into the list of cached resources.
items
attribute.DOMString mozItem( in unsigned long index );
Parameters
index
- The index of the cached item whose URI should be returned.
Return value
An DOMString
containing the URI of the specified resource.
mozRemove()
Removes an item from the list of dynamically managed entries. If this was the last reference to the given URI in the application cache, the cache entry is removed.
void mozRemove( in DOMString uri );
Parameters
uri
- The URI of the item to remove from the list.
swapCache()
Swaps in the newest version of the application cache. The newest version of resources are updated on first refresh. This means already loaded resources should only update after a page refresh.
void swapCache();
Parameters
None.
update()
Begins the application cache update process. This will check for a new cache manifest but will not tell the browser to use the updated cache.
void update();
Parameters
None.