目录
1、Fetch()–代替XMLHttpRequest
前言
全局的 fetch() 方法用于发起获取资源的请求(用于取代传统的XMLHttpRequest的)。返回一个Promise对象。
语法
fetch(input[, init])
参数
input:定义要获取的资源
- 一个要获取资源的 URL。一些浏览器会接受 blob: 和 data:
- 一个 Request 对象。
init :一个配置项对象,包括所有对请求的设置(跟Request() 对象的接口一致)
const response = fetch(url, {
method: "GET",
headers: {
"Content-Type": "text/plain;charset=UTF-8"
},
body: undefined,
referrer: "about:client",
referrerPolicy: "no-referrer-when-downgrade",
mode: "cors",
credentials: "same-origin",
cache: "default",
redirect: "follow",
integrity: "",
keepalive: false,
signal: undefined
});
method:HTTP 请求的方法,POST、DELETE、PUT都在这个属性设置。
headers:一个对象,用来定制 HTTP 请求的标头。
body:POST 请求的数据体。
cache:指定如何处理缓存。可能的取值如下:
/*
default:默认值,先在缓存里面寻找匹配的请求。
no-store:直接请求远程服务器,并且不更新缓存。
reload:直接请求远程服务器,并且更新缓存。
no-cache:将服务器资源跟本地缓存进行比较,有新的版本才使用服务器资源,否则使用缓存。
force-cache:缓存优先,只有不存在缓存的情况下,才请求远程服务器。
only-if-cached:只检查缓存,如果缓存里面不存在,将返回504错误。
*/
mode: 指定请求的模式。可能的取值如下:
/*
cors:默认值,允许跨域请求。
same-origin:只允许同源请求。
no-cors:请求方法只限于 GET、POST 和 HEAD,并且只能使用有限的几个简单标头,不能添加跨域的复杂标头,相当于提交表单所能发出的请求。
*/
credentials:指定是否发送 Cookie。可能的取值如下:
/*
same-origin:默认值,同源请求时发送 Cookie,跨域请求时不发送。
include:不管同源请求,还是跨域请求,一律发送 Cookie。
omit:一律不发送。
*/
signal:指定一个 AbortSignal 实例,用于取消fetch()请求
keepalive:用于页面卸载时,告诉浏览器在后台保持连接,继续发送数据。
/*
一个典型的场景就是,用户离开网页时,脚本向服务器提交一些用户行为的统计信息。
这时,如果不用keepalive属性,数据可能无法发送,因为浏览器已经把页面卸载了。
*/
redirect: 指定 HTTP 跳转的处理方法。可能的取值如下:
/*
follow:默认值,fetch()跟随 HTTP 跳转。
error:如果发生跳转,fetch()就报错。
manual:fetch()不跟随 HTTP 跳转,但是response.url属性会指向新的 URL,response.redirected属性会变为true,由开发者自己决定后续如何处理跳转。
*/
integrity:指定一个哈希值,用于检查 HTTP 回应传回的数据是否等于这个预先设定的哈希值。
/*
比如,下载文件时,检查文件的 SHA-256 哈希值是否相符,确保没有被篡改
fetch('http://site.com/file', {
integrity: 'sha256-abcdef'
});
*/
referrer: 用于设定fetch请求的referer标头。
/*
这个属性可以为任意字符串,也可以设为空字符串(即不发送referer标头)。
*/
referrerPolicy: 用于设定Referer标头的规则。可能的取值如下:
/*
no-referrer-when-downgrade:默认值,总是发送Referer标头,除非从 HTTPS 页面请求 HTTP 资源时不发送。
no-referrer:不发送Referer标头。
origin:Referer标头只包含域名,不包含完整的路径。
origin-when-cross-origin:同源请求Referer标头包含完整的路径,跨域请求只包含域名。
same-origin:跨域请求不发送Referer,同源请求发送。
strict-origin:Referer标头只包含域名,HTTPS 页面请求 HTTP 资源时不发送Referer标头。
strict-origin-when-cross-origin:同源请求时Referer标头包含完整路径,跨域请求时只包含域名,HTTPS 页面请求 HTTP 资源时不发送该标头。
unsafe-url:不管什么情况,总是发送Referer标头。
*/
返回值
Promise,resolve 时回传 Response 对象。
Response 对象
1、同步属性
fetch()
请求成功返回Promise
,Promise
调用then
方法得到一个Response
对象。它对应服务器的HTTP
回应。Response
包含的数据通过Stream
接口异步读取,但是它还包含一些同步属性,对应HTTP
回应的标头信息(Headers),可以立即读取。- 标头信息属性有下面这些:
const myPromise = fetch('https://api.github.com/users/ruanyf')
myPromise.then(response => {
console.log(response, '------->response对象')
})
1. response.ok:返回一个布尔值,表示请求是否成功
例如:true对应 HTTP 请求的状态码 200 到 299,false对应其他的状态码。
2. response.status:返回一个数字,表示 HTTP 回应的状态码
例如:200,表示成功请求
3. response.statusText属性返回一个字符串,表示 HTTP 回应的状态信息
例如:请求成功以后,服务器返回"OK"
4. response.url:返回请求的 URL。
如果: URL 存在跳转,该属性返回的是最终 URL。
5. response.redirected:返回一个布尔值,表示请求是否发生过跳转。
6. response.type:返回请求的类型。可能的值如下:
basic:普通请求,即同源请求。
cors:跨域请求。
error:网络错误,主要用于 Service Worker。
2、判断请求
fetch()
发出请求以后,只有网络错误或者无法连接时,fetch()
才会报错,其他情况都不会报错,而是认为请求成功。- 只有通过
Response.status
属性,得到HTTP
回应的真实状态码,才能判断请求是否成功 - 另一种方法是判断
response.ok
是否为true
const myPromise = fetch('https://api.github.com/users/ruanyf')
myPromise.then(response => {
console.log(response, '------->response')
// 第一种方法
if (response.ok) {
console.log('状态成功-------> true对应 HTTP 请求的状态码 200 到 299,false对应其他的状态码。')
}
// 第二种方法
if (response.status >= 200 && response.status < 300) {
console.log('状态成功-------> status 对应 HTTP 的状态码')
} else {
console.log('状态失败-------> ')
}
})
3、操作标头
Response 对象
还有一个Response.headers
属性,指向一个Headers 对象
,对应HTTP
回应的所有标头。Headers 对象
可以使用for...of
循环进行遍历
for (let [key, value] of response.headers) {
console.log(`${key} : ${value}`);
}
- 提供了以下方法,用来操作标头。比较常用的也就是:
response.headers.get()
response.headers.get():根据指定的键名,返回键值。
response.headers.has(): 返回一个布尔值,表示是否包含某个标头。
response.headers.set():将指定的键名设置为新的键值,如果该键名不存在则会添加。
response.headers.append():添加标头。
response.headers.delete():删除标头。
response.headers.keys():返回一个遍历器,可以依次遍历所有键名。
response.headers.values():返回一个遍历器,可以依次遍历所有键值。
response.headers.entries():返回一个遍历器,可以依次遍历所有键值对([key, value])。
response.headers.forEach():依次遍历标头,每个标头都会执行一次参数函数。
4、读取内容
Response对象
根据服务器返回的不同类型的数据,提供了不同的读取方法。- 下面5个读取方法都是异步的,返回的都是
Promise 对象
。必须等到异步操作结束,才能得到服务器返回的完整数据。 - Stream 对象只能读取一次,读取完就没了。这意味着五个读取方法,只能使用一个,否则会报错。
const myPromise = fetch('https://api.github.com/users/ruanyf')
myPromise.then(response => {
console.log(response, '------->response')
response.text() // 得到文本字符串,用于获取文本数据,比如 HTML 文件。
response.json() // 得到 JSON 对象。
response.blob() // 得到二进制 Blob 对象,例如读取图片文件,显示在网页上。
response.formData() // 得到 FormData 表单对象,主要用在 Service Worker 里面,拦截用户提交的表单,修改某些数据以后,再提交给服务器。
response.arrayBuffer() // 得到二进制 ArrayBuffer 对象,主要用于获取流媒体文件。
})
5、创建副本
Response 对象
提供Response.clone()
方法,创建Response对象
的副本,实现多次读取。
const response1 = await fetch('flowers.jpg');
// response.clone()复制了一份 Response 对象,然后将同一张图片读取了两次
const response2 = response1.clone();
const myBlob1 = await response1.blob();
const myBlob2 = await response2.blob();
image1.src = URL.createObjectURL(myBlob1);
image2.src = URL.createObjectURL(myBlob2);
6、底层接口
Response.body
属性是Response 对象
暴露出的底层接口,返回一个ReadableStream 对象
,供用户操作- 例如:用来分块读取内容,显示下载的进度
const response = await fetch('flower.jpg');
// response.body.getReader()方法返回一个遍历器
const reader = response.body.getReader();
while(true) {
// 这个遍历器的read()方法每次返回一个对象,表示本次读取的内容块
const {done, value} = await reader.read();
// done属性是一个布尔值,用来判断有没有读完
if (done) {
break;
}
// value属性是一个 arrayBuffer 数组,表示内容块的内容,而value.length属性是当前块的大小
console.log(`Received ${value.length} bytes`)
}
案例
基本使用(实现图片下载,预览也可以的)
<template>
<div class="emqrcode">
<a-upload :file-list="fileList" :before-upload="beforeUpload">
<a-button> <a-icon type="upload" /> Select File </a-button>
</a-upload>
<div>------------------------------</div>
<div ref="div"></div>
</div>
</template>
<script>
export default {
data () {
return {
fileList: []
}
},
methods: {
beforeUpload (file) {
this.fileList = [...this.fileList, file]
const url = window.URL.createObjectURL(file)
console.log(url, '------->url')
let link = document.createElement('a')
fetch(url).then(response => {
return response.blob()
}).then(res => {
console.log(res, '------->res')
link.href = URL.createObjectURL(res)
link.download = 'pic'
document.body.appendChild(link)
link.click()
}).catch(err => {
console.log(err, '------>Request Failed')
})
return false
}
}
}
</script>
<style lang="less"></style>