目录— 个文件
⌕
目录加载中…
…/core/http/HttpDefine.ts
1/** HTTP 方法(与常见 REST 约定一致) */
2export enum HttpMethod {
3 GET = "GET",
4 POST = "POST",
5 PUT = "PUT",
6 DELETE = "DELETE",
7}
8
9/** 统一返回:业务层可再解析 data */
10export type HttpRawResult = {
11 statusCode: number;
12 data: unknown;
13};
14
15export type HttpRequestOptions = {
16 /** 相对路径(配合 host/serverAddress)或完整 https URL */
17 url: string;
18 data?: unknown;
19 method?: HttpMethod | string;
20 /** 前缀;为空则用 HttpManager.serverAddress */
21 host?: string;
22 headers?: Record<string, string>;
23 /** 为 true 时允许同一 key 并发重复请求 */
24 enableMult?: boolean;
25 /** XHR 超时毫秒,默认 15000;wx.request 使用 timeout 字段(若宿主支持) */
26 timeoutMs?: number;
27 /** callback 风格完成时回调(与 Promise 二选一或并存) */
28 callback?: (res: HttpRawResult) => void;
29};
讲解30 行
HTTP 请求类型与枚举人工通读
HttpDefine.ts
定义四种 HTTP 方法、统一返回结构 HttpRawResult,以及请求参数 HttpRequestOptions 的全部可选字段。HttpManager 的两个入口都以这套类型为参数,业务只需按这里声明传入地址、数据、方法与头部。
先看 HttpMethod 与 HttpRawResult,再逐个读 HttpRequestOptions 的字段注释,最后回 HttpManager 看哪些字段真正被使用。
特殊处理与易错点
- 特殊处理enableMult 默认 false,同方法同 URL 同请求体的并发请求会被判为重复并拦截,只有显式置 true 才放行。L24
- 特殊处理timeoutMs 只作用于 XHR 的 timeout,缺省时由 HttpManager 补 15000 毫秒。L26
- 易错点host 为空才会退回 HttpManager.serverAddress,两者都为空时相对路径会被直接拼到空串上,请求发往当前页面域名。L21
2注释HTTP 方法(与常见 REST 约定一致)
10注释统一返回:业务层可再解析 data
11属性统一返回:业务层可再解析 data
12属性请求数据,GET 时序列化为查询串,其它方法作为请求体。
17属性相对路径或完整 http 地址,是拼接最终请求地址的基准。
21注释前缀;为空则用 HttpManager.serverAddress
24注释为 true 时允许同一 key 并发重复请求
26注释XHR 超时毫秒,默认 15000;wx.request 使用 timeout 字段(若宿主支持)
28注释callback 风格完成时回调(与 Promise 二选一或并存)