网络请求
get
发送get请求
参数
参数 | 类型 | 必需 | 默认值 | 说明 |
---|---|---|---|---|
url | String | 是 | 网络请求地址,如果项目中配置了apiPrefix并且setting中的apiPrefix为true,则添加配置的前缀 | |
data | Object | 否 | 要传的参数,会拼接在请求的url中 | |
header | Object | 否 | 设置http请求的header | |
resDataType | String | 否 | json | 设置response的数据类型, 为json时, 会尝试对返回值进行JSON.parse(), 若不希望parse, 则传入'text'即可 |
setting | Object | 否 | {jsonp: false(仅web端有效), apiPrefix: Boolean(根据传入url决定), credentials: 'include'(仅web端有效)} | 自定义了设置,apiPrefix为是否添加chameleon.config.js中设置的apiPrefix (以http://或https://或//开头的url默认不会拼接, 其他情况均会自动拼接); jsonp 为 true 时会发起一个 jsonp 请求; credentials可选值'omit'/'same-origin'/'include', 对应fetch的credentials |
domain | String | 否 | 网络请求的域名前缀(chameleon-api@0.3.1 开始支持)具体参见api多域名mock 如果设置了domain则chameleon.config.js中的apiPrefix失效 |
返回值
返回promise,对应的请求成功和失败回调
举例
cml.get({
url: 'https://cml.com/api/user/1'
}).then(res => {
cml.showToast({
message: JSON.stringify(res),
duration: 2000
})
}, err => {
cml.showToast({
message: JSON.stringify(err),
duration: 2000
})
})
post
发送post请求
参数
参数 | 类型 | 必需 | 默认值 | 说明 |
---|---|---|---|---|
url | String | 是 | 网络请求地址,如果项目中配置了apiPrefix并且setting中的apiPrefix为true,则添加配置的前缀 | |
data | Object | 否 | 要传的参数,会拼接在请求的url中 | |
header | Object | 否 | 设置http请求的header | |
contentType | String | 否 | form | 取值:form或json,决定body中data的格式,对应header中content-type为application/x-www-form-urlencoded或application/json |
resDataType | String | 否 | json | 设置response的数据类型, 为json时, 会尝试对返回值进行JSON.parse(), 若不希望parse, 则传入'text'即可 |
setting | Object | 否 | {jsonp: false(仅web端有效), apiPrefix: Boolean(根据传入url决定), credentials: 'include'(仅web端有效)} | 自定义了设置,apiPrefix为是否添加chameleon.config.js中设置的apiPrefix (以http://或https://或//开头的url默认不会拼接, 其他情况均会自动拼接); jsonp 为 true 时会发起一个 jsonp 请求; credentials可选值'omit'/'same-origin'/'include', 对应fetch的credentials |
domain | String | 否 | 网络请求的域名前缀(chameleon-api@0.3.1开始支持)具体参见api多域名mock 如果设置了domain则chameleon.config.js中的apiPrefix失效 |
返回值
返回promise,对应的请求成功和失败回调
举例
cml.post({
url: 'https://cml.com/api/user/update',
data: {
a: 1
}
}).then(res => {
cml.showToast({
message: JSON.stringify(res),
duration: 2000
})
}, err => {
cml.showToast({
message: JSON.stringify(err),
duration: 2000
})
})
request
发送request请求
参数
参数 | 类型 | 必需 | 默认值 | 说明 |
---|---|---|---|---|
url | String | 是 | 网络请求地址,如果项目中配置了apiPrefix并且setting中的apiPrefix为true,则添加配置的前缀 | |
data | Object | 否 | 要传的参数,会拼接在请求的url中 | |
method | Object | 否 | 若cml.get()/cml.post()无法满足需求,如需使用DELETE/PUT时,可调用此方法 | |
header | Object | 否 | 设置http请求的header | |
contentType | String | 否 | form | 取值:form或json,决定body中data的格式,对应header中content-type为application/x-www-form-urlencoded或application/json |
resDataType | String | 否 | json | 设置response的数据类型, 为json时, 会尝试对返回值进行JSON.parse(), 若不希望parse, 则传入'text'即可 |
setting | Object | 否 | {jsonp: false(仅web端有效), apiPrefix: Boolean(根据传入url决定), credentials: 'include'(仅web端有效)} | 自定义了设置,apiPrefix为是否添加chameleon.config.js中设置的apiPrefix (以http://或https://或//开头的url默认不会拼接, 其他情况均会自动拼接); jsonp 为 true 时会发起一个 jsonp 请求; credentials可选值'omit'/'same-origin'/'include', 对应fetch的credentials |
domain | String | 否 | 网络请求的域名前缀(chameleon-api@0.3.1 开始支持)具体参见api多域名mock 如果设置了domain则chameleon.config.js中的apiPrefix失效 |
返回值
返回promise,对应的请求成功和失败回调
举例
cml.request({
url: 'https://cml.com/api/user/1',
data: {
a: 1
},
method: 'PUT'
}).then(res => {
cml.showToast({
message: JSON.stringify(res),
duration: 2000
})
}, err => {
cml.showToast({
message: JSON.stringify(err),
duration: 2000
})
})