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.

* Some parts of this feature may have varying levels of support.

備註: 此功能可在 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
# interface-formdata

瀏覽器相容性

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
FormData
[Symbol.iterator]
FormData() constructor
submitter parameter
append
filename parameter
delete
entries
forEach
get
getAll
has
keys
set
values
Available in workers

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

參見