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: 27 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 (about 7 years ago)
- Default Branch: master
- Last Pushed: 2024-04-01T15:14:38.000Z (7 months ago)
- Last Synced: 2024-05-15T14:06:57.811Z (6 months ago)
- Topics: fastify, fastify-plugin
- Language: JavaScript
- Size: 142 KB
- Stars: 128
- Watchers: 16
- Forks: 19
- Open Issues: 1
-
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://www.npmjs.com/package/@fastify/formbody)
[](https://www.npmjs.com/package/@fastify/formbody)
[](https://standardjs.com)
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/
This branch targets Fastify v4. Please refer to [this branch](https://github.com/fastify/fastify-formbody/tree/3.x) and related versions for Fastify `^2.0.0` compatibility.
For Fastify v3 support, please use @fastify/formbody `^6.0.1`.
## Install
```
npm i @fastify/formbody
```
## 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)