微信小程序API 打开小程序
wx.navigateToMiniProgram(OBJECT)
基础库 1.3.0 开始支持,低版本需做兼容处理
iOS 微信客户端 6.5.9 版本开始支持,Android 客户端即将在 6.5.10 版本开始支持,请先使用 iOS 客户端进行调试
打开同一公众号下关联的另一个小程序。
OBJECT参数说明:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
appId | String | 是 | 要打开的小程序 appId |
path | String | 否 | 打开的页面路径,如果为空则打开首页 |
extraData | Object | 否 | 需要传递给目标小程序的数据,目标小程序可在 App.onLaunch() ,App.onShow() 中获取到这份数据。详情 |
envVersion | String | 否 | 要打开的小程序版本,有效值 develop(开发版),trial(体验版),release(正式版) ,仅在当前小程序为开发版或体验版时此参数有效;如果当前小程序是体验版或正式版,则打开的小程序必定是正式版。默认值 release |
success | Function | 否 | 接口调用成功的回调函数 |
fail | Function | 否 | 接口调用失败的回调函数 |
complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
success返回参数说明:
参数名 | 类型 | 说明 |
---|---|---|
errMsg | String | 调用结果 |
示例代码:
wx.navigateToMiniProgram({
appId: '',
path: 'pages/index/index?id=123',
extraData: {
foo: 'bar'
},
envVersion: 'develop',
success(res) {
// 打开成功
}
})
Bug & Tip
- tip: 在开发者工具上调用此 API 并不会真实的跳转到另外的小程序,但是开发者工具会校验本次调用跳转是否成功详情
- tip: 开发者工具上支持被跳转的小程序处理接收参数的调试详情
- tip: 只有同一公众号下的关联的小程序之间才可相互跳转 详情
wx.navigateBackMiniProgram(OBJECT)
基础库 1.3.0 开始支持,低版本需做兼容处理
iOS 微信客户端 6.5.9 版本开始支持,Android 客户端即将在 6.5.10 版本开始支持,请先使用 iOS 客户端进行调试
返回到上一个小程序,只有在当前小程序是被其他小程序打开时可以调用成功
OBJECT参数说明:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
extraData | Object | 否 | 需要返回给上一个小程序的数据,上一个小程序可在App.onShow() 中获取到这份数据。详情 |
success | Function | 否 | 接口调用成功的回调函数 |
fail | Function | 否 | 接口调用失败的回调函数 |
complete | Function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
success返回参数说明:
参数名 | 类型 | 说明 |
---|---|---|
errMsg | String | 调用结果 |
示例代码:
wx.navigateBackMiniProgram({
extraData: {
foo: 'bar'
},
success(res) {
// 返回成功
}
})