W3cubDocs

/Web APIs

Request: formData() method

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

Syntax

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((data) => {
  // do something with the formdata sent in the request
});

Specifications

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

Browser compatibility