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

FormData.append()

· 52CE 我爱测

FormData 接口的 **`append()`** 方法会添加一个新值到 `FormData` 对象内的一个已存在的键中,如果键不存在则会添加该键。

XMLHttpRequest API

FormData 接口的 append() 方法会添加一个新值到 FormData 对象内的一个已存在的键中,如果键不存在则会添加该键。

FormData.set 和 append() 的区别在于,如果指定的键已经存在, FormData.set 会使用新值覆盖已有的值,而 append() 会把新值添加到已有值集合的后面。

语法

这个方法有两个版本:一个有两个参数的版本和一个有三个参数的版本。

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

参数

  • name
    • : value 中包含的数据对应的表单名称。
  • value
    • : 表单的值。可以是String 或 Blob (包括子类型,如 File)。
  • filename
    • : 传给服务器的文件名称 (一个 String), 当一个 Blob 或 File 被作为第二个参数的时候, Blob 对象的默认文件名是 "blob"。 File 对象的默认文件名是该文件的名称。

[!NOTE] 如果你指定一个 Blob 作为数据添加到 FormData 对象中,文件名会被放在 "Content-Disposition" 头部(常常会根据浏览器变化而变化)传给服务器。

返回值

空

示例

下面的代码创建了一个空的 FormData 对象:

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

你可以通过 FormData.append 往对象里加入键值对:

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

跟常规表单数据一样,你可以使用同一个名称添加多个值 。例如 (为了与 PHP 命名习惯一致在名称中添加了 []):

formData.append("userpic[]", myFileInput1.files[0], "chris1.jpg");
formData.append("userpic[]", myFileInput2.files[0], "chris2.jpg");

这项技术使得多文件上传的处理更加简单,因为所得数据结构更有利于循环。

规范

浏览器兼容性

参见

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

资料来源与适用范围

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

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

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