• JS API 列表
  • 基础
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • 设备
  • 画布
  • 界面
  • 页面导航
  • tt.navigateTo
  • tt.redirectTo
  • tt.switchTab
  • tt.navigateBack
  • tt.reLaunch
  • 开放接口
  • 行业开放
  • 第三方平台
  • 其它
  • 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 组件也可以实现同样的功能。