Fast 请求配置
FastAxiosRequestConfig<Input> 继承 AxiosRequestConfig<Input> 和以下扩展选项。
requestType 请求模式
必填。与 Fast.NET HttpRequestActionEnum 的 OpenAPI 输出同步:
ts
type RequestType = "auth" | "query" | "add" | "edit" | "delete" | "submit" | "upload" | "download" | "export" | "import" | "callback" | "other";download 和 export 进入 Fast 文件响应处理。uni adapter 是否选择文件 API 仍由 method: "upload" | "download" 决定。
扩展选项
| 选项 | 默认值 | 行为 |
|---|---|---|
cancelDuplicateRequest | true | 依据处理器补齐后的 URL、方法、可安全编码的请求体及身份头去重;不透明文件体默认不自动去重。 |
loading | false | 在请求生命周期内调用 Loading show/close。 |
loadingText | "加载中..." | 传给 Loading show 的文字。 |
cache | false | 显式命名空间非空时对符合条件的 GET RESTful 简洁响应启用缓存。 |
getMethodCacheHandle | true | 未加密的 GET 请求追加时间戳参数,避免浏览器或代理复用旧响应。 |
simpleDataFormat | true | RESTful JSON 成功响应只返回 data。 |
showErrorMessage | true | 展示 HTTP、网络和超时错误。 |
showCodeMessage | true | 展示 Fast 业务 code/success 错误。 |
autoDownloadFile | true | 浏览器文件响应成功后自动保存。 |
requestCipher | 全局配置 | 调用已注册的请求加密和响应解密处理器。 |
restfulResult | true | 按 ApiResponse 校验 code/success 并处理 data。 |
cacheNamespace | 容器 namespace | 非空身份/租户/语言命名空间;空值禁用请求缓存。 |
duplicateKey | 未设置 | 文件或其他不透明请求体的显式去重标识;不放入明文凭据。 |
返回规则
| 条件 | 返回结果 |
|---|---|
| 自定义 response 处理器返回非空值 | 自定义返回值 |
method: "download" 或 requestType: "download" | 完整 AxiosResponse |
requestType: "export" 或响应类型为 Blob | 完整 AxiosResponse |
非 JSON + simpleDataFormat: true | response.data |
非 JSON + simpleDataFormat: false | 完整 AxiosResponse |
| JSON + RESTful + 简洁模式 | 解密后结构中的 data |
| 其他 JSON | 解密后或原始响应数据 |
Fast 业务 code 不在 200–299 或 success === false 时抛出 AxiosError。取消请求保留 Axios CanceledError,便于调用方继续使用 axios.isCancel() 判断。
边界行为
JSON 或解密结果为 null/undefined 时原样返回;其他非对象 RESTful 结果抛出清晰的协议错误。URLSearchParams 的重复键和调用方原对象会保留。showErrorMessage 同时控制离线和文件 HTTP 失败提示;showCodeMessage 独立控制业务协议提示。
