Taro.onAppShow(callback)

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

返回有效 referrerInfo 的场景

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

注意

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

支持情况：

参考文档

类型

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

参数

参数	类型	说明
callback	(res: CallbackResult) => void	小程序切前台事件的回调函数

CallbackResult

参数	类型	必填	说明
path	string	是	小程序切前台的路径
query	TaroGeneral.IAnyObject	是	小程序切前台的 query 参数
shareTicket	string	是	shareTicket，详见获取更多转发信息
scene	number	是	小程序切前台的场景值
referrerInfo	ResultReferrerInfo	是	来源信息。从另一个小程序、公众号或 App 进入小程序时返回。否则返回 {}。(参见后文注意)
forwardMaterials	ForwardMaterial[]	否	打开的文件信息数组，只有从聊天素材场景打开（scene为1173）才会携带该参数
chatType	keyof ChatType	否	从微信群聊/单聊打开小程序时，chatType 表示具体微信群聊/单聊类型
apiCategory	keyof ApiCategory	否	API 类别

ResultReferrerInfo

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

参数	类型	必填	说明
appId	string	否	来源小程序、公众号或 App 的 appId
extraData	TaroGeneral.IAnyObject	否	来源小程序传过来的数据，scene=1037或1038时支持

ForwardMaterial

ChatType 类型合法值

参数	类型	说明
type	string	文件的mimetype类型
name	string	文件名
path	string	文件路径（如果是webview则是url）
size	number	文件大小

ChatType

ChatType 类型合法值

参数	说明
1	微信联系人单聊
2	企业微信联系人单聊
3	普通微信群聊
4	企业微信互通群聊

ApiCategory

API 类别合法值

参数	说明
default	默认类别
nativeFunctionalized	原生功能化，视频号直播商品、商品橱窗等场景打开的小程序
browseOnly	仅浏览，朋友圈快照页等场景打开的小程序
embedded	内嵌，通过打开半屏小程序能力打开的小程序