tt.navigateToMiniProgram
收藏基础库 1.15.0 开始支持本方法，这是一个异步方法。
跳转到另一个小程序。
| 前提条件 | 无 |
| 业务背景 | 无 |
| 使用限制 |
|
| 注意事项 | 跳转需要由用户点击触发，只能在 bindtap 的事件回调中同步使用该 api，并且会弹窗询问是否允许跳转。 |
| 支持沙盒 | 否 |
| 相关教程 | 无 |
语法
tt.navigateToMiniProgram(options)
参数说明
options 为 object 类型，属性如下：
| 属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
|---|---|---|---|---|---|
| path | string | 否 | 要跳转的小程序页面路径（不传则默认打开首页），允许携带 query 参数，格式详见示例 | 1.15.0 | |
| extraData | object | 否 | 需要传递给目标小程序的数据，目标小程序可在 App.onLaunch，App.onShow，tt.getLaunchOptionsSync 中获取到这份数据。如果跳转的是小游戏，可以在 tt.onShow，tt.getLaunchOptionsSync 中可以获取到这份数据数据 | 1.15.0 | |
| envVersion | enum | current | 否 | 要打开的小程序版本。合法的值有 current--线上版；latest--测试版。仅在当前小程序为开发版或测试版时此参数有效。如果当前小程序是正式版，则打开的小程序必定是正式版 | 1.15.0 |
| appId | string | 是 | 要跳转的小程序 id | 1.15.0 | |
| success | function | 否 | 接口调用成功的回调函数 | 1.15.0 | |
| fail | function | 否 | 接口调用失败的回调函数 | 1.15.0 | |
| complete | function | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） | 1.15.0 |
回调成功
object 类型，属性如下：
| 属性名 | 类型 | 说明 | 最低支持版本 |
|---|---|---|---|
| errMsg | string | "navigateToMiniProgram:ok" | 1.15.0 |
回调失败
object 类型，属性如下：
| 属性名 | 类型 | 说明 | 最低支持版本 |
|---|---|---|---|
| errMsg | string | "navigateToMiniProgram:fail" + 详细错误信息 | 1.15.0 |
错误码
| errorCode | errMsg | errorType | 说明 | 最低支持版本 |
|---|---|---|---|---|
| 113595 | navigateToMiniProgram:fail cancel | U | 用户取消 用户取消，不需要特殊处理 | 1.15.0 |
| 113502 | navigateToMiniProgram:fail appId xxx is not in navigateToMiniProgramAppIdList | D | 小程序不在列表里 检查navigateToMiniProgramAppIdList | 1.15.0 |
| 113591 | avigateToMiniProgram:fail Internal error xxx | F | 小程序框架内部错误，有需要请创建工单咨询 | 1.15.0 |
| 113501 | navigateToMiniProgram:fail can not jump to self | D | 不能跳转到当前小程序 不能跳转到当前小程序 | 1.15.0 |
| 113599 | navigateToMiniProgram:fail params.xxx should be xxx, but got xxx | D | 入参无效 检查入参 | 1.15.0 |
| 113583 | navigateToMiniProgram:fail platform auth deny | D | 开发者错误,没有申请appid的权限 请查看能力对应文档，申请对应的能力白名单 | 1.15.0 |
扫码体验
请使用字节宿主APP扫码
