Skip to content

Fix uploading files using fetch and multipart/form-data

The Valley of Code

Your Web Development Manual

I had a form that accepted a file and some fields and I wanted to send this data to the server through the Fetch API, like this (React code):

<form
  encType='multipart/form-data'
  action='/api/post'
  method='POST'
  onSubmit={async (e) => {
    e.preventDefault()

    if (!title) {
      alert('Enter a title')
      return
    }
    if (!content && !image) {
      alert('Enter some text in the post')
      return
    }

    const body = new FormData()
    body.append('image', image)
    body.append('title', title)
    body.append('content', content)

    const res = await fetch('/api/post', {
      body,
      method: 'POST',
      headers: {
        'Content-Type': 'multipart/form-data',
      },
    })
  }}
>
...
</form>

I had a problem. The files data was not actually sent to the server.

The solution was this: you must NOT set the headers.

I did set the multipart/form-data header as thatโ€™s what you do with files upload, but apparently thatโ€™s what is breaking the file upload through fetch.

Remove the headers from the fetch request and things should be working.

โ†’ Get my JavaScript Beginner's Handbook
โ†’ Read my JavaScript Tutorials on The Valley of Code
โ†’ Read my TypeScript Tutorial on The Valley of Code
  • THE VALLEY OF CODE (+ PRO), your web development manual
  • I wrote 15+ free coding BOOKS, download them here
  • SOLOPRENEUR LAND the missing MBA for wannabe solopreneurs craving a life with more freedom, control, fulfillment and purpose (summer 2024)