91 lines
2.2 KiB
TypeScript
91 lines
2.2 KiB
TypeScript
import type { ICommonResponse } from "#shared/types";
|
|
|
|
/**
|
|
* 构造统一成功响应。
|
|
*
|
|
* @param data 要返回给前端的数据，没有数据时传 null
|
|
* @param msg 提示信息，默认“请求成功”
|
|
* @returns 符合 ICommonResponse 格式的对象，code 固定为 0
|
|
*/
|
|
export const createSuccessResponse = <T>(
|
|
data: T | null = null,
|
|
msg: string = "请求成功"
|
|
): ICommonResponse<T> => {
|
|
return {
|
|
code: 0,
|
|
data,
|
|
msg
|
|
};
|
|
};
|
|
|
|
/**
|
|
* 构造统一错误响应。
|
|
*
|
|
* @param code 错误码，默认 400；上游错误时传上游状态码
|
|
* @param msg 错误描述，展示给前端的提示文案
|
|
* @param data 附带的错误详情，通常是上游返回的原始响应体
|
|
* @returns 符合 ICommonResponse 格式的错误响应
|
|
*/
|
|
export const createErrorResponse = (
|
|
code: number = 400,
|
|
msg: string = "请求失败",
|
|
data: unknown = null
|
|
): ICommonResponse => {
|
|
return {
|
|
code,
|
|
data,
|
|
msg
|
|
};
|
|
};
|
|
|
|
/**
|
|
* 将上游请求错误转换为统一响应。
|
|
*
|
|
* @param error ofetch 抛出的错误对象
|
|
* @param fallbackMessage 当上游没有提供可用错误信息时的兜底提示
|
|
* @returns 符合 ICommonResponse 格式的错误响应
|
|
*/
|
|
export const createUpstreamErrorResponse = (
|
|
error: unknown,
|
|
fallbackMessage: string = "请求失败"
|
|
): ICommonResponse => {
|
|
const fetchError = error as {
|
|
data?: unknown;
|
|
message?: string;
|
|
response?: {
|
|
_data?: unknown;
|
|
status?: number;
|
|
};
|
|
statusCode?: number;
|
|
};
|
|
|
|
const errorData = fetchError.data ?? fetchError.response?._data ?? null;
|
|
const errorMessage =
|
|
typeof errorData === "string"
|
|
? errorData
|
|
: fetchError.message || fallbackMessage;
|
|
|
|
return createErrorResponse(
|
|
fetchError.statusCode ?? fetchError.response?.status ?? 500,
|
|
errorMessage,
|
|
errorData
|
|
);
|
|
};
|
|
|
|
/** 判断上游或本地鉴权错误是否为 401，用于统一清理失效登录态 */
|
|
export const isUnauthorizedError = (error: unknown): boolean => {
|
|
const fetchError = error as {
|
|
response?: {
|
|
status?: number;
|
|
};
|
|
status?: number;
|
|
statusCode?: number;
|
|
};
|
|
|
|
return (
|
|
fetchError.statusCode === 401 ||
|
|
fetchError.status === 401 ||
|
|
fetchError.response?.status === 401
|
|
);
|
|
};
|