• JS API 列表
  • 基础
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • 设备
  • 画布
  • 界面
  • 页面导航
  • tt.navigateTo
  • tt.redirectTo
  • tt.switchTab
  • tt.navigateBack
  • tt.reLaunch
  • 开放接口
  • 行业开放
  • 第三方平台
  • 其它
  • tt.reLaunch
    收藏
    我的收藏

    基础库 1.0.0 开始支持本方法,这是一个异步方法。

    关闭所有页面,打开应用内的某个页面。

    前提条件
    业务背景
    使用限制
    注意事项
    Tip: 使用 navigator 组件也可以实现同样的功能
    支持沙盒
    相关教程

    语法

    tt.reLaunch(options)

    参数说明

    options 为 object 类型,属性如下:

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

    回调成功

    object 类型,属性如下:

    属性名类型说明最低支持版本
    errMsgstring
    "reLaunch:ok"
    1.0.0

    回调失败

    object 类型,属性如下:

    属性名类型说明最低支持版本
    errMsgstring
    "reLaunch:fail" + 详细错误信息
    1.0.0

    错误码

    errorCodeerrMsgerrorType说明最低支持版本
    102303Full screen player existsD
    播放器全屏时调用
    1.0.0
    102399params url is requiredurl is invalid. params.url should be string, but got undefinedparams. url should be string, but got ${url}url is invalidD
    没传 url 参数没传 path,page 实例构造失败, url 不合法
    1.0.0
    102304The plugin page not foundD
    插件的 config 里是否包含 page
    1.0.0
    102310The app launch page errorD
    首次路由页面错误
    1.0.0
    102307invalid plugin loaderF
    小程序框架内部错误,有需要请创建工单咨询
    1.0.0
    102308plugin decode failedF
    小程序框架内部错误,有需要请创建工单咨询
    1.0.0
    102309{task/common}, has been releasedF
    小程序框架内部错误,有需要请创建工单咨询
    1.0.0
    102305url ${url} is not in app.jsonD
    Appjson 中不存在该页面
    1.0.0
    102306this page has been blockedD
    页面因为违规被封禁
    1.0.0
    102301top view is nullD
    当前不存在页面
    1.0.0
    102399params.url should be string, but got undefinedparams.url should be string, but got ${url}url is invalidD
    url 不合法
    1.0.0

    扫码体验

    请使用字节宿主APP扫码

    代码示例