全局配置 ​

errorHandleByCode: (code: number, errMsg?: string) => {
    // console.log(`【Request Debug:配置】${code}`);
    if (code === 401) {
        // 一般为未登录状态，可在这里统一跳转登录页面
        console.log('401拦截演示');
        // 此处仅为演示
        msg({ title: errMsg || '未登录，请先登录' });
    } else if (code === 403) {
        // 一般为token过期，可在这里清除token并跳转登录页面处理
        console.log('403拦截演示');
        // 此处仅为演示
        msg({ title: errMsg || '登录过期，请重新登录' });
    } else if (code === 404) {
        // 请求不存在
        console.log('404拦截演示');
        // 此处仅为演示
        msg({ title: errMsg || '请求资源不存在' });
    } else if (code === 500) {
        console.log('500拦截演示');
        msg({ title: errMsg || '接口返回错误500' });
    } else if (code === 502) {
        console.log('500拦截演示');
    } else if (code === 503) {
        console.log('503拦截演示');
    } else if (code !== 200) {
        console.log('自定义错误码拦截演示');
        msg({ title: '请求服务异常' });
    }
}

interface Data {
    code: number;
}
apiErrorInterception: (data: Data, args?: UniApp.RequestSuccessCallbackResult) => {
    if (data.code !== 1) {
        msg({ title: '请求失败' });
    }
}

tokenValue: () => {
    return new Promise((resolve, _) => {
        try {
            // getToken 为获取token的示例方法，请根据自己的实际业务灵活修改
            const token = getToken();
            token && resolve(token);
            resolve('');
        } catch (error) {
            resolve(false);
        }
    });
}

import qs from 'qs';
// qs 插件转化示例
buildQueryString: (params?: object) => {
    return qs.stringify(params);
}

{
	baseUrl: {
		/**
         * 开发环境域名
         */
        dev: '',
        /**
         * 生产环境域名
         */
        pro: '',
	},
	/**
     * 调试模式，开启后控制台会显示内部调试打印信息
     */
    debug: false,
    /**
     * 运行环境，有效值：`'h5'`、`'uniapp'`、`'mp-weixin'`，默认为 `'uniapp'`
     * + `h5`: 运行在浏览器环境，使用 [`XMLHttpRequest`](https://developer.mozilla.org/zh-CN/docs/Web/API/XMLHttpRequest) 发送请求
     * + `uniapp`: 运行在uniapp环境，使用 [`uni.request`](https://uniapp.dcloud.net.cn/api/request/request.html) 发送请求
     * + `mp-weixin`: 运行在微信小程序环境，使用 [`wx.request`](https://developers.weixin.qq.com/miniprogram/dev/api/network/request/wx.request.html) 发送请求
     * + `1.7.0` 及以上版本支持
     */
    env: 'uniapp',
	/**
     * 请求过程是否显示loading
     */
    loading: true,
	/**
     * 请求中loading弹窗的提示文本，默认为 `'请求中...'`
     */
    loadingText: '请求中...',
    /**
     * 自定义请求前拦截
     * + `1.3.12` 及以上版本支持。
     */
    before: () => {};
    /**
     * 自定义请求后拦截
     * + `1.3.12` 及以上版本支持。
     */
    after: () => {};
	// 下面配置项参考 [uniapp 网络请求API](https://uniapp.dcloud.io/api/request/request.html)
    /**
     * 自定义请求头信息
     * + `1.3.12` 及以上版本支持。
     */
    header: {};
	/**
     * 请求超时时间，单位ms
     */
    timeout: 6000,
	/**
     * 请求方式，有效值：`'GET'`、`'POST'`、`'PUT'`、`'DELETE'`、`'CONNECT'`、`'HEAD'`、`'OPTIONS'`、`'TRACE'`
     */
    method: 'GET',
	/**
     * 如果设为 json，会对返回的数据进行一次 JSON.parse，非 json 不会进行 JSON.parse
     */
    dataType: 'json',
	/**
     * 设置响应的数据类型。合法值：`text`、`arraybuffer`
     */
    responseType: 'text',
	/**
     * 验证 ssl 证书
     */
    sslVerify: true,
	/**
     * 跨域请求时是否携带凭证（cookies）
     */
    withCredentials: false,
	/**
     * DNS解析时优先使用ipv4
     */
    firstIpv4: false,
	/**
     * 业务错误代码拦截处理程序，请根据业务实际情况灵活设置
     * + `reject` 参数可以自定义抛出异常，需要 `v1.8.2` 及以上版本支持
     * @param code 
     * @param errMsg 
     * @returns 
     */
    errorHandleByCode: (code: number, errMsg?: string, reject?: (reason?: any) => void) => {},
    /**
     * API错误拦截处理程序，请根据业务实际情况灵活设置
     * + `1.1.0` 及以上版本支持
     * + `reject` 参数可以自定义抛出异常，需要 `v1.8.2` 及以上版本支持
     * @param data API返回内容
     * @param args uniapp请求API回调结果
     */
    apiErrorInterception: (data: any, args?: UniApp.RequestSuccessCallbackResult, reject?: (reason?: any) => void) => {},
	/**
     * 网络异常或者断网处理程序，建议更新缓存中是否断网或者网络繁忙的标识以便前端页面展示没有网络或者断网的通用异常页面
     * @returns
     */
    networkExceptionHandle: () => {},
    /**
     * API成功状态码
     * + `1.2.0` 及以上版本支持
     * + 设置该参数后，API业务失败时将直接抛出异常，开发者需要在 `catch` 中捕获API返回的错误信息，或者在 `apiErrorInterception` 中统一捕获API返回的错误信息
     */
    xhrCode: 0,
    /**
     * 语义化接口响应状态码字段名称，默认为 `code`
     * + `1.2.0` 及以上版本支持
     */
    xhrCodeName: 'code',
	/**
     * 请求成功时接口响应描述信息字段名称，默认为 `'msg'`
     */
    requestSuccessResponseMsgName: 'msg',
	/**
     * 缓存中token字段名称，方便请求库从缓存获取token完成自动填充token
     */
    tokenStorageKeyName: '',
    /**
     * 自定义获取task_id处理程序，通过promise返回最新task_id值即可
     * + `1.5.11` 及以上版本支持
     */
    taskIdValue: undefined,
    /**
     * 自定义获取token处理程序，通过promise返回最新token值即可
     * + `1.0.2` 及以上版本支持
     * @returns 
     * @example
     * ```ts
     * tokenValue: () => {
     *      return new Promise((resolve, _) => {
     *          // 获取最新token演示
     *          const token = getToken();
     *          token && resolve(token);
     *      });
     * }
     * ```
     */
    tokenValue: undefined,
    /**
     * 自定义构建URL参数方式，即用什么方式把请求的params对象数据转为`a=1&b=2`的格式，默认使用NodeJS内置对象 `URLSearchParams` 转化，可以自定义通过 `qs` 插件的方式转化
     * + `1.0.2` 及以上版本支持
     * 
     * @example
     * ```ts
     * // qs 插件转化示例
     * import qs from 'qs';
     * 
     * return qs.stringify(obj);
     * ```
     */
    buildQueryString: undefined,
	/**
     * 请求携带token的方式，有效值：`header`、`body`
     */
    takeTokenMethod: 'header',
	/**
     * 请求携带token的字段名称，header方式默认为 `Authorization`
     */
    takenTokenKeyName: 'Authorization',
	/**
     * 是否自动刷新token
     */
    autoRefreshToken: false,
	/**
     * 自动刷新token程序，返回promise，`autoRefreshToken` 为 `true`时生效
     */
    refreshTokenHandle: () => {},
	/**
     * 自定义token失效的错误代码，便于请求库内部做自动刷新token判断
     */
    tokenExpiredCode: 403,
    /**
     * token失效错误代码类型，支持 `httpStatusCode` 和 `apiResponseCode`，默认为 `httpStatusCode`
     * + `httpStatusCode`: 原生http请求状态码
     * + `apiResponseCode`: 接口响应错误码
     * 
     * + `1.5.11` 及以上版本支持
     */
    tokenExpiredCodeType: 'httpStatusCode',
	/**
     * 请求失败是否自动重试
     */
    retry: false,
	/**
     * 请求失败自动重试次数
     */
    retryCount: 3,
	/**
     * 请求失败重试次数是否自动计算，失败重试次数上限依然是设置的retryCount值
     */
    retryCountAutoOffRetry: true,
	/**
     * 请求失败用来生成重试时间上限（指数退避算法需要），单位秒
     */
    retryMaximum: 64,
	/**
     * 请求失败执行重试时间上限（指数退避算法需要），达到上限后不再重试
     */
    retryDeadline: 10000,
    /**
     * `loading` 动画请求多久后开始展示，单位毫秒，默认值 0
     * + 仅支持请求库默认动画
     * + `1.7.0` 及以上版本支持
     */
    loadingStartTime: 0;
}