# wx.getBackgroundFetchData(object object)

基础库 2.8.0 开始支持,低版本需做兼容处理

以 [Promise 风格]((app-service/api#异步 -API- 返回-Promise)) 调用:支持

小程序插件:不支持

相关文档: 周期性更新数据预拉取

# 功能描述

拉取 backgroundFetch 客户端缓存数据。 当调用接口时,若当次请求未结束,会先返回本地的旧数据(之前打开小程序时请求的),如果本地没有旧数据会返回失败,而不会等待请求完成。

# 参数

# object object

属性 类型 默认值 必填 说明
fetchType String 缓存数据类别,取值为 periodic 或 pre
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

# object.success 回调函数

# 参数
# Object res
属性 类型 说明
fetchedData String 缓存数据
timeStamp Number 客户端拿到缓存数据的时间戳。(注:安卓 timeStamp 单位是 ms,iOS timeStamp 单位是 s)
path String 小程序页面路径
query String 传给页面的 query 参数
scene Number 进入小程序的场景值