https://github.com/petruki/validator4oak
Validator & Sanitizer middleware for Oak.
https://github.com/petruki/validator4oak
deno oak validator
Last synced: 3 days ago
JSON representation
Validator & Sanitizer middleware for Oak.
- Host: GitHub
- URL: https://github.com/petruki/validator4oak
- Owner: petruki
- License: mit
- Created: 2024-03-06T06:03:43.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2025-03-08T21:12:54.000Z (about 1 year ago)
- Last Synced: 2025-03-08T22:19:50.922Z (about 1 year ago)
- Topics: deno, oak, validator
- Language: TypeScript
- Homepage:
- Size: 93.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
***
Validator4Oak
Validator & Sanitizer middleware for Oak.
[](https://github.com/petruki/validator4oak/actions/workflows/master.yml)
[](https://sonarcloud.io/summary/new_code?id=petruki_validator4oak)
[](https://deno.land/x/validator4oak)
[](https://jsr.io/@trackerforce/validator4oak)
[](https://opensource.org/licenses/MIT)
***
This module provides a middleware for [Oak](https://github.com/oakserver/oak) to validate and sanitize requests.
**Compatibility**: Oak v14.0.0+
- Validate request query, body, form and header parameters
- Sanitize request parameters
- Define custom error handlers
- Create custom validators and sanitizers
- Stack up multiple validators and sanitizers
Import module with:
```typescript
import * as mod from "@trackerforce/validator4oak@[VERSION]";
import * as mod from "https://deno.land/x/validator4oak@v[VERSION]/mod.ts";
```
# Usage
### Validate query parameters
```typescript
const router = new Router();
const { query, check } = ValidatorMiddleware.createMiddleware();
const { isUrl } = ValidatorFn.createValidator();
router.get('/api/v1/shorten',
query(check('name').ifValue(isUrl())),
(ctx: Context) => {
// ...
},
);
```
Optional query parameters:
```typescript
router.get('/api/v1/shorten',
query(check('url').isOptional()),
(ctx: Context) => {
// ...
},
);
```
### Validate body and form parameters
Key body parameters can be accessed using dot-path notation keys, e.g. `order.number`.
Since Oak v14, body request can only be consumed once, so you'll need to use state.request_body to access it within the route.
Using body:
```typescript
router.post('/checkout/v1/confirm',
body(check('order.number').ifValue(isNumeric())),
(ctx: Context) => {
// ...
const body = ctx.state.request_body; // Access the body request
// ...
},
);
```
Using form:
```typescript
router.post('/checkout/v1/confirm',
form(check('order.number').ifValue(isNumeric())),
(ctx: Context) => {
// ...
const body = ctx.state.request_body; // Access the form request
// ...
},
);
```
It's also possible to validate array of complex objects using `isArray()` and `*` wildcard to access array elements.
```typescript
router.post('/checkout/v1/confirm',
body(
check('order.items').ifValue(isArray()),
check('order.items.*.sku').ifValue(isString(), hasLength({ min: 6 })),
check('order.items.*.quantity').ifValue(isNumeric())
), (ctx: Context) => {
// ...
},
);
```
### Validate header parameters
```typescript
const { header } = ValidatorMiddleware.createMiddleware();
const { isNumber } = ValidatorFn.createValidator();
router.post('/example/v1/shorten',
header(check('x-api-key').ifValue(isNumber())),
(ctx: Context) => {
// ...
},
);
```
### Sanitize parameters
```typescript
const { escape, trim } = ValidatorSn.createSanitizer();
const { hasLength } = ValidatorFn.createValidator();
router.post('/message/v1/send',
body(
check('message')
.sanitizeWith(escape(), trim())
.ifValue(hasLength({ max: 500 }))
), (ctx: Context) => {
// ...
},
);
```
### Testing
Use `deno task test` to run tests.
#### Check Oak compatibility
Replace the Oak version in the `tests/deps.ts` file to verify if middleware is compatible.
```typescript
export * from "jsr:@oak/oak@[OAK_VERSION]";
```
## Contributing
Please open an issue if you have some cool ideas to contribute.