tencent cloud

跳转

PDF
聚焦模式
字号
最后更新时间: 2025-02-24 17:10:35

exitMiniProgram

该 API 使用方法为 wx.exitMiniProgram(Object object)
说明:
该 API 小程序支持,小游戏暂不支持。
功能说明:退出当前小程序。必须有单击行为才能调用成功。
参数及说明:Object object。
属性
类型
默认值
必填
说明
success
function
-
接口调用成功的回调函
fail
function
-
接口调用失败的回调函数
complete
function
-
接口调用结束的回调函数(调用成功、失败都会执行)

navigateToMiniProgram

该 API 使用方法为 wx.navigateToMiniProgram(Object object)
说明:
该 API 小程序支持,小游戏暂不支持。
功能说明:打开另一个小程序。
参数及说明:Object object。
属性
类型
默认值
必填
说明
appId
string
-
要打开的小程序 appId
path
string
-
打开的页面路径,如果为空则打开首页, path 中 ? 后面的部分会成为 query,在小程序的 App.onLaunchApp.onShowPage.onLoad 的回调函数或 wx.getLaunchOptionsSync 中可以获取到 query 数据。
extraData
object
-
需要传递给目标小程序的数据,目标小程序可在 App.onLaunchApp.onShow 中获取到这份数据
envVersion
string
release
要打开的小程序版本。仅在当前小程序为开发版或体验版时此参数有效。如果当前小程序是正式版,则打开的小程序必定是正式版,其合法值如下:
develop:开发版
trial:体验版
release:正式版
success
function
-
接口调用成功的回调函数
fail
function
-
接口调用失败的回调函数
complete
function
-
接口调用结束的回调函数(调用成功、失败都会执行)

使用限制

需要用户触发跳转

若用户未单击小程序页面任意位置,则开发者将无法调用此接口自动跳转至其他小程序。

需要用户确认跳转

在跳转至其他小程序前,将统一增加弹窗,询问是否跳转,用户确认后才可以跳转其他小程序。如果用户单击取消,则回调fail cancel

每个小程序可跳转的其他小程序数量限制为不超过10个

开发者提交新版小程序代码时,如使用了跳转其他小程序功能,则需要在代码配置中声明将要跳转的小程序名单,限定不超过10个,否则将无法通过审核。该名单可在发布新版时更新,不支持动态修改。配置方法详见 配置。调用此接口时,所跳转的 appId 必须在配置列表中,否则回调fail appId "${appId}" is not in navigateToMiniProgramAppIdList
示例代码:
wx.navigateToMiniProgram({
appId: '',
path: 'page/index/index?id=123',
extraData: {
foo: 'bar'
},
envVersion: 'develop',
success(res) {
// 打开成功
}
})

navigateBackMiniProgram

该 API 使用方法为 wx.navigateBackMiniProgram(Object object)
说明:
该API 小程序支持,小游戏暂不支持。
功能说明:返回到上一个小程序。只有在当前小程序是被其他小程序打开时可以调用成功。
参数及说明:Object object。
属性
类型
默认值
必填
说明
extraData
Object
{}
需要返回给上一个小程序的数据,上一个小程序可在 App.onShow 中获取到这份数据
success
function
-
接口调用成功的回调函数
fail
function
-
接口调用失败的回调函数
complete
function
-
接口调用结束的回调函数(调用成功、失败都会执行)
示例代码:
wx.navigateBackMiniProgram({
extraData: {
foo: 'bar'
},
success(res) {
// 返回成功
}
})


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈