Parsing request body (JSON and form data) in Node.js

Introduction

When a user sends data to your server, you need to read it. Parsing the request body means turning that data into something your code can use easily.

When a user submits a form on a website and you want to get their input.

When your server receives JSON data from a mobile app or frontend.

When you want to handle file uploads or form submissions.

When you build APIs that accept data from clients.

When you need to process user input to save it or respond accordingly.

Syntax

Node.js

import express from 'express';
const app = express();

// To parse JSON data
app.use(express.json());

// To parse URL-encoded form data
app.use(express.urlencoded({ extended: true }));

app.post('/submit', (req, res) => {
  const data = req.body;
  res.send(data);
});

express.json() reads JSON data sent in the request body.

express.urlencoded() reads form data sent as URL-encoded (like from HTML forms).

Examples

This line tells Express to automatically read JSON data from incoming requests.

Node.js

app.use(express.json());

This line tells Express to read form data sent with the content type application/x-www-form-urlencoded.

Node.js

app.use(express.urlencoded({ extended: true }));

This route reads the parsed data from req.body and sends a response.

Node.js

app.post('/data', (req, res) => {
  console.log(req.body);
  res.send('Got your data!');
});

Sample Program

This simple Express server listens on port 3000. It can accept POST requests with JSON or form data at the /submit route. It sends back the data it received as JSON.

Node.js

import express from 'express';

const app = express();
const port = 3000;

// Middleware to parse JSON
app.use(express.json());

// Middleware to parse form data
app.use(express.urlencoded({ extended: true }));

app.post('/submit', (req, res) => {
  // req.body contains parsed data
  res.json({ receivedData: req.body });
});

app.listen(port, () => {
  console.log(`Server running on http://localhost:${port}`);
});

Important Notes

Always use these middleware before your routes to ensure req.body is populated.

For JSON, the client must send the header Content-Type: application/json.

For form data, the client sends Content-Type: application/x-www-form-urlencoded.

Summary

Parsing request body lets your server understand data sent by users or apps.

Use express.json() for JSON data and express.urlencoded() for form data.

Access the parsed data in your route handlers via req.body.

Practice

1. What does express.json() middleware do in a Node.js Express app?

easy

A. It serves static JSON files from the server.

B. It parses URL query parameters and stores them in req.query.

C. It encrypts JSON data before sending it to the client.

D. It parses incoming JSON request bodies and makes the data available in req.body.

Solution

1. Step 1: Understand express.json() purpose

   This middleware parses JSON data sent in the request body, converting it into a JavaScript object.

2. Step 2: Know where parsed data is stored

   The parsed object is assigned to req.body so route handlers can access it easily.

3. Final Answer:

   It parses incoming JSON request bodies and makes the data available in req.body. -> Option D

4. Quick Check:

   express.json() parses JSON body = C [OK]

Hint: express.json() parses JSON body into req.body [OK]

Common Mistakes:

• Confusing express.json() with parsing URL query parameters
• Thinking it serves static files
• Assuming it encrypts data

2. Which middleware correctly parses URL-encoded form data in Express?

easy

A. app.use(express.urlencoded({ extended: true }))

B. app.use(express.json())

C. app.use(express.static('public'))

D. app.use(bodyParser.raw())

Solution

1. Step 1: Identify middleware for form data

   express.urlencoded() parses URL-encoded form data sent by HTML forms.

2. Step 2: Check correct usage

   Using { extended: true } allows rich objects and arrays to be encoded.

3. Final Answer:

   app.use(express.urlencoded({ extended: true })) -> Option A

4. Quick Check:

   express.urlencoded() parses form data = A [OK]

Hint: Use express.urlencoded() for form data parsing [OK]

Common Mistakes:

• Using express.json() for form data
• Confusing static file serving with parsing
• Using bodyParser.raw() instead of urlencoded

3. Given this Express route, what will console.log(req.body) output if the client sends JSON {"name":"Alice"}?

app.use(express.json());
app.post('/user', (req, res) => {
  console.log(req.body);
  res.send('Received');
});

medium

A. { name: 'Alice' }

B. undefined

C. An empty object {}

D. A string '{"name":"Alice"}'

Solution

1. Step 1: Middleware parses JSON body

   express.json() converts JSON string into a JavaScript object and assigns it to req.body.

2. Step 2: Logging req.body shows parsed object

   console.log prints the object { name: 'Alice' }.

3. Final Answer:

   { name: 'Alice' } -> Option A

4. Quick Check:

   express.json() parses JSON to object = B [OK]

Hint: express.json() parses JSON string to object in req.body [OK]

Common Mistakes:

• Expecting req.body to be a string
• Not using express.json() middleware
• Assuming req.body is undefined

4. Why does req.body remain undefined in this Express app?

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

app.post('/submit', (req, res) => {
  console.log(req.body);
  res.send('Done');
});

app.listen(3000);

medium

A. Because the server is not listening on port 3000.

B. Because the route path is incorrect.

C. Because the app is missing middleware to parse the request body.

D. Because console.log cannot print req.body.

Solution

1. Step 1: Check middleware usage

   The app does not use express.json() or express.urlencoded(), so request bodies are not parsed.

2. Step 2: Understand req.body behavior

   Without parsing middleware, req.body is undefined because Express does not parse request bodies by default.

3. Final Answer:

   Because the app is missing middleware to parse the request body. -> Option C

4. Quick Check:

   Missing body parser middleware = D [OK]

Hint: Always add body parser middleware to access req.body [OK]

Common Mistakes:

• Assuming req.body is always available
• Blaming route path or console.log
• Ignoring middleware setup

5. You want to accept both JSON and URL-encoded form data in your Express app. Which setup correctly parses both types so req.body works for all POST requests?

hard

A. app.use(express.urlencoded({ extended: false })); app.use(express.json());

B. app.use(express.json()); app.use(express.urlencoded({ extended: true }));

C. app.use(express.json()); app.use(express.urlencoded({ extended: false }));

D. app.use(bodyParser.json()); app.use(bodyParser.urlencoded());

Solution

1. Step 1: Identify middleware for both data types

   express.json() parses JSON bodies; express.urlencoded({ extended: true }) parses form data with rich objects.

2. Step 2: Confirm correct order and options

   Both middlewares should be used; extended: true allows nested objects in form data.

3. Final Answer:

   app.use(express.json()); app.use(express.urlencoded({ extended: true })); -> Option B

4. Quick Check:

   Use both express.json() and express.urlencoded({ extended: true }) = A [OK]

Hint: Use both express.json() and express.urlencoded({ extended: true }) [OK]

Common Mistakes:

• Using extended: false limits form data parsing
• Using deprecated bodyParser package
• Not including both middlewares