文件
fenleixinxi/uniapp/common/utils/request.js
MiAn c2e0f72b30 feat: 新增分类页面与规范化顶部导航栏组件
新增分类页面及图标资源,完善底部导航分类 tab,新增 navbar 度量工具适配不同设备,优化请求参数处理,修复通知相关显示问题,统一顶部导航栏样式以适配系统状态栏与胶囊避让。
2026-10-20 11:02:42 +08:00

170 行
5.7 KiB
JavaScript

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

/**
* 全链路统一请求层
* - 统一拼接 baseURL / 版本号
* - 自动注入 token
* - 统一响应结构解包:{ code, message, data }
* - 401 自动清理登录态并跳转登录
* - 支持 mock 降级(无后端 / 联调前)
*
* 该文件为纯 ES Module,Node 测试脚本可直接 import(需先注入 globalThis.uni)。
*/
import config from '../config/index.js'
import storage from './storage.js'
import { matchMock } from '../mock/index.js'
// 便于测试注入的运行时环境(默认使用全局 uni)
export function getRuntime() {
return {
request: typeof uni !== 'undefined' && uni.request ? uni.request.bind(uni) : null,
showToast: typeof uni !== 'undefined' && uni.showToast ? uni.showToast.bind(uni) : () => {},
navigateTo: typeof uni !== 'undefined' && uni.navigateTo ? uni.navigateTo.bind(uni) : () => {},
showLoading: typeof uni !== 'undefined' && uni.showLoading ? uni.showLoading.bind(uni) : () => {},
hideLoading: typeof uni !== 'undefined' && uni.hideLoading ? uni.hideLoading.bind(uni) : () => {},
}
}
/** 拼接完整地址 */
export function buildUrl(url) {
if (/^https?:\/\//i.test(url)) return url
const path = url.startsWith('/') ? url : `/${url}`
return `${config.baseURL}/${config.apiVersion}${path}`
}
/** 组装请求头 */
export function buildHeaders(extra = {}) {
const token = storage.get(config.storageKeys.token, '')
const headers = {
'Content-Type': 'application/json;charset=UTF-8',
'X-Client': 'fenleixinxi',
...extra,
}
if (token) headers.Authorization = `Bearer ${token}`
return headers
}
/**
* 底层请求(返回 Promise<data>)
* @param {Object} options { url, method, data, header, silent, mock }
*/
/**
* 清理请求参数中 undefined / null / 空串 的无效字段
* 防止在微信小程序等环境下 GET 请求被底层错误序列化为 "key=undefined"
* @param {Object} data 原始请求参数
* @returns {Object} 清理后的参数
*/
export function cleanParams(data) {
if (!data || typeof data !== 'object' || Array.isArray(data)) return data
const cleaned = {}
for (const key of Object.keys(data)) {
const val = data[key]
if (val !== undefined && val !== null && val !== '') {
cleaned[key] = val
}
}
return cleaned
}
export function request(options = {}) {
const {
url,
method = 'GET',
data = {},
header = {},
silent = false, // 失败是否静默(不弹 toast)
mock = config.forceMock, // 强制走 mock
} = options
const requestData = String(method).toUpperCase() === 'GET' ? cleanParams(data) : data
const runtime = getRuntime()
const finalUrl = buildUrl(url)
const headers = buildHeaders(header)
const doMock = () =>
matchMock({ url, method: method.toUpperCase(), data }).then((res) => res)
// 强制 mock 或运行环境无 uni.request
if (mock || !runtime.request) {
return doMock()
}
return new Promise((resolve, reject) => {
runtime.request({
url: finalUrl,
method: method.toUpperCase(),
data: requestData,
header: headers,
timeout: config.timeout,
success(res) {
// HTTP 层
if (res.statusCode === 401) {
onUnauthorized(runtime)
return reject(toErr('登录已过期,请重新登录', 401))
}
if (res.statusCode < 200 || res.statusCode >= 300) {
return handleFail(
{ message: `网络异常(${res.statusCode})`, statusCode: res.statusCode },
{ url, method, data, silent, runtime, resolve, reject }
)
}
const body = res.data || {}
// 业务层:约定 code===0 或 code===200 为成功
if (body.code === 0 || body.code === 200) {
resolve(body.data !== undefined ? body.data : body)
} else {
const err = toErr(body.message || body.msg || '请求失败', body.code)
if (!silent) runtime.showToast({ title: err.message, icon: 'none' })
reject(err)
}
},
fail(err) {
handleFail(err, { url, method, data, silent, runtime, resolve, reject })
},
})
})
}
/**
* 失败处理:
* 1) 若开启 mock 降级,则使用本地 mock 路由兜底(保证离线可演示)
* 2) 否则抛出异常
*/
function handleFail(err, ctx) {
const { url, method, data, silent, runtime, resolve, reject } = ctx
if (config.enableMockFallback) {
// 尝试用本地 mock 路由兜底(离线可演示;无匹配路由时 mock 会 reject)
matchMock({ url, method: String(method).toUpperCase(), data })
.then(resolve)
.catch(() => {
const e = toErr(err && (err.errMsg || err.message) ? err.errMsg || err.message : '网络请求失败')
if (!silent) runtime.showToast({ title: e.message, icon: 'none' })
reject(e)
})
return
}
const e = toErr(err && (err.errMsg || err.message) ? err.errMsg || err.message : '网络请求失败')
if (!silent) runtime.showToast({ title: e.message, icon: 'none' })
reject(e)
}
/** 401 处理 */
function onUnauthorized(runtime) {
storage.remove(config.storageKeys.token)
storage.remove(config.storageKeys.userInfo)
runtime.showToast({ title: '登录已过期', icon: 'none' })
runtime.navigateTo({ url: '/pages/auth/login' })
}
function toErr(message, code = -1) {
const e = new Error(message)
e.code = code
return e
}
/** 语法糖 */
export const get = (url, data, opts = {}) => request({ url, method: 'GET', data, ...opts })
export const post = (url, data, opts = {}) => request({ url, method: 'POST', data, ...opts })
export const put = (url, data, opts = {}) => request({ url, method: 'PUT', data, ...opts })
export const del = (url, data, opts = {}) => request({ url, method: 'DELETE', data, ...opts })
export default request