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

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

CacheStorage 接口(可适用于全局性caches) 的 match() 方法检查给定的Request 对象或url字符串是否是一个已存储的 Response 对象的key. 这个方法针对 Response 返回一个 Promise ,如果没有匹配则返回 undefined

cache对象按创建顺序查询。

提示: caches.match() 是一个便捷方法。其作用等同于在每个缓存上调用 cache.match() 方法 (按照caches.keys()返回的顺序) 直到返回Response 对象。

语法

caches.match(request, options).then(function(response) {
  // Do something with the response
});

参数

request
想要匹配的 Request。这个参数可以是 Request 对象或 URL 字符串。
options 可选
这个对象中的属性控制在匹配操作中如何进行匹配选择。可选择参数如下:
  • ignoreSearch: Boolean值, 指定匹配过程是否应该忽略url中查询参数。举个例子,如果该参数设置为true, 那么 ?value=bar 作为 http://foo.com/?value=bar 中的查询参数将会在匹配过程中被忽略。该参数默认 false
  • ignoreMethodBoolean 值,当被设置为 true 时,将会阻止在匹配操作中对 Request请求的 http 方式的验证 (通常只允许 GETHEAD 两种请求方式)。该参数默认为 false.
  • ignoreVaryBoolean 值,当该字段被设置为 true, 告知在匹配操作中忽略对VARY头信息的匹配。换句话说,当请求 URL 匹配上,你将获取匹配的 Response 对象,无论请求的 VARY  头存在或者没有。该参数默认为 false.
  • cacheNameDOMString 值, 表示所要搜索的缓存名称。

返回值

返回resolve为匹配 ResponsePromise 对象。如果没有与指定request相匹配response,promise将使用 undefined resolve.

例子

此示例来自于MDN sw-test example (请参阅 sw-test running live)。这里,等待 FetchEvent 事件触发。我们构建自定义响应,像这样:

  1. 使用 CacheStorage.match() 检查 CacheStorage 中是否存在匹配请求,如果存在,则使用它。
  2. 如果没有,使用  open() 打开 v1 cache,使用 Cache.put()  将默认网络请求放入 cache 中,并只用 return response.clone() 返回默认网络请求的克隆副本。最后一个是必须的,因为 put() 使用响应主体。
  3. 如果此操作失败(例如,因为网络已关闭),则返回备用响应。
caches.match(event.request).then(function(response) {
  return response || fetch(event.request).then(function(r) {
    caches.open('v1').then(function(cache) {
      cache.put(event.request, r);
    });
    return r.clone();
  });
}).catch(function() {
  return caches.match('/sw-test/gallery/myLittleVader.jpg');
});

规范

Specification Status Comment
Service Workers
CacheStorage
Working Draft Initial definition.

浏览器兼容性

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
Basic support
Experimental
Chrome Full support 54
Full support 54
Partial support 40
Notes
Notes The options parameter only supports ignoreSearch, and cacheName.
Edge Full support YesFirefox Full support 44
Notes
Full support 44
Notes
Notes Service workers (and Push) have been disabled in the Firefox 45 & 52 Extended Support Releases (ESR.)
IE No support NoOpera Full support 41
Full support 41
Partial support 27
Notes
Notes The options parameter only supports ignoreSearch, and cacheName.
Safari Full support 11.1WebView Android Full support 54
Full support 54
Partial support 40
Notes
Notes The options parameter only supports ignoreSearch, and cacheName.
Chrome Android Full support 54
Full support 54
Partial support 40
Notes
Notes The options parameter only supports ignoreSearch, and cacheName.
Edge Mobile Full support YesFirefox Android Full support 44Opera Android Full support 41
Full support 41
Partial support 27
Notes
Notes The options parameter only supports ignoreSearch, and cacheName.
Safari iOS Full support YesSamsung Internet Android ?

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.

亦可参考

文档标签和贡献者

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