1. 概述
FormData類型其實是在XMLHttpRequest 2級定義的,它是為序列化表以及創建與表單格式相同的數據(當然是用于XHR傳輸)提供便利。
2. 構造函數
創建一個formData對象實例有幾種方式
1、創建一個空對象實例
var formData = new FormData();
此時可以調用Append()方法來添加數據
2、使用已有的表單來初始化一個對象實例
假如現在頁面已經有一個表單
<form id="myForm" action="" method="post">
<input type="text" name="name">名字
<input type="password" name="psw">密碼
<input type="submit" value="提交">
</form>
我們可以使用這個表單元素作為初始化參數,來實例化一個formData對象
// 獲取頁面已有的一個form表單
var form = document.getElementById("myForm");
// 用表單來初始化
var formData = new FormData(form);
// 我們可以根據name來訪問表單中的字段
var name = formData.get("name"); // 獲取名字
var psw = formData.get("psw"); // 獲取密碼
// 當然也可以在此基礎上,添加其他數據
formData.append("token","kshdfiwi3rh");
3. 操作方法
首先,我們要明確formData里面存儲的數據形式,一對key/value組成一條數據,key是唯一的,一個key可能對應多個value。如果是使用表單初始化,每一個表單字段對應一條數據,它們的html name屬性即為key值,它們value屬性對應value值。
3.1 獲取值
我們可以通過get(key)/getAll(key)來獲取對應的value,
formData.get("name"); // 獲取key為name的第一個值
formData.get("name"); // 返回一個數組,獲取key為name的所有值
3.2 添加數據
我們可以通過append(key, value)來添加數據,如果指定的key不存在則會新增一條數據,如果key存在,則添加到數據的末尾
formData.append("k1", "v1");
formData.append("k1", "v2");
formData.append("k1", "v1");
formData.get("k1"); // "v1"
formData.getAll("k1"); // ["v1","v2","v1"]
3.3 設置修改數據
我們可以通過set(key, value)來設置修改數據,如果指定的key不存在則會新增一條,如果存在,則會修改對應的value值。
formData.append("k1", "v1");
formData.set("k1", "1");
formData.getAll("k1"); // ["1"]
3.4 判斷是否該數據
我們可以通過has(key)來判斷是否對應的key值
formData.append("k1", "v1");
formData.append("k2",null);
formData.has("k1"); // true
formData.has("k2"); // true
formData.has("k3"); // false
3.5 刪除數據
通過delete(key),來刪除數據
formData.append("k1", "v1");
formData.append("k1", "v2");
formData.append("k1", "v1");
formData.delete("k1");
formData.getAll("k1"); // []
3.6 遍歷
我們可以通過entries()來獲取一個迭代器,然后遍歷所有的數據,
formData.append("k1", "v1");
formData.append("k1", "v2");
formData.append("k2", "v1");
var i = formData.entries();
i.next(); // {done:false, value:["k1", "v1"]}
i.next(); // {done:fase, value:["k1", "v2"]}
i.next(); // {done:fase, value:["k2", "v1"]}
i.next(); // {done:true, value:undefined}
可以看到返回迭代器的規則
- 每調用一次next()返回一條數據,數據的順序由添加的順序決定
- 返回的是一個對象,當其done屬性為true時,說明已經遍歷完所有的數據,這個也可以作為判斷的依據
- 返回的對象的value屬性以數組形式存儲了一對key/value,數組下標0為key,下標1為value,如果一個key值對應多個value,會變成多對key/value返回
我們也可以通過values()方法只獲取value值
formData.append("k1", "v1");
formData.append("k1", "v2");
formData.append("k2", "v1");
var i = formData.entries();
i.next(); // {done:false, value:"v1"}
i.next(); // {done:fase, value:"v2"}
i.next(); // {done:fase, value:"v1"}
i.next(); // {done:true, value:undefined}
4. 發送數據
我們可以通過xhr來發送數據
var xhr = new XMLHttpRequest();
xhr.open("post","login");
xhr.setRequestHeader("Content-Type","application/x-www-form-urlencoded");
xhr.send(formData);
這種方式可以來實現文件的異步上傳。
5. 其他
瀏覽器兼容性查詢:https://caniuse.com/#search=formdata
英文文檔:https://developer.mozilla.org/en-US/docs/Web/API/FormData
轉自:https://segmentfault.com/a/1190000006716454