客户端 API/网页应用/小程序API/导航/switchTab
# switchTab(Object object)

跳转到指定 TabBar 页面，并关闭其他所有非 TabBar 页面。
**注意事项**：将要跳转到的 TabBar 页面需要在app.json中定义。

## 支持说明

应用能力 | Android | iOS | PC | 预览效果
---|---|---|---|---
小程序 | **✓** | **✓** | **✓** | 预览
网页应用 | **X** | **X** | **X** | /

## 输入

继承[标准对象输入](https://open.larksuite.com/document/uYjL24iN/ukzNy4SO3IjL5cjM)，扩展属性描述：

名称 | 数据类型 | 必填 | 默认值 | 描述
---|---|---|---|---
url | string | 是 | &nbsp; | 需要跳转的 TabBar 页面的路径。**路径后不能携带参数**<br>**示例值**：/page/API/index

## 输出

继承[标准对象输出](https://open.larksuite.com/document/uYjL24iN/ukzNy4SO3IjL5cjM#8c92acb8)，无扩展属性

## 示例代码

```js
tt.switchTab({
    "url": "/pages/api/index",
    success(res) {
      console.log(JSON.stringify(res));
    },
    fail(res) {
      console.log(`switchTab fail: ${JSON.stringify(res)}`);
    }
});
```

返回值示例：
```json
{"errMsg":"switchTab:ok"}
```