微信小程序开发文档微信小程序API 打开小程序

2024-02-25 开发教程微信小程序开发文档匿名 3℃

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) {
    // 返回成功
  }
})

上一节：微信小程序API 用户数据的签名验证和加解密

下一节：微信小程序API 账号信息

"微信小程序开发文档"的目录

微信小程序开发文档 微信小程序API 打开小程序

wx.navigateToMiniProgram(OBJECT)

Bug & Tip

wx.navigateBackMiniProgram(OBJECT)

微信小程序开发文档微信小程序API 打开小程序