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

參見