当前位置：首页 > uni-app

uniapp队列下载

2026-01-15 18:08:03uni-app

uniapp 实现队列下载的方法

在 uniapp 中实现队列下载通常需要管理多个下载任务，确保它们按顺序执行。可以通过以下方法实现：

使用 Promise 和递归实现队列下载

定义一个下载队列数组，通过递归或循环逐个处理下载任务。

const downloadQueue = [];
let isDownloading = false;

function addToQueue(url) {
  downloadQueue.push(url);
  if (!isDownloading) {
    processQueue();
  }
}

function processQueue() {
  if (downloadQueue.length === 0) {
    isDownloading = false;
    return;
  }

  isDownloading = true;
  const url = downloadQueue.shift();

  uni.downloadFile({
    url: url,
    success: (res) => {
      if (res.statusCode === 200) {
        console.log('下载成功', res.tempFilePath);
      }
    },
    complete: () => {
      processQueue();
    }
  });
}

使用 async/await 实现顺序下载

利用 async/await 可以更清晰地管理异步下载任务。

async function downloadFilesSequentially(urls) {
  for (const url of urls) {
    try {
      const res = await new Promise((resolve, reject) => {
        uni.downloadFile({
          url: url,
          success: resolve,
          fail: reject
        });
      });
      console.log('下载完成', res.tempFilePath);
    } catch (error) {
      console.error('下载失败', error);
    }
  }
}

并发控制下载

如果需要控制并发数，可以使用类似以下方法：

async function downloadWithConcurrency(urls, maxConcurrent = 3) {
  const queue = [];
  let activeDownloads = 0;

  urls.forEach(url => {
    queue.push(() => 
      new Promise((resolve) => {
        activeDownloads++;
        uni.downloadFile({
          url,
          success: (res) => {
            console.log('下载完成', res.tempFilePath);
            resolve();
          },
          complete: () => {
            activeDownloads--;
            next();
          }
        });
      })
    );
  });

  function next() {
    if (activeDownloads < maxConcurrent && queue.length) {
      const task = queue.shift();
      task();
    }
  }

  for (let i = 0; i < Math.min(maxConcurrent, urls.length); i++) {
    next();
  }
}