ks.navigateTo

更新时间：2024-09-19 14:44:22

保留当前页面，跳转到应用内的某个页面。不能跳转到 tabBar 页面。小程序页面栈的最大深度为六层。

navigateTo(options: NavigateToOptions): Promise<NavigateToResult>

参数

参数	类型	必填
options	NavigateToOptions	是

NavigateToOptions

属性

属性	类型	必填	说明
url	string	是	需要跳转到的页面的代码包路径。路径后可以带参数，参数与路径之间用 ? 分隔，参数键与参数值之间用 = 相连，不同参数之间用 & 分隔，如 'path?key=value&key2=value2'
events	Record<string, (data: unknown) => void>	否	页面间通信接口，用于监听被打开页面发送到当前页面的数据
success	(result: NavigateToResult) => void	否	接口调用成功的回调函数
fail	(error: APIError) => void	否	接口调用失败的回调函数
complete	(resultOrError: NavigateToResult | APIError) => void	否	接口调用结束的回调函数（调用成功、失败都会执行）

返回值

Promise<NavigateToResult>

NavigateToResult

属性

属性	类型	说明
eventChannel	EventChannel	和被打开页面进行通信

错误信息

错误信息	错误说明
app not in foreground	当前小程序未在前台
page xxx is not found	页面未找到
can not navigateTo a tabbar page	不能跳转到tabbar页面
reach max WebView Depth x	超过页面栈最大深度

扫码体验

示例代码