Utility for converting arbitrarily deep JavaScript objects to FromData, using Rails conventions for nested arrays and objects.

If you use Rails views to generate and submit forms already, you do not need this library.

If you use some other method for generating your front end data, or have it as a JavaScript of JSON object, then this library can be considered the glue code needed to plug in to a Rails backend.

import jasonForm from 'jason-form';

const input = {
 string: 'string',
 array: [1,2],
 object: {
  foo: 'foo',
  bar: 'bar'
  }
};

const body = jasonForm.formData(input) // [['string', 'string'], ['array[]', 1], ['array[]', 2], ['object[foo]', 'foo'] ['object[bar]', 'bar']]

fetch('http://my.rails.server', {
  method: 'POST',
  credentials: 'include',
  body,
  headers: {
    'Content-Type': 'multipart/form-data'
  }
})

In most cases, this will work just fine and should indeed be the preferred approach. The issue is when you need to transmit data that is not supported by the JSON format (such as file upload data), or the backend that you need to send data to only accepts form data. Then this library becomes helpful.

Run it through rails_request first.