如何使用 wx.downloadFile 下载文件？

推荐答案

// www.javascriptcn.com code example
wx.downloadFile({
  url: 'https://example.com/file.pdf', // 文件的下载地址
  success(res) {
    // 下载成功后，文件临时路径在 res.tempFilePath
    console.log('文件下载成功，临时路径:', res.tempFilePath);
    // 可以在这里进行文件保存或其他操作
  },
  fail(err) {
    console.error('文件下载失败:', err);
  },
  complete() {
    console.log('下载操作完成');
  }
});

本题详细解读

1. wx.downloadFile 的作用

wx.downloadFile 是微信小程序提供的 API，用于从指定的 URL 下载文件到本地。下载的文件会存储在临时路径中，开发者可以根据需要将文件保存到本地或进行其他操作。

2. 参数说明

• url: 必填，表示要下载文件的网络地址。
• success: 下载成功后的回调函数，返回一个包含临时文件路径的对象 res，路径可以通过 res.tempFilePath 获取。
• fail: 下载失败时的回调函数，返回错误信息。
• complete: 下载操作完成时的回调函数，无论成功或失败都会执行。

3. 注意事项

• 下载的文件会存储在临时路径中，小程序关闭后可能会被清理。如果需要永久保存，可以使用 wx.saveFile 将文件保存到本地。
• 下载的文件大小限制为 10MB，超过此大小可能会导致下载失败。
• 下载的文件路径是临时路径，开发者可以根据需要进行进一步处理，如预览、保存等。

4. 示例代码解析

在示例代码中，我们使用 wx.downloadFile 下载一个 PDF 文件。下载成功后，文件的临时路径会通过 res.tempFilePath 返回，开发者可以在此路径上进行进一步操作，如保存文件或预览文件。如果下载失败，错误信息会通过 fail 回调返回。

5. 扩展应用

• 保存文件: 下载成功后，可以使用 wx.saveFile 将文件保存到本地。
• 预览文件: 可以使用 wx.openDocument 打开并预览下载的文件。
• 文件上传: 下载的文件可以作为后续上传操作的源文件。