Fetch API
提供了一个 JavaScript接口,用于访问和操纵 HTTP 管道的部分,例如请求和响应。它还提供了一个全局
fetch()
方法,该方法提供了一种简单,合乎逻辑的方式来跨网络异步获取资源。
fetch()
必须接受一个参数---路径。无论请求成功与否,它都返回一个 Promise 对象,resolve 对应请求的
Response
。另外你还可以设置第二个参数(可选的参数)
options
(常用配置如下,具体详情参见
Request
)。
options={
method: "GET",
headers: {
Accept: 'application/json, text/plain, */*',
'Content-Type': 'application/json;charset=UTF-8',
'Content-Type': 'application/x-www-form-urlencoded;charset=UTF-8',
credentials: 'include',
mode: 'cors',
cache: 'default'
复制代码
cache参数
cache 表示如何处理缓存, 遵守 http 规范, 拥有如下几种值:
default: 浏览器从 HTTP 缓存中寻找匹配的请求.
no-store: 浏览器在不先查看缓存的情况下从远程服务器获取资源,并且不会使用下载的资源更新缓存
reload: 请求之前将忽略 http 缓存的存在, 但请求拿到响应后, 它将主动更新 http 缓存.
no-cache: 如果存在缓存, 那么 fetch 将发送一个条件查询 request 和一个正常的 request , 拿到响应后, 它会更新http缓存.
force-cache: 浏览器在其HTTP缓存中查找匹配的请求。
如果存在匹配,
新鲜或过时
,则将从缓存中返回。
如果没有匹配,浏览器将发出正常请求,并使用下载的资源更新缓存
only-if-cached: fetch 强行取缓存,( 即使缓存过期了也从缓存取). 如果没有缓存, 浏览器将返回错误
这是一个比较基本的案例,这里为了看的清楚,没有处理 catch 问题 。
var url = 'https://zhidao.baidu.com/question/api/hotword?pn=1561&rn=5&t=1551165472017';
fetch(url).then(function(response) {
return response;
}).then(function(data) {
console.log(data);
复制代码
可以自己动手把这个代码直接贴到控制台中 , 这里为了防止同源策略,并且看到更详细的数据我们最好在 https://zhidao.baidu.com 内的控制台中输入。如果在其他的页面我们应该在 fetch 方法的第二个参数中加上{ mode: "no-cors" }。为了看的更加清楚,我贴出这两种情况的打印结果,如下所示:
在 https://zhidao.baidu.com 网页控制台输入的地址
在其他网页控制台输入的地址
我们会发现两个打印结果基本不同,首先跨域打印的结果中很多数据都是空的,另外我们也发现其中 type 也不相同,这里介绍下 response.type。
fetch请求的响应类型( response.type )为如下三种之一:
basic,同域下, 响应类型为 “basic”。
cors,跨域下,返回 cors 响应头, 响应类型为 “cors”。
opaque,跨域下, 服务器没有返回 cors 响应头, 响应类型为 “opaque”。
fetch
设了
{mode='no-cors'}
表示不垮域,可以请求成功,但拿不到服务器返回数据
看到这里,心急的同学会发现,其实现在数据还是没有拿到,我们仅仅只是拿到了个 Response 对象。那么如何拿到数据呢?
var url = 'https://zhidao.baidu.com/question/api/hotword?pn=1561&rn=5&t=1551165472017';
fetch(url).then(function(response) {
return response.json();
}).then(function(data) {
console.log(data);
复制代码
通过 response 原型上的 json 方法拿到数据,在返回出去。response 原型打印如下:
这里要注意的是 response .json / response.text 方法只能使用一个并且只能使用一次,同时使用两个,或则使用两次都会报如下错误:
Uncaught (in promise) TypeError: Failed to execute 'json' on 'Response': body stream is locked
为什么不能使用两次?
数据流只能读取一次,一旦读取,数据流变空,再次读取会报错。可以使用 response.clone() 复制一个副本。
为什么只能读取一次?
答案还在查寻中,同时也希望知道的读者能够指点一下。
上面的写法,看起来有回调,又有链式调用,我们试着换个新写法,这里使用 async/await 来实现:
var url = 'https://zhidao.baidu.com/question/api/hotword?pn=1&rn=5&t=1551191647420'
let getData = async () => {
let response = await fetch(url)
let data = response.json()
console.log(data)
复制代码
打印 data 如下:
这里 data 是一个 Promise 对象,由于他的内部变量[[PromiseValue]]在外部无法得到,只能在 then 中获取,所以在后面加上 then 获取 data
let response = await fetch(url);
let data = response.json();
data.then((res)=>{
console.log(res)
复制代码
封装
我们通过 fetch 来做个简易的 request 封装,顺便把 options 再回顾一遍,很多配置在实际中可能是不需要的,都有默认配置(options 的默认配置在下面括号中)。
function request(url, data = {}) {
// options配置的默认选项在括号中
return fetch(url, {
method: "POST", //(GET), POST, PUT, DELETE, etc
mode: "cors", // (same-origin), no-cors, cors
cache: "no-cache", // (default), no-cache, reload, force-cache, only-if-cached
credentials: "same-origin", //(same-origin), include, omit
headers: {
"Content-Type": "application/json",
// "Content-Type": "application/x-www-form-urlencoded",
redirect: "follow", //(follow), manual, error
referrer: "no-referrer", //(client), no-referrer
body: JSON.stringify(data), // 这里格式要与 "Content-Type" 同步
.then(response => response.json());
复制代码
最后
初次写帖,如有错误或不严谨的地方,请务必给予指正,谢谢
Fetch API
传统 Ajax 已死,Fetch 永生