# showToast(Object object)

showToast(Object object) 用于显示灰色背景（PC 端为彩色背景）的消息提示。

## 注意事项

多次弹出 `toast/loading` 时，后一个会立刻覆盖前一个。

## 支持说明

该接口支持小程序和网页应用调用，对应的客户端版本支持情况如下所示。

应用能力 | Android | iOS | PC | Harmony | 预览效果
---|---|---|---|---|---
小程序 | **✓** | **✓** | **✓** | V7.35.0+ | 预览
网页应用 | V3.44.0+ | V3.44.0+ | V3.47.0+ | V7.35.0+ | 预览

## 输入

该接口继承[标准对象输入](https://open.feishu.cn/document/uYjL24iN/ukzNy4SO3IjL5cjM)，扩展属性如下所示。

名称 | 数据类型 | 是否必填 | 默认值 | 描述
---|---|---|---|---
title | string | 是 | \- | 消息内容。最多显示 2 行，示例值：添加购物车成功<br>**注意事项**：V7.11 版本以前且平台为移动端时<br>- 当显示图标时，title 最多可显示 7 个中文字符。<br>- 当不显示图标时，title 最多可显示 2 行。
duration | number | 否 | 1500 | 提示框停留的时间。单位：ms
icon | string | 否 | success | 图标的类型。可选值：<br>- `success`：成功<br>- `loading`：加载中<br>- `none`：不显示图标（PC 端暂不支持）<br>- `error`：错误（仅 PC 端有效）<br>- `info`：提示（仅 PC 端有效）<br>- `warning`：警告（仅 PC 端有效）
mask | boolean | 否 | false | 是否显示透明蒙层，防止触摸穿透。取值：<br>- true：显示<br>- false：不显示<br>**注意事项**：**注意**：<br>- Android/iOS 端：飞书 [V2.5.0](https://open.feishu.cn/document/uYjL24iN/uAjMuAjMuAjM/version-compatibility) 及以上版本支持设置该字段。<br>- PC/Harmony 端：暂不支持设置该字段。

## 输出

该接口继承[标准对象输出](https://open.feishu.cn/document/uYjL24iN/ukzNy4SO3IjL5cjM#8c92acb8)，无扩展属性。

## 示例代码

调用示例：

```js
tt.showToast({
    "title": "添加购物车成功",
    "duration": 3000,
    "icon": "success",
    "mask": false,
    success(res) {
      console.log(JSON.stringify(res));
    },
    fail(res) {
      console.log(`showToast fail: ${JSON.stringify(res)}`);
    }
});
```

`success`返回对象示例：

```json
{
  errMsg: "showToast:ok"
}
``` 

## 错误码

`fail` 返回对象中可能包含 errno 属性，表示错误码。关于 errno 错误码的详细说明以及通用错误码列表，可参见[Errno 错误码](https://open.feishu.cn/document/uYjL24iN/uAjMuAjMuAjM/errno)。