Adapter that lets Integreat send and receive content in application/x-www-form-urlencoded encoding.
Requires node v18 and Integreat v1.0.
Install from npm:
npm install integreat-adapter-form
Example of use:
import Integreat from 'integreat'
import httpTransporter from 'integreat-transporter-http'
import formAdapter from 'integreat-adapter-form'
import defs from './config.js'
const great = Integreat.create(defs, {
transporters: { http: httpTransporter },
adapters: { form: formAdapter },
})
// ... and then dispatch actions as usual
Example service configuration:
{
id: 'store',
transporter: 'http',
adapters: ['form'],
options: {
includeHeaders: true
},
endpoints: [
{ options: { uri: 'https://api.com/formDataEndpoint' } }
]
}
Data in payload and response will be application/x-www-form-urlencoded encoded as described in the W3C Forms specification when sending to a service, and decoded back to JS data coming from a service.
Arrays are serialized to several keys postfixed with brackets '[]'
. When
normalizing keys postfixed with brackets, the brackets are removed and the value
of all keys with the same name, are joined into one array in the order they
appear.
The adapter has no options.
The package also includes a transformer, that works exactly like the adapter,
except it is intended for use in mutation pipelines with
{ $transform: 'form' }
. You may use it like this:
Example of use:
import integreat from 'integreat'
import httpTransporter from 'integreat-transporter-http'
import formTransformer from 'integreat-adapter-form/transformer.js'
import defs from './config.js'
const great = Integreat.create(defs, {
transporters: { http: httpTransporter },
transformers: { form: formTransformer },
})
// In a mutation pipeline:
const mutation = ['response.data', { $transform: 'form' }]
The tests can be run with npm test
.
Please read CONTRIBUTING for details on our code of conduct, and the process for submitting pull requests.
This project is licensed under the ISC License - see the LICENSE file for details.