The FormData()
constructor creates a new FormData
object.
Note: This feature is available in Web Workers.
Syntax
var formData = new FormData(form)
Parameters
Example
The following line creates an empty FormData
object:
var formData = new FormData(); // Currently empty
You could add a key/value pair to this using FormData.append
:
formData.append('username', 'Chris');
Or you can specify the optional form
argument when creating the FormData
object, to prepopulate it with values from the specified form:
<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>
Note: Only successful form controls are included in a FormData object, i.e. those with a name, not disabled and checked (radio buttons and checkboxes) or selected (one or more options within a select).
let myForm = document.getElementById('myForm');
let 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