Request.formData()

The formData() method of the Request interface reads the request body and returns it as a promise that resolves with a FormData object.

Syntax

request.formData().then(function(formdata) {
  // do something with your formdata
});

Parameters

None.

Return value

A Promise that resolves with a FormData object.

Examples

const formData = new FormData();
const fileField = document.querySelector('input[type="file"]');

formData.append('username', 'abc123');
formData.append('avatar', fileField.files[0]);

const request = new Request('/myEndpoint', {
  method: 'POST',
  body: formData
});

request.formData().then(function(data) {
  // do something with the formdata sent in the request
});

Specifications

Specification
Fetch Standard (Fetch)
# ref-for-dom-body-formdata①

Browser compatibility

BCD tables only load in the browser

See also