# wx.chooseMessageFile(Object object)

> 基础库 2.5.0 开始支持，低版本需做[兼容处理](1003706)。

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

## 功能描述

从客户端会话选择文件。

## 参数

### Object object


```json
[
  {
    "属性": "count",
    "类型": "number",
    "默认值": "",
    "必填": "是",
    "说明": "最多可以选择的文件个数，可以 0～100",
    "最低版本": ""
  },
  {
    "属性": "type",
    "类型": "string",
    "默认值": "'all'",
    "必填": "否",
    "说明": "所选的文件的类型",
    "最低版本": "",
    "子项": [
      {
        "合法值": "all",
        "说明": "从所有文件选择"
      },
      {
        "合法值": "video",
        "说明": "只能选择视频文件"
      },
      {
        "合法值": "image",
        "说明": "只能选择图片文件"
      },
      {
        "合法值": "file",
        "说明": "可以选择除了图片和视频之外的其它的文件"
      }
    ]
  },
  {
    "属性": "extension",
    "类型": "Array.<string>",
    "默认值": "",
    "必填": "否",
    "说明": "根据文件拓展名过滤，仅 type==file 时有效。每一项都不能是空字符串。默认不过滤。",
    "最低版本": "[2.6.0](1003706)"
  },
  {
    "属性": "success",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用成功的回调函数",
    "最低版本": ""
  },
  {
    "属性": "fail",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用失败的回调函数",
    "最低版本": ""
  },
  {
    "属性": "complete",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用结束的回调函数（调用成功、失败都会执行）",
    "最低版本": ""
  }
]
```

#### object.success 回调函数
##### 参数

###### Object res


```json
[
  {
    "属性": "tempFiles",
    "类型": "Array.<Object>",
    "说明": "返回选择的文件的本地临时文件对象数组",
    "子项": [
      {
        "结构属性": "path",
        "类型": "string",
        "说明": "本地临时文件路径 (本地路径)"
      },
      {
        "结构属性": "size",
        "类型": "number",
        "说明": "本地临时文件大小，单位 B"
      },
      {
        "结构属性": "name",
        "类型": "string",
        "说明": "选择的文件名称"
      },
      {
        "结构属性": "type",
        "类型": "string",
        "说明": "选择的文件类型",
        "子项": [
          {
            "合法值": "video",
            "说明": "选择了视频文件"
          },
          {
            "合法值": "image",
            "说明": "选择了图片文件"
          },
          {
            "合法值": "file",
            "说明": "选择了除图片和视频的文件"
          }
        ]
      },
      {
        "结构属性": "time",
        "类型": "number",
        "说明": "选择的文件的会话发送时间，Unix时间戳，工具暂不支持此属性"
      }
    ]
  }
]
```

```js
wx.chooseMessageFile({
  count: 10,
  type: 'image',
  success (res) {
    // tempFilePath可以作为img标签的src属性显示图片
    const tempFilePaths = res.tempFiles
  }
})
```