Package Exports
- slice-upload-utils
Readme
slice-upload-utils
介绍
本工具包含上传和下载功能。vite + vue的实现。
上传
- 包括切片上传，秒传，断点续传，暂停、取消。
下载
- 切片下载，合并，暂停、取消。
上传hash计算
为了优化计算hash时间，hash值计算分两种，一直是计算文件的真实MD5，一种是计算自定义hash值。
自定义hash值：
:: preHash，采用截取file前段和末段合成一个新的文件，同时结合文件的最后修改时间，和file.size一起计算的一个新的hash值。
:: chunkHash，采用preHash结合chunkSize和该切片的index计算hash值。
真实hash值：
:: preHash, file文件的hash值，file的真实MD5值计算，在file.size大于chunkSize时，通过计算chunk的web worker线程里面同时计算。
:: chunkHash, file.size 小于chunkSize时，file等于chunk，chunkHash等于preHash；file.size大于chunkSize时在web worker里面计算。
可以根据实例中的isPreHash和isChunkHash的值来判断当前是否计算的真实hash。
快速开始
- 使用 pnpm 安装
pnpm add file-slice-upload示例代码
调用说明
export interface UseSliceUploadOptions extends Omit<SliceUploadOptions, 'file'> {
/**
* 上传文件
*/
file: Ref<File | null | undefined>
/**
* 上传函数
*/
request: UploadRequest
/**
* 报错处理函数
*/
onError?: UploadEventType['error']
/**
* 上传完成函数
*/
onFinish?: UploadEventType['finish']
/**
* 预检函数
*/
preVerifyRequest?: PreVerifyUploadRequest
/**
* 分片大小
* @default 1024 * 1024 * 2
*/
chunkSize?: number
/**
* 并发上传数
* @default 3
*/
poolCount?: number
/**
* 请求失败后，重试次数
*
* @default 3
*/
retryCount?: number
/**
* 请求失败后，重试间隔时间
* @default 300
*/
retryDelay?: number
/**
* 请求超时时间(15s)
* @default 15000
*/
timeout?: number
/**
* 计算整个文件的hash，开启后比较耗时间
*
* @default false
*/
realPreHash?: boolean
/**
* 计算分片文件的hash，开启后比较耗时间
*
* @default false
*/
realChunkHash?: boolean
}