上传:上传文件资源,客户端直接发起一个 HTTP POST (multipart/form-data) 请求。
成功发起上传后, 该接口可以通过回调持续获取上传进度。
syberh.upload.start(Object object)
参数
Object object
| 属性 | 类型 | 默认值 | 必填 | 描述 |
| url | String | | 是 | 上传路径 |
| name | String | file | 否 | 文件域的名称, 服务端通过该值提取文件流. 默认为file |
| file | String | | 是 | 文件本地路径 |
| cookie | Object | | 否 | 待发送的cookie |
| header | Object | | 否 | 待发送的HTTP请求头 |
| form | Object | | 否 | 发送额外的表单数据 |
| success | function | | 否 | 回调成功 |
| fail | function | | 否 | 回调失败 |
object.success回调函数
参数
| 属性 | 类型 | 描述 |
| id | String | 上传ID |
| status | String | 状态(1:开始,2:下载中,3:完成) |
| sent | number | 已上传的数据字节数 |
| total | number | 上传文件的字节总数 |
| response | Object | 服务端的响应结果, 仅在status为3时存在. 包含属性: cookie, header, body |
object.fail回调函数
参数
| 属性 | 类型 | 描述 |
| code | String | 错误码 |
| msg | String | 错误信息 |
示例代码
syberh.upload.start({
'url': 'XXX',
'name': 'file',
'file': 'XXX',
'cookie': {
cookieName: 'test_cookie'
},
'header': {
headerName: 'test_header'
},
'form': {
name: 'syberos'
},
success: function(result) {
console.log('success',result);
},
fail: function(error) {
console.log('fail: ', error);
}
});