Skip to content

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";

downloadexport 进入 Fast 文件响应处理。uni adapter 是否选择文件 API 仍由 method: "upload" | "download" 决定。

扩展选项

选项默认值行为
cancelDuplicateRequesttrue依据处理器补齐后的 URL、方法、可安全编码的请求体及身份头去重;不透明文件体默认不自动去重。
loadingfalse在请求生命周期内调用 Loading show/close。
loadingText"加载中..."传给 Loading show 的文字。
cachefalse显式命名空间非空时对符合条件的 GET RESTful 简洁响应启用缓存。
getMethodCacheHandletrue未加密的 GET 请求追加时间戳参数,避免浏览器或代理复用旧响应。
simpleDataFormattrueRESTful JSON 成功响应只返回 data
showErrorMessagetrue展示 HTTP、网络和超时错误。
showCodeMessagetrue展示 Fast 业务 code/success 错误。
autoDownloadFiletrue浏览器文件响应成功后自动保存。
requestCipher全局配置调用已注册的请求加密和响应解密处理器。
restfulResulttrueApiResponse 校验 code/success 并处理 data。
cacheNamespace容器 namespace非空身份/租户/语言命名空间;空值禁用请求缓存。
duplicateKey未设置文件或其他不透明请求体的显式去重标识;不放入明文凭据。

返回规则

条件返回结果
自定义 response 处理器返回非空值自定义返回值
method: "download"requestType: "download"完整 AxiosResponse
requestType: "export" 或响应类型为 Blob完整 AxiosResponse
非 JSON + simpleDataFormat: trueresponse.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 独立控制业务协议提示。