my.onAppShow

简介

my.onAppShow

监听小程序切前台事件。

调用此接口实质为动态注册 app.js 注册小程序 生命周期事件回调。对应的取消监听接口为 my.offAppShow

入参

Function listener

参数

Object res

属性

类型

描述

path

String

启动小程序的路径(代码包路径)。

scene

Number

启动小程序的场景值。

query

Object

启动小程序的 query 参数。

referrerInfo

Object

来源消息。

重要

低版本基础库上此字段可能为 undefined。因此获取其属性时请注意先判空,如:options.referrerInfo && options.referrerInfo.appId

apiCategory

string

API 类别。

referrerInfo

属性

类型

描述

appId

String

来源小程序。

extraData

Object

来源小程序使用 my.navigateToMiniProgramextraData 入参传递的数据。

apiCategory

枚举值

描述

兼容性

default

默认类型。

-

embedded

以半屏方式打开小程序时返回。

基础库:2.7.22+

代码示例

my.onAppShow(Function listener)

const onAppShowHandler = (res) => {
  console.log('onAppShow:', res)
};

my.onAppShow(onAppShowHandler);