JSON request and response patterns in Express - Mini Project: Build & Apply

JSON Request and Response Patterns with Express

📖 Scenario: You are building a simple Express server that handles JSON data from clients. This server will receive JSON requests and send JSON responses.

🎯 Goal: Create an Express server that accepts JSON data in a POST request and responds with a JSON message confirming the received data.

📋 What You'll Learn

Create an Express app instance

Use middleware to parse JSON request bodies

Create a POST route at /submit that reads JSON data from the request body

Send a JSON response confirming the received data

💡 Why This Matters

🌍 Real World

Many web applications use Express servers to handle JSON data sent from frontend clients or other services.

💼 Career

Understanding JSON request and response patterns is essential for backend developers working with APIs and web servers.

1

Set up Express app and import modules

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

Express

// Your code here

Hint

Use require('express') to import Express and then call express() to create the app.

2

Add JSON body parsing middleware

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

Express

const express = require('express');
const app = express();
// Add JSON parsing middleware here

Hint

Use app.use(express.json()) to enable JSON parsing for request bodies.

3

Create POST route to receive JSON data

Create a POST route at /submit using app.post. Inside the route handler, access the JSON data from req.body and store it in a variable called data.

Express

const express = require('express');
const app = express();
app.use(express.json());

// Create POST /submit route here

Hint

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

4

Send JSON response confirming received data

Inside the POST route handler, send a JSON response using res.json with an object containing a message key that says "Data received" and a received key with the data variable.

Express

const express = require('express');
const app = express();
app.use(express.json());

app.post('/submit', (req, res) => {
    const data = req.body;
    // Send JSON response here
});

Hint

Use res.json({ message: "Data received", received: data }) to send the JSON response.

Practice

1. What does the express.json() middleware do in an Express app?

easy

A. It sends JSON responses to the client.

B. It parses incoming JSON request bodies automatically.

C. It logs JSON data to the console.

D. It validates JSON schema in requests.

Solution

1. Step 1: Understand middleware purpose

   The express.json() middleware is designed to parse JSON data sent in the request body.

2. Step 2: Differentiate from response methods

   Sending JSON responses is done by res.json(), not express.json().

3. Final Answer:

   It parses incoming JSON request bodies automatically. -> Option B

4. Quick Check:

   express.json() parses JSON requests [OK]

Hint: express.json() parses JSON request bodies [OK]

Common Mistakes:

• Confusing express.json() with res.json()
• Thinking it sends JSON responses
• Assuming it validates JSON schema

2. Which of the following is the correct way to send a JSON response with Express?

easy

A. res.sendJson({ message: 'Hello' })

B. res.send({ json: 'Hello' })

C. res.json({ message: 'Hello' })

D. res.jsonify({ message: 'Hello' })

Solution

1. Step 1: Identify Express response methods

   Express provides res.json() to send JSON responses with proper headers.

2. Step 2: Check method names

   Methods like sendJson or jsonify do not exist in Express.

3. Final Answer:

   res.json({ message: 'Hello' }) -> Option C

4. Quick Check:

   Use res.json() to send JSON responses [OK]

Hint: Use res.json() to send JSON responses [OK]

Common Mistakes:

• Using non-existent methods like sendJson or jsonify
• Using res.send() without JSON formatting
• Confusing method names

3. Given this Express route, what will be the JSON response when a POST request with body { "name": "Alice" } is sent?

app.use(express.json());
app.post('/greet', (req, res) => {
  const user = req.body.name;
  res.json({ greeting: `Hello, ${user}!` });
});

medium

A. Empty response

B. { "greeting": "Hello, undefined!" }

C. SyntaxError

D. { "greeting": "Hello, Alice!" }

Solution

1. Step 1: Parse JSON body with express.json()

   The middleware parses the JSON body, so req.body.name is 'Alice'.

2. Step 2: Construct JSON response

   The response sends { greeting: `Hello, Alice!` } as JSON.

3. Final Answer:

   { "greeting": "Hello, Alice!" } -> Option D

4. Quick Check:

   Parsed JSON body used in res.json() response [OK]

Hint: express.json() parses body; res.json() sends response [OK]

Common Mistakes:

• Forgetting to use express.json() middleware
• Accessing req.body before parsing
• Expecting undefined instead of 'Alice'

4. What is wrong with this Express code snippet for handling JSON requests?

app.post('/data', (req, res) => {
  const data = req.body;
  res.json({ received: data });
});

medium

A. Missing express.json() middleware to parse JSON body.

B. Using res.json() instead of res.send().

C. Incorrect route method; should be app.get.

D. No error; code works fine.

Solution

1. Step 1: Check JSON parsing middleware

   The code accesses req.body but does not show express.json() middleware usage.

2. Step 2: Understand middleware necessity

   Without express.json(), req.body will be undefined for JSON requests.

3. Final Answer:

   Missing express.json() middleware to parse JSON body. -> Option A

4. Quick Check:

   express.json() needed to parse JSON requests [OK]

Hint: Always add express.json() to parse JSON bodies [OK]

Common Mistakes:

• Assuming req.body is parsed automatically
• Confusing res.json() with res.send()
• Using wrong HTTP method for JSON POST

5. You want to create an Express route that accepts a JSON array of numbers in the request body and responds with a JSON object containing the sum of those numbers. Which code snippet correctly implements this?

hard

A. app.post('/sum', express.json(), (req, res) => {
const numbers = req.body;
const sum = numbers.reduce((a, b) => a + b, 0);
res.json({ sum });
});

B. app.post('/sum', (req, res) => {
const numbers = JSON.parse(req.body);
const sum = numbers.reduce((a, b) => a + b, 0);
res.json({ sum });
});

C. app.post('/sum', express.urlencoded(), (req, res) => {
const numbers = req.body;
const sum = numbers.reduce((a, b) => a + b, 0);
res.json({ sum });
});

D. app.post('/sum', (req, res) => {
const numbers = req.body.numbers;
const sum = numbers.reduce((a, b) => a + b, 0);
res.send({ sum });
});

Solution

1. Step 1: Use express.json() middleware to parse JSON array

   app.post('/sum', express.json(), (req, res) => { const numbers = req.body; const sum = numbers.reduce((a, b) => a + b, 0); res.json({ sum }); }); correctly uses express.json() middleware inline to parse the JSON array in the request body.

2. Step 2: Sum array and send JSON response

   It sums the numbers with reduce and sends the result with res.json(), which sets correct headers.

3. Step 3: Identify errors in other options

   app.post('/sum', (req, res) => { const numbers = JSON.parse(req.body); const sum = numbers.reduce((a, b) => a + b, 0); res.json({ sum }); }); tries to parse req.body manually, which is already parsed by middleware. app.post('/sum', express.urlencoded(), (req, res) => { const numbers = req.body; const sum = numbers.reduce((a, b) => a + b, 0); res.json({ sum }); }); uses express.urlencoded() which is for form data, not JSON. app.post('/sum', (req, res) => { const numbers = req.body.numbers; const sum = numbers.reduce((a, b) => a + b, 0); res.send({ sum }); }); accesses req.body.numbers but expects array directly in body; also uses res.send() which may not set JSON headers properly.

4. Final Answer:

   app.post('/sum', express.json(), (req, res) => { const numbers = req.body; const sum = numbers.reduce((a, b) => a + b, 0); res.json({ sum }); }); -> Option A

5. Quick Check:

   express.json() + res.json() for JSON array sum [OK]

Hint: Use express.json() middleware and res.json() for JSON data [OK]

Common Mistakes:

• Not using express.json() to parse JSON body
• Using express.urlencoded() for JSON data
• Manually parsing req.body with JSON.parse
• Using res.send() instead of res.json() for JSON response