# file-upload-utils

> 处理大文件上传、秒传、断点+续传的工具包

Latest version **1.0.0** (published 2023-12-21) · ISC license · 0 weekly downloads

## Install

```sh
npm install file-upload-utils
pnpm add file-upload-utils
yarn add file-upload-utils
bun add file-upload-utils
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.0 |
| Published | 2023-12-21 |
| First published | 2023-12-21 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 23 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1 |
| Maintainers | codercgx |

## Links

- npm: https://www.npmjs.com/package/file-upload-utils
- Repository: https://github.com/chenguox/file-upload-utils
- Homepage: https://github.com/chenguox/file-upload-utils#readme
- Issues: https://github.com/chenguox/file-upload-utils/issues
- npm.io page: https://npm.io/package/file-upload-utils

## Dependencies (1)

- [spark-md5](https://npm.io/package/spark-md5.md) ^3.0.2

## Recent versions

- 1.0.0 (latest) — 2023-12-21

## README

# file-upload-utils

处理大文件上传、秒传、断点+续传的工具包

## 功能实现：

大文件上传

* 文件切成分片 √
* 分片 hash 生成 √
* 合并上传 √
* 并发控制 √
* 进度条提示 √

小文件直传

文件秒传 √

## 使用示例

```typescript
import { useState } from 'react';
import SliceUpload from "./upload";
import { SliceUploadFileChunk } from './type';

interface IOptions {
  chunkSize?: number
  poolCount?: number
}

export function useSliceUpload(options: IOptions) {
  const [totalProgress, setTotalProgress] = useState(0);
  const [chunks, setChunks] = useState([])

  const instance = new SliceUpload({});

  const updateChunks = () => {
    const data = instance.getChunkData()
    setChunks(data)
  }


  // 设置上传请求
  instance.setUploadRequest((params: SliceUploadFileChunk) => {
    // 文件数据
    const data = new FormData()
    data.append('chunk', params.chunk);
    data.append('index', String(params.index));
    data.append('chunkHash', params.chunkHash);
    data.append('chunkName', params.chunkName);
    data.append('chunkTotal', String(params.chunkTotal))

    const options = {
      url: "http://localhost:8888/upload/",
      method: "POST" as const,
      data,
    }

    return options
  })

  // 进度条
  instance.on('progress', (result) => {
    console.log(result.progress);
    setTotalProgress(result.progress);
    updateChunks()
  });


  return {
    chunks,
    totalProgress,
  }
}



```

---
_Source: https://npm.io/package/file-upload-utils · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._