Installations

npm install fastify-raw-body

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS

Min. Node Version

>= 10

Node Version

20.8.0

NPM Version

10.1.0 Score

99.4

Supply Chain

92.1

Quality

76.1

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

0

Total

63

Closed

19

Merged

44

Issues

Open

2

Total

13

Closed

11

Releases

15

v5.0.0

Updated on Sep 17, 2024

v4.3.0

Updated on Nov 16, 2023

v4.2.2

Updated on Aug 10, 2023

v4.2.1

Updated on Jul 15, 2023

v4.2.0

Updated on Dec 16, 2022

v4.1.3

Updated on Nov 26, 2022

View All 15 releases

Contributors

9

Unable to fetch Contributors

View All 9 Contributors

Languages

2

JavaScript

TypeScript

JavaScript (95.49%)

TypeScript (4.51%)

validate.email 🚀

Verify real, reachable, and deliverable emails with instant MX records, SMTP checks, and disposable email detection.

Developer

Eomm

Download Statistics

Total Downloads

7,366,911

Last Day

13,790

Last Week

80,696

Last Month

321,744

Last Year

3,276,312

GitHub Statistics

MIT License

47 Stars

62 Commits

10 Forks

2 Watchers

2 Branches

9 Contributors

Updated on Mar 10, 2025

Bundle Size

280.89 kB

Minified

156.51 kB

Minified + Gzipped

Bundlephobia

Sponsor this package

https://github.com/Eomm/fastify-raw-body?sponsor=1

Maintainers

1

Package Meta Information

Latest Version

5.0.0

Package Id

fastify-raw-body@5.0.0

Unpacked Size

25.33 kB

Size

5.83 kB

File Count

8

NPM Version

10.1.0

Node Version

20.8.0

Published on

Sep 17, 2024

Total Downloads

Cumulative downloads

Total Downloads

7,366,911

Last Day

-13.6%

13,790

Compared to previous day

Last Week

2.4%

80,696

Compared to previous week

Last Month

18.7%

321,744

Compared to previous month

Last Year

54.3%

3,276,312

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

3

fastify-plugin raw-body secure-json-parse

Dev Dependencies

5

@types/node fastify standard tap tsd

fastify-raw-body

Adds the raw body to the Fastify request object.

Install

npm i fastify-raw-body

Compatibility

Plugin version	Fastify version
`^5.0.0`	`^5.0.0`
`^4.2.1`	`^4.19.0`
`^4.0.0`	`^4.0.0`
`^3.0.0`	`^3.0.0`
`^2.0.0`	`^2.0.0`

Usage

This plugin will add the request.rawBody.
It will get the data using the preParsing hook.

1import Fastify from 'fastify'
2
3const app = Fastify()
4await app.register(import('fastify-raw-body'), {
5  field: 'rawBody', // change the default request.rawBody property name
6  global: false, // add the rawBody to every request. **Default true**
7  encoding: 'utf8', // set it to false to set rawBody as a Buffer **Default utf8**
8  runFirst: true, // get the body before any preParsing hook change/uncompress it. **Default false**
9  routes: [], // array of routes, **`global`** will be ignored, wildcard routes not supported
10  jsonContentTypes: [], // array of content-types to handle as JSON. **Default ['application/json']**
11})
12
13app.post('/', {
14  config: {
15    // add the rawBody to this route. if false, rawBody will be disabled when global is true
16    rawBody: true
17  },
18  handler (req, reply) {
19    // req.rawBody the string raw body
20    reply.send(req.rawBody)
21  }
22})

Note
You need to await the plugin registration to make sure the plugin is ready to use. All the routes defined before the plugin registration will be ignored. This change has been introduced in Fastify v4.

Warning
Setting global: false and then the route configuration { config: { rawBody: true } } will save memory of your server since the rawBody is a copy of the body and it will double the memory usage.
So use it only for the routes that you need to.

Raw body as Buffer

It is important to know that setting encoding: false will run addContentTypeParser to add a content type parser for application/json.

This is needed since the default content type parser will set the encoding of the request stream to { parseAs: 'string' }.

If you haven't customized this component, it will be secure as the original one since secure-json-parse is used under the hood.

License

Copyright Manuel Spigolon, Licensed under MIT.

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

10

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

10

License

Determines if the project has defined a license.

2

Maintained

Determines if the project is "actively maintained".

2

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Fuzzing

Determines if the project uses fuzzing.

0

Security-Policy

Determines if the project has published a security policy.

0

SAST

Determines if the project uses static code analysis.

Score

4.2

/10

Last Scanned on 2025-03-17

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to fastify-raw-body

fastify-raw-body

Installations

Developer Guide

Yes

CommonJS

>= 10

20.8.0

10.1.0

Score

Pull Requests

0

63

19

44

Issues

2

13

11

Releases

Contributors

Unable to fetch Contributors

Languages

validate.email 🚀

Developer

Eomm

Download Statistics

GitHub Statistics

Bundle Size

280.89 kB

156.51 kB

Sponsor this package

Maintainers

Package Meta Information

Total Downloads

7,366,911

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Dev Dependencies

fastify-raw-body

Install

Compatibility

Usage

Raw body as Buffer

License

10

10

10

10

2

2

0

0

0

0

0

0

4.2

/10