大网数据广告活动
Web 标准与前端开发

FormData.set()

· 52CE 我爱测

`set()`** 方法会对 `FormData` 对象里的某个 `key` 设置一个新的值,如果该 `key` 不存在,则添加。

XMLHttpRequest API

set() 方法会对 FormData 对象里的某个 key 设置一个新的值,如果该 key 不存在,则添加。

set() 和 FormData.append 不同之处在于:如果某个 key 已经存在,set() 会直接覆盖所有该 key 对应的值,而 FormData.append 则是在该 key 的最后位置再追加一个值。

语法

该方法有两种使用方式,一个是传入两个参数,一个是传入三个参数。

formData.set(name, value);
formData.set(name, value, filename);

参数

  • name
    • : 字段名称。
  • value
    • : 字段的值,该值可以是一个 String 或 Blob(包括其子类,例如 File),如果不是这两个指定的类型,其将被转成一个字符串。
  • filename
    • : 当第二个参数传递的是一个 blob 对象(Blob)或者 file 对象(File),filename 参数就代表传给服务端的文件名(一个 String)。 Blob 对象的默认文件名是 "blob",File 对象的默认文件名则为其“name”属性

[!NOTE] 如果对 FormData 对象插入一个 blob 对象( Blob),那么发送给服务器的请求头部(header)里的“Content-Disposition”里的文件名称将会根据浏览器的不同而不同。

示例

先创建一个空的 FormData 对象:

var formData = new FormData(); // Currently empty

使用 FormData.set 设置键/值:

formData.set("username", "Chris");
formData.set("userpic", myFileInput.files[0], "chris.jpg");

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。