如何封装一个可取消的 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 实现了自定义 "取消请求" 的方法,简单来说,通过原生方法就是把这个请求给取消了,自定义实现方法就是把将旧数据直接抛弃不适用,明白了这一点其实通过其他的方式实现也可以.

相关推荐
吞掉星星的鲸鱼23 分钟前
使用高德api实现天气查询
前端·javascript·css
低头不见23 分钟前
tcp的粘包拆包问题,如何解决?
网络·网络协议·tcp/ip
lilye6626 分钟前
程序化广告行业(55/89):DMP与DSP对接及数据统计原理剖析
java·服务器·前端
....49227 分钟前
Vue3 + Element Plus + AntV X6 实现拖拽树组件
javascript·vue.js·elementui·antvx6
zhougl9962 小时前
html处理Base文件流
linux·前端·html
花花鱼2 小时前
node-modules-inspector 可视化node_modules
前端·javascript·vue.js
HBR666_2 小时前
marked库(高效将 Markdown 转换为 HTML 的利器)
前端·markdown
careybobo4 小时前
海康摄像头通过Web插件进行预览播放和控制
前端
TDengine (老段)4 小时前
TDengine 中的关联查询
大数据·javascript·网络·物联网·时序数据库·tdengine·iotdb
Aa美少女战士5 小时前
单域名 vs 通配符:如何选择最适合你的 SSL 证书?
网络协议·https·ssl