FormData

构造函数 FormData

创建一个新的 FormData 对象

方法

FormData.append()

向 FormData 中添加新的属性值。即使对应的属性值已经存在也不会覆盖原值，而是新增一个值。

var formData = new FormData()
formData.append("name", "cez")
formData.append("name", "zlz")

formData.getAll("name")   // ["cez", "zlz"]

可以发现，通过 .append() 方法添加的属性值 zlz 并不会覆盖原值。

FormData.set()

向 FormData 中添加新的属性值，如果对应的属性值存在则覆盖原值，否则新增一项属性值。

var formData = new FormData()
formData.set("name", "cez")
formData.set("name", "zlz")

formData.getAll("name")   // ["zlz"]

可以发现，通过 .set() 方法添加的属性值 zlz 会覆盖原值。

FormData.getAll()

返回与指定的键关联的所有值

var formData = new FormData()
formData.append("name", "cez")
formData.append("name", "zlz")

formData.getAll("name")   // ["cez", "zlz"]

可以发现，通过 .getAll() 方法获取的是指定键的所有值。

FormData.get()

返回与指定的键关联的第一个值

var formData = new FormData()
formData.append("name", "cez")
formData.append("name", "zlz")

formData.getAll("name")  // ["cez", "zlz"]
formData.get("name")     // cez

可以发现，通过 .get() 方法获取的是指定键的第一个值。

FormData.keys()

返回一个 iterator 对象，该对象包含所有的键。

var formData = new FormData()
formData.append("name", "cez")
formData.append("gender", "男")
formData.append("age", 22)

for (var k of formData.keys()) {
    console.log(k)   // name gender age
}

FormData.values()

返回一个 iterator 对象，该对象包含所有的值。

var formData = new FormData()
formData.append("name", "cez")
formData.append("gender", "男")
formData.append("age", 22)

for (var v of formData.values()) {
	console.log(v)   // cez 男 22
}

FormData.entries()

返回一个 iterator 对象，该对象包含所有键值对。

var formData = new FormData()
formData.append("name", "cez")
formData.append("gender", "男")
formData.append("age", 22)

for (var i of formData.entries()) {
	console.log(i)  // ["name", "cez"] ["gender", "男"] ["age", "22"]
}

// 等效于
for (var i of formData {
	console.log(i)  // ["name", "cez"] ["gender", "男"] ["age", "22"]
}

FormData.has()

返回一个布尔值表明 FormData 对象是否包含某些键

var formData = new FormData()
formData.append("name", "cez")

formData.has("name")   // true