feat: UI

wupengfei

2025-05-22 758d8056dc3dbc6bf92c298aa3627e66b933b5a0

 apps/h5/src/utils/request/index.ts

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,303 @@
import { type IRequestOptions, BoleRequest, type RequestConfig } from '@bole-core/core';
import { type AxiosRequestConfig, type AxiosError } from 'axios';
import qs from 'qs';
import NProgress from '../progress';
import { loadEnv } from '@build/index';
import { getToken, getUserInfo } from '../storage';
import { useUserStoreHook } from '@/store/modules/user';
import { ElLoading as Loading, ElNotification } from 'element-plus';
import { router } from '@/router';
import { Message, tokenIsExpired } from '@/utils';

// åŠ è½½çŽ¯å¢ƒå˜é‡ VITE_PROXY_DOMAIN（开发环境）  VITE_PROXY_DOMAIN_REAL（打包后的线上环境）
const { VITE_PROXY_DOMAIN, VITE_PROXY_DOMAIN_REAL, DEV } = loadEnv();

const RefreshTokenUrl = '/GetTokenByRefreshToken';

/** è¯·æ±‚白名单，放置一些不需要token的接口（通过设置请求白名单，防止token过期后再请求造成的死循环问题） */
const whiteList = [RefreshTokenUrl, '/GetToken'];

let loadingInstance: ReturnType<typeof Loading.service>;

function startLoading() {
  loadingInstance = Loading.service({
    fullscreen: true,
    lock: true,
    background: 'transparent',
  });
}

function endLoading() {
  if (loadingInstance) {
    loadingInstance.close();
  }
}

// é”™è¯¯å¤„理方案： é”™è¯¯ç±»åž‹
enum ErrorShowType {
  /**
   * å•¥ä¹Ÿä¸å¹²
   */
  SILENT = 0,

  WARN_MESSAGE = 1,
  ERROR_MESSAGE = 2,
  /**
   * é€šçŸ¥æŠ¥é”™
   */
  NOTIFICATION = 3,
  /**
   * é‡å®šå‘
   */
  REDIRECT = 9,
}
// ä¸ŽåŽç«¯çº¦å®šçš„响应数据格式
interface ResponseStructure {
  success: boolean;
  data: any;
  /**
   * é”™è¯¯ç 
   */
  error?: number;
  /**
   * é”™è¯¯ä¿¡æ¯
   */
  msg?: string;
  showType?: ErrorShowType;
}

interface ErrorResponse {
  error?: {
    data: any;
    code: number;
    message: string;
  };
}

interface ErrorInfo {
  errorCode?: number;
  errorMessage?: string;
  showType?: ErrorShowType;
  data: any;
}

const AxiosOptions: AxiosRequestConfig = {
  baseURL: DEV ? VITE_PROXY_DOMAIN : VITE_PROXY_DOMAIN_REAL,
  timeout: 30000,
  headers: {
    Accept: 'application/json, text/plain, */*',
    'Content-Type': 'application/json',
    'X-Requested-With': 'XMLHttpRequest',
  },
  // æ•°ç»„格式参数序列化
  paramsSerializer: {
    //@ts-ignore
    serialize: (params) => qs.stringify(params, { indices: false }),
  },
  withCredentials: true,
};

const config: RequestConfig<ResponseStructure, IRequestOptions> = {
  ...AxiosOptions,

  errorConfig: {
    // é”™è¯¯æŽ¥æ”¶åŠå¤„理
    errorHandler: (error, opts) => {
      console.log('error: ', error);
      if (opts?.skipErrorHandler) throw error;

      if (opts?.customErrorHandler) {
        if (opts?.customErrorHandler(error)) {
          return;
        }
      }

      // æˆ‘们的 errorThrower æŠ›å‡ºçš„错误。
      if (error.name === 'BizError') {
        const errorInfo: ErrorInfo | undefined = (error as any).info;
        if (errorInfo) {
          const { errorMessage, errorCode } = errorInfo;
          switch (errorInfo.showType) {
            case ErrorShowType.SILENT:
              // do nothing
              break;
            case ErrorShowType.WARN_MESSAGE:
              Message.warnMessage(errorMessage);
              break;
            case ErrorShowType.ERROR_MESSAGE:
              Message.errorMessage(errorMessage);
              break;
            case ErrorShowType.NOTIFICATION:
              ElNotification.error({
                message: `${errorCode}: ${errorMessage}`,
              });
              break;
            case ErrorShowType.REDIRECT:
              // TODO: redirect
              break;
            default:
              Message.errorMessage(errorMessage);
          }
        }
      } else if ((error as AxiosError<ResponseStructure, IRequestOptions>).response) {
        // Axios çš„错误
        // è¯·æ±‚成功发出且服务器也响应了状态码，但状态代码超出了 2xx çš„范围
        handleAxiosResponseError(error as AxiosError<ErrorResponse, IRequestOptions>);
        // Message.errorMessage(`Response status:${(error as AxiosError).response.status}`);
      } else if ((error as AxiosError).request) {
        // è¯·æ±‚已经成功发起，但没有收到响应
        // \`error.request\` åœ¨æµè§ˆå™¨ä¸­æ˜¯ XMLHttpRequest çš„实例，
        // è€Œåœ¨node.js中是 http.ClientRequest çš„实例
        Message.errorMessage('服务器无响应，请重试');
      } else {
        // å‘送请求时出了点问题
        Message.errorMessage('发送请求时出了点问题');
      }
    },

    // é”™è¯¯æŠ›å‡º
    errorThrower: (res) => {
      const { success, data, error: errorCode, msg, showType } = res;
      if (!success) {
        const error: any = new Error(msg);
        error.name = 'BizError';
        error.info = { errorCode, errorMessage: msg, showType, data };
        throw error; // æŠ›å‡ºè‡ªåˆ¶çš„错误
      }
    },
  },

  requestInterceptors: [
    [
      (config) => {
        const $config = config;
        // å¼€å¯è¿›åº¦æ¡åŠ¨ç”»
        if (config.needNProcess) {
          NProgress.start();
        }

        const token = getToken();

        const userInfo = getUserInfo();

        const { showLoading = true, mock } = $config;

        if (mock) {
          $config.url = $config.url.replace(/^\/api/, '');
        }

        /**
         * å¦‚果是refreshToken这个方法 å°±ç›´æŽ¥è¿”回 é˜²æ­¢å†…存泄漏
         */
        if (whiteList.some((url) => $config.url.toLowerCase().includes(url.toLowerCase()))) {
          return $config;
        }

        if (showLoading) {
          startLoading();
        }

        return new Promise((resolve) => {
          if (token && $config.withCredentials) {
            if (tokenIsExpired(userInfo)) {
              if (!BoleRequest.refreshTokenPending) {
                const userStore = useUserStoreHook();
                BoleRequest.refreshTokenPending = true;
                // token过期刷新
                userStore
                  .refreshToken({
                    refreshToken: userInfo.refreshToken,
                    clientId: userStore.accountInfo.client_id,
                  })
                  .then((res) => {
                    $config.headers['Authorization'] = 'Bearer ' + res.accessToken;
                    BoleRequest.requests.forEach((cb) => cb(res.accessToken));
                    BoleRequest.requests = [];
                  })
                  .finally(() => {
                    BoleRequest.refreshTokenPending = false;
                  });
              }
              resolve(BoleRequest.retryOriginalRequest($config));
            } else {
              $config.headers['Authorization'] = 'Bearer ' + token;
              resolve($config);
            }
          } else {
            resolve($config);
          }
        });
      },
      (error: AxiosError) => {
        endLoading();
        return Promise.reject(error);
      },
    ],
  ],
  responseInterceptors: [
    [
      (response) => {
        const $config = response.config as IRequestOptions;

        const { needNProcess, getResponse = false } = $config;

        // å…³é—­è¿›åº¦æ¡åŠ¨ç”»
        if (needNProcess) {
          NProgress.done();
        }

        endLoading();

        return getResponse ? response : (response.data as any).result;
      },
      (error) => {
        endLoading();
        return Promise.reject(error);
      },
    ],
  ],
};

const ErrorMessageMap = {
  [400]: '请求错误',
  [401]: '未授权，请登录',
  [403]: '拒绝访问',
  [404]: '请求地址出错',
  [408]: '请求超时',
  [500]: '服务器内部错误',
  [501]: '服务未实现',
  [502]: '网关错误',
  [503]: '服务不可用',
  [504]: '网关超时',
  [505]: 'HTTP版本不受支持',
};

function handleAxiosResponseError(error: AxiosError<ErrorResponse, IRequestOptions>) {
  if (error.response.config.url.toLowerCase().includes(RefreshTokenUrl.toLowerCase())) {
    handleLogout();
    return;
  }
  if (error && error.response) {
    let message = ErrorMessageMap[error.response?.status] ?? '请求错误';
    if (error.response.data?.error?.message) {
      message = error.response.data?.error?.message;
    }

    if (error.response?.status === 401) {
      handleLogout();
    }
    Message.errorMessage(message);
  }
}

function handleLogout() {
  const userStore = useUserStoreHook();
  let path = '/';
  if (userStore.token) {
    path = router.currentRoute.value.fullPath;
  }
  userStore.logout();
  router.replace(`/login?redirect=${path}`);
}

export const request = BoleRequest.create(config);