yu-file-down

文件下载工具，支持Blob下载和URL下载。

安装

npm install yu-file-down

使用

基础用法

import { downloadFileFromUrl, downloadFileFromElement } from 'yu-file-down';

// 从URL下载文件
await downloadFileFromUrl('https://example.com/file.pdf', 'document.pdf', {
  onSuccess: () => {
    console.log('下载成功');
  },
  onError: (error) => {
    console.error('下载失败:', error);
  }
});

// 从文件对象下载
await downloadFileFromElement({
  download_url: 'https://example.com/file.pdf',
  file_name: 'document.pdf'
});

从Blob下载

import { downloadFileFromBlob } from 'yu-file-down';

const blob = new Blob(['文件内容'], { type: 'text/plain' });
downloadFileFromBlob(blob, 'file.txt');

批量下载

import { downloadFiles } from 'yu-file-down';

await downloadFiles([
  { url: 'https://example.com/file1.pdf', fileName: 'file1.pdf' },
  { url: 'https://example.com/file2.pdf', fileName: 'file2.pdf' }
], {
  delay: 500, // 每个文件之间延迟500ms
  onProgress: ({ current, total }) => {
    console.log(`下载进度: ${current}/${total}`);
  }
});

API

downloadFileFromUrl(url, fileName, options)

从URL下载文件。

参数：

• url (string) - 文件URL
• fileName (string) - 文件名
• options (object) - 配置选项
  • onSuccess (Function) - 成功回调
  • onError (Function) - 失败回调
  • fallbackToDirect (boolean) - 失败时是否回退到直接下载，默认 true

downloadFileFromElement(fileData, options)

从文件对象下载文件。

参数：

• fileData (object) - 文件数据对象，包含 url/download_url/file_url 和 file_name/name
• options (object) - 配置选项

downloadFileFromBlob(blob, fileName, onSuccess)

从Blob下载文件。

参数：

• blob (Blob) - Blob对象
• fileName (string) - 文件名
• onSuccess (Function) - 成功回调（可选）

downloadFiles(files, options)

批量下载文件。

参数：

• files (Array) - 文件数组，每个元素包含 url 和 fileName
• options (object) - 配置选项
  • delay (number) - 每个文件之间的延迟（毫秒），默认 500
  • onProgress (Function) - 进度回调

特性

• ✅ 支持Blob下载（跨域友好）
• ✅ 自动回退到直接下载
• ✅ 批量下载支持
• ✅ 进度回调
• ✅ TypeScript 支持