FormData
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
io error: No such file or directory (os error 2) (/home/runner/work/yari/yari/mdn/translated-content/files/zh-tw/web/api/xmlhttprequest_api/index.md)
备注: 此功能可在 Web Worker 中使用。
FormData
介面可為表單資料中的欄位/值建立相對應的的鍵/值對(key/value)集合,之後便可使用 XMLHttpRequest.send()
方法來送出資料。它在編碼類型設定為 multipart/form-data
時會採用與表單相同的格式送出。
實作 FormData
的物件可以直接利用 for...of
語法結構來替代 entries()
:for (var p of myFormData)
等同於 for (var p of myFormData.entries())
。
建構式
FormData()
-
建立一個新的
FormData
物件。
方法
FormData.append()
-
追加新值到
FormData
物件已有的對應鍵上;若該鍵不存在,則為其追加新的鍵。 FormData.delete()
-
刪除指定的鍵值對。
FormData.entries()
-
回傳
iterator
,可用來處理物件中所有的鍵值對。 FormData.get()
-
回傳指定的鍵在
FormData
物件中找到的第一個對應值。 FormData.getAll()
-
回傳指定的鍵在
FormData
物件中所有對應值的陣列。 FormData.has()
-
回傳
FormData
物件是否含有指定鍵值對的布林值。 FormData.keys()
-
回傳
iterator
,可用來處理物件中所有鍵值對之中的鍵。 FormData.set()
-
為
FormData
物件已有的鍵設定新值;若該鍵不存在,則為其追加新的鍵。 FormData.values()
-
回傳
iterator
,可用來處理物件中所有鍵值對之中的值。
規範
Specification |
---|
XMLHttpRequest Standard # interface-formdata |
瀏覽器相容性
BCD tables only load in the browser