官方开发文档wx.downloadFile(OBJECT)
下载文件资源到本地,客户端直接发起一个HTTPGET请求,返回文件的本地临时路径。使用前请先阅读。
OBJECT参数说明:
参数类型必填必填urlString是下载资源的urlheaderObject否HTTP请求Header,header中不能设置ReferersuccessFunction否下载成功后以tempFilePath的形式传给页面,res={tempFilePath:'文件的临时路径'}failFunction否接口调用失败的回调函数completeFunction否接口调用结束的回调函数(调用成功、失败都会执行)注:文件的临时路径,在小程序本次启动期间可以正常使用,如需持久保存,需在主动调用,才能在小程序下次启动时访问得到。
success返回参数说明:
参数类型说明tempFilePathString临时文件路径,下载后的文件会存储到一个临时文件statusCodeNumber开发者服务器返回的HTTP状态码返回值:
基础库1.4.0开始支持,低版本需做
返回一个downloadTask对象,通过downloadTask,可监听下载进度变化事件,以及取消下载任务。
downloadTaskdownloadTask对象的方法列表:
方法参数说明最低版本onProgressUpdatecallback监听下载进度变化abort中断下载任务onProgressUpdate返回参数说明:
参数类型说明progressNumber下载进度百分比totalBytesWrittenNumber已经下载的数据长度,单位BytestotalBytesExpectedToWriteNumber预期需要下载的数据总长度,单位Bytes
wxml:
buttonbindtap='down_file'下载/button//用来触发下载函数的按钮viewimagesrc='{{img_l}}'bindtap='preview_img'/image/view下载的资源在服务器中支持:
page({data:{img_l:''},preview_img:function(){//图片预览函数wx.previewImage({current:this.data.img_l,//当前显示图片的http链接urls:this.data.img_l//需要预览的图片http链接列表})},down_file:function(){var_this=this;constdownloadTask=wx.downloadFile({url:'http://127.0.0.1/m_pro/min_img/1517295297785-2018-01-30.jpg',//仅为示例,并非真实的资源success:function(res){//只要服务器有响应数据,就会把响应内容写入文件并进入success回调,业务需要自行判断是否下载到了想要的内容console.log(res)if(res.statusCode===200){_this.setData({img_l:res.tempFilePath//将下载的图片临时路径赋值给img_l,用于预览图片})}}})downloadTask.onProgressUpdate((res)={console.log('下载进度',res.progress)console.log('已经下载的数据长度',res.totalBytesWritten)console.log('预期需要下载的数据总长度',res.totalBytesExpectedToWrite)})}})
最新资讯
-

小程序制作平台选型踩坑记录:2026年五大主流方案横向对比
2026 年微信小程序月活达 10.7 亿、覆盖 108 个行业,本次横向对比即速应用、乔拓云、凡科、有赞、微盟五大主流平台,分三阶段给出选型结论,核心聚焦成本、扩展性、运营能力三大维度。 -

即速应用,赋能企业玩转微信小程序智慧经营
作为国内领军的智慧商业经营服务商,即速应用始终秉承“让每个企业都拥有自己的智慧店铺”的愿景,持续赋能更多企业玩转智慧经营。即速应用旗下拥有“小程序搭建工具-即速应用”、“私域流量专家-即客云”等产品,帮助商家打通互联网全生态营销闭环。 -

即客云2.0重磅更新,让微信小程序运营更简单!
即客云作为一款基于企业微信的第三方工具,现从多维度提供超过30种功能,自上线以来,已服务多家企业,受到一致好评。近期,我们根据客户反馈和市场调研正式推出升级版 即客云2.0!更新了私域运营SOP,群日历功能,批量拓客,客户雷达,消息推送,个人欢迎语,帮助企业更好运用企业微信;同时提升了社群运营工作标准化,提升运营效率,帮助企业实现客户增长,玩转私域流量。










