--- title: FetchEvent.respondWith() slug: Web/API/FetchEvent/respondWith translation_of: Web/API/FetchEvent/respondWith ---

{{APIRef("Service Workers API")}}{{SeeCompatTable}}

{{domxref("FetchEvent")}} 接口的 respondWith() 方法旨在包裹代码，这些代码为来自受控页面的request生成自定义的response。这些代码通过返回一个 {{domxref("Response")}} 、 network error 或者 Fetch的方式resolve。

有关跨域内容污染的渲染端安全检测与 {{domxref("Response")}} 体的透明度（或者不透明度）相关联，而不是URL。如果request是一个顶级的导航，而返回值是一个类型属性不透明的 {{domxref("Response")}}（即不透明响应体），一个 network error 将被返回给 Fetch。所有成功（非网络错误）响应的最终URL是请求的URL。

语法

FetchEvent.respondWith(
  //Promise that resolves to a Response or a network error.
​)

返回值

Void.

参数

任何自定义的响应生成代码。

示例

该代码片段来自 service worker fetch sample (run the fetch sample live)。 {{domxref("ServiceWorkerGlobalScope.onfetch")}} 事件处理程序侦听 {{event("fetch")}} 事件。当触发时，{{domxref("FetchEvent.respondWith", "FetchEvent.respondWith(any value)")}} 返回一个promise给受控页面。该promise在 {{domxref("Cache")}} 对象中查询第一个匹配URL请求。如果没有发现匹配项，该代码将转而从网络获取响应。

该代码也处理从 {{domxref("ServiceWorkerGlobalScope.fetch")}} 操作中抛出的异常。请注意，HTTP错误响应（例如404）不会触发异常。 它将返回具有相应错误代码集的正常响应对象。

self.addEventListener('fetch', function(event) {
  console.log('Handling fetch event for', event.request.url);

  event.respondWith(
    caches.match(event.request).then(function(response) {
      if (response) {
        console.log('Found response in cache:', response);

        return response;
      }
      console.log('No response found in cache. About to fetch from network...');

      return fetch(event.request).then(function(response) {
        console.log('Response from network is:', response);

        return response;
      }).catch(function(error) {
        console.error('Fetching failed:', error);

        throw error;
      });
    })
  );
});

规范

Specification Status Comment
{{SpecName('Service Workers', '#fetch-event-respondwith-method', 'respondWith()')}} {{Spec2('Service Workers')}} Initial definition.

浏览器兼容性

{{Compat("api.FetchEvent.respondWith")}}

请参见