tt.onAppLaunch
收藏
我的收藏

基础库 2.8.0 开始支持本方法,这是一个同步方法。​
监听小程序启动事件。该事件与 App.onLaunch 的回调时机与参数一致。​

语法​

tt.onAppLaunch(callback)

参数说明​

callback​

类型​
默认值​
必填​
说明​
最低支持版本​
function​
是​
启动事件的回调参数​
2.8.0​

回调函数参数说明​

object 类型,属性如下:​
属性名​
类型​
说明​
最低支持版本​
path​
string​
小程序启动页面路径​
2.8.0​
scene​
string​
小程序启动场景值
2.8.0​
query​
object​
小程序启动参数​
2.8.0​
refererInfo​
RefererInfo​
来源信息,从另一个小程序进入小程序时会有具体信息,否则返回 {}​
2.8.0​
showFrom​
number​
唤起小程序的方式,目前取值固定为 10,表示通过 schema 唤起​
2.8.0​
RefererInfo 类型说明​
object 类型,属性如下:​
属性名​
类型​
说明​
最低支持版本​
appId​
string​
来源小程序的 appId​
2.8.0​
extraData​
object​
来源小程序传过来的数据,场景值为 "011009" 或 "011010" 时支持​
2.8.0​

扫码体验​

代码示例​

<view class="content"> <text class="title">小程序启动参数:</text> <view class="attr-wrap"> <text class="attr">scene: {{launchQuery.scene}}</text> <text class="attr">path: {{launchQuery.path}}</text> <text class="attr">query: {{launchQuery.query}}</text> <text class="attr">referrerInfo: {{launchQuery.referrerInfo}}</text> <text class="attr">showFrom: {{launchQuery.showFrom}}</text> </view> <button size="default" class="clear-btn" bindtap="clearAllAttr" disabled="{{!launchQuery.path}}"> 清空上面参数 </button> </view>
Page({ data: { launchQuery: {}, }, onLoad: function (options) { tt.onAppLaunch((res) => { const params = Object.assign({}, res); console.log("scene: ", params.scene); console.log("path: ", params.path); console.log("query: ", params.query); console.log("referrerInfo: ", params.referrerInfo); console.log("showFrom: ", params.showFrom); params.query = params.query && JSON.stringify(params.query); params.referrerInfo = params.referrerInfo && JSON.stringify(params.referrerInfo); this.setData({ launchQuery: params, }); console.log("onAppLaunch success"); tt.showToast({ title: "已成功监听小程序启动事件", icon: "none", duration: 3000, }); }); }, clearAllAttr() { this.setData({ launchQuery: {}, }); }, });

Bug & Tip​

无​