如何封装一个可取消的 HTTP 请求?

前言

你可能会好奇什么样的场景会需要取消 HTTP 请求呢?

确实在实际的项目开发中,可能会很少有这样的需求,但是不代表没有,比如:

假如要实现上述这个公告栏,每点击一个 tab 按钮就会切换展示容器容器中的内容,但是由于这是三个 tab 按钮对应展示容器和信息条目结构样式都一致,于是为了 复用这个结构 ,将展示容器和其中的信息条目都作为三个 tab 按钮对应展示效果,只是点击每个 tab 按钮后 发送请求 后得到的数据不同.

正常情况下 tab1 对应的数据在初始化时进行展示,但是现在还存在一个问题,那就是如果点击完 tab2 并且已经发送了请求获取数据,假设这个请求需要 30s 后才响应回来,由于用户比较着急于是直接点了 tab3 ,此时 tab3 对应的接口已经发送出去但是未响应,而此时 tab2 对应的接口响应回来了,就会导致展示容器中的信息条目展现了错误的数据.

现在你应该知道,为什么需要一个可取消的 HTTP 请求了吧!!

准备工作

为了避免 端口、协议、IP 等不一致产生的跨域问题,这里就直接使用 express 启动一个本地服务,并返回测试页面 index.html,目录结构如下:

  • 其中最外层的 serverv.js 就是本地服务的代码,内容很简单:

    js 复制代码
    const path = require('path')
    const express = require('express')
    const app = express()
    
    // 返回静态资源
    app.use(express.static(path.join(__dirname, 'src')))
    
    // 处理 api 请求接口
    app.get('/message', function (req, res) {
      setTimeout(()=>{
        res.send('Hello World')
      } , 1000);
    });
    
    
    app.listen(3000, (error) => {
      if (error) {
        console.error("server error:", error);
        return
      }
      console.log("server runing at port 3000 ...");
    })
  • src/index.html 是测试页面,里面引入 src/request.js 中封装的请求方法

  • src/request.js 简单的封装了一些请求方法,包含 XMLHttpRequestfetchaxios 三种方式,内容如下:

    js 复制代码
    // xhrRequest
    function xhrRequest({
     method = 'get',
     url,
     params = null,
     async = true,
     success,
    }) {
     success = typeof success === 'function' ? success : () => {}
    
     const xhr = new XMLHttpRequest()
    
     xhr.open(method, url, async)
    
     xhr.onreadystatechange = () => {
       if (xhr.readyState == 4) {
         if ((xhr.status >= 200 && xhr.status < 300) || xhr.status == 304) {
           success(xhr.responseText)
         } else {
           console.log('Request was unsuccessful: ' + xhr.status)
         }
       }
     }
    
     method === 'post' ? xhr.send(params || null) : xhr.send()
    
     return () => {
       console.log(`当前请求已被取消,url:`, url)
       xhr.abort()
     }
    }
    
    // fetchRequest
    function fetchRequest({ method = 'GET', url, params }) {
     let abortController = new AbortController()
    
     let patload = {
       method: method,
       signal: abortController.signal,
     }
    
     if (method === 'POST') patload.body = JSON.stringify(params)
    
     return {
       abort: () => {
         console.log(`当前请求已被取消,url:`, url)
         abortController.abort()
       },
       result: fetch(url, patload),
     }
    }
    
    // axiosRequest
    window.axiosCancelArr = []
    let Axios = null
    function axiosRequest() {
     if (Axios) return Axios
    
     Axios = axios.create({
       baseURL: '',
       timeout: 10000,
     })
    
     //请求前拦截
     Axios.interceptors.request.use(
       (config) => {
         // 添加取消标记
         config.cancelToken = new axios.CancelToken((cancel) => {
           window.axiosCancelArr.push({url: config.url, cancel})
         })
         return config
       },
       (error) => {
         return Promise.reject(error)
       },
     )
    
     //请求后返回数据拦截
     Axios.interceptors.response.use(
       (res) => {
         return res
       },
       (res) => {
         return Promise.reject(res)
       },
     )
    
     return Axios
    }

原生方法取消请求

XMLHttpRequest ------ (new XMLHttpRequest()).abort()

下面的图示,演示了 请求成功请求被取消 时的两种表现:

以下是在测试页面 index.html 中的代码,对应 js 代码在准备工作部分:

js 复制代码
  <div>
    <button onclick="send()">send request</button>
    <button onclick="cancel()">cancel request</button>
  </div>

  <script src="./request.js"></script>
  <script>
    let cancel = () => {}

    function send(){
      console.log("正在发送 xhr 请求...")
      // 获取取消请求的方法
      cancel = xhrRequest({
        url:'/message',
        success(data){
          console.log("接收数据:", data)
        }
      })
    }
 <script>

fetch ------ (new AbortController()).abort()

下面的图示,演示了 请求成功请求被取消 时的两种表现:

以下是在测试页面 index.html 中的代码,对应 js 代码在准备工作部分:

js 复制代码
<div>
  <button onclick="send()">send request</button>
  <button onclick="cancel()">cancel request</button>
</div>

<script src="./request.js"></script>
<script>
  let cancel = () => {}

  // fetch
  function send() {
    console.log('正在发送 fetch 请求...')
    const { result, abort } = fetchRequest({
      url: '/message',
    })

    cancel = abort

    result
      .then((data) => {
        console.log('接收数据:', data)
      })
      .catch((error) => {
        console.log('fetch error:', error)
      })
  }
 </script>

axios ------ new axios.CancelToken((cancel) => {}))

下面的图示,演示了 请求成功请求被取消 时的两种表现:

以下是在测试页面 index.html 中的代码,对应 js 代码在准备工作部分:

js 复制代码
<div>
  <button onclick="send()">send request</button>
  <button onclick="cancel()">cancel request</button>
</div>

<script src="./request.js"></script>
<script>
  let cancel = () => {}

  // axios
  const AxiosInstance = axiosRequest()

  function send() {
    console.log('正在发 axios 送请求...')
    AxiosInstance.get('/message')
      .then((res) => {
        console.log('接收数据:', res)
      })
      .catch((error) => {
        console.log('axios error:', error)
      })
  }

  cancel = () => {
    console.log('axiosCancel = ', window.axiosCancel)
    window.axiosCancelArr.forEach((item) => {
      item.cancel()
    })
  }
</script>

实现自定义方法 " 取消请求 "

注意这里的 "请求方法" 是包含引号的,也就是说并不是像原生方法那样真的把已发送出去的请求进行取消,但是可以通过其他方式不在接收之前请求响应的数据,转而使用最新接口响应的数据,从侧面实现避免旧接口响应造成的干扰.

如果要自定义实现 "取消请求" 方法,最先想到的应该是 promise,因为 promise 有一个重要的特性就是:状态一旦从 pending -> fullfilled 或 pending -> rejected 的变更,之后就无法在进行更改.

既然如此,我们就可以在接口响应时通过 promise.resolve() 进行返回,一旦需要 "取消请求" 就可以先于接口响应时先更改对应 promise 的状态,从而抛弃上一次接口响应的数据.

request.js 中代码如下:

js 复制代码
// xhrRequestPromise
window.cancelXhrRequestArr = []
function xhrRequestPromise({
  method = 'get',
  url,
  params = null,
  async = true,
}) {
  return new Promise((resolve, reject) => {
    cancelXhrRequestArr.push({ reject, url })

    success = typeof success === 'function' ? success : () => {}

    const xhr = new XMLHttpRequest()

    xhr.open(method, url, async)

    xhr.onreadystatechange = () => {
      if (xhr.readyState == 4) {
        if ((xhr.status >= 200 && xhr.status < 300) || xhr.status == 304) {
          resolve(xhr.responseText)
        } else {
          console.log('Request was unsuccessful: ' + xhr.status)
        }
      }
    }

    method === 'post' ? xhr.send(params || null) : xhr.send()
  })
}

测试页面 index.html 代码如下:

js 复制代码
<div>
  <button onclick="send()">send request</button>
  <button onclick="cancel()">cancel request</button>
</div>

<script src="./request.js"></script>
<script>
  let cancel = () => {
    cancelXhrRequestArr.forEach(({reject, url}) => {
      reject(`abandon request url:${url}`)
    })
  }

  // xhrRequestPromise
  function send() {
    console.log('正在发送 xhr 请求...')
    const xhrp = xhrRequestPromise({ url: '/message' })
      .then((res) => {
        console.log('接收数据:', res)
      })
      .catch((error) => {
        console.log('xhrRequest error:', error)
      })
  }
  </script>

最后

上面通过 XMLHttpRequestfetchaxios 三种方式来演示了如何取消请求,同时也通过 promise 实现了自定义 "取消请求" 的方法,简单来说,通过原生方法就是把这个请求给取消了,自定义实现方法就是把将旧数据直接抛弃不适用,明白了这一点其实通过其他的方式实现也可以.

相关推荐
上官熊猫20 分钟前
nuxt3项目打包部署到服务器后配置端口号和开启https
前端·vue3·nuxt3
dal118网工任子仪2 小时前
61,【1】BUUCTF WEB BUU XSS COURSE 11
前端·数据库·xss
约定Da于配置4 小时前
uniapp封装websocket
前端·javascript·vue.js·websocket·网络协议·学习·uni-app
山楂树の4 小时前
xr-frame 模型摆放与手势控制,支持缩放旋转
前端·xr·图形渲染
大叔_爱编程4 小时前
wx030基于springboot+vue+uniapp的养老院系统小程序
vue.js·spring boot·小程序·uni-app·毕业设计·源码·课程设计
LBJ辉5 小时前
1. 小众但非常实用的 CSS 属性
前端·css
milk_yan5 小时前
Docker集成onlyoffice实现预览功能
前端·笔记·docker
计算机学姐6 小时前
基于微信小程序的驾校预约小程序
java·vue.js·spring boot·后端·spring·微信小程序·小程序
村口蹲点的阿三6 小时前
Spark SQL 中对 Map 类型的操作函数
javascript·数据库·hive·sql·spark
m0_748255027 小时前
头歌答案--爬虫实战
java·前端·爬虫