Version: next

Taro.onAppShow(callback)

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

返回有效 referrerInfo 的场景

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

注意

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

参考文档

类型

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

参数

CallbackResult

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

ResultReferrerInfo

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

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

API 支持度

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