在此页

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

put() 方法在 缓存 interface allows key/value pairs to be added to the current 缓存 对象。

Often, you will just want to fetch() one or more requests, then add the result straight to your cache. In such cases you are better off using Cache.add() / Cache.addAll() , as they are shorthand functions for one or more of these operations.

fetch(url).then(function(response) {
  if (!response.ok) {
    throw new TypeError('Bad response status');
  }
  return cache.put(url, response);
})
					

注意 : put() will overwrite any key/value pair previously stored in the cache that matches the request.

注意 : Cache.add / Cache.addAll do not cache responses with Response.status values that are not in the 200 range, whereas Cache.put lets you store any request/response pair. As a result, Cache.add / Cache.addAll can't be used to store opaque responses, whereas Cache.put can.

句法

cache.put(request, response).then(function() {
  // request/response pair has been added to the cache
});
					

参数

request

Request object or URL that you want to add to the cache.

response

响应 you want to match up to the request.

返回值

A Promise that resolves with undefined .

注意 : The promise will reject with a TypeError if the URL scheme is not http or https .

范例

This example is from the MDN sw-test example (见 sw-test running live ). Here we wait for a FetchEvent to fire. We construct a custom response like so:

1. Check whether a match for the request is found in the CacheStorage 使用 CacheStorage.match() . If so, serve that.
2. If not, open the v1 cache using open() , put the default network request in the cache using Cache.put() and return a clone of the default network request using return response.clone() . Clone is needed because put() consumes the response body.
3. If this fails (e.g., because the network is down), return a fallback response.

var response;
var cachedResponse = caches.match(event.request).catch(function() {
  return fetch(event.request);
}).then(function(r) {
  response = r;
  caches.open('v1').then(function(cache) {
    cache.put(event.request, response);
  });
  return response.clone();
}).catch(function() {
  return caches.match('/sw-test/gallery/myLittleVader.jpg');
});
					

规范

规范	状态	注释
服务工作者 The definition of 'Cache: put' 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
put	Chrome 43 43 Requires HTTPS from version 46.	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 30 30 Requires HTTPS from version 33.	Safari 11	WebView Android 43 43 Requires HTTPS from version 46.	Chrome Android 43 43 Requires HTTPS from version 46.	Firefox Android 39	Opera Android 30 30 Requires HTTPS from version 33.	Safari iOS 11	Samsung Internet Android 4.0 4.0 Requires HTTPS from Samsung Internet 5.0.

图例

完整支持

完整支持

不支持

不支持

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

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

见实现注意事项。

另请参阅

• 使用服务工作者
• 缓存
• 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