ajax

跨域异步请求

需要加载的模块

const pmui = app.requireModule('pmui');

pmui.ajax

跨域请求

  • 支持自定义headers
  • 支持上传文件
/**
 * @param params    详细参数
 * @param callback  回调事件
 */
pmui.ajax({params}, callback(result))

params 参数说明

属性名 类型 必须 描述 默认值
url String √ 请求地址 -
name String - 请求名称，用于取消请求 -
method String - 请求类型，get、post get
dataType String - 返回数据类型，json、text json
timeout Number - 请求超时时间（单位：毫秒） 15000
cache Number - 缓存时间，0不缓存（单位：毫秒） 0
headers Object - 请求头部headers -
data Object - 发送数据 -
files Object - 提交/上传文件 -
beforeAfter Boolen - 是否回调前(ready)、后(complete)事件 false
progressCall Boolen - 是否回调上传进度事件 false

callback 回调result说明

{
    status: 'success',      //状态，详见：注①
    
    code: 200,              //请求结果状态码
    headers: { ... },       //请求结果headers信息
    result: '...',          //请求结果
    
    name: 'requestName',    //请求名称
    url: 'http://....',     //请求地址
    cache: false,           //请求结果是否为缓存

    progress: {             //上传进度信息
        current: 10240,     // 当前进度大小
        total: 20480,       // 总进度大小
        fraction: 0.5,      // 进度比0~1
    }
}

注①：

  • ready就绪
  • progress上传进度更新
  • success请求成功
  • error请求失败
  • complete请求结束

回调过程：ready -> [progress] -> (success | error) -> complete；

:::warning 状态提示

  • ready和complete事件仅在beforeAfter=true时有回调 ，

  • progress事件仅在上传文件且progressCall=true时有回调 。

:::

简单示例

//示例①
pmui.ajax({
    url: 'http://....'
}, function(result) {
    //......
});

//示例②
pmui.ajax({
    url: 'http://....',
    method: 'post',
    headers: {
        token: 'x2eefhjb2h3rj'
    },
    data: {
        username: 'pmui'
    },
    files: {
        userimg: '/storage/sdcard/.....'
    }
}, function(result) {
    //......
});

pmui.ajaxCancel

取消跨域请求

/**
 * @param name    请求名称（留空则取消所有请求）
 */
pmui.ajaxCancel(name)

pmui.getCacheSizeAjax

获取跨域请求缓存

/**
 * @param callback  回调事件，{size:123123}，单位：字节B
 */
pmui.getCacheSizeAjax(callback(result))

pmui.clearCacheAjax

清除跨域请求缓存

pmui.clearCacheAjax()