小程序应用级事件wx.onAppShow

wx.onAppShow(function callback)

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

基础库 2.1.2 开始支持,低版本需做兼容处理。
需要页面权限:当前是插件页面时,宿主小程序不能调用该接口,反之亦然
小程序插件:不支持

参数

function callback

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

参数

Object 启动参数
https://developers.weixin.qq.com/miniprogram/dev/f... colspan="4">
属性 类型 说明 最低版本
path string 启动小程序的路径 (代码包路径)
scene number 启动小程序的场景值
query Object 启动小程序的 query 参数
shareTicket string shareTicket,详见获取更多转发信息
referrerInfo Object 来源信息。从另一个小程序、公众号或 App 进入小程序时返回。否则返回 `{}`。(参见后文注意)
结构属性 类型 说明
appId string 来源小程序、公众号或 App 的 appId
extraData Object 来源小程序传过来的数据,scene=1037或1038时支持
forwardMaterials Array. 打开的文件信息数组,只有从聊天素材场景打开(scene为1173)才会携带该参数
结构属性 类型 说明
type string 文件的mimetype类型
name string 文件名
path string 文件路径(如果是webview则是url)
size number 文件大小
chatType number 从微信群聊/单聊打开小程序时,chatType 表示具体微信群聊/单聊类型
合法值 说明
1 微信联系人单聊
2 企业微信联系人单聊
3 普通微信群聊
4 企业微信互通群聊
apiCategory string API 类别 2.20.0
合法值 说明
default 默认类别
nativeFunctionalized 原生功能化,视频号直播商品、商品橱窗等场景打开的小程序
browseOnly 仅浏览,朋友圈快照页等场景打开的小程序
embedded 内嵌,通过打开半屏小程序能力打开的小程序

返回有效 referrerInfo 的场景

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

不同 apiCategory 场景下的 API 限制

X 表示 API 被限制无法使用;不在表格中的 API 不限制。

default nativeFunctionalized browseOnly embedded
navigateToMiniProgram X</td><td><code>X
openSetting X</td><td></td></tr><tr><td><button open-type="share"></td><td></td><td><code>X X</td><td><code>X
<button open-type="feedback"> X</td><td></td></tr><tr><td><button open-type="open-setting"></td><td></td><td></td><td><code>X
openEmbeddedMiniProgram X</td><td><code>X X

注意

部分版本在无referrerInfo的时候会返回

undefined,建议使用 <code>options.referrerInfo && options.referrerInfo.appId 进行判断。

分类小程序生命周期相关推荐:

小程序生命周期wx.getLaunchOptionsSync 小程序生命周期wx.getEnterOptionsSync 小程序应用级事件wx.onUnhandledRejection 小程序应用级事件wx.onThemeChange 小程序应用级事件wx.onPageNotFound 小程序应用级事件wx.onError 小程序应用级事件wx.onAudioInterruptionEnd 小程序应用级事件wx.onAudioInterruptionBegin 小程序应用级事件wx.onAppShow 小程序应用级事件wx.onAppHide 小程序应用级事件wx.offUnhandledRejection 小程序应用级事件wx.offThemeChange 小程序应用级事件wx.offPageNotFound 小程序应用级事件wx.offError 小程序应用级事件wx.offAudioInterruptionEnd 小程序应用级事件wx.offAudioInterruptionBegin 小程序应用级事件wx.offAppShow 小程序应用级事件wx.offAppHide