a45162c62a
401 统一跳 /login 并携带目标路径;新增纯函数守卫 isLoginLocation/ isAuthEndpointRequest/shouldRedirectUnauthorized:已处登录页或失败请求即 登录端点时不再二次跳转,避免登录页死循环与吞掉登录失败反馈。http 层 success/error 两支均带失败请求 URL 过守卫后再跳转。envelope/http 单测 8 用例 + 全量 179 单测 + vue-tsc/vite build 通过。
96 lines
3.8 KiB
TypeScript
96 lines
3.8 KiB
TypeScript
/** API 响应解包与错误归一化(任务 22):纯函数,无框架依赖。 */
|
||
|
||
export const REQUEST_FALLBACK_MESSAGE = '网络异常,请稍后重试'
|
||
|
||
function textOf(value: Record<string, unknown>): string {
|
||
const message = value.message
|
||
const error = value.error
|
||
if (typeof message === 'string' && message.trim()) return message.trim()
|
||
if (typeof error === 'string' && error.trim()) return error.trim()
|
||
return ''
|
||
}
|
||
|
||
/**
|
||
* 统一解包 Java 响应:
|
||
* - success=false -> 抛错(取 message/error,空则“请求失败”);
|
||
* - 带非空 data -> 返回 data;
|
||
* - 否则原样返回(允许 {item}/{items} 等信封由调用方再解)。
|
||
*/
|
||
export function unwrap<T>(payload: unknown): T {
|
||
const value = payload as Record<string, unknown> | null
|
||
if (!value || typeof value !== 'object') return payload as T
|
||
if (value.success === false) {
|
||
throw new Error(textOf(value) || '请求失败')
|
||
}
|
||
if ('data' in value && value.data !== null && value.data !== undefined) {
|
||
return value.data as T
|
||
}
|
||
return payload as T
|
||
}
|
||
|
||
/** 从任意负载取错误文案;缺省回退。 */
|
||
export function errorTextOf(payload: unknown): string {
|
||
if (payload instanceof Error) return payload.message.trim() || REQUEST_FALLBACK_MESSAGE
|
||
if (payload && typeof payload === 'object') {
|
||
const text = textOf(payload as Record<string, unknown>)
|
||
if (text) return text
|
||
}
|
||
if (typeof payload === 'string' && payload.trim()) return payload.trim()
|
||
return REQUEST_FALLBACK_MESSAGE
|
||
}
|
||
|
||
/** 负载/状态码是否 401(未登录)。 */
|
||
export function isUnauthorized(payload: unknown): boolean {
|
||
const record = payload as { status?: unknown; statusCode?: unknown; code?: unknown } | null
|
||
if (!record || typeof record !== 'object') return false
|
||
return [record.status, record.statusCode, record.code].some((v) => v === 401)
|
||
}
|
||
|
||
/** Axios 错误(带 response)或普通 Error 统一取可展示文案。 */
|
||
export function requestErrorMessage(error: unknown): string {
|
||
const response = (error as { response?: { data?: unknown; status?: number } })?.response
|
||
if (response) {
|
||
const text = errorTextOf(response.data)
|
||
if (text) return text
|
||
}
|
||
return errorTextOf(error)
|
||
}
|
||
|
||
/** 当前地址作为登录跳转的 redirect 参数(encodeURIComponent 后)。 */
|
||
export function loginRedirectTarget(location: { pathname: string; search: string }): string {
|
||
return encodeURIComponent(`${location.pathname}${location.search}`)
|
||
}
|
||
|
||
/** 登录页统一入口;401 一律跳此路径。 */
|
||
export const LOGIN_PATH = '/login'
|
||
|
||
/** 当前 pathname 是否处于登录页(去掉可能携带的查询串后比较)。 */
|
||
export function isLoginLocation(pathname: string): boolean {
|
||
if (typeof pathname !== 'string') return false
|
||
const queryAt = pathname.indexOf('?')
|
||
return (queryAt >= 0 ? pathname.slice(0, queryAt) : pathname) === LOGIN_PATH
|
||
}
|
||
|
||
/** 把请求 URL(相对或绝对)规整为相对路径,便于与登录入口比较。 */
|
||
export function requestRelativePath(url: string): string {
|
||
if (typeof url !== 'string') return ''
|
||
const noQuery = url.split('?')[0]
|
||
const match = noQuery.match(/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\/[^/]+(.*)$/)
|
||
return match ? match[1] : noQuery
|
||
}
|
||
|
||
/** 401 失败请求本身是否指向登录/认证端点(登录提交失败不应再被踢回登录页)。 */
|
||
export function isAuthEndpointRequest(url: string | undefined): boolean {
|
||
return requestRelativePath(url || '') === LOGIN_PATH
|
||
}
|
||
|
||
/**
|
||
* 401 是否应执行“跳 /login”:已处于登录页或失败请求即登录端点时不应再跳,
|
||
* 否则会在登录页循环跳转或吞掉登录失败反馈。
|
||
*/
|
||
export function shouldRedirectUnauthorized(currentPathname: string, requestUrl?: string): boolean {
|
||
if (isLoginLocation(currentPathname)) return false
|
||
if (isAuthEndpointRequest(requestUrl)) return false
|
||
return true
|
||
}
|