Form Data Extended


Makes FormData support nested objects and arrays.

As far as I know there are no hard specifications concerning nested multipart
requests. This package tries to cater to the most common use cases. Allowing
configuration to support different standards could be part of future features.

Installation

npm install form-data-extended --save

Usage

Form data extended exports a single function that takes an object or array. It
returns a FormData instance that should be correctly structured.

``javascript
const formData = require('form-data-extended')

const userFormData = formData({
name: "John Doe",
location: {
country: "USA",
city: "New York",
},
picture: file, // file instanceof File === true
nicknames: [
"Johny",
"Joe",
"Jo",
]
})

userFormData instanceof FormData // => true
`

The FormData will have the following key value pairs. Notice that it supports
file instances too.

`
name = John Doe
location[country] = USA
location[city] = "New York"
picture =
nicknames[] = Johny
nicknames[] = Joe
nicknames[] = Jo
``