DEV Community

You probably don't need body-parser in your Express apps

Taylor Beeston on June 09, 2020

What is body-parser? Often, when I see a blog post or article describing an Express.js server, it usually starts out with something simi...

Read full post

Salah Bentayeb • Jun 10 '20

it proves that the majority prefer to follow the tutorials than to read the documentation ... I am part of the majority 👀, I just learned this technique thanks for sharing 🙏

Taylor Beeston • Jun 10 '20

No problem!

Mohamad Kalaaji • Jun 10 '20

It has been there for quite some time 🙃 body parser became part of express

You can use both, they perform the exact same job but one thing you need to keep in mind that if there is an issue with the express build in body parser then you have to update express as whole, as for the independent body parser package if there is an issue with it then you have to update that package only

Taylor Beeston • Jun 10 '20

That is a good point that I hadn't thought of. Though at least mostly in my limited experience, express upgrades have been pretty painless

Jater Loh • Jun 9 '20

Hi, thanks for sharing! I was not aware that express ships with bodyParser now, I have to give this a try. In regards to named imports, it does make the code more concise. But I think it may be a tad confusing to have a function named json.

Taylor Beeston • Jun 9 '20

At first I thought it would be weird too, but I've found that only using it on routes that actually need to parse json actually doesn't look so bad. For example

import { Router, json } from 'express';

const router = Router();

router.route('/').get((_, response) => {
  return response.status(200).send("No parsing needed here");
});

router.route('/').post(json(), (request, response) => {
  return response.status(200).json(request.body);
});

export default router;

It might still be better to just use express.json or to rename it to something like jsonMiddleware though

Tobias SN • Jun 9 '20

Express also has built-in middleware for raw data (express.raw) and text (express.text) since 4.17.0.

Taylor Beeston • Jun 9 '20

That is true! They've also got express.urlencoded,

Ingo Steinke, web developer • Apr 20 '21

Thanks for your post! When following tutorials, even if they do not seem outdated at first sight, once I ask myself: do I really have to do this now in 202... (add current year) chances are, I don't.

No Babel, no manual HTTP CORS headers, and no external body parser.

Yuri Silva • Apr 18 '22

Yes, I was searching ways of deploy a express API in Firebase and every tutorial I saw was saying to install body-parser framework, those which are from 2021/22, which made me think: WHY are they keeping using it ? Does express body parser performs bad or is outshined by the other one ?

Josué Gabuardi • Jul 26 '20

Now read the NPM documentation... since now you don't need Babel... you only need the attribute type: module in your package.json and node.js will use ESM imports by default.

Day Souza • Jun 9 '20

That's so cool! I just tested it, thanks!

Taylor Beeston • Jun 9 '20

No problem! Glad you found it useful!

Robin Goudeketting • Jul 16 '20

What I understood is that the parser in express is actually the same one, since they always are used together, they just integrated it.

Jerry Nwosu • Oct 27 '20

Thanks. This was helpful.

Arya • Jul 14 '22

Excuse me if my question seems amateur, but why doesn't express parse the body automatically and needs to be told so?

Sumanth Yedoti • Jun 10 '20

I think, express.json() is to parse header body which is json. Body parser is also to parse form data. Please correct me if im wrong.

Taylor Beeston • Jun 10 '20

As per the Express docs

This is a built-in middleware function in Express. It parses incoming requests with JSON payloads and is based on body-parser.

Returns middleware that only parses JSON and only looks at requests where the Content-Type header matches the type option. This parser accepts any Unicode encoding of the body and supports automatic inflation of gzip and deflate encodings.

A new body object containing the parsed data is populated on the request object after the middleware (i.e. req.body), or an empty object ({}) if there was no body to parse, the Content-Type was not matched, or an error occurred.

Joseph • Jun 13 '20

It's good to remember that the body parsing was added, removed and then added again stackoverflow.com/a/47232318

Ste • Jun 9 '20

Amazing! Didn’t know this! Thank you :)