在此页

• 句法
• 范例
• 浏览器兼容性
• 另请参阅
• 相关话题

addAll() 方法在 缓存 interface takes an array of URLs, retrieves them, and adds the resulting response objects to the given cache. The request objects created during retrieval become keys to the stored response operations.

注意 : addAll() will overwrite any key/value pairs previously stored in the cache that match the request, but will fail if a resulting put() operation would overwrite a previous cache entry stored by the same addAll() 方法。

句法

cache.addAll(requests[]).then(function() {
  // requests have been added to the cache
});
					

参数

requests

An array of string URLs that you want to be fetched and added to the cache. You can specify the Request object instead of the URL.

返回值

A Promise that resolves with undefined .

异常

异常	Happens when
TypeError	The URL scheme is not http or https . The Response status is not in the 200 range (i.e., not a successful response.) This occurs if the request does not return successfully, but also if the request is a cross-origin no-cors request (in which case the reported status is always 0.)

范例

This code block waits for an InstallEvent to fire, then runs waitUntil() to handle the install process for the app. This consists of calling CacheStorage.open to create a new cache, then using addAll() to add a series of assets to it.

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'
      ]);
    })
  );
});
					

规范

规范	状态	注释
服务工作者 The definition of 'Cache: addAll' in that specification.	工作草案	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
addAll	Chrome 46 注意事项 46 注意事项 Requires HTTPS.	Edge 16	Firefox 39 注意事项 39 注意事项 Extended Support Releases (ESR) before Firefox 78 ESR do not support service workers and the Push API.	IE 不支持 No	Opera 33 注意事项 33 注意事项 Requires HTTPS.	Safari 11	WebView Android 46 注意事项 46 注意事项 Requires HTTPS.	Chrome Android 46 注意事项 46 注意事项 Requires HTTPS.	Firefox Android 39	Opera Android 33 注意事项 33 注意事项 Requires HTTPS.	Safari iOS 11	Samsung Internet Android 5.0 注意事项 5.0 注意事项 Requires HTTPS.

图例

完整支持

完整支持

不支持

不支持

实验。期望将来行为有所改变。

实验。期望将来行为有所改变。

见实现注意事项。

另请参阅

• 使用服务工作者
• 缓存
• WorkerGlobalScope.caches

元数据

• 最后修改： Jun 23, 2020

相关话题

1. 服务工作者 API
2. 缓存
3. 方法

   1. add()
   2. addAll()
   3. delete()
   4. keys()
   5. match()
   6. matchAll()
   7. put()
4. Related pages for Service Workers API

   1. CacheStorage
   2. Client
   3. Clients
   4. ExtendableEvent
   5. FetchEvent
   6. InstallEvent
   7. Navigator.serviceWorker
   8. NotificationEvent
   9. PeriodicSyncEvent
   10. PeriodicSyncManager
   11. PeriodicSyncRegistration
   12. ServiceWorker
   13. ServiceWorkerContainer
   14. ServiceWorkerGlobalScope
   15. ServiceWorkerRegistration
   16. SyncEvent
   17. SyncManager
   18. SyncRegistration
   19. WindowClient