当前位置: 首页 > 文档资料 > Fes.js 开发文档 >

@fesjs/plugin-request

优质
小牛编辑
134浏览
2023-12-01

基于 axios 封装的 request,内置防止重复请求、请求节流、错误处理等功能。

启用方式

package.json 中引入依赖:

{
    "dependencies": {
        "@fesjs/fes": "^2.0.0",
        "@fesjs/plugin-request": "^2.0.0"
    },
}

配置

构建时配置

export default {
    request: {
        dataField: 'result'
    },
}

dataField

  • 类型: string

  • 默认值: ''

  • 详情:

    dataField 对应接口统一格式中的数据字段,比如接口如果统一的规范是 { success: boolean, result: any} ,那么就不需要配置,这样你通过 useRequest 消费的时候会生成一个默认的 formatResult,直接返回 result 中的数据,方便使用。如果你的后端接口不符合这个规范,可以自行配置 dataField。配置为 ''(空字符串)的时候不做处理。

base(即将废弃)

  • 类型: string

  • 默认值: ''

  • 详情:

    base 接口前缀。

⚠️警告,这个字段将在下个版本废弃,推荐使用 axios baseURL在新窗口打开

运行时配置

app.js 中进行运行时配置。

export const request = {
    // 格式化 response.data (只有 response.data 类型为 object 才会调用)
    responseDataAdaptor: (data) => {

    },
    // 关闭 response data 校验(只判断 xhr status)
    closeResDataCheck: false,
    // 请求拦截器
    requestInterceptors: [],
    // 相应拦截器
    responseInterceptors: [],
    // 错误处理
    // 内部以 reponse.data.code === '0' 判断请求是否成功
    // 若使用其他字段判断,可以使用 responseDataAdaptor 对响应数据进行格式
    errorHandler: {
        11199(response) {
            // 特殊 code 处理逻辑
        },
        404(error) {
        },
        default(error) {
            // 异常统一处理
        }
    },
    // 其他 axios 配置
    ...otherConfigs
}

skipErrorHandler

  • 类型: boolean | string | number | array<string | number>

  • 默认值: ``

  • 详情:

    指定当前请求的某些错误状态不走 errorHandler,单独进行处理。如果设置为 true,当前请求的错误处理都不走 errorHandler

  • 示列:

import {request} from '@fesjs/fes';

request('/api/login', null, {
    skipErrorHandler: '110'
}).then((res) => {
    // do something
}).catch((err) => {
    // 这里处理 code 为 110 的异常
    // 此时 errorHandler[110] 函数不会生效,也不会执行 errorHandler.default
})

使用

发起一个普通 post 请求

import {request} from '@fesjs/fes';

request('/api/login', {
    username: 'robby',
    password: '123456'
}).then((res) => {
    // do something
}).catch((err) => {
    // 处理异常
})

merge 重复请求

连续发送多个请求,会被合并成一个请求,不会报 REPEAT 接口错误。

当发生 REPEAT 请求异常,并且确保自身代码合理的情况下,可以使用该配置。

import {request} from '@fesjs/fes';

request('/api/login', {
    username: 'robby',
    password: '123456'
}, {
    mergeRequest: true, // 在一个请求没有回来前,重复发送的请求会合并成一个请求
}).then((res) => {
    // do something
}).catch((err) => {
    // 处理异常
})

请求节流

import {request} from '@fesjs/fes';

request('/api/login', {
    username: 'robby',
    password: '123456'
}, {
    throttle: 1000, // 1 秒内只能发起一次请求
}).then((res) => {
    // do something
}).catch((err) => {
    // 处理异常
})

请求缓存

import {request} from '@fesjs/fes';

request('/api/login', {
    username: 'robby',
    password: '123456'
}, {
    cache: {
        cacheType: 'ram', // ram: 内存,session: sessionStorage,local:localStorage
        cacheTime: 1000 * 60 * 3 // 缓存时间:默认3min
    },
}).then((res) => {
    // do something
}).catch((err) => {
    // 处理异常
})

cachetrue,则默认使用 ram 缓存类型,缓存时间 3min。

结合 use 使用

import {useRequest} from '@fesjs/fes';


export default {
    setup() {
        const {loading, data, error} = useRequest('/api/login', {
            username: 'robby',
            password: '123456'
        })

        return {
            loading,
            data,
            error
        }
    }
}

API

request

  • 类型:函数

  • 详情:请求后端接口

  • 参数

    • url: 后端接口 url
    • data: 参数
    • options: 配置( 支持 axios 所有配置)
  • 返回值: Promise

useRequest

request 的封装,返回响应式 loadingerrordata