• JS API 列表
  • 基础
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • 设备
  • 画布
  • 界面
  • 页面导航
  • 开放接口
  • 登录
  • 用户信息
  • 广告
  • 支付
  • 分享
  • 小程序跳转
  • tt.navigateToMiniProgram
  • tt.navigateBackMiniProgram
  • 抖音视频能力
  • 收货地址
  • 设置
  • 授权
  • 评价能力
  • 数据分析
  • 视频拍摄器
  • 引导关注
  • 订阅消息
  • 电商插件能力(即将废弃)
  • AI/AR能力
  • 转发和挂载
  • 直播能力
  • 流量来源识别
  • 侧边栏能力
  • 隐私信息授权
  • web化
  • 行业开放
  • 第三方平台
  • 其它
  • tt.navigateToMiniProgram
    收藏
    我的收藏

    基础库 1.15.0 开始支持本方法,这是一个异步方法。

    跳转到另一个小程序。

    前提条件
    业务背景
    使用限制

    该方法需要预先在 app.json 中配置 navigateToMiniProgramAppIdList 属性。每个小程序可跳转的其他小程序数量限制为不超过10

    注意事项

    跳转需要由用户点击触发,只能在 bindtap 的事件回调中同步使用该 api,并且会弹窗询问是否允许跳转。

    支持沙盒
    相关教程

    语法

    tt.navigateToMiniProgram(options)

    参数说明

    options 为 object 类型,属性如下:

    属性名类型默认值必填说明最低支持版本
    pathstring
    要跳转的小程序页面路径(不传则默认打开首页),允许携带 query 参数,格式详见示例
    1.15.0
    extraDataobject

    需要传递给目标小程序的数据,目标小程序可在 App.onLaunchApp.onShowtt.getLaunchOptionsSync 中获取到这份数据。如果跳转的是小游戏,可以在 tt.onShowtt.getLaunchOptionsSync 中可以获取到这份数据数据

    1.15.0
    envVersionenumcurrent

    要打开的小程序版本。合法的值有 current--线上版;latest--测试版。仅在当前小程序为开发版或测试版时此参数有效。如果当前小程序是正式版,则打开的小程序必定是正式版

    1.15.0
    appIdstring
    要跳转的小程序 id
    1.15.0
    successfunction
    接口调用成功的回调函数
    1.15.0
    failfunction
    接口调用失败的回调函数
    1.15.0
    completefunction
    接口调用结束的回调函数(调用成功、失败都会执行)
    1.15.0

    回调成功

    object 类型,属性如下:

    属性名类型说明最低支持版本
    errMsgstring
    "navigateToMiniProgram:ok"
    1.15.0

    回调失败

    object 类型,属性如下:

    属性名类型说明最低支持版本
    errMsgstring
    "navigateToMiniProgram:fail" + 详细错误信息
    1.15.0

    错误码

    errorCodeerrMsgerrorType说明最低支持版本
    113595navigateToMiniProgram:fail cancelU
    用户取消

    用户取消,不需要特殊处理

    1.15.0
    113502navigateToMiniProgram:fail appId xxx is not in navigateToMiniProgramAppIdListD
    小程序不在列表里

    检查navigateToMiniProgramAppIdList

    1.15.0
    113591avigateToMiniProgram:fail Internal error xxxF
    小程序框架内部错误,有需要请创建工单咨询
    1.15.0
    113501navigateToMiniProgram:fail can not jump to selfD
    不能跳转到当前小程序

    不能跳转到当前小程序

    1.15.0
    113599navigateToMiniProgram:fail params.xxx should be xxx, but got xxxD
    入参无效

    检查入参

    1.15.0
    113583navigateToMiniProgram:fail platform auth denyD
    开发者错误,没有申请appid的权限

    请查看能力对应文档,申请对应的能力白名单

    1.15.0

    扫码体验

    请使用字节宿主APP扫码

    代码示例