For AI agents: the complete documentation index is available at /apps-plugin/docs/llms.txt, the full documentation bundle is available at /apps-plugin/docs/llms-full.txt, and this page is available as Markdown at /apps-plugin/docs/js-api/router/redirectTo.md.

redirectTo

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

扫码预览

扫码预览 redirectTo

支持版本

前端库版本不低于 0.0.19。

支持平台

平台支持情况
Android支持
iOS支持
PC不支持
HarmonyOS不支持

支持场景

场景支持情况
页面支持
卡片不支持

使用说明

  • url 为应用插件内的页面路径,可携带查询参数;跳转会替换当前页面,不保留在页面栈中。

调用方式

异步 API

redirectTo(params: NavigateToParams): Promise<object>

入参

名称类型必填默认值约束说明
urlstring是--跳转的页面的路径,如 'path?key=value&key2=value2'

调用示例

import { redirectTo } from '@doubao-dev/framework/api';

await redirectTo({ url: '/pages/result/index' });

成功返回

无返回字段。

错误处理

错误对象和通用错误码见 通用错误处理。

失败示例

{
  "errNo": 104,
  "errMsg": "invalid url"
}

错误码

errNoerrMsg平台触发条件处理建议
104invalid urlAndroid、iOSurl 为空或无法解析为有效的应用插件页面路径检查 url 是否为合法的应用内页面路径后重试。

通用错误码

errNoerrMsg说明平台
102internal error内部错误Android、iOS