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

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

    关闭当前页面,跳转到应用内的某个页面,不能跳转到 tabBar 页面。

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

    语法

    tt.redirectTo(options)

    参数说明

    options 为 object 类型,属性如下:

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

    回调成功

    object 类型,属性如下:

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

    回调失败

    object 类型,属性如下:

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

    错误码

    errorCodeerrMsgerrorType说明最低支持版本
    102099params url is requiredurl is invalidparams.url should be string, but got undefinedparams.url should be string, but got ${url}url is invalidD
    没传 url 参数没传 path,page 实例构造失败3-5. url 不合法
    1.0.0
    102004The plugin page not foundD
    插件的 config 里是否包含 page
    1.0.0
    102010The app launch page errorD
    首次路由页面错误
    1.0.0
    102007invalid plugin loaderF
    小程序框架内部错误,有需要请创建工单咨询
    1.0.0
    102008plugin decode failedF
    小程序框架内部错误,有需要请创建工单咨询
    1.0.0
    102009{task/common}, has been releasedF
    小程序框架内部错误,有需要请创建工单咨询
    1.0.0
    102002Can only jump to non-tab pagesD
    只能跳转到非 tab 页面
    1.0.0
    102003Full screen player existsD
    播放器全屏时调用
    1.0.0
    102006this page has been blockedD
    页面因为违规被封禁
    1.0.0
    102005url ${url} is not in app.jsonD
    Appjson 中不存在该页面
    1.0.0
    102001top view is nullD
    当前不存在页面
    1.0.0
    102099params.url should be string, but got undefinedparams.url should be string, but got ${url}url is invalidD
    url 不合法
    1.0.0

    代码示例