此頁面由社群從英文翻譯而來。了解更多並加入 MDN Web Docs 社群。

View in English Always switch to English

FormData

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2015年7月⁩.

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

瀏覽器相容性

參見