一、使用uniapp内置的downloadFile
uniapp提供了一个下载文件的API:downloadFile。通过该API可以简单地实现文件下载。具体使用方法如下:
uni.downloadFile({ url: 'http://example.com/file.zip', success: (res) => { if (res.statusCode === 200) { uni.saveFile({ tempFilePath: res.tempFilePath, success: function(res) { console.log('文件下载并保存成功'); } }); } } });
以上代码会从http://example.com/file.zip路径下载文件,并将文件保存到本地。当然,也可以自定义下载的文件名和路径。
二、使用原生XMLHttpRequest
如果需要更精细化地控制文件下载过程,可以使用XMLHttpRequest。XMLHttpRequest是浏览器提供的原生API,可以通过它发起HTTP请求,实现文件下载功能。uniapp也提供了XMLHttpRequest的封装,即uni.request。下面是使用XMLHttpRequest实现文件下载的代码示例:
uni.request({ url: "http://example.com/file.zip", method: "GET", responseType: "arraybuffer", success: (response) => { const fileData = new Uint8Array(response.data); const blob = new Blob([fileData], {type: "application/octet-stream"}); const url = URL.createObjectURL(blob); const elem = window.document.createElement('a'); elem.href = url; elem.download = "file.zip"; document.body.appendChild(elem); elem.click(); document.body.removeChild(elem); }, });
以上代码实现了从远程URL下载文件,并通过Blob和URL.createObjectURL将二进制内容转化为可下载的URL。最终会通过创建一个下载链接来触发文件下载。需要注意的是,这里的responseType必须为arraybuffer,以便正确地处理二进制数据。
三、使用第三方库
如果需要更高级的功能,比如下载进度条、断点续传等,可以使用一些优秀的第三方库来实现。这里介绍两个常用的第三方库:axios和downloadjs。
axios是基于Promise的HTTP客户端库,支持浏览器和Node.js环境。它提供了一些方便的方法来处理HTTP请求和响应。下面是使用axios实现文件下载的示例:
axios({ url: 'http://example.com/file.zip', method: 'GET', responseType: 'blob', onDownloadProgress: function(progressEvent) { const percentCompleted = Math.round((progressEvent.loaded * 100) / progressEvent.total); console.log(percentCompleted); }, }).then((response) => { const url = window.URL.createObjectURL(new Blob([response.data])); const link = document.createElement('a'); link.href = url; link.setAttribute('download', 'file.zip'); document.body.appendChild(link); link.click(); });
以上代码使用axios下载文件,并通过onDownloadProgress回调函数实现了下载进度的监听。同时,利用Blob和URL.createObjectURL将返回的二进制数据转化为可供下载的URL。
downloadjs是专门用于浏览器文件下载的库,提供了非常简单的API。下面是使用downloadjs实现文件下载的示例:
download('http://example.com/file.zip', 'file.zip', 'application/octet-stream');
以上代码使用downloadjs下载文件,并指定文件名和MIME类型。downloadjs还可以自动处理断点续传等高级功能,非常方便实用。
四、小结
本文介绍了几种实现uniapp文件下载的方法,包括内置downloadFile、原生XMLHttpRequest、第三方库axios和downloadjs。使用这些方法可以简单方便地实现文件下载功能,同时也能够实现更高级的特性。