Express express.json() Middleware

Beginner
⏱️ 9 min read
📚 Updated: May 2026
🎯 4 Code Examples
Express.js

What you’ll learn

  • How express.json() parses incoming JSON payloads.
  • Where to register it in middleware order.
  • How to configure options like body size limits.
  • How to handle parsing errors cleanly.

Overview

express.json() is built-in body parsing middleware that converts JSON request text into JavaScript objects on req.body.

Automatic parsing

No manual JSON parsing needed in each route handler.

Essential for APIs

Most REST endpoints using POST/PUT/PATCH depend on it.

Secure options

Set body size limits to reduce abuse risk from very large payloads.

Syntax

javascript
app.use(express.json())
app.use(express.json({ limit: '100kb' }))
  • Register before routes that read req.body.
  • Use options for payload limits and parsing behavior.
  • Pair with error middleware for invalid JSON handling.
1

Basic JSON body parsing

javascript
const express = require('express');
const app = express();

app.use(express.json());

app.post('/users', function (req, res) {
  res.status(201).json({ body: req.body });
});
2

Limit request body size

javascript
app.use(express.json({ limit: '200kb' }));

📋 express.json() vs express.urlencoded()

MiddlewareParsesCommon source
express.json()JSON bodyAPI clients, frontend fetch/AJAX
express.urlencoded()URL-encoded form bodyHTML form submissions

🧪 Testing checklist

  • Send valid JSON and verify req.body values are parsed.
  • Send invalid JSON and confirm error handling response.
  • Test oversized payload rejection if limit is configured.
  • Ensure middleware is loaded before body-dependent routes.

Pitfalls to avoid

Late registration

Empty req.body

Add express.json() before route handlers.

No limit

Resource pressure

Use body size limits for safer production behavior.

No error middleware

Poor API errors

Return consistent JSON errors when parsing fails.

❓ FAQ

It parses JSON request bodies and assigns the parsed object to req.body.
Use it for APIs or endpoints that accept JSON payloads, typically before route handlers.
Express throws a parsing error; handle it with error middleware to return a clean response.
No. It targets JSON content types unless customized through options.
Yes. Use options like limit to protect the app from large payloads.

Summary

  • Core role: express.json() populates req.body for JSON requests.
  • Placement: register it before routes that consume request bodies.
  • Reliability: configure limits and add robust parse-error handling.
Did you know?

express.json() parses incoming JSON payloads and populates req.body for matching requests.

About the author

Mari Selvan M P
Mari Selvan M P 🔗

Developer, cloud engineer, and technical writer

  • Experience 12 years building web and cloud systems
  • Focus Full Stack Development, AWS, and Developer Education

I write practical tutorials so students and working developers can learn by doing—from databases and APIs to deployment on AWS.

AWS Certified Developer – Associate (Credly)

4 people found this page helpful

Express app.use() Method Express app.post() Method