# wx.showToast(Object object)

> __以 [Promise 风格](/miniprogram/dev/framework/app-service/api.md#异步-API-返回-Promise) 调用__：支持
> 
> __小程序插件__：支持，需要小程序基础库版本不低于 [1.9.6](1003706)
> 
> __微信 Windows 版__：支持
> 
> __微信 Mac 版__：支持
> 
> __微信 鸿蒙 OS 版__：支持

## 功能描述

显示消息提示框

## 参数

### Object object


```json
[
  {
    "属性": "title",
    "类型": "string",
    "默认值": "",
    "必填": "是",
    "说明": "提示的内容",
    "最低版本": ""
  },
  {
    "属性": "icon",
    "类型": "string",
    "默认值": "success",
    "必填": "否",
    "说明": "图标",
    "最低版本": "",
    "子项": [
      {
        "合法值": "success",
        "说明": "显示成功图标，此时 title 文本最多显示 7 个汉字长度",
        "最低版本": ""
      },
      {
        "合法值": "error",
        "说明": "显示失败图标，此时 title 文本最多显示 7 个汉字长度",
        "最低版本": "[2.14.1](1003706)"
      },
      {
        "合法值": "loading",
        "说明": "显示加载图标，此时 title 文本最多显示 7 个汉字长度",
        "最低版本": ""
      },
      {
        "合法值": "none",
        "说明": "不显示图标，此时 title 文本最多可显示两行，[1.9.0](1003706)及以上版本支持",
        "最低版本": ""
      }
    ]
  },
  {
    "属性": "image",
    "类型": "string",
    "默认值": "",
    "必填": "否",
    "说明": "自定义图标的本地路径，image 的优先级高于 icon",
    "最低版本": "[1.1.0](1003706)"
  },
  {
    "属性": "duration",
    "类型": "number",
    "默认值": "1500",
    "必填": "否",
    "说明": "提示的延迟时间",
    "最低版本": ""
  },
  {
    "属性": "mask",
    "类型": "boolean",
    "默认值": "false",
    "必填": "否",
    "说明": "是否显示透明蒙层，防止触摸穿透",
    "最低版本": ""
  },
  {
    "属性": "success",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用成功的回调函数",
    "最低版本": ""
  },
  {
    "属性": "fail",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用失败的回调函数",
    "最低版本": ""
  },
  {
    "属性": "complete",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用结束的回调函数（调用成功、失败都会执行）",
    "最低版本": ""
  }
]
```

## 示例代码

```js
wx.showToast({
  title: '成功',
  icon: 'success',
  duration: 2000
})
```

## 注意

- [wx.showLoading](/miniprogram/dev/api/ui/interaction/wx.showLoading) 和 [wx.showToast](/miniprogram/dev/api/ui/interaction/wx.showToast) 同时只能显示一个
- [wx.showToast](/miniprogram/dev/api/ui/interaction/wx.showToast) 应与 [wx.hideToast](/miniprogram/dev/api/ui/interaction/wx.hideToast) 配对使用