监听小程序切前台事件。该事件与 App.onShow 的回调参数一致。

返回有效 referrerInfo 的场景

场景值场景appId含义
1020公众号 profile 页相关小程序列表来源公众号
1035公众号自定义菜单来源公众号
1036App 分享消息卡片来源App
1037小程序打开小程序来源小程序
1038从另一个小程序返回来源小程序
1043公众号模板消息来源公众号

注意

部分版本在无referrerInfo的时候会返回 undefined，建议使用 options.referrerInfo && options.referrerInfo.appId 进行判断。

参考文档

类型

  1. (callback: (result: CallbackResult) => void) => void

参数

CallbackResult

参数类型说明
pathstring小程序切前台的路径
queryRecord<string, any>小程序切前台的 query 参数
referrerInfoResultReferrerInfo来源信息。从另一个小程序、公众号或 App 进入小程序时返回。否则返回 {{}}。(参见后文注意)
scenenumber小程序切前台的场景值
shareTicketstringshareTicket，详见获取更多转发信息

ResultReferrerInfo

来源信息。从另一个小程序、公众号或 App 进入小程序时返回。否则返回 {}。(参见后文注意)

参数类型说明
appIdstring来源小程序、公众号或 App 的 appId
extraDataRecord<string, any>来源小程序传过来的数据，scene=1037或1038时支持

API 支持度

API微信小程序H5React Native
Taro.onAppShow✔️