/** * 请求层(全链路统一网关)测试 * 覆盖:URL 拼接 / 鉴权头 / 业务码解包 / 401 / 网络异常 / mock 降级 */ import { describe, it, expect, expectReject } from './harness.mjs' import config from '../common/config/index.js' import storage from '../common/utils/storage.js' import request, { get, post, buildUrl, buildHeaders, getRuntime } from '../common/utils/request.js' /** 构造一个可控的 uni 运行时 */ function installUni(handler) { const calls = { toasts: [], navigations: [], requests: [] } globalThis.uni = { request(opts) { calls.requests.push(opts) handler(opts, calls) }, showToast(o) { calls.toasts.push(o) }, navigateTo(o) { calls.navigations.push(o) }, getStorageSync: () => '', setStorageSync: () => {}, removeStorageSync: () => {}, } return calls } function clearUni() { delete globalThis.uni } describe('请求层 · 基础能力', () => { it('buildUrl 拼接版本号与网关地址', () => { expect(buildUrl('/home/feed')).toBe(`${config.baseURL}/${config.apiVersion}/home/feed`) expect(buildUrl('post/create')).toContain('/v1/post/create') expect(buildUrl('https://a.com/x')).toBe('https://a.com/x') }) it('buildHeaders 注入 token 与客户端标识', () => { storage.clear() storage.set(config.storageKeys.token, 'T-123') const h = buildHeaders() expect(h.Authorization).toBe('Bearer T-123') expect(h['X-Client']).toBe('fenleixinxi') storage.remove(config.storageKeys.token) expect(buildHeaders().Authorization).toBeFalsy() }) it('无 uni.request 时自动走 mock(离线可运行)', async () => { clearUni() const data = await get('/home/categories') expect(data).toBeArray() expect(data.length).toBeGreaterThan(0) }) }) describe('请求层 · 真实 HTTP 通道', () => { it('业务码 0 时返回 data 字段', async () => { const calls = installUni((opts) => { opts.success({ statusCode: 200, data: { code: 0, message: 'ok', data: { total: 7 } } }) }) const res = await get('/home/feed', { page: 1 }) expect(res.total).toBe(7) expect(calls.requests[0].url).toContain('/v1/home/feed') clearUni() }) it('业务码非 0 时 reject 并 toast 提示', async () => { const calls = installUni((opts) => { opts.success({ statusCode: 200, data: { code: 1001, message: '参数错误' } }) }) await expectReject(() => post('/post/create', { title: '' }), '参数错误') expect(calls.toasts[0].title).toBe('参数错误') clearUni() }) it('HTTP 401 清空登录态并跳转登录页', async () => { storage.set(config.storageKeys.token, 'EXPIRED') const calls = installUni((opts) => opts.success({ statusCode: 401, data: {} })) await expectReject(() => get('/auth/profile'), '登录已过期') expect(storage.get(config.storageKeys.token, '')).toBe('') expect(calls.navigations[0].url).toBe('/pages/auth/login') clearUni() }) it('显式开启 enableMockFallback 时,网络异常且存在 mock 路由则自动降级', async () => { const saved = config.enableMockFallback config.enableMockFallback = true const calls = installUni((opts) => opts.fail({ errMsg: 'request:fail timeout' })) const res = await get('/member/plans') expect(res).toBeArray() expect(res[0].planId).toBeDefined() clearUni() config.enableMockFallback = saved }) // 生产配置下必须关闭降级:否则真实接口失败会静默返回 mock 假数据, // 表现为「后台改了但前端不变」,且真实问题被完全掩盖。 it('生产配置(enableMockFallback=false)网络异常时不静默返回 mock 数据', async () => { expect(config.forceMock).toBe(false) expect(config.enableMockFallback).toBe(false) installUni((opts) => opts.fail({ errMsg: 'request:fail timeout' })) await expectReject(() => get('/member/plans'), 'request:fail') clearUni() }) it('网络异常且无 mock 路由时抛出异常', async () => { installUni((opts) => opts.fail({ errMsg: 'request:fail' })) await expectReject(() => get('/not/exist/endpoint'), 'request:fail') clearUni() }) it('getRuntime 在无 uni 环境返回安全降级函数', () => { clearUni() const rt = getRuntime() expect(rt.request).toBe(null) rt.showToast({ title: 'x' }) // 不应抛错 }) }) describe('请求层 · mock 强制模式', () => { it('mock:true 时绕过网络直接返回 mock 数据', async () => { const calls = installUni(() => { throw new Error('不应发起真实请求') }) const res = await request({ url: '/home/banners', mock: true }) expect(res).toBeArray() expect(calls.requests).toHaveLength(0) clearUni() }) })