reqwest.multipart
reqwest.multipart
功能
设置 multipart/form-data 请求体,用于提交普通字段和文件字段。
语法
reqwest(url).multipart(values)
参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| values | Object | 是 | 无 | multipart 字段映射对象;键和值的规则见下方。 |
values 对象结构
| 键 | 值类型 | 说明 |
|---|---|---|
| 字段名 | Any | 普通字段,调用时会转为字符串。 |
| 字段名 | Object | 文件字段;对象中必须提供 path,可选 file_name、mime。 |
文件字段对象结构
| 字段 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| path | String | 是 | 无 | 要上传的本地文件路径。 |
| file_name | String | 否 | 原文件名 | 上传时暴露给服务端的文件名。 |
| mime | String | 否 | 自动识别 | 文件 MIME 类型,例如 image/png。 |
返回值
| 类型 | 说明 |
|---|---|
| Reqwest | 返回新的请求构建器。 |
示例
request = reqwest('https://example.com/upload').method('POST').multipart({ name: 'BT', file: {path: 'demo.txt', file_name: 'demo.txt', mime: 'text/plain'} }) result = type(request) // 输出:Reqwest print result
注意事项
- values 必须是对象,否则会报错。
- body、json、form、multipart 都会设置请求体;同一请求中最后一次设置的请求体生效。