微信小程序封装网络请求和拦截器实战步骤

更新时间：2023年03月31日 10:32:18 作者：迪迦

这篇文章主要介绍了微信小程序封装网络请求和拦截器实战步骤，这样可以提高开发效率，减少代码重复，同时也可以提高代码的可维护性和可读性

1. 前言

今天和合作伙伴对接代码的时候，打开压缩包，发现项目有很大的问题，项目里根本没有登录验证请求封装拦截器这些东西，在开发小程序时，无疑想要维护还是比较麻烦的，实际上我们通常需要封装网络请求和拦截器，以实现统一处理状态码和存储用户登录信息等功能。这样可以提高开发效率，减少代码重复，同时也可以提高代码的可维护性和可读性。

2. 思路

封装网络请求

首先，需要封装网络请求，负责发送请求和处理响应。该类应该包含以下方法：

·request(url, method, data, header)：发送网络请求，并返回响应结果。

·get(url, data, header)：发送 GET 请求。

·post(url, data, header)：发送 POST 请求。

等不同请求方式

可以使用小程序提供的 wx.request 方法来实现网络请求，该方法的参数与上述方法的参数一一对应。在处理响应时，可以使用Promise对象来处理异步操作。

统一处理状态码

可以创建一个checkStatus函数，用于统一处理状态码。该函数接受一个response参数，用于判断请求是否成功。如果请求成功，则返回一个Promise对象，以便于我们进行后续的操作。如果请求失败，则抛出一个错误。

创建拦截器类

具体处理逻辑见下文。

2.1 封装网络请求

封装一个request函数，用于发送请求。该函数接受一个参数options，用于配置请求。我们可以在该函数中使用小程序提供的wx.request接口发送请求，并在请求完成后返回一个Promise对象，以便于我们进行后续的操作。

function request(options) {
  return new Promise((resolve, reject) => {
    wx.request({
      url: options.url,
      method: options.method || 'GET',
      data: options.data || {},
      header: options.header || {},
      success: resolve,
      fail: reject
    })
  })
}

2.2 统一处理状态码

我们可以封装一个checkStatus函数，用于统一处理状态码。该函数接受一个response参数，用于判断请求是否成功。如果请求成功，则返回一个Promise对象，以便于我们进行后续的操作。如果请求失败，则抛出一个错误。

function checkStatus(response) {
  const { statusCode, data } = response
  if (statusCode >= 200 && statusCode < 300) {
    return Promise.resolve(data)
  } else {
    const error = new Error(`请求失败，状态码：${statusCode}`)
    error.response = response
    throw error
  }
}

2.3 封装拦截器

我们可以封装一个interceptor函数，用于封装拦截器。该函数接受一个chain参数，用于执行拦截器链。我们可以在该函数中定义一个requestInterceptor和一个responseInterceptor，用于分别处理请求和响应的拦截器。我们可以在requestInterceptor中设置请求头，以便于在后续的请求中进行身份验证。我们可以在responseInterceptor中统一处理状态码，并在请求成功时更新用户登录信息。

function interceptor(chain) {
  const requestInterceptor = (options) => {
    // 设置请求头
    options.header.Authorization = 'Bearer ' + getApp().globalData.token
    return chain.request(options)
  }
  const responseInterceptor = (response) => {
    const { statusCode, data } = response
    if (statusCode >= 200 && statusCode < 300) {
      // 更新用户登录信息
      getApp().globalData.userInfo = data.userInfo
    } else {
      const error = new Error(`请求失败，状态码：${statusCode}`)
      error.response = response
      throw error
    }
    return response
  }
  return {
    request: requestInterceptor,
    response: responseInterceptor
  }
}

2.4 不同请求方式兼容

//封装put请求方式的代码如下：
function put(options) {
  return new Promise((resolve, reject) => {
    wx.request({
      url: options.url,
      method: 'PUT',
      data: options.data || {},
      header: options.header || {},
      success: resolve,
      fail: reject
    })
  })
}
//封装delete请求方式的代码如下：
function del(options) {
  return new Promise((resolve, reject) => {
    wx.request({
      url: options.url,
      method: 'DELETE',
      data: options.data || {},
      header: options.header || {},
      success: resolve,
      fail: reject
    })
  })
}
//封装post请求方式的代码如下：
function post(options) {
  return new Promise((resolve, reject) => {
    wx.request({
      url: options.url,
      method: 'POST',
      data: options.data || {},
      header: options.header || {},
      success: resolve,
      fail: reject
    })
  })
}

2.5 全局存储用户登录信息

我们可以在小程序的app.js中定义一个全局变量globalData，用于存储用户登录信息。我们可以在登录成功后将用户信息保存到该变量中，并在后续的请求中使用该变量进行身份验证。

App({
  globalData: {
    userInfo: null,
    token: null
  }
})

2.6 完整代码

// request.js
function request(options) {
  return new Promise((resolve, reject) => {
    wx.request({
      url: options.url,
      method: options.method || 'GET',
      data: options.data || {},
      header: options.header || {},
      success: resolve,
      fail: reject
    })
  })
}
function put(options) {
  return new Promise((resolve, reject) => {
    wx.request({
      url: options.url,
      method: 'PUT',
      data: options.data || {},
      header: options.header || {},
      success: resolve,
      fail: reject
    })
  })
}
function del(options) {
  return new Promise((resolve, reject) => {
    wx.request({
      url: options.url,
      method: 'DELETE',
      data: options.data || {},
      header: options.header || {},
      success: resolve,
      fail: reject
    })
  })
}
function post(options) {
  return new Promise((resolve, reject) => {
    wx.request({
      url: options.url,
      method: 'POST',
      data: options.data || {},
      header: options.header || {},
      success: resolve,
      fail: reject
    })
  })
}
function checkStatus(response) {
  const { statusCode, data } = response
  if (statusCode >= 200 && statusCode < 300) {
    return Promise.resolve(data)
  } else {
    const error = new Error(`请求失败，状态码：${statusCode}`)
    error.response = response
    throw error
  }
}
function interceptor(chain) {
  const requestInterceptor = (options) => {
    options.header.Authorization = 'Bearer ' + getApp().globalData.token
    return chain.request(options)
  }
  const responseInterceptor = (response) => {
    const { statusCode, data } = response
    if (statusCode >= 200 && statusCode < 300) {
      getApp().globalData.userInfo = data.userInfo
    } else {
      const error = new Error(`请求失败，状态码：${statusCode}`)
      error.response = response
      throw error
    }
    return response
  }
  return {
    request: requestInterceptor,
    response: responseInterceptor
  }
}
export { request, put, del, post, checkStatus, interceptor }

3. 使用示例

import { request, interceptor, checkStatus } from './request'
const chain = interceptor({
  request: (options) => {
    console.log('请求拦截器')
    return options
  },
  response: (response) => {
    console.log('响应拦截器')
    return response
  }
})
request({
  url: 'https://xxx.com/api/users',
  method: 'GET'
})
  .then(checkStatus)
  .then(data => {
    console.log(data)
  })
  .catch(error => {
    console.log(error)
  })

4. 注意事项

① 在使用拦截器时，需要注意拦截器的执行顺序。在上述示例中，拦截器的执行顺序是先执行请求拦截器，再执行响应拦截器。

② 在小程序中，我们可以使用getApp()函数来获取小程序实例，从而访问全局变量。

③ 在发送请求时，需要注意请求的参数配置。在上述示例中，默认使用的是GET请求方法和空对象作为请求参数，并且配置了常用请求方式，如果需要使用其他请求方法或者自定义请求参数，请在调用request函数时进行相应的配置。

5. 结语

实际上请求的url地址也可以单独封装的，需要单独新建一个js文件里面导出域名或者url地址，再调用request封装的地方，import引入一下就可以了，以上便是关于小程序封装网络请求和拦截器的全部内容，希望可以帮到有需要的小伙伴。欢迎大家多多交流，共同进步~

到此这篇关于微信小程序封装网络请求和拦截器实战步骤的文章就介绍到这了,更多相关小程序封装网络请求和拦截器内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

JavaScript中的垃圾回收与内存泄漏示例详解
这篇文章主要给大家介绍了关于JavaScript中垃圾回收与内存泄漏的相关资料，文中通过示例代码介绍的非常详细，对大家学习或者使用JavaScript具有一定的参考学习价值，需要的朋友们下面来一起学习学习吧
2019-05-05
javascript实现瀑布流加载图片原理
这篇文章主要为大家介绍了javascript实现瀑布流加载图片效果，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2016-02-02
javascript window.onerror事件学习新收获
javascript window.onerror事件学习新收获...
2007-11-11
ES6对象操作实例详解
这篇文章主要介绍了ES6对象操作,结合实例形式详细分析了ES6对象创建、赋值、比较、合并等相关操作技巧与注意事项,需要的朋友可以参考下
2020-05-05
使用js实现将后台传入的json数据放在前台显示
今天小编就为大家分享一篇使用js实现将后台传入的json数据放在前台显示，具有很好的参考价值，希望对大家有所帮助。一起跟随小编过来看看吧
2018-08-08
JavaScript中变量的相互引用
变量相互引用的原因是：由于某些类型的变量是按地址存储的而导致的两个或多的参数的值互相影响.
2010-05-05
JavaScript实现快速排序的方法
这篇文章主要介绍了JavaScript实现快速排序的方法,实例分析了javascript快速排序的相关实现技巧,具有一定参考借鉴价值,需要的朋友可以参考下
2015-07-07
浅谈Javascript鼠标和滚轮事件
浅谈Javascript鼠标和滚轮事件,鼠标事件也许是web页面当中最常用到的事件，因为鼠标是最常用的导航设备
2012-06-06
浅析JavaScript 调试方法和技巧
本文给大家浅析javascript调试方法和技巧，涉及到javascript调试方法和技巧方面的知识，本文介绍的非常详细，非常具有参考借鉴介绍，感兴趣的朋友一起看看吧
2015-10-10
js获取图片的base64编码并压缩
这篇文章主要介绍了js获取图片的base64编码并压缩，帮助大家更好的理解和使用js，感兴趣的朋友可以了解下
2020-12-12