大文件上传插件,支持秒传,分片上传,断点续传。
- html页面直接引用dist文件,用法参考
demo.html
- es环境可以直接引用
dist
文件夹的index.esm.js文件,也可以直接引用src/uploader.tsx
<body >
<div id="root">
<input type="file" id="upload" onchange="upload(this.files)" />
</div>
<script src="/dist/index.js"></script>
<script>
document.getElementById( "upload" ).onchange = function(e){
console.log(Uploader);
const file = e.target.files[0]
const ctx = {
maxConcurrency: 5,
totalSize: file.size,
chunkSize: 1024 * 1024,
uploadUrl: '/2/upload',
mergeUrl: '/2/merge',
touchUrl: '/2/init',
testChunks: false,
withCredentials: 'include',
}
const up = new Uploader(ctx, file)
up.on('progress', (e) => {
console.log('progess',e)
})
up.on('complete', (e) => {
console.log('complete',e)
alert(e.url)
})
up.run()
}
</script>
</body>
-
success
,上传成功时触发,e = {"upload_id":"xxxxx","status":1,"url":"","chunks":[]},其中status定义0:待上传,1:上传中,2:已完成,3:已失败 -
fail
,上传失败时触发,e :Error -
complete
,上传成功或失败时触发,返回值同 success 或 fail -
progess
,上传进度变化时触发,返回内容如下e={ uploadedSize: 1286679, totalSize: 1286679 }
初始化上传动作,返回upload_id,会携带文件md5和mime信息,
如果文件已经存在,则直接返回status=2,url不为空。
如果之前上传过,status=1,chunks会返回已经上传的chunk的index和hash
属性 | 类型 | 说明 |
---|---|---|
size | String |
整个文件的 md5 值 |
chunk_size | String |
整个文件的大小 |
digest | String |
整个文件的 md5 值 |
文件的前200个字节(为了获取文件的mime
)
属性 | 类型 | 说明 |
---|---|---|
url | String |
已上传时返回线上文件路径 |
upload_id | String |
上传凭证,如果已完成,该字段为空字符串 |
chunks | Array<{index:number,etag:string}> |
未完全上传时,返回已上传的分块序号 |
status | int |
0:待上传,1:上传中,2:已完成,3:已失败 |
分片传输
属性 | 类型 | 说明 |
---|---|---|
index | String |
分片序号,从0开始 |
upload_id | String |
传输凭证 |
digest | String |
分片内容的 md5 值 |
传输的分片内容
合并传输分片
属性 | 类型 | 说明 |
---|---|---|
upload_id | String |
传输凭证 |
digest | String |
整个文件的 md5 值 |
json格式,所有分片的编号和摘要,Array<{index:number,etag:string}>
用法与h5一致,参考wxm文件夹下的代码