gd-web-core 0.0.16 → 0.0.18

package/docs/utils/request.md

@@ -54,6 +54,8 @@ interface RequestOptions {
   transformResponse?: (res: ResponseData, config: RequestConfig) => any  // 自定义响应处理
   useAuthToken?: boolean                                // 是否启用 Authorization token
   getToken?: () => string | null                        // 获取 token 的函数
+  authTokenHeader?: string                               // 自定义 Authorization header 名称，默认 `Authorization`
+  authTokenFormat?: (token: string) => string            // 自定义 Authorization 格式
 }
 ```
 
@@ -86,6 +88,36 @@ configureRequest({
   useAuthToken: true,
   getToken: () => localStorage.getItem('token')
 })
+
+// 自定义 Authorization header 名称
+configureRequest({
+  useAuthToken: true,
+  authTokenHeader: 'QSS-Authorization' // 自定义 header 名称
+})
+
+// 自定义 Authorization 格式
+configureRequest({
+  useAuthToken: true,
+  authTokenFormat: (token) => `Bearer ${token}` // 默认格式
+})
+
+// 其他格式示例
+configureRequest({
+  useAuthToken: true,
+  authTokenFormat: (token) => `QSS ${token}` // 自定义前缀
+})
+
+configureRequest({
+  useAuthToken: true,
+  authTokenFormat: (token) => token // 无前缀
+})
+
+// 同时自定义 header 名称和格式
+configureRequest({
+  useAuthToken: true,
+  authTokenHeader: 'X-Auth-Token',
+  authTokenFormat: (token) => `${token}`
+})
 ```
 
 ---
@@ -152,7 +184,7 @@ const data = await request.get('/api/users', {
 1. **请求拦截器**
    - 自动显示 loading（可通过 `hideLoading: true` 禁用）
    - 自动添加时间戳参数 `_t` 防止缓存
-   - 自动添加 Authorization token（当配置 `useAuthToken: true` 时）
+   - 自动添加 Authorization token（当配置 `useAuthToken: true` 时，可通过 `authTokenFormat` 自定义格式）
 
 2. **响应拦截器**
    - 自动移除 pending

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gd-web-core",
-  "version": "0.0.16",
+  "version": "0.0.18",
   "description": "Vue 3 基座能力封装库 - 组件与工具函数",
   "type": "module",
   "files": [

package/src/utils/request.ts

@@ -12,7 +12,7 @@ export interface RequestConfig extends AxiosRequestConfig {
   hideErrMsg?: boolean;
   /** 是否隐藏 loading */
   hideLoading?: boolean;
-  useToken?: boolean;
+  useToken?: string;
 }
 
 // 定义通用的响应结构
@@ -62,6 +62,10 @@ export interface RequestOptions {
   useAuthToken?: boolean;
   /** 获取 token 的函数，默认从 localStorage 获取 */
   getToken?: () => string | null;
+  /** 自定义 Authorization header 名称，默认 `Authorization` */
+  authTokenHeader?: string;
+  /** 自定义 Authorization 格式，默认 `Bearer ${token}` */
+  authTokenFormat?: (token: string) => string;
 }
 
 interface CustomAxiosInstance extends AxiosInstance {
@@ -199,7 +203,9 @@ request.interceptors.request.use(
         if (!config.headers) {
           config.headers = {} as any;
         }
-        (config.headers as any).Authorization = `Bearer ${token}`;
+        const headerName = globalOptions.authTokenHeader || 'Authorization';
+        const format = globalOptions.authTokenFormat || ((t: string) => `Bearer ${t}`);
+        (config.headers as any)[headerName] = format(token);
       }
     }