This page was translated from English by the community. Learn more and join the MDN Web Docs community.

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() 생성자(Constructor)는 새로운 FormData객체를 만듭니다.

참고 : 이 기능은 Web Worker에서 사용할 수 있습니다.

Syntax

js
var formData = new FormData(form);

Parameters

form Optional

HTML <form> 요소 — 지정된 경우 FormData 객체는 form의 현재 key/value 들로 채워집니다. key/value는 submit한 각 요소의 name property와 value를 사용합니다. 또한 파일 입력 내용을 인코딩합니다.

Example

다음 코드는 빈 FormData 객체를 만듭니다:

js
var formData = new FormData(); // Currently empty

FormData.append을 사용하여 key/value 쌍을 추가할 수 있습니다:

js
formData.append("username", "Chris");

또는 FormData 객체를 만들 때 선택적으로 form argument를 지정할 수 있는데, 지정된 양식대로 value를 미리 채우는 것입니다:

html
<form id="myForm" name="myForm">
  <div>
    <label for="username">Enter name:</label>
    <input type="text" id="username" name="username" />
  </div>
  <div>
    <label for="useracc">Enter account number:</label>
    <input type="text" id="useracc" name="useracc" />
  </div>
  <div>
    <label for="userfile">Upload file:</label>
    <input type="file" id="userfile" name="userfile" />
  </div>
  <input type="submit" value="Submit!" />
</form>

참고 : 모든 입력 요소는 'name' 속성(attribute) 을 갖고 있습니다. 나중에 value에 접근하는데 필요합니다.

js
var myForm = document.getElementById("myForm");
formData = new FormData(myForm);

명세서

Specification
XMLHttpRequest
# dom-formdata

브라우저 호환성

See also