https://github.com/integreat-io/integreat-adapter-form
application/x-www-form-urlencoded adapter for Integreat
https://github.com/integreat-io/integreat-adapter-form
adapter form integreat urlencoded
Last synced: 8 months ago
JSON representation
application/x-www-form-urlencoded adapter for Integreat
- Host: GitHub
- URL: https://github.com/integreat-io/integreat-adapter-form
- Owner: integreat-io
- License: other
- Created: 2018-07-05T07:24:48.000Z (almost 8 years ago)
- Default Branch: main
- Last Pushed: 2025-03-30T18:16:32.000Z (about 1 year ago)
- Last Synced: 2025-10-23T20:20:08.645Z (8 months ago)
- Topics: adapter, form, integreat, urlencoded
- Language: TypeScript
- Size: 352 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# application/x-www-form-urlencoded adapter for Integreat
Adapter that lets
[Integreat](https://github.com/integreat-io/integreat) send and receive content
in application/x-www-form-urlencoded encoding.
[](https://www.npmjs.com/package/integreat-adapter-form)
[](https://qlty.sh/gh/integreat-io/projects/integreat-adapter-form)
## Getting started
### Prerequisits
Requires node v18 and Integreat v1.0.
### Installing and using
Install from npm:
```
npm install integreat-adapter-form
```
Example of use:
```javascript
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:
```javascript
{
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](https://www.w3.org/TR/html401/interact/forms.html#didx-applicationx-www-form-urlencoded)
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.
Available options:
- `setStructureInKeys`: When this is `true`, we'll serialize key and values so
that the structure of value is set in the key, with the leaf values as
values. `{ data: [{ id: 'ent1 }] }` will for instance be serialized to the
key `data[0][id]` and the value `'ent1'`. Default behavior (or when
`setStructureInKeys` is `false`) is to use the first level as key (`data` in
this case, and JSON stringify the rest as value.
### Form transformer
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:
```javascript
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' }]
```
### Running the tests
The tests can be run with `npm test`.
## Contributing
Please read
[CONTRIBUTING](https://github.com/integreat-io/integreat-adapter-form/blob/master/CONTRIBUTING.md)
for details on our code of conduct, and the process for submitting pull
requests.
## License
This project is licensed under the ISC License - see the
[LICENSE](https://github.com/integreat-io/integreat-adapter-form/blob/master/LICENSE)
file for details.