Parsing request body (JSON and form data) in Node.js - Mini Project: Build & Apply

Parsing request body (JSON and form data)

📖 Scenario: You are building a simple Node.js server that accepts data from clients. The clients can send data either as JSON or as form data. Your server needs to read this data correctly to use it later.

🎯 Goal: Create a Node.js server that can parse incoming request bodies as JSON and as URL-encoded form data using Express middleware.

📋 What You'll Learn

Create an Express app instance

Add middleware to parse JSON request bodies

Add middleware to parse URL-encoded form data

Create a POST route that accesses parsed data from req.body

💡 Why This Matters

🌍 Real World

Web servers often receive data from clients in different formats like JSON or form data. Parsing this data correctly is essential to process user input, forms, or API requests.

💼 Career

Understanding how to parse request bodies is a fundamental skill for backend developers working with Node.js and Express to build APIs and web applications.

1

Create Express app instance

Write code to import Express and create an app instance called app.

Node.js

const express = require('express');
// Your code here

Hint

Use require('express') to import Express and then call it as a function to create app.

2

Add JSON body parsing middleware

Add middleware to app to parse incoming JSON request bodies using express.json().

Node.js

const express = require('express');
const app = express();
// Your code here

Hint

Use app.use(express.json()) to add JSON parsing middleware.

3

Add URL-encoded form data parsing middleware

Add middleware to app to parse URL-encoded form data using express.urlencoded({ extended: false }).

Node.js

const express = require('express');
const app = express();
app.use(express.json());
// Your code here

Hint

Use app.use(express.urlencoded({ extended: false })) to add form data parsing middleware.

4

Create POST route to access parsed data

Create a POST route at /submit that accesses the parsed data from req.body and assigns it to a variable called data.

Node.js

const express = require('express');
const app = express();
app.use(express.json());
app.use(express.urlencoded({ extended: false }));

// Your code here

Hint

Use app.post('/submit', (req, res) => { ... }) and inside the handler assign req.body to data.

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