跳到正文

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" 决定。

扩展选项 ​

选项默认值行为
cancelDuplicateRequesttrue依据处理器补齐后的 URL、方法、可安全编码的请求体及身份头去重;不透明文件体默认不自动去重。
loadingfalse在请求生命周期内调用 Loading show/close。
loadingText"加载中..."传给 Loading show 的文字;未指定时跟随容器语言。
cachefalse对符合条件的 GET RESTful 简洁响应启用接口路径与查询参数缓存(不含 baseURL),无需命名空间。
getMethodCacheHandletrue未加密的 GET 请求追加时间戳参数,避免浏览器或代理复用旧响应。
simpleDataFormattrueRESTful JSON 成功响应只返回 data。
showErrorMessagetrue展示 HTTP、网络和超时错误。
showCodeMessagetrue展示 Fast 业务 code/success 错误。
autoDownloadFiletrue浏览器文件响应成功后自动保存。
requestCipher全局配置调用已注册的请求加密和响应解密处理器。
restfulResulttrue按 ApiResponse 校验 code/success 并处理 data。
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 独立控制业务协议提示。