编者按:本文作者舒丽琦,奇舞团前端开发工程师
在我们web开发过程中,很多地方需要我们取消重复的请求。但是哪种场合需要我们取消呢?我们如何取消呢?带着这些问题我们阅读本文。
阅读完本文,你将了解以下内容:
最近做的项目中,用的用户经常遇到这样的问题:
这些问题给用户的体验是很不友好的。那么取消无用的请求是很有必要的。
我们用的请求库是axios。那么我们可以在请求的时候拦截请求判断当前的请求是否重复,如果重复我们就取消当前的请求。大致的实现过程如下:
我们把目前处于pending的请求存储(假如我们放在一个数组)起来。每个请求发送之前我们都要判断当前这个请求是否已经存在于这个数组。如果存在,说明请求重复了,我们就在数组中找到重复的请求并且取消。如果不存在,说明这个请求不是重复的,正常发送并且把这个请求api添加在数据中,等请求结束之后删除数组中的这个api。
我们这个解决思路有了,但是axios如何取消请求的呢?我们先来了解下
查看axios文档发现axios提供了两种取消请求的方法(http://www.axios-js.com/zh-cn/docs/#%E5%8F%96%E6%B6%88)
解决取消请求的思路有了,取消请求的办法也有了,那么剩下的就是封装了
由于同事之前已经封装了axios——very-axios(https://github.com/verymuch/very-axios) (基于 axios 进行二次封装,更简单、更统一地使用 axios)。那么我们就这个基础上提一个pr吧。那么从现在开始我们就一步一步的来实现,这个过程包含了【如何给开源的项目贡献代码】【如何在本地调试npm】如果已经了解的同学可以直接略过。
由于同事已经封装了axios并且已经开源了。那么我贡献代码的方式主要有两种:
我们采用的第二种方式。我们去 very-axios(https://github.com/verymuch/very-axios) 把代码fork到自己的仓库(如果你还没有自己的github,需要自己注册下哦)。

那么你回到自己的github仓库下面就会看有一个一摸一样的项目

那么我们现在就可以git clone这个仓库的代码到本地,新建branch进行开发,就比如我新建了一个这样的branch:

现在已经有本地的代码了,但是我们如何本地化调试npm包呢?那就需要npm link 了
首先在我们要修改的npm 包中npm link:

之后我们会得到
/Users/shuliqi/.nvm/versions/node/v12.17.0/lib/node_modules/very-axios -> /Users/shuliqi/study/axios/very-axios这意思就是我们把very-axios链接到全局的node_modules
然后我们进入我们my-project-of-axios 目录下面执行npm link very-axios 如图:

这意思就是very-axios被安装在my-project-of-axios 下面了。very-axios的修改都会同步到my-project-of-axios。就实现本地测试了。
我们在my-project-of-axios中的HelloWorld.vue文件中做列子。
如果这里看的不是很懂的同学可以看看这两篇文章:如何在本地调试npm包(https://github.com/allenGKC/Blog/issues/13)。如何使用 GitHub Flow 给开源项目贡献代码(https://juejin.im/post/6844903636863041550)
准备工作完成了, 那我们开始封装的事情。根据我们之前的思路。我们采用axios 如何取消请求的第一种方式。
声明一个Map。用来存储每个请求的 标识 和 取消的函数
// 存储每个请求的标识和取消的函数this.pendingAjax = new Map();自定一个字段来让用户自己决定是否需要取消重复的请求
// 是否取消重复的请求cancelDuplicated = false,自定一个字段来让用户是否有全局的统一的设置重复标识的函数。如果没有设置全局的统一的函数,则默认是请求的method 和url作为重复的标识
// 生成重复标识的方式duplicatedKeyFn,this.duplicatedKeyFn = isFunction(duplicatedKeyFn) ? duplicatedKeyFn : (config) => `${config.method}${config.url}`;添加请求
/** * 将请求添加到pendingAjax * @param {Object} config */addPendingAjax(config) { // 是否需要取消重复的请求 if (!this.cancelDuplicated) return const veryConfig = config.veryConfig || {}; const duplicatedKey = JSON.stringify({ duplicatedKey: veryConfig.duplicatedKey || this.duplicatedKeyFn(config), type: REQUEST_TYPE.DUPLICATED_REQUEST, }); config.cancelToken = config.cancelToken || new axios.CancelToken((cancel) => { // 如果pendingAjax中不存在当前请求,添加进去 if (duplicatedKey && !this.pendingAjax.has(duplicatedKey)) { this.pendingAjax.set(duplicatedKey, cancel); } });}这里面我们可以使用duplicatedKey字段来让用户对单一请求自定义重复的标识。或者可以使用一个函数duplicatedKeyFn统一的让用户自定义重复的标识
删除请求
/** * 从pendingAjax中删除请求 * @param {Object} config */ removePendingAjax(config) { // 是否需要取消重复的请求 if (!this.cancelDuplicated) return const veryConfig = config.veryConfig || {}; const duplicatedKey = JSON.stringify({ duplicatedKey: veryConfig.duplicatedKey || this.duplicatedKeyFn(config), type: REQUEST_TYPE.DUPLICATED_REQUEST, }); // 如果pendingAjax中存在当前请求, 取消当前请求并将其删除 if (duplicatedKey && this.pendingAjax.has(duplicatedKey)) { const cancel = this.pendingAjax.get(duplicatedKey); cancel(duplicatedKey); this.pendingAjax.delete(duplicatedKey); } }封装好了, 我们在哪里使用呢?肯定是在请求开始之前和请求完成之后使用。
在请求之前
// 拦截请求this.axios.interceptors.request.use((config) => { // 在请求开始之前检查先前的请求 this.removePendingAjax(config); // 将当前请求添加到pendingAjax this.addPendingAjax(config); // ...});在请求完成之后去掉该请求
// 拦截响应this.axios.interceptors.response.use(response => { removePending(response) return response}, error => { // ...})到现在已经完成了该有的功能, 但是取消请求的错误我们不该返回给用户。所以:
(err) => {// 类型是否为重复请求let isDuplicatedType;try { const errorType = (JSON.parse(error.message) || {}).type isDuplicatedType = errorType === REQUEST_TYPE.DUPLICATED_REQUEST;} catch (error) { isDuplicatedType = false}if (isDuplicatedType) return;}我们在请求完成之后的err里面做一个判断,判断如果当前请求是取消的类型,我们就不返回给用户错误的提示信息。