FormData()

FormData() 생성자(Constructor)는 새로운 FormData객체를 만듭니다.

메모: 웹워커(Web Workers)에서도 사용할 수 있습니다.

Syntax

var formData = new FormData(form)

Parameters

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

Example

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

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

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

formData.append('username', 'Chris');

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

<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에 접근하는데 필요합니다.

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

Specifications

Specification Status Comment
XMLHttpRequest
The definition of 'FormData()' in that specification.
Living Standard Initial definition

Browser compatibility

BCD tables only load in the browser

See also