tt.reLaunch
收藏
我的收藏

基础库 1.0.0 开始支持本方法,这是一个异步方法。​
关闭所有页面,打开应用内的某个页面。​

语法​

tt.reLaunch(options)

参数说明​

options 为 object 类型,属性如下:​
属性名​
类型​
默认值​
必填​
说明​
最低支持版本​
url​
string​
是​
需要跳转的应用内页面路径,路径后可以带参数,参数与路径之间使用 ? 分隔,参数键与参数值用 = 相连,不同参数用 & 分隔,如 "path?key=value&key2=value2"​
1.0.0​
query​
object​
否​
跳转时需要传递的 query 参数,query 对象中的 key、value 最终会被拼接到 url 中,如 "key1=value1&key2=value2"。请注意,如果 query 对象中的 key 和 url 中的 key 重复将被忽略。​
3.7.0​
success​
function​
否​
接口调用成功后的回调函数​
1.0.0​
fail​
function​
否​
接口调用失败后的回调函数​
1.0.0​
complete​
function​
否​
接口调用结束后的回调函数(调用成功、失败都会执行)​
1.0.0​

回调成功​

object 类型,属性如下:​
属性名​
类型​
说明​
最低支持版本​
errMsg​
string​
"reLaunch:ok"​
1.0.0​

回调失败​

object 类型,属性如下:​
属性名​
类型​
说明​
最低支持版本​
errMsg​
string​
"reLaunch:fail " + 错误信息​
1.0.0​

错误码​

errNo​
errMsg​
说明​
最低支持版本​
20000​
reLaunch:fail params.url should be string, but got undefined​
url 未传​
2.28.0​
20000​
reLaunch:fail params.url should be string, but got ${url}​
url 为非字符串​
2.28.0​
20000​
reLaunch:fail url is invalid​
url 无效​
2.28.0​
21301​
reLaunch:fail top view is null​
当前未打开任何页面​
2.28.0​
21500​
reLaunch:fail url "${removeHtmlSuffixFromUrl(url)}" is not in app.json​
页面未在 app.json 中配置​
2.28.0​
21500​
reLaunch:fail this page has been blocked​
目标页面被屏蔽​
2.28.0​

扫码体验​

代码示例​

Bug & Tip​

    Tip:使用 navigator 组件也可以实现同样的功能。​