大文件上传插件，支持秒传，分片上传，断点续传。兼容小程序。
采用泛型注入依赖的方式，兼容 web 和小程序，在编译期减少了无用代码
在 dist 文件有已经编译好的文件，当然，你也可以自己编译
先安装依赖
yarn install
编译支持 web 的文件
yarn build // 或者 yarn dev
编译支持小程序的文件(小程序只编译了 commonjs 格式，如果需要，自己修改rollup.wxm.config.js)
yarn wxm
- html 页面直接引用 dist 文件，用法参考
demo.html - es 环境可以直接引用
dist文件夹的web/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',
}
const up = uploader(ctx, file)
up.on('progress', e => {
console.log('progess', e)
})
up.on('success', e => {
console.log('success', e)
alert(e.url)
})
up.on('complete', e => {
console.log('complete', e)
})
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 文件夹下的代码
因为小程序不支持Blob和URLSearchParams,所以规避了 BLob，同时根据URLSearchParams的 set 和 toString 方法，仿了一个简单实现，然后通过泛型注入。
同时小程序获取文件 size 也是异步的，所以在方法实例的时候有所不同，实现差别如下
// web 实现
const uploader = (ctx: IContext, f: File) => {
return new Uploader<WebFile, WebRequest, URLSearchParams>(ctx, new WebFile(f), new WebRequest(), URLSearchParams)
}
// 小程序实现
const fsm = wx.getFileSystemManager()
const getSize = (filePath: string): Promise<number> => {
return new Promise(resolve => {
fsm.getFileInfo({
filePath,
success(res) {
resolve(res.size)
},
fail(e: WechatMiniprogram.GetFileInfoFailCallbackResult) {
throw Error(e.errMsg)
},
})
})
}
const uploader = async (ctx: IContext, filePath: string) => {
return getSize(filePath).then(n => {
return new Uploader<WxmFile, WxmRequest, URLSearchParams>(
ctx,
new WxmFile(fsm, filePath, n),
new WxmRequest(),
URLSearchParams,
)
})
}所以体现在实例化的差别
// web
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',
}
const up = uploader(ctx, file)
up.on('progress', e => {
console.log('progess', e)
})
up.on('success', e => {
console.log('success', e)
alert(e.url)
})
up.run()
// 小程序
const ctx = {
maxConcurrency: 5,
totalSize: 0,
chunkSize: 1024 * 1024,
uploadUrl: '/2/uploader/upload',
mergeUrl: '/2/uploader/merge',
touchUrl: '/2/uploader/init',
testChunks: false,
}
uploader(ctx, filePath).then(ins=>{
ins.on('progress', e => {
console.log('progess', e)
})
ins.on('success',(e)=>{
wx.showModal({
title: '地址',
content: e.url,
success (res) {
if (res.confirm) {
console.log('用户点击确定')
} else if (res.cancel) {
console.log('用户点击取消')
}
}
})