fetch()
方法定义在Window
对象以及WorkerGlobalScope
对象上,用于发起获取资源的请求,其返回一个Promise
对象,这个Promise
对象会在请求响应后被resolve
,并传回Response
对象。
Promise<Response> fetch(input[, init])
input
: 定义要获取的资源,其值可以是:
URL
,一些浏览器会接受 blob
和data
作为schemes
。Request
对象。init
: 一个配置项对象,包括所有对请求的设置。可选的参数有:
method
: 请求使用的方法,如GET
、POST
。headers
: 请求的头信息,形式为Headers
的对象或包含ByteString
值的对象字面量。body
: 请求的body
信息:可能是一个Blob
、BufferSource
、FormData
、URLSearchParams
或者USVString
对象,注意GET
或HEAD
方法的请求不能包含body
信息。mode
: 请求的模式,如cors
、no-cors
或者same-origin
。credentials
: 请求的credentials
,如omit
、same-origin
或者include
,为了在当前域名内自动发送cookie
,必须提供这个选项。cache
: 请求的cache
模式: default
、no-store
、reload
、no-cache
、force-cache
或者only-if-cached
。redirect
: 可用的redirect
模式: follow
自动重定向,error
如果产生重定向将自动终止并且抛出一个错误,或者manual
手动处理重定向。referrer
: 一个USVString
可以是no-referrer
、client
或一个URL
,默认是 client
。referrerPolicy
: 指定了HTTP
头部referer
字段的值,可能为以下值之一: no-referrer
、no-referrer-when-downgrade
、origin
、origin-when-cross-origin
、unsafe-url
。integrity
: 包括请求的subresource integrity
值,例如: sha256-BpfBw7ivV8q2jLiT13fxDYAe2tJllusRSZ273h2nFSE=
。返回一个Promise
,resolve
时回传Response
对象。
HTTP
状态码时,从fetch()
返回的Promise
不会被标记为 reject
,即使响应的HTTP
状态码是404
或500
,其会将Promise
状态标记为 resolve
,但是返回的Promise
会将resolve
的返回值的ok
属性设置为false
,仅当网络故障时或请求被阻止时,才会标记为reject
。fetch()
不会接受跨域cookies
,你也不能使用fetch()
建立起跨域会话,其他域的Set-Cookie
头部字段将会被无视。fetch()
不会发送cookies
,除非使用了credentials
的初始化选项。发起一个简单的资源请求,对于fetch
请求返回一个Promise
对象,这个Promise
对象会在请求响应后被resolve
,并传回Response
对象。
通过init
配置对象设置参数,可以设置method
、headers
、body
、mode
、credentials
、cache
、redirect
、referrer
、referrerPolicy
、integrity
。
Headers.append()
: 给现有的header
添加一个值, 或者添加一个未存在的header
并赋值。
Headers.delete()
: 从Headers
对象中删除指定header
。
Headers.entries()
: 以迭代器的形式返回Headers
对象中所有的键值对。
Headers.get()
: 以ByteString
的形式从Headers
对象中返回指定header的全部值。
Headers.has()
: 以布尔值的形式从Headers
对象中返回是否存在指定的header
。
Headers.keys()
: 以迭代器的形式返回Headers
对象中所有存在的header
名。
Headers.set()
: 替换现有的header
的值, 或者添加一个未存在的header
并赋值。
Headers.values()
: 以迭代器的形式返回Headers
对象中所有存在的header
的值。
通过Response
对象对响应的数据作处理,包括获取响应状态以及响应体的处理等操作。
Response
对象的相关属性与方法:
Response.headers
: 只读,包含此Response
所关联的Headers
对象。Response.ok
: 只读,包含了一个布尔值,标示该Response
成功,HTTP
状态码的范围在 200-299
。Response.redirected
: 只读,表示该Response
是否来自一个重定向,如果是的话,它的URL
列表将会有多个条目。Response.status
: 只读,包含Response
的状态码。Response.statusText
: 只读,包含了与该Response
状态码一致的状态信息。Response.type
: 只读,包含Response
的类型,例如basic
、cors
。Response.url
: 只读,包含Response
的URL
。Response.useFinalURL
: 包含了一个布尔值,来标示这是否是该Response
的最终URL
。Response.clone()
: 创建一个Response
对象的克隆。Response.error()
: 返回一个绑定了网络错误的新的Response
对象。Response.redirect()
: 用另一个URL
创建一个新的Response
。Response
实现了Body
接口,相关属性与方法可以直接使用:
Body.body
: 只读,一个简单的getter
,用于暴露一个ReadableStream
类型的body
内容。
Body.bodyUsed
: 只读,包含了一个布尔值来标示该Response
是否读取过Body
。
Body.arrayBuffer()
: 读取Response
对象并且将它设置为已读,并返回一个被解析为ArrayBuffer
格式的Promise
对象,Responses
对象被设置为了stream
的方式,所以它们只能被读取一次。
Body.blob()
:
读取Response
对象并且将它设置为已读,并返回一个被解析为Blob
格式的Promise
对象。
Body.formData()
:
读取Response
对象并且将它设置为已读,并返回一个被解析为FormData
格式的Promise
对象。
Body.json()
:
读取Response
对象并且将它设置为已读,并返回一个被解析为JSON
格式的Promise
对象。
Body.text()
:
读取Response
对象并且将它设置为已读,并返回一个被解析为USVString
格式的Promise
对象。