이 번역은 완료되지 않았습니다. 이 문서를 번역해 주세요.

FormData 인터페이스는 XMLHttpRequest.send()로 쉽게 보내질 수 있는 폼 field와 그 값들로 나타나는 key/value쌍들을 쉽게 만들 수 있는 방법을 제공한다. 만약에 인코딩 타입이 "multipart/form-data"로 설정이 되어 있으면 폼이 사용하는 것과 같은 포맷으로 사용한다.

FormData 객체는 entries() 대신 for...of로 바로 사용되어 질 수 있다: for (var p of myFormData)는 (var p of myFormData.entries())와 같다.

Note: 이 기능은 Web Workers에서 가능하다.

생성자

FormData()
새로운 FormData 객체를 생성한다.

메소드

FormData.append()
FormData 객체안에 이미 키가 존재하면 그 키에 새로운 값을 추가하고, 키가 없으면 추가한다.
FormData.delete()
FormData 객체로 부터 키/벨류 쌍을 삭제한다.
FormData.entries()
이 오브젝트에 담긴 모든 키/벨류 쌍을 순회할 수 있는 iterator를 반환한다.
FormData.get()
FormData 객체 내의 값들 중 주어진 키와 연관된 첫번째 값을 반환한다.
FormData.getAll()
FormData 객체 내의 값들 중 주어진 키와 연관된 모든 값이 담긴 배열을 반환한다.
FormData.has()
FormData 객체에 특정 키/벨류 쌍의 존재 여부를 참/거짓(boolean) 상태를 반환한다.
FormData.keys()
이 객체에 담긴 모든 키/벨류 쌍들의 모든 키들을 순회 할 수 있는 iterator를 반환한다.
FormData.set()
FormData 객체 내에 존재하는 키에 대한 새로운 값을 입력하거나 존재하지 않는 새로운 키/벨류 쌍을 입력한다.
FormData.values()
이 객체에 담긴 키/벨류 쌍의 모든 벨류를순회할 수 있는 iterator를 반환한다.

Specifications

Specification Status Comment
XMLHttpRequest
The definition of 'FormData' in that specification.
Living Standard FormData defined in XHR spec

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Edge Firefox (Gecko) Internet Explorer Edge Opera Safari
Basic support 7.0 (Yes) 4.0 (2.0)[1] 10 (Yes) 12 5
append with filename (Yes) No support 22.0 (22.0) ? ? (Yes) ?
delete(), get(), getAll(), has(), set() 50.0 No support 39.0 (39.0) No support ? (Yes) No support
entries(), keys(), values(), and support of for...of 50.0 No support 44.0 (44.0) ? ? (Yes) No support
Available in web workers (Yes) (Yes) 39.0 (39.0) No support ? (Yes) No support
Feature Android Android Webview Edge Firefox Mobile (Gecko) Firefox OS (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support 3.0[2] (Yes)[2] (Yes) 4.0 (2.0)[1] 1.0.1 ? 12 ? (Yes)
append with filename ? (Yes) No support 22.0 (22.0) 1.2 ? ? ? (Yes)
delete(), get(), getAll(), has(), set() (Yes) 50.0 No support No support No support No support No support No support 50.0
entries(), keys(), values(), and support of for...of ? 50.0 No support 44.0 (44.0) 2.5 ? ? ? 50.0
Available in web workers (Yes) (Yes) (Yes) (Yes) (Yes) No support (Yes) No support (Yes)

[1] Prior to Gecko 7.0 (Firefox 7.0 / Thunderbird 7.0 / SeaMonkey 2.4), if you specified a Blob as the data to append to the object, the filename reported in the "Content-Disposition" HTTP header was an empty string; this resulted in errors being reported by some servers. Starting from Gecko 7.0, the filename "blob" is sent.

[2] XHR in Android 4.0 sends empty content for FormData with blob.

See also

문서 태그 및 공헌자

이 페이지의 공헌자: SangMin_Kang, HanHyeoksu
최종 변경자: SangMin_Kang,