Request: phương thức formData()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Note: This feature is available in Web Workers.

Phương thức formData() của giao diện Request đọc body của request và trả về nó dưới dạng một promise giải quyết với một đối tượng FormData.

Cú pháp

js
formData()

Tham số

Không có.

Giá trị trả về

Một Promise giải quyết với một đối tượng FormData.

Ngoại lệ

TypeError

Được ném ra vì một trong các lý do sau:

  • Body của request là disturbed hoặc locked.
  • Có lỗi khi giải mã nội dung body, ví dụ do header Content-Encoding không đúng.
  • Kiểu MIME của body không thể xác định từ các header Content-Type trong request, hoặc không phải application/x-www-form-urlencoded hoặc multipart/form-data.
  • Body không thể được phân tích thành đối tượng FormData.

Ví dụ

js
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) => {
  // làm gì đó với formdata được gửi trong request
});

Thông số kỹ thuật

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

Tương thích trình duyệt

Xem thêm