axios-wechat-adapter
Version:
axios微信小程序适配器,可以复用web或者node上的axios请求
149 lines (148 loc) • 6.68 kB
TypeScript
declare type IAnyObject = Record<string, any>;
export declare type WechatRequestMethod = 'OPTIONS' | 'GET' | 'HEAD' | 'POST' | 'PUT' | 'DELETE' | 'TRACE' | 'CONNECT';
/** 网络请求过程中一些调试信息
*
* 最低基础库: `2.10.4` */
interface RequestProfile {
/** SSL建立完成的时间,如果不是安全连接,则值为 0 */
SSLconnectionEnd: number;
/** SSL建立连接的时间,如果不是安全连接,则值为 0 */
SSLconnectionStart: number;
/** HTTP(TCP) 完成建立连接的时间(完成握手),如果是持久连接,则与 fetchStart 值相等。注意如果在传输层发生了错误且重新建立连接,则这里显示的是新建立的连接完成的时间。注意这里握手结束,包括安全连接建立完成、SOCKS 授权通过 */
connectEnd: number;
/** HTTP(TCP) 开始建立连接的时间,如果是持久连接,则与 fetchStart 值相等。注意如果在传输层发生了错误且重新建立连接,则这里显示的是新建立的连接开始的时间 */
connectStart: number;
/** DNS 域名查询完成的时间,如果使用了本地缓存(即无 DNS 查询)或持久连接,则与 fetchStart 值相等 */
domainLookupEnd: number;
/** DNS 域名查询开始的时间,如果使用了本地缓存(即无 DNS 查询)或持久连接,则与 fetchStart 值相等 */
domainLookupStart: number;
/** 评估当前网络下载的kbps */
downstreamThroughputKbpsEstimate: number;
/** 评估的网络状态 slow 2g/2g/3g/4g */
estimate_nettype: string;
/** 组件准备好使用 HTTP 请求抓取资源的时间,这发生在检查本地缓存之前 */
fetchStart: number;
/** 协议层根据多个请求评估当前网络的 rtt(仅供参考) */
httpRttEstimate: number;
/** 当前请求的IP */
peerIP: string;
/** 当前请求的端口 */
port: number;
/** 收到字节数 */
receivedBytedCount: number;
/** 最后一个 HTTP 重定向完成时的时间。有跳转且是同域名内部的重定向才算,否则值为 0 */
redirectEnd: number;
/** 第一个 HTTP 重定向发生时的时间。有跳转且是同域名内的重定向才算,否则值为 0 */
redirectStart: number;
/** HTTP请求读取真实文档结束的时间 */
requestEnd: number;
/** HTTP请求读取真实文档开始的时间(完成建立连接),包括从本地读取缓存。连接错误重连时,这里显示的也是新建立连接的时间 */
requestStart: number;
/** HTTP 响应全部接收完成的时间(获取到最后一个字节),包括从本地读取缓存 */
responseEnd: number;
/** HTTP 开始接收响应的时间(获取到第一个字节),包括从本地读取缓存 */
responseStart: number;
/** 当次请求连接过程中实时 rtt */
rtt: number;
/** 发送的字节数 */
sendBytesCount: number;
/** 是否复用连接 */
socketReused: boolean;
/** 当前网络的实际下载kbps */
throughputKbps: number;
/** 传输层根据多个请求评估的当前网络的 rtt(仅供参考) */
transportRttEstimate: number;
}
/** 接口调用失败的回调函数 */
declare type RequestFailCallback = (res: GeneralCallbackResult) => void;
interface GeneralCallbackResult {
errMsg: string;
}
declare type RequestCompleteCallback = (res: GeneralCallbackResult) => void;
interface RequestSuccessCallbackResult<T extends string | IAnyObject | ArrayBuffer = string | IAnyObject | ArrayBuffer> {
/** 开发者服务器返回的 cookies,格式为字符串数组
*
* 最低基础库: `2.10.0` */
cookies: string[];
/** 开发者服务器返回的数据 */
data: T;
/** 开发者服务器返回的 HTTP Response Header
*
* 最低基础库: `1.2.0` */
header: IAnyObject;
/** 网络请求过程中一些调试信息
*
* 最低基础库: `2.10.4` */
profile: RequestProfile;
/** 开发者服务器返回的 HTTP 状态码 */
statusCode: number;
errMsg: string;
}
/** 接口调用成功的回调函数 */
declare type RequestSuccessCallback<T extends string | IAnyObject | ArrayBuffer = string | IAnyObject | ArrayBuffer> = (result: RequestSuccessCallbackResult<T>) => void;
declare namespace WechatMiniprogram {
interface RequestOption<T extends string | IAnyObject | ArrayBuffer = string | IAnyObject | ArrayBuffer> {
/** 开发者服务器接口地址 */
url: string;
/** 接口调用结束的回调函数(调用成功、失败都会执行) */
complete?: RequestCompleteCallback;
/** 请求的参数 */
data?: string | IAnyObject | ArrayBuffer;
/** 返回的数据格式
*
* 可选值:
* - 'json': 返回的数据为 JSON,返回后会对返回的数据进行一次 JSON.parse;
* - '其他': 不对返回的内容进行 JSON.parse; */
dataType?: 'json' | '其他';
/** 开启 cache
*
* 最低基础库: `2.10.4` */
enableCache?: boolean;
/** 开启 http2
*
* 最低基础库: `2.10.4` */
enableHttp2?: boolean;
/** 开启 quic
*
* 最低基础库: `2.10.4` */
enableQuic?: boolean;
/** 接口调用失败的回调函数 */
fail?: RequestFailCallback;
/** 设置请求的 header,header 中不能设置 Referer。
*
* `content-type` 默认为 `application/json` */
header?: IAnyObject;
/** HTTP 请求方法
*
* 可选值:
* - 'OPTIONS': HTTP 请求 OPTIONS;
* - 'GET': HTTP 请求 GET;
* - 'HEAD': HTTP 请求 HEAD;
* - 'POST': HTTP 请求 POST;
* - 'PUT': HTTP 请求 PUT;
* - 'DELETE': HTTP 请求 DELETE;
* - 'TRACE': HTTP 请求 TRACE;
* - 'CONNECT': HTTP 请求 CONNECT; */
method?: WechatRequestMethod;
/** 响应的数据类型
*
* 可选值:
* - 'text': 响应的数据为文本;
* - 'arraybuffer': 响应的数据为 ArrayBuffer;
*
* 最低基础库: `1.7.0` */
responseType?: 'text' | 'arraybuffer';
/** 接口调用成功的回调函数 */
success?: RequestSuccessCallback<T>;
/** 超时时间,单位为毫秒
*
* 最低基础库: `2.10.0` */
timeout?: number;
}
}
export {};
declare global {
const wx: {
request: (args?: WechatMiniprogram.RequestOption) => void;
};
}