Creating Your First Express Server

# CHAPTER 4

Creating Your First Express Server #

1. Introduction #

2. Learning Objectives #

• Import and instantiate the Express module.

• Understand the app object.

• Define a basic GET route.

• Use app.listen() to start the server on a specific port.

3. Beginner-Friendly Explanation #

1. 1. Importing Express: This is legally registering your business name.

1. 2. Instantiating app: This is signing the lease for the building. You now have an empty store (const app = express();).

1. 3. Defining a Route: This is placing a cashier at the front desk and giving them a script: "When someone walks in and says 'Hello', you reply with 'Welcome'." (app.get(...))

1. 4. Listening on a Port: This is unlocking the front doors and flipping the "Open" sign so customers can actually enter. (app.listen(3000))

4. Step 1: The Code Skeleton #

// 1. Import the Express framework
const express = require('express');

// 2. Instantiate the application (Creates the 'app' object)
const app = express();

// 3. Define the Port number the server will listen on
const PORT = 3000;

5. Step 2: Defining a Basic Route #

// When a GET request hits the root URL ('/'), execute this callback function
app.get('/', (req, res) => {
    
    // Send plain text back to the browser
    res.send('Welcome to my first Express Server!');
    
});

*Note: req represents the Request, and res represents the Response.*

6. Step 3: Starting the Server #

// Bind the app to Port 3000 and run a callback when successful
app.listen(PORT, () => {
    console.log(`Server is successfully running on http://localhost:${PORT}`);
});

7. The Complete File #

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

app.get('/', (req, res) => {
    res.send('Welcome to my first Express Server!');
});

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

8. Running the Server #

node index.js

You will see Server is successfully running on http://localhost:3000 printed in the terminal. Open your web browser (Google Chrome) and type http://localhost:3000 into the address bar. You will see your welcome message!

To stop the server, go to your terminal and press Ctrl + C.

9. Best Practices #

• Use Environment Variables for Ports: In professional applications, you should never hardcode const PORT = 3000;. When you deploy to a cloud provider like Heroku or AWS, the cloud server assigns a random port dynamically. You should write:

10. Common Mistakes #

• The "Address Already in Use" Error: If you run node index.js and get an EADDRINUSE: address already in use :::3000 error, it means you already have a Node server running in the background (or in another terminal window) that is occupying Port 3000. Stop the other server, or change this script's port to 3001.

11. Exercises #

1. 1. Trace the flow: You type http://localhost:3000 into Chrome and hit Enter. What exact code block in index.js catches this action, and how does it respond?

12. Coding Challenges #

• Challenge: Add a second route to your index.js file. If the user visits http://localhost:3000/api/status, the server should use res.send() to reply with the text: "API is online and healthy". Run the server and test it in your browser.

13. MCQs with Answers #

14. Interview Questions #

• Q: Explain the role of the req and res objects passed into an Express route callback function.

• Q: Why do developers use nodemon instead of the standard node command during development? What problem does it solve?

15. FAQs #

16. Summary #

17. Next Chapter Recommendation #