Web/API/WindowOrWorkerGlobalScope/caches

This is an experimental technologyCheck the Browser compatibility table carefully before using this in production.

The caches read-only property of the WindowOrWorkerGlobalScope interface returns the CacheStorage object associated with the current context. This object enables functionality such as storing assets for offline use, and generating custom responses to requests.

Syntax

var myCacheStorage = self.caches; // or just caches

Value

A CacheStorage object.

Example

The following example shows how you'd use a cache in a service worker context to store assets offline.

this.addEventListener('install', function(event) {
  event.waitUntil(
    caches.open('v1').then(function(cache) {
      return cache.addAll([
        '/sw-test/',
        '/sw-test/index.html',
        '/sw-test/style.css',
        '/sw-test/app.js',
        '/sw-test/image-list.js',
        '/sw-test/star-wars-logo.jpg',
        '/sw-test/gallery/',
        '/sw-test/gallery/bountyHunters.jpg',
        '/sw-test/gallery/myLittleVader.jpg',
        '/sw-test/gallery/snowTroopers.jpg'
      ]);
    })
  );
});

Specifications

Specification	Status	Comment
Service WorkersThe definition of 'caches' in that specification.	Working Draft	Defined in a `WindowOrWorkerGlobalScope` partial in the newest spec.
Service Workers	Working Draft	Initial definition.

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`caches` Experimental'	Chrome Full support 40	Edge Full support ≤79	Firefox Full support 42 Full support 42 Full support 52 Notes' Notes' `caches` now defined on `WindowOrWorkerGlobalScope` mixin.	IE No support No	Opera ?	Safari No support No	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support 42 Full support 42 Full support 52 Notes' Notes' `caches` now defined on `WindowOrWorkerGlobalScope` mixin.	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes

Legend

Full support: Full support
No support: No support
Compatibility unknown: Compatibility unknown
Experimental. Expect behavior to change in the future.': Experimental. Expect behavior to change in the future.
See implementation notes.': See implementation notes.