JS對象文檔 - FormData

前言

FormData 接口提供了一種表示表單數據的鍵值對 key/value 的構造方式,並且可以輕鬆的將數據通過XMLHttpRequest.send() 方法發送出去,本接口和此方法都相當簡單直接。如果送出時的編碼類型被設爲 "multipart/form-data",它會使用和表單一樣的格式。

正文

構造函數

const formData = new FormData(form)

參數

form 可選

一個 HTML 上的<form>表單元素——當指定了,這種方式創建的FormData對象會自動將 form 中的表單值也包含進去,包括文件內容也會被編碼之後包含進去。

實例方法

FormData.append()

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 對象的默認文件名是該文件的名稱。

返回值

FormData.delete()

FormData 接口的 delete() 方法會從 FormData 對象中刪除指定鍵,即 key,和它對應的值,即 value。

FormData.entries()

該方法返回一個 iterator對象,此對象可以遍歷訪問 FormData 中的鍵值對。其中鍵值對的 key 是一個 String 對象;value 是一個 String , 或者 Blob對象。

FormData.get()

FormData 的 get() 方法用於返回 FormData 對象中和指定的鍵關聯的第一個值,如果你想要返回和指定鍵關聯的全部值,那麼可以使用 getAll() 方法。

FormData.getAll()

getAll() 方法會返回該 FormData 對象指定 key 的所有值。

FormData.has()

該方法會返回一個布爾值,表示該FormData對象是否含有某個 key。

FormData.keys()

該方法返回一個迭代器(iterator),遍歷了該 formData 包含的所有 key,這些 key 是 String 對象。

FormData.set()

該方法會對 FormData 對象裏的某個 key 設置一個新的值,如果該 key 不存在,則添加。

set() 和 FormData.append 不同之處在於:如果某個 key 已經存在,set() 會直接覆蓋所有該 key 對應的值,而 FormData.append 則是在該 key 的最後位置再追加一個值。

FormData.values()

該方法返回一個允許遍歷該對象中所有值的 迭代器 。這些值是 String 或是Blob 對象。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章