FormData

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

注意:此功能在 Web Workers 中可用。

FormData 介面提供了一種構建一組表示表單欄位及其值的鍵/值對的方法,這些鍵/值對可以使用 fetch()XMLHttpRequest.send()navigator.sendBeacon() 方法傳送。它使用的格式與表單將編碼型別設定為 "multipart/form-data" 時使用的格式相同。

如果想生成一個表單在進行簡單的 GET 提交時會生成的查詢引數,也可以直接將它傳遞給 URLSearchParams 建構函式。

一個實現 FormData 的物件可以直接用於 for...of 結構,而不是使用 entries()for (const p of myFormData) 等同於 for (const p of myFormData.entries())

建構函式

FormData()

建立一個新的 FormData 物件。

例項方法

FormData.append()

FormData 物件中,向現有鍵追加一個新值,如果該鍵不存在則新增該鍵。

FormData.delete()

FormData 物件中刪除一個鍵/值對。

FormData.entries()

返回一個 迭代器,用於迭代 FormData 中包含的所有鍵/值對。

FormData.get()

FormData 物件中返回給定鍵關聯的第一個值。

FormData.getAll()

FormData 物件中返回給定鍵關聯的所有值的陣列。

FormData.has()

返回一個 FormData 物件是否包含某個特定鍵。

FormData.keys()

返回一個 迭代器,用於迭代 FormData 中包含的所有鍵/值對的鍵。

FormData.set()

FormData 物件中設定一個現有鍵的新值,如果該鍵/值不存在則新增該鍵/值。

FormData.values()

返回一個 迭代器,用於迭代 FormData 中包含的所有值。

規範

規範
XMLHttpRequest
# interface-formdata

瀏覽器相容性

另見