Zip Downloader

资源下载器（下载资源、Zip 压缩、下载到本地）

📥 参数说明

Options 参数说明：

参数名	类型	是否必填	默认值	说明
`filename`	string	否		保存的文件名，添加此参数时会将压缩包保存到本地，未配置返回压缩包的 Blob 对象
`resources`	(Resource \| () => Promise<Resource>)[]	是		资源列表，数组，每个元素为对象，包含 `name` 和 `url` 或者 `blob` 字段
`concurrency`	number	否	`10`	并发数，默认 `10`
`onProgress`	(index: number) => Promise<void>	否		下载进度回调函数，参数为当前正在下载的资源索引
`onError`	(error: Error, index: number) => Promise<void>	否	`async (error, index) => { throw error }`	下载出错回调函数，参数为当前出错的资源索引和错误信息，默认抛出异常阻止后续下载，可配置为空函数忽略错误

Resource 参数说明：

参数名	类型	是否必填	说明
`name`	string	是	资源名称
`url`	string	否	URL 类型资源
`blob`	Blob 或者 () => Promise<Blob>	否	Blob 类型资源

📦 使用示例

下载，压缩，并保存到本地

await zipDownloader({
  filename: 'index.zip',
  resources: [
    { name: 'index.html', url: location.href },
    {
      name: 'hello.txt',
      blob: new Blob(['hello world'], { type: 'text/plain' }),
    },
    {
      name: 'example.txt',
      blob: () => fetch('https://example.com').then(response => response.blob()),
    },
    () => fetch('https://example.com').then(response => ({
      name: 'example2.txt',
      blob: () => response.blob(),
    })),
  ],
  concurrency: 10,
  async onProgress(index) {
    console.log(`正在下载第 ${index + 1} 个资源`)
  },
})

仅下载和压缩

const blob = await zipDownloader({
  resources: [
    { name: 'index.html', url: location.href },
    {
      name: 'hello.txt',
      blob: new Blob(['hello world'], { type: 'text/plain' }),
    },
    {
      name: 'example.txt',
      blob: () => fetch('https://example.com').then(response => response.blob()),
    },
    () => fetch('https://example.com').then(response => ({
      name: 'example2.txt',
      blob: () => response.blob(),
    })),
  ],
  concurrency: 10,
  async onProgress(index) {
    console.log(`正在下载第 ${index + 1} 个资源`)
  },
})
// 自行处理
// GM_download(URL.createObjectURL(blob), 'index.zip')

忽略异常的资源

await zipDownloader({
  filename: 'index.zip',
  resources: [
    { name: 'index.html', url: location.href },
    {
      name: 'hello.txt',
      blob: new Blob(['hello world'], { type: 'text/plain' }),
    },
    {
      name: 'example.txt',
      blob: () => fetch('https://example.com').then(response => response.blob()),
    },
    () => fetch('https://example.com').then(response => ({
      name: 'example2.txt',
      blob: () => response.blob(),
    })),
  ],
  concurrency: 10,
  async onProgress(index) {
    console.log(`正在下载第 ${index + 1} 个资源`)
  },
  async onError(error, index) {
    console.warn(`处理第 ${index} 个资源时出现异常: ${error}`)
    // throw error 不跑出异常
  }
})

📖 使用方式

方式一：直接引入库文件

// ==UserScript==
// @require      https://**/zip-downloader.js?*
// @grant        GM_download
// ==/UserScript==

(async function () {
  'use strict'
  await zipDownloader({
    filename: 'index.zip',
    resources: [
      { name: 'index.html', url: location.href },
      {
        name: 'hello.txt',
        blob: new Blob(['hello world'], { type: 'text/plain' }),
      },
    ],
    concurrency: 10,
    async onProgress(index) {
      console.log(`正在下载第 ${index + 1} 个资源`)
    },
  })
})()

方式二：vite + vite-plugin-monkey [推荐]

初始化项目

npm create monkey

安装 zip-downloader 依赖

npm i @xiaohuohumax/zip-downloader

在 main.ts 中使用 zip-downloader

import zipDownloader from '@xiaohuohumax/zip-downloader'

await zipDownloader({
  filename: 'index.zip',
  resources: [
    { name: 'index.html', url: location.href },
    {
      name: 'hello.txt',
      blob: new Blob(['hello world'], { type: 'text/plain' }),
    },
  ],
  concurrency: 10,
  async onProgress(index) {
    console.log(`正在下载第 ${index + 1} 个资源`)
  },
})

修改 vite.config.ts 排除 zip-downloader 依赖和添加 GM_download 权限

import { defineConfig } from 'vite'
import monkey, { cdn } from 'vite-plugin-monkey'

// https://vitejs.dev/config/
export default defineConfig({
  plugins: [
    monkey({
      build: {
        externalGlobals: {
          '@xiaohuohumax/zip-downloader': cdn.jsdelivr('zipDownloader', 'dist/index.lib.js'),
        },
      },
      userscript: {
        grant: ['GM_download']
      },
    }),
  ],
})

🧩 依赖项目

zip.js Zip 压缩库
p-limit 并发限制库

🚨 免责声明

本脚本仅供学习交流使用
请勿用于任何商业用途
使用本脚本产生的任何后果由用户自行承担

♻ 其他说明

GreasyFork 或者 ScriptCat 回复不及时，问题反馈推荐直接在 Github 提 Issue。

如果觉得本脚本对你有帮助，欢迎点个 ⭐ Star 支持一下！

Wird geladen…