tt.onAppLaunch
收藏
我的收藏

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

监听小程序启动事件。该事件与 App.onLaunch 的回调时机与参数一致。

语法

JavaScript复制
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

扫码体验

代码示例

HTML复制
<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>

JavaScript复制
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: {},
    });
  },
});