Why understanding res matters in Express - See It in Action

Why understanding res matters

📖 Scenario: You are building a simple Express server that sends responses to users. Understanding how the res object works is important to send the right messages back.

🎯 Goal: Build a basic Express server that uses the res object to send a text message and a JSON response to the client.

📋 What You'll Learn

Create an Express app variable called app

Create a route handler for GET requests on /hello

Use res.send() to send a plain text message

Create a route handler for GET requests on /data

Use res.json() to send a JSON object

💡 Why This Matters

🌍 Real World

Express servers are used to build web applications and APIs that send data and pages to users. Knowing how to use <code>res</code> helps you control what users see.

💼 Career

Backend developers must understand how to send correct responses using <code>res</code> in Express to build reliable and user-friendly web services.

1

Set up Express app

Create a variable called express that requires the 'express' module. Then create a variable called app by calling express().

Express

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

Hint

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

2

Add a simple text response route

Add a GET route handler on /hello using app.get. The handler function should take req and res as parameters. Use res.send() to send the text message 'Hello, world!'.

Express

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

app.get('/hello', (req, res) => {
  // Your code here
});

Hint

Use app.get('/hello', (req, res) => { res.send('Hello, world!'); }) to send a text response.

3

Add a JSON response route

Add a GET route handler on /data using app.get. The handler function should take req and res as parameters. Use res.json() to send the JSON object { message: 'This is JSON data' }.

Express

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

app.get('/hello', (req, res) => {
  res.send('Hello, world!');
});

app.get('/data', (req, res) => {
  // Your code here
});

Hint

Use res.json({ message: 'This is JSON data' }) to send JSON data.

4

Start the Express server

Add code to start the server by calling app.listen on port 3000. Use a callback function that logs 'Server running on port 3000'.

Express

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

app.get('/hello', (req, res) => {
  res.send('Hello, world!');
});

app.get('/data', (req, res) => {
  res.json({ message: 'This is JSON data' });
});

// Your code here

Hint

Use app.listen(3000, () => { console.log('Server running on port 3000'); }) to start the server.

Practice

1. What is the main purpose of the res object in Express?

easy

A. To manage database connections

B. To handle incoming requests from the client

C. To send responses back to the client

D. To configure server settings

Solution

1. Step 1: Understand the role of res in Express

   The res object represents the response that the server sends back to the client after processing a request.

2. Step 2: Differentiate res from other objects

   The req object handles incoming requests, while res controls what is sent back, such as text, JSON, or files.

3. Final Answer:

   To send responses back to the client -> Option C

4. Quick Check:

   res sends responses [OK]

Hint: Remember: res = response sent back to user [OK]

Common Mistakes:

• Confusing res with req
• Thinking res manages server setup
• Assuming res handles database

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

easy

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

B. res.sendJSON({ message: 'Hello' })

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

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

Solution

1. Step 1: Recall Express method for JSON response

   Express provides the res.json() method to send JSON data properly formatted to the client.

2. Step 2: Check syntax correctness

   Only res.json() is the correct method name; others like sendJson or sendJSON do not exist.

3. Final Answer:

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

4. Quick Check:

   Use res.json() for JSON [OK]

Hint: Use exact method name: json, not sendJson [OK]

Common Mistakes:

• Using incorrect method names like sendJson
• Confusing res.send with res.json
• Passing wrong argument structure

3. What will be the output sent to the client when this Express handler runs?

app.get('/hello', (req, res) => {
  res.status(200).send('Welcome!');
});

medium

A. Status 404 with message 'Welcome!'

B. No response sent

C. Status 500 with empty message

D. Status 200 with message 'Welcome!'

Solution

1. Step 1: Analyze the status code set by res.status(200)

   The code sets the HTTP status to 200, which means OK or success.

2. Step 2: Check the message sent with res.send('Welcome!')

   The string 'Welcome!' is sent as the response body to the client.

3. Final Answer:

   Status 200 with message 'Welcome!' -> Option D

4. Quick Check:

   Status 200 + send message = Status 200 with message 'Welcome!' [OK]

Hint: res.status sets code; res.send sends message [OK]

Common Mistakes:

• Assuming default status is 404
• Thinking res.send changes status code
• Forgetting to send a response

4. Identify the error in this Express code snippet:

app.get('/data', (req, res) => {
  res.send('Data loaded');
  res.json({ success: true });
});

medium

A. res.json should be called before res.send

B. Calling res.send and res.json in the same handler causes an error

C. res.send cannot send strings

D. No error, code works fine

Solution

1. Step 1: Understand response methods behavior

   Once res.send() sends a response, the connection closes and no further response can be sent.

2. Step 2: Identify the problem with multiple sends

   Calling res.json() after res.send() tries to send a second response, causing an error.

3. Final Answer:

   Calling res.send and res.json in the same handler causes an error -> Option B

4. Quick Check:

   Only one response per request [OK]

Hint: Send only one response per request [OK]

Common Mistakes:

• Trying to send multiple responses
• Assuming order of send/json fixes issue
• Thinking res.send can't send strings

5. You want to send a file named report.pdf to the client using res. Which code snippet correctly achieves this in Express?

hard

A. res.download('report.pdf');

B. res.sendFile('report.pdf');

C. res.send('report.pdf');

D. res.json({ file: 'report.pdf' });

Solution

1. Step 1: Understand methods to send files in Express

   res.sendFile() sends a file as response, but requires an absolute path or root option; res.download() prompts the client to download the file.

2. Step 2: Choose method that correctly sends file for download

   res.download('report.pdf') sends the file with headers to trigger download, which is usually desired for files like PDFs.

3. Final Answer:

   res.download('report.pdf'); -> Option A

4. Quick Check:

   Use res.download to send files for download [OK]

Hint: Use res.download for file downloads [OK]

Common Mistakes:

• Using res.send for files (sends text)
• Using res.json to send file name only
• Using res.sendFile without absolute path