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

Fetch API 提供了一个获取资源的接口(包括跨域)。任何使用过 XMLHttpRequest 的人都能轻松上手,但新的API提供了更强大和灵活的功能集。

概念和用法

Fetch 提供了对 RequestResponse (以及其他与网络请求有关的)对象的通用定义。使之今后可以被使用到更多地应用场景中:无论是service workers、Cache API、又或者是其他处理请求和响应的方式,甚至是任何一种需要你自己在程序中生成响应的方式。

它还提供了一种定义,将 CORS 和 HTTP 原生的头信息结合起来,取代了原来那种分离的定义。

发送请求或者获取资源,需要使用 GlobalFetch.fetch 方法。它在很多接口中都被实现了,比如 Window 和 WorkerGlobalScope。所以在各种环境中都可以用这个方法获取到资源。

 fetch() 必须接受一个参数——资源的路径。无论请求成功与否,它都返回一个 promise 对象,resolve 对应请求的 Response。你也可以传一个可选的第二个参数init(参见 Request)。

一旦 Response 被返回,就有一些方法可以使用了,比如定义内容或者处理方法(参见 Body)。

你也可以通过 Request() 和 Response() 的构造函数直接创建请求和响应,但是我们不建议这么做。他们应该被用于创建其他 API 的结果(比如,service workers 中的 FetchEvent.respondWith)。

注意:更多关于 Fetch API 的用法,参考 Using Fetch,以及一些概念 Fetch basic concepts

中止 fetch

浏览器已经开始为AbortControllerAbortSignal 接口(也就是Abort API)添加实验性支持,允许像 Fetch 和 XHR 这样的操作在还未完成时被中止 。请参阅接口页面了解更多详情。

Fetch 接口

fetch()
包含了fetch() 方法,用于获取资源。
Headers
相当于 response/request 的头信息,可以修改它,或者针对不同的结果做不同的操作。
Request
相当于一个资源请求。
Response
相当于请求的响应

Fetch mixin

Body
提供了关联 response/request 中 body 的方法,可以定义它的文档类型以及请求如何被处理。

规范

规范 状态 说明
Fetch Living Standard Initial definition

浏览器兼容

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Edge Firefox (Gecko) IE Opera Safari (WebKit)
Basic support 42 14 39 (39)
34[1]
52 (52)[2]
未实现 29
28[1]
10.1
ReadableStream response body 43 14 未实现[3] 未实现 ? 未实现
Feature Android Webview Chrome for Android Edge Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support 42 42 (Yes) (Yes) 未实现 未实现 10.1
ReadableStream response body 43 43 (Yes) 未实现[3] 未实现 ? 未实现

[1] 这个API是在一个preference幕后被实现的。

[2] 在火狐浏览器中,若版本旧于52版本,get() 只返回指定头信息里的第一个值,而getAll()返回所有的值。在52版本之后的火狐浏览器, get() 返回所有的值, 而getAll() 被移除了。

[3] 火狐浏览器目前支持可读数据流,但是隐藏在  dom.streams.enabled 以及 javascript.options.streams 这两个preference中。

相关链接

文档标签和贡献者

标签: 
最后编辑者: HDUCC,