101 lines
2.7 KiB
TypeScript
101 lines
2.7 KiB
TypeScript
/**
|
||
* API 工具函数
|
||
*
|
||
* 统一处理 API 请求和错误响应
|
||
* 提供类型安全的API请求封装
|
||
* 包括：错误响应解析、成功响应解析、统一请求函数、错误消息获取
|
||
*
|
||
* @created 2025-01-XX（从各组件提取）
|
||
* @utils
|
||
*/
|
||
|
||
import type { ApiErrorResponse, ApiSuccessResponse } from '../_components/types'
|
||
|
||
/**
|
||
* 安全地解析 API 错误响应
|
||
* @param response - fetch Response 对象
|
||
* @returns Promise<ApiErrorResponse>
|
||
*/
|
||
export async function parseErrorResponse(response: Response): Promise<ApiErrorResponse> {
|
||
try {
|
||
const data = await response.json()
|
||
return (data as ApiErrorResponse) || { error: '请求失败' }
|
||
} catch {
|
||
// 如果响应不是 JSON，返回默认错误
|
||
return { error: `HTTP ${response.status}: ${response.statusText || '请求失败'}` }
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 安全地解析 API 成功响应
|
||
* @param response - fetch Response 对象
|
||
* @returns Promise<T>
|
||
*/
|
||
export async function parseSuccessResponse<T = unknown>(response: Response): Promise<T> {
|
||
const data = await response.json()
|
||
return data as T
|
||
}
|
||
|
||
/**
|
||
* 统一的 API 请求函数，自动处理错误
|
||
* @param url - API 端点
|
||
* @param options - fetch 选项
|
||
* @returns Promise<{ success: true; data: T } | { success: false; error: string }>
|
||
*/
|
||
export async function apiRequest<T = unknown>(
|
||
url: string,
|
||
options?: RequestInit
|
||
): Promise<{ success: true; data: T } | { success: false; error: string }> {
|
||
try {
|
||
const response = await fetch(url, options)
|
||
|
||
if (!response.ok) {
|
||
const errorData = await parseErrorResponse(response)
|
||
return {
|
||
success: false,
|
||
error: errorData.error || `HTTP ${response.status}: ${response.statusText || '请求失败'}`,
|
||
}
|
||
}
|
||
|
||
const data = await parseSuccessResponse<T>(response)
|
||
return {
|
||
success: true,
|
||
data,
|
||
}
|
||
} catch (error) {
|
||
console.error('API request error:', error)
|
||
const errorMessage = error instanceof Error ? error.message : '网络请求失败，请稍后重试'
|
||
return {
|
||
success: false,
|
||
error: errorMessage,
|
||
}
|
||
}
|
||
}
|
||
|
||
/**
|
||
* 获取错误消息的辅助函数
|
||
* @param error - 错误对象或错误响应
|
||
* @param defaultMessage - 默认错误消息
|
||
* @returns 错误消息字符串
|
||
*/
|
||
export function getErrorMessage(
|
||
error: unknown,
|
||
defaultMessage: string = '操作失败'
|
||
): string {
|
||
if (typeof error === 'string') {
|
||
return error
|
||
}
|
||
|
||
if (error instanceof Error) {
|
||
return error.message || defaultMessage
|
||
}
|
||
|
||
if (error && typeof error === 'object' && 'error' in error) {
|
||
const apiError = error as ApiErrorResponse
|
||
return apiError.error || defaultMessage
|
||
}
|
||
|
||
return defaultMessage
|
||
}
|
||
|