https://github.com/metcoder95/fastify-split-validator
fastify-split-validator is a plugin which allows you to setup, granularly, different validator per HTTP part of the request. This works at a route level, doing a fallback into a default validator using the default server config from the instance where the plugin is being installed.
https://github.com/metcoder95/fastify-split-validator
ajv fastify fastify-plugin fastify-split-validator node validator
Last synced: about 2 months ago
JSON representation
fastify-split-validator is a plugin which allows you to setup, granularly, different validator per HTTP part of the request. This works at a route level, doing a fallback into a default validator using the default server config from the instance where the plugin is being installed.
- Host: GitHub
- URL: https://github.com/metcoder95/fastify-split-validator
- Owner: metcoder95
- License: mit
- Created: 2021-10-19T22:36:07.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-01-09T19:19:45.000Z (4 months ago)
- Last Synced: 2025-02-27T05:49:29.416Z (2 months ago)
- Topics: ajv, fastify, fastify-plugin, fastify-split-validator, node, validator
- Language: JavaScript
- Homepage:
- Size: 85.9 KB
- Stars: 10
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yaml
- License: LICENSE
Awesome Lists containing this project
README
# fastify-split-validator
[](https://github.com/MetCoder95/fastify-split-validator/actions/workflows/ci.yml) [](https://github.com/MetCoder95/fastify-split-validator/actions/workflows/codeql-analysis.yml) 
---
`fastify-split-validator` is a plugin which allows you to setup, granularly, different validates per HTTP part of the request. This works at a route level, doing a fallback into a default validator using the default server config from the instance where the plugin is being installed.
You can provide your own default validator to act as fallback in case this is not defined within the definition of the route (_by default uses Ajv@8 as default fallback_).
## Setup
Install by running `npm install fastify-split-validator`.
### Options
**Instance**
- `defaultValidator`: default validator to be used as fallback in case nothing is provided at a route level definition
Example:
```js
const fastify = require('fastify');
const splitValidator = require('fastify-split-validator');
const Ajv = require('ajv');
const app = fastify();
const validator = new Ajv({});
await app.register(splitValidator, { defaultValidator: validator });
```
>**Note**:
> It is important to advice that with the new fastify@v4, all the route registration now happens asynchronously.
> This change translates in a way that if any plugin is meant to set logic into the `onRoute` hook for manipulating
> routes after registration, it is necessary to await until the plugin is fully loaded before proceeding with the next parts
> of your route definition. Otherwise, this can lead to non-deterministic behaviours when the plugin will not the expected
> effect on your fastify application.
**On Route**
- `schemaValidators`: an object with the HTTP parts as keys and the validators to be used for that part as values
- `schemaValidators.body`: validator to be used for the body of the request
- `schemaValidators.params`: validator to be used for the params of the request
- `schemaValidators.headers`: validator to be used for the headers of the request
- `schemaValidators.querystring`: validator to be used for the querystring of the request
- `schemaValidators.query`: alias for `schemaValidators.querystring`
### TypeScript
```ts
import fastify from 'fastify';
import splitValidator from 'fastify-split-validator';
import Ajv from 'ajv';
const app = fastify();
const validator = new Ajv({});
const bodyValidator = new Ajv({});
const headersValidator = new Ajv({});
await app.register(splitValidator, { defaultValidator: validator });
app.post('/', {
config: {
schemaValidators: {
body: bodyValidator,
headers: headersValidator,
},
},
}, (req, reply) => {
// ...
});
```
### JavaScript
```js
const fastify = require('fastify');
const splitValidator = require('fastify-split-validator');
const Ajv = require('ajv');
const app = fastify();
const validator = new Ajv({});
const bodyValidator = new Ajv({});
const headersValidator = new Ajv({});
await app.register(splitValidator, { defaultValidator: validator });
app.post('/', {
config: {
schemaValidators: {
body: bodyValidator,
headers: headersValidator,
},
},
}, (req, reply) => {
// ...
});
```
See [test](test/index.test.js) for more examples.