Fetch API mixin for urlencoding an object and setting Content-Type if unset. Functional and immutable.

Downloads in past


101.0.07 years ago7 years agoMinified + gzip package size for fetch-formify in KB


!NPM versionnpm-badge !Build statustravis-badge
Fetch Formify is a mixin for the Fetch APIfetch for browsers and Node.js that urlencodes an object into a body and sets the Content-Type header to application/x-www-form-urlencoded if not given. It's functional and immutable, in that it doesn't modify any properties given to it.


npm install fetch-formify

FetchFormify.js follows semantic versioning, so feel free to depend on its major version with something like >= 1.0.0 < 2 (a.k.a ^1.0.0).


Wrap the native fetch function with the one from FetchFormify.js:
var fetchWithFormify = require("fetch-formify")(fetch)

Then pass any object you'd like urlencoded under the form property:
fetch("/feedback", {method: "POST", form: {message: "Hello!"}})

That property will be urlencoded with the querystring and passed on to the original fetch function under the body property. The Content-Type header will be set to application/x-www-form-urlencoded if it's not set.


To set a custom Content-Type header, just pass it as you normally would:
fetch("/feedback", {
  method: "POST",
  headers: {"Content-Type": "application/vnd.feedback"},
  form: {message: "Hello!"}


Browsers have the Fetch API available at window.fetch:
var fetch = require("fetch-formify")(window.fetch)
fetch("/feedback", {method: "POST", form: {message: "Hello!"}})


Node.js doesn't have a built-in implementation of the Fetch API, but you can use any library with a compatible interface, such as node-fetch:
var fetch = require("fetch-formify")(require("node-fetch"))
fetch("/feedback", {method: "POST", form: {message: "Hello!"}})


FetchFormify.js is released under a Lesser GNU Affero General Public License, which in summary means:
  • You can use this program for no cost.
  • You can use this program for both personal and commercial reasons.
  • You do not have to share your own program's code which uses this program.
  • You have to share modifications (e.g. bug-fixes) you've made to this program.

For more convoluted language, see the LICENSE file.


Andri Möllmoll typed this and the code.
Monday Calendar
monday supported the engineering work.
If you find FetchFormify.js needs improving, please don't hesitate to type to me now at andri@dot.eeemail or create an issue onlineissues.