Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fastify/fastify-formbody
A Fastify plugin to parse x-www-form-urlencoded bodies
https://github.com/fastify/fastify-formbody
fastify fastify-plugin
Last synced: 2 days ago
JSON representation
A Fastify plugin to parse x-www-form-urlencoded bodies
- Host: GitHub
- URL: https://github.com/fastify/fastify-formbody
- Owner: fastify
- License: mit
- Created: 2017-09-07T01:12:42.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-09-22T09:17:23.000Z (4 months ago)
- Last Synced: 2024-10-29T14:46:35.506Z (3 months ago)
- Topics: fastify, fastify-plugin
- Language: JavaScript
- Size: 155 KB
- Stars: 128
- Watchers: 17
- Forks: 19
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
- License: LICENSE
Awesome Lists containing this project
- awesome-fastify - `fastify-formbody` - www-form-urlencoded bodies. (<h2 align="center">Awesome Fastify</h2> / <h2 align="center">Ecosystem</h2>)
README
# @fastify/formbody
[](https://github.com/fastify/fastify-formbody/actions/workflows/ci.yml)
[](https://www.npmjs.com/package/@fastify/formbody)
[](https://www.npmjs.com/package/@fastify/formbody)
[](https://github.com/neostandard/neostandard)
A simple plugin for [Fastify][fastify] that adds a content type parser for
the content type `application/x-www-form-urlencoded`.
[fastify]: https://fastify.dev/
## Install
```
npm i @fastify/formbody
```
### Compatibility
| Plugin version | Fastify version |
| ---------------|-----------------|
| `^8.x` | `^5.x` |
| `^7.x` | `^4.x` |
| `^6.x` | `^3.x` |
| `^3.x` | `^2.x` |
| `^2.x` | `^1.x` |
Please note that if a Fastify version is out of support, then so are the corresponding versions of this plugin
in the table above.
See [Fastify's LTS policy](https://github.com/fastify/fastify/blob/main/docs/Reference/LTS.md) for more details.
## Example
Given the following code:
```js
const fastify = require('fastify')()
fastify.register(require('@fastify/formbody'))
fastify.post('/', (req, reply) => {
reply.send(req.body)
})
fastify.listen({ port: 8000 }, (err) => {
if (err) throw err
})
```
And a `POST` body of:
```html
foo=foo&bar=bar&answer=42
```
The sent reply would be the object:
```js
{
foo: 'foo',
bar: 'bar',
answer: 42
}
```
## Options
The plugin accepts an options object with the following properties:
+ `bodyLimit`: The maximum amount of bytes to process
before returning an error. If the limit is exceeded, a `500` error will be
returned immediately. When set to `undefined` the limit will be set to whatever
is configured on the parent Fastify instance. The default value is
whatever is configured in
[fastify](https://github.com/fastify/fastify/blob/main/docs/Reference/Server.md#bodylimit)
(`1048576` by default).
+ `parser`: The default parser used is the querystring.parse built-in. You can change this default by passing a parser function e.g. `fastify.register(require('@fastify/formbody'), { parser: str => myParser(str) })`
## Upgrading from 4.x
Previously, the external [qs lib](https://github.com/ljharb/qs) was used that did things like parse nested objects. For example:
- ***Input:*** `foo[one]=foo&foo[two]=bar`
- ***Parsed:*** `{ foo: { one: 'foo', two: 'bar' } }`
The way this is handled now using the built-in querystring.parse:
- ***Input:*** `foo[one]=foo&foo[two]=bar`
- ***Parsed:*** `{ 'foo[one]': 'foo', 'foo[two]': 'bar' }`
If you need nested parsing, you must configure it manually by installing the qs lib (`npm i qs`), and then configure an optional parser:
```js
const fastify = require('fastify')()
const qs = require('qs')
fastify.register(require('@fastify/formbody'), { parser: str => qs.parse(str) })
```
## License
Licensed under [MIT](./LICENSE).