前端axios取消請(qǐng)求總結(jié)詳解
應(yīng)用場(chǎng)景
取消請(qǐng)求在前端有時(shí)候會(huì)用到,以下是兩個(gè)工作中可能會(huì)用到的場(chǎng)景
- tab切換時(shí)刷新某個(gè)列表數(shù)據(jù),如果他們共用一個(gè)變量存儲(chǔ)數(shù)據(jù)列表,當(dāng)請(qǐng)求有延時(shí),可能會(huì)導(dǎo)致兩個(gè)tab數(shù)據(jù)錯(cuò)亂;
- 導(dǎo)出文件或下載文件時(shí),中途取消 。
如何取消請(qǐng)求
取消http請(qǐng)求,axios文檔里提供了兩種用法:
第一種:使用 CancelToken
const { CancelToken, isCanCel } = axios;
const source = CancelToken.source();
axios.get('/user/12345', {
cancelToken: source.token
}).catch(thrown => {
if (isCancel(thrown)) {
// 獲取 取消請(qǐng)求 的相關(guān)信息
console.log('Request canceled', thrown.message);
} else {
// 處理其他異常
}
});
axios.post('/user/12345', {
name: 'new name'
}, {
cancelToken: source.token
})
// 取消請(qǐng)求。參數(shù)是可選的,參數(shù)傳遞一個(gè)取消請(qǐng)求的相關(guān)信息,在 catch 鉤子函數(shù)里能獲取到
source.cancel('Operation canceled by the user.');
第二種:給構(gòu)造函數(shù) CancelToken 傳遞一個(gè) executor 函數(shù)作為參數(shù)。這種方法的好處是,可以用同一個(gè) cancel token 來(lái)取消多個(gè)請(qǐng)求
const CancelToken = axios.CancelToken;
let cancel;
axios.get('/user/12345', {
cancelToken: new CancelToken(function executor(c) {
// 參數(shù) c 也是個(gè)函數(shù)
cancel = c;
})
});
// 取消請(qǐng)求,參數(shù)用法同上
cancel();
項(xiàng)目中用法示例
在一個(gè)真實(shí)的項(xiàng)目中,一般都會(huì)對(duì)axios進(jìn)行二次封裝,針對(duì)請(qǐng)求、響應(yīng)、狀態(tài)碼、code等做處理。貼一個(gè)項(xiàng)目里常用的request.js:
import axios from 'axios'
import store from '@/store'
import { getToken } from '@/utils/auth'
// 創(chuàng)建一個(gè) axios 實(shí)例,并改變默認(rèn)配置
const service = axios.create({
baseURL: process.env.BASE_API, // api 的 base_url
timeout: 5000 // request timeout
})
// 請(qǐng)求攔截
service.interceptors.request.use(
config => {
// Do something before request is sent
if (store.getters.token) {
// 讓每個(gè)請(qǐng)求攜帶token-- ['X-Token']為自定義key 請(qǐng)根據(jù)實(shí)際情況自行修改
config.headers['X-Token'] = getToken()
}
return config
},
error => {
// Do something with request error
console.log(error) // for debug
Promise.reject(error)
}
)
// 響應(yīng)攔截
service.interceptors.response.use(
response => response,
error => {
alert(error)
return Promise.reject(error)
}
)
export default service
對(duì)于某一個(gè)請(qǐng)求添加取消的功能,要在調(diào)用api時(shí),加上cancelToken選項(xiàng),使用時(shí)的示例:
// api.js
import request from 'request'
export function getUsers(page, options) {
return request({
url: 'api/users',
params: {
page
},
...options
})
}
// User.vue
import { CancelToken, isCancel } from 'axios'
import { getUsers } from 'api'
...
cancel: null
...
toCancel() {
this.cancel('取消請(qǐng)求')
}
getUsers(1,
{
cancelToken: new CancelToken(c => (this.cancel = c))
}
)
.then(...)
.catch(err => {
if (isCancel) {
console.log(err.message)
} else {
...
}
})
以上,我們就可以順順利利地使用封裝過(guò)的axios,取消某一個(gè)請(qǐng)求了。其原理無(wú)非就是把cancelToken的配置項(xiàng),在調(diào)用api時(shí)加上,然后就可以在業(yè)務(wù)代碼取消特定請(qǐng)求了。
批量取消請(qǐng)求
在 document 里的第二種方法已經(jīng)說(shuō)過(guò):通過(guò)指定同一個(gè)cancel token來(lái)取消。但是,在上面的項(xiàng)目示例中,不能控制拿到相同的cancel token。我們可以換個(gè)思路:用數(shù)組保存每個(gè)需要取消的cancel token,然后逐一調(diào)用數(shù)組里的每一項(xiàng)即可:
// User.vue
import { CancelToken, isCancel } from 'axios'
import { getUsers } from 'api'
...
cancel: []
...
toCancel() {
while (this.cancel.length > 0) {
this.cancel.pop()('取消請(qǐng)求')
}
}
getUser1(1,
{
cancelToken: new CancelToken(c1 => (this.cancel.push(c1)))
}
)
getUser2(2,
{
cancelTokem: new CancleTokem(c2 => (this.cancel.push(c2)))
}
)
切換路由時(shí),取消請(qǐng)求
上面講了取消一個(gè)請(qǐng)求及頁(yè)面內(nèi)批量abort的方法,此外,還有一種需求——切換路由時(shí),取消所有。 這里不詳細(xì)贅述了,大概思路就是在請(qǐng)求攔截器里,統(tǒng)一加個(gè)token,并設(shè)置全局變量source控制一個(gè)cancel token,在路由變化時(shí)調(diào)用cancel方法。
http.interceptors.request.use(config => {
config.cancelToken = store.source.token
return config
}, err => {
return Promise.reject(err)
})
router.beforeEach((to, from, next) => {
const CancelToken = axios.CancelToken
store.source.cancel && store.source.cancel()
store.source = CancelToken.source()
next()
})
// 全局變量
store = {
source: {
token: null,
cancel: null
}
}
取消請(qǐng)求的實(shí)現(xiàn)原理
cancelToken的source方法維護(hù)了一個(gè)對(duì)象,里面包括了token令牌和cancel方法,token來(lái)自與構(gòu)造函數(shù)CancelToken,調(diào)用cancel方法后,token的promise狀態(tài)為resolved,進(jìn)而又調(diào)用了xhr的abort方法,取消請(qǐng)求成功。 來(lái)分析下取消請(qǐng)求是怎么實(shí)現(xiàn)的,先從一個(gè)簡(jiǎn)單的取消請(qǐng)求的例子開始:
var CancelToken = axios.CancelToken;
var source = CancelToken.source();
axios.get('/get?name=xmz', {
cancelToken : source.token
}).then((response)=>{
console.log('response', response)
}).catch((error)=>{
if(axios.isCancel(error)){
console.log('取消請(qǐng)求傳遞的消息', error.message)
}else{
console.log('error', error)
}
})
// 取消請(qǐng)求
source.cancel('取消請(qǐng)求傳遞這條消息');
這就是一個(gè)簡(jiǎn)單的取消請(qǐng)求的例子,那么就從最開始的axios.CancelToken來(lái)看,先去axios/lib/axios.js文件中。
axios.CancelToken = require('./cancel/CancelToken');
不費(fèi)吹灰之力,就找到了CancelToken,在例子中我們調(diào)用了source方法,那么就去axios/lib/cancel/CancelToken.js文件中看看這個(gè)source方法到底是干什么的?
CancelToken.source = function(){
var cancel;
var token = new CancelToken(function executor(c) {
cancel = c
})
return {
token : token,
cancel : cancel
}
}
source方法很簡(jiǎn)單,就是返回一個(gè)具有token和cancel屬性的對(duì)象,但是token和cancel都是通過(guò)CancelToken這個(gè)構(gòu)造函數(shù)來(lái)的,那么還在這個(gè)文件中向上看,找到CancelToken函數(shù)。
function CancelToken (executor){
// ...
// 判斷executor是一個(gè)函數(shù),不然就報(bào)錯(cuò)
var resolvePromise;
this.promise = new Promise(function(resolve){
resolvePromise = resolve;
})
var token = this;
// 以上token現(xiàn)在有一個(gè)promise屬性,是一個(gè)未成功的promise對(duì)象;
executor(function cancel(message){
if(token.reason){
return;
}
token.reason = new Cancel(message);
resolvePromise(token.reason);
})
// 這個(gè)cancel函數(shù)就是 上面函數(shù)中的cancel,也就是source.cancel;
}
現(xiàn)在知道了source.cancel是一個(gè)函數(shù),souce.token是一個(gè)實(shí)例化對(duì)象,暫時(shí)就知道這些,繼續(xù)看文章最開始的例子,接下來(lái)是去發(fā)送請(qǐng)求了,最下面還有一行代碼是執(zhí)行souce.cancel(); souce.cancel就是用來(lái)觸發(fā)取消請(qǐng)求的函數(shù)。 現(xiàn)在再回頭來(lái)看,上面的cancel函數(shù),cancel執(zhí)行,給token加了一個(gè)reason屬性,那么看下這個(gè)reason屬性是什么吧,看下這個(gè)Cancel構(gòu)造函數(shù),在axios/lib/cancel/Cancel.js文件中
function Cancel(message){
this.message = message
}
Cancel特別簡(jiǎn)單就是給實(shí)例化對(duì)象添加一個(gè)message屬性,所以現(xiàn)在token.reason是一個(gè)具有message屬性的對(duì)象了。 繼續(xù)回到cancel函數(shù)中,resolvePromise函數(shù)執(zhí)行了,那么token.promise對(duì)象,這個(gè)原本未變成,成功狀態(tài)的promise,變成了成功狀態(tài)了,并且將token.reason對(duì)象傳遞過(guò)去了。 簡(jiǎn)單總結(jié)一下,執(zhí)行取消函數(shù),就是讓token的promise的狀態(tài)變成了成功; 好了,突然發(fā)現(xiàn)分析中斷了,變成成功狀態(tài)又怎樣了,怎么取消的呢?雖然現(xiàn)在的同步代碼都執(zhí)行完了,但是請(qǐng)求還沒發(fā)送出去呢,我們還要去看發(fā)送請(qǐng)求的函數(shù)
在分析發(fā)送請(qǐng)求之前,再看下最開始的例子,和最普通的發(fā)送一個(gè)get請(qǐng)求還是有一點(diǎn)區(qū)別的,配置對(duì)象中多了,一個(gè)cancelToken的屬性,值是token,到底起了什么作用呢,去axios/lib/adapters/xhr.js中一探究竟(這里只截取其中關(guān)于cancelToken的部分)。
// 在發(fā)送請(qǐng)求之前,驗(yàn)證了cancelToken,看來(lái)此處就是用來(lái)取消請(qǐng)求的;
if(config.cancelToken){
// 具體是如何取消的,是在這個(gè)判斷內(nèi)定義的;
config.cancelToken.promise.then(function(cancel){
request.abort();
reject(cancel);
request = null;
})
}
// 發(fā)送請(qǐng)求
request.send(requestData);
仔細(xì)看這只是一個(gè)promise的then函數(shù),只有在promise的狀態(tài)變成成功后才會(huì)執(zhí)行,而剛才我們分析了,cancel就是讓這個(gè)promise的狀態(tài)變成成功,所以如果執(zhí)行了,取消請(qǐng)求的函數(shù),這個(gè)then就會(huì)執(zhí)行,取消發(fā)送請(qǐng)求,并且把發(fā)送請(qǐng)求的promise變成reject,被axiox.get().catch()捕獲; 流程已經(jīng)清楚了,最后再總結(jié)一下: 執(zhí)行cancel是讓token的promise變成成功,在真正發(fā)送請(qǐng)求之前,驗(yàn)證token.promise的狀態(tài)是否已經(jīng)變了,如果變了,就取消請(qǐng)求,就是這樣一個(gè)簡(jiǎn)單的思想來(lái)進(jìn)行取消請(qǐng)求的。
以上就是axios取消請(qǐng)求總結(jié)的詳細(xì)內(nèi)容,更多關(guān)于axios取消請(qǐng)求的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章!
相關(guān)文章
vue2 設(shè)置router-view默認(rèn)路徑的實(shí)例
今天小編就為大家分享一篇vue2 設(shè)置router-view默認(rèn)路徑的實(shí)例,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2018-09-09
ElementUI實(shí)現(xiàn)el-table行列合并的操作步驟
在前端開發(fā)中,數(shù)據(jù)展示一直是一個(gè)重要的部分,而表格則是數(shù)據(jù)展示最常見的形式之一,ElementUI 是餓了么前端團(tuán)隊(duì)推出的一款基于 Vue 的 UI 組件庫(kù),其中的 el-table 組件是一個(gè)功能強(qiáng)大且靈活的表格組件,今天我們要詳細(xì)探討的是 el-table 的行列合并操作2024-08-08
Vue實(shí)現(xiàn)過(guò)渡效果的基本方法
Vue 提供了一個(gè)強(qiáng)大的過(guò)渡系統(tǒng),可以用于在進(jìn)入、離開和列表渲染時(shí)添加各種動(dòng)畫效果,這些過(guò)渡不僅能夠提升用戶體驗(yàn),還能使界面更加生動(dòng)和吸引人,本文將介紹 Vue 中實(shí)現(xiàn)過(guò)渡效果的基本方法,并提供使用 setup 語(yǔ)法糖的代碼示例,需要的朋友可以參考下2024-09-09
淺談Vue static 靜態(tài)資源路徑 和 style問(wèn)題
這篇文章主要介紹了淺談Vue static 靜態(tài)資源路徑 和 style問(wèn)題,具有很好的參考價(jià)值,希望對(duì)大家有所幫助。一起跟隨小編過(guò)來(lái)看看吧2020-11-11

