uniapp上传文件时用到的api是什么?格式是什么?

在uni-app中,上传文件通常使用uni.uploadFile API。这个API允许你将本地资源上传到服务器。以下是这个API的基本使用方法和格式:

基本使用

复制代码
复制代码
`uni.uploadFile({
url: 'https://example.com/upload', // 上传的接口,需要开发者服务器支持
filePath: tempFilePaths[0], // 需要上传的文件路径,可以是临时文件路径也可以是永久文件路径
name: 'file', // 文件对应的 key,开发者在服务器端通过这个 key 可以获取到文件二进制内容
formData: {
'user': 'test'
}, // HTTP 请求中其他额外的 form data
success: (uploadFileRes) => {
// 返回的上传信息,比如:
// {
// tempFilePath: "文件的本地临时路径",
// statusCode: 200, // http 状态码
// data: {} // 开发者服务器返回的内容
// }
console.log(uploadFileRes.data);
},
fail: (err) => {
// 上传失败
console.error(err);
}
});`

参数说明

  • url:开发者服务器地址。
  • filePath:要上传文件资源的路径(本地路径)。
  • name:发送到服务器的文件对应的 key,即开发者在服务器端通过这个 key 可以获取到文件二进制内容。
  • formData:HTTP 请求中其他额外的 form data。
  • header :HTTP 请求 Header, 默认为:{"Content-Type": "multipart/form-data"}
  • success:接口调用成功的回调函数。
  • fail:接口调用失败的回调函数。
  • complete:接口调用结束的回调函数(调用成功、失败都会执行)。

返回值

成功时,返回的对象包含字段statusCodedataerrMsgtempFilePath(文件的本地临时路径)。

注意事项

  • 调用uni.chooseImageuni.chooseMessageFile接口可以获取到文件的本地临时路径。
  • 上传文件的大小有限制,具体限制由服务器端和客户端共同决定。
  • formData中,除了文件外的其他字段都可以以键值对的形式存在,服务器可以通过这些字段进行验证或处理。
  • 如果需要上传多个文件,可能需要多次调用uni.uploadFile或在服务器端处理多个文件的上传逻辑。

总之,uni.uploadFile是uni-app中用于上传文件的API,通过它可以将文件上传到服务器。在调用时,需要正确设置urlfilePathname等参数,并根据需要设置formDataheader

相关推荐
CoderLiu几秒前
程序化工具调用(PTC)与动态工作流引擎:深入大模型工具调用的架构演进与实践
前端·人工智能·后端
码农胖大海11 分钟前
我的第一个产品,只有一段提示词
前端·ai编程·产品
“AI国潮设计-小江”30 分钟前
Python实战 | SDXL精准控制“普宁英歌舞×星空蛋糕”IP落地,附核心Prompt与商用授权思路
开发语言·人工智能·python·prompt·aigc
邋遢道39 分钟前
# 企业级 Agent 从 0 到 1(二):技术选型与最小骨架
前端·chrome
计算机魔术师42 分钟前
我看了 OpenAI 首席科学家的最新长文,把原来的认知推翻了一遍
前端
乱码三千1 小时前
使用ComfyUI+MinMax-H3音视频模型生成视频
前端·后端·github
Coder_Ke1 小时前
代码我都定位了,Codex 还在考古:于是我写了个 VS Code 插件
前端
小刘在重生~2 小时前
Java常用类|String类详解 + BigDecimal精准计算(含面试题)
java·开发语言·python
YYYing.2 小时前
【C++进阶系列 (二)】关于线程堆栈的那些事——函数调用过程
开发语言·c++·函数·线程堆栈
邪修king2 小时前
Re:Linux系统篇(十九):进程篇(八): 进程等待详解:wait/waitpid,僵尸进程到底该如何回收
java·开发语言