MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

这篇翻译不完整。请帮忙从英语翻译这篇文章

这是一个实验中的功能
此功能某些浏览器尚在开发中,请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订,所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

Cache接口的 add()方法接受一个URL,检索它并将返回的response对象添加到给定的cache。 add() 方法在功能上等同于以下代码:

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

对于更复杂的操作,您需要直接使用Cache.put()

注意: add() 将会覆盖之前存储在cache中与request匹配的任何key/value对。

注意: 初始 Cache 实现 (在 Blink 和 Gecko中) resolve Cache.add, Cache.addAll, 和 Cache.put promises 在response体被完全写入缓存后。更新后的规范版本表示一旦条目被记录到数据库,即使response体依旧在传输中,浏览器也可以resolve promise。

语法

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

参数

request
要添加到cache的request。它可以是一个 Request 对象,也可以是 URL。

返回值

A Promise that resolves with void.

Exceptions

Exception 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.)

示例

此代码块等待 InstallEvent 事件触发,然后运行 waitUntil 来处理该应用程序的安装过程。 包括调用 CacheStorage.open 来创建一个新的缓存,然后使用 Cache.add 来添加一个资源到该缓存。

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

规范

Specification Status Comment
Service Workers
Cache
Working Draft Initial definition.

浏览器兼容性

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Basic support 46.0 (Yes)[1] 未实现 24 未实现
Require HTTPS 46.0 (Yes)[1] ? ? ?
TypeError if request is not successful (Yes) 47.0 (47.0)[1] (Yes) (Yes) (Yes)
Feature Android Android Webview Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support 未实现 未实现 (Yes) ? 未实现 ? 未实现 46.0
Require HTTPS 未实现 未实现 (Yes) ? ? ? ? 46.0
TypeError if request is not successful (Yes) (Yes) (Yes) (Yes) (Yes) (Yes) (Yes) (Yes)

[1] Service workers (and Push) have been disabled in the Firefox 45 & 52 Extended Support Releases (ESR.)

参见

文档标签和贡献者

 此页面的贡献者: flyingsouthwind
 最后编辑者: flyingsouthwind,