Cache.add() | Web API

在此页

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

add() 方法在 缓存 interface takes a URL, retrieves it, and adds the resulting response object to the given cache. add() method is functionally equivalent to the following:

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

For more complex operations, you'll need to use Cache.put() 直接。

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

句法

cache.add(request).then(function() {
  // request has been added to the cache
});

参数

request: The request you want to add to the cache. This can be a Request object or a URL.

返回值

A Promise that resolves with undefined .

异常

异常 Happens when

异常	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.)


										TypeError

The URL scheme is not


											http


											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 calls waitUntil() to handle the install process for the app. This consists of calling CacheStorage.open to create a new cache, then using Cache.add to add an asset to it.

this.addEventListener('install', function(event) {
  event.waitUntil(
    caches.open('v1').then(function(cache) {
      return cache.add('/sw-test/index.html');
    })
  );
});

规范

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

图例

完整支持
不支持
实验。期望将来行为有所改变。

另请参阅

元数据

最后修改： Jun 23, 2020

服务工作者 API
缓存
方法
1. add()
2. addAll()
3. delete()
4. keys()
5. match()
6. matchAll()
7. put()
Related pages for Service Workers API

在此页

句法

参数

返回值

异常

范例

规范

浏览器兼容性

图例

另请参阅

相关话题