小程序开放平台

文档中心
基础
canIUse
base64ToArrayBuffer
arrayBufferToBase64
系统
小程序
生命周期
应用级事件
onUnhandledRejection
onPageNotFound
onError
onAppShow
onAppHide
offUnhandledRejection
offPageNotFound
offError
offAppShow
offAppHide
更新
路由
跳转
转发
界面
网络
支付
数据缓存
媒体
位置
开放接口
设备
XHSML
性能
第三方平台
文件
数据分析
画布

xhs.onAppShow

开发
>
JS API
>
基础
>
小程序
>
应用级事件
>
onAppShow
>
更新时间:2025-04-10 15:30:21

以Promise风格调用: 不支持

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

参数

function callback
小程序切前台事件的回调函数

参数

属性
类型
说明
pathstring小程序切前台的路径 (代码包路径)
scenenumber小程序切前台的场景值(小红书目前暂不支持)
queryobject小程序切前台的 query 参数

注意

实例代码

// 监听小程序切前台事件
xhs.onAppShow((res) => {
  console.log('小程序切前台:', res);

  // 参数说明
  const { path, query, scene } = res;

  console.log('路径:', path);
  console.log('查询参数:', query);
  console.log('场景值(暂不支持):', scene);

  // 根据路径或查询参数执行特定逻辑
  if (path === '/pages/index/index') {
    console.log('切前台时回到首页');
  } else {
    console.log('切前台时回到其他页面');
  }

  // 例如:记录切前台的时间
  const timestamp = Date.now();
  console.log('切前台时间戳:', timestamp);
});
该文档是否对您有帮助?