tt.onAppShow
收藏
我的收藏

基础库 1.46.0 开始支持本方法,这是一个同步方法。

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

前提条件
业务背景
使用限制
注意事项
  • 如在打开或跳转小程序时传递了 encode 后的值作为参数,为避免发生页面错误,请自行将拿到的值使用 decodeURIComponent 进行一次 decode 操作;
  • 如果多次注册同一个回调函数,该回调函数会多次执行。
支持沙盒
相关教程

语法

tt.onAppShow(callback)

参数说明

callback

类型默认值必填说明最低支持版本
function
小程序切前台事件的回调函数。
1.46.0

callback 是一个回调函数,接收 object 类型的参数,属性如下:

属性名类型说明最低支持版本
scenestring

小程序切前台的场景值

1.46.0
referrerInfoobject
来源信息,从另一个小程序或 App 进入小程序时返回
1.46.0
pathstring
小程序切前台的路径 (代码包路径)
1.46.0
queryobject
小程序切前台的 query 参数
1.46.0
showFromenum
唤起小程序页面的来源方式:10 - 用户点击小程序入口 schema,0 - 其它方式(如前后台切换)
2.7.0

referrerInfo 类型说明

object 类型,属性如下:

属性名类型说明最低支持版本
appIdstring
来源小程序的 appId
1.46.0
extraDataobject
来源小程序传过来的数据
1.46.0

返回值

扫码体验

请使用字节宿主APP扫码

代码示例