Creating a basic HTTP server in Node.js - Why You Should Know This

The Big Idea

What if you could run your own web server with just a few lines of code?

The Scenario

Imagine you want to share a simple message or webpage with your friends over the internet by running your own server on your computer.

You try to handle all the network details yourself, like listening for requests, reading data, and sending responses.

The Problem

Doing all the network communication manually is very complicated and easy to get wrong.

You have to manage low-level details like TCP connections, data streams, and protocols, which can be confusing and error-prone.

This makes building even a simple server slow and frustrating.

The Solution

Node.js provides a built-in HTTP module that lets you create a basic web server with just a few lines of code.

This module handles all the complex network details for you, so you can focus on what your server should do.

Before vs After

✗ Before

Open TCP socket, parse HTTP request manually, write HTTP response bytes

✓ After

const http = require('http');
http.createServer((req, res) => {
  res.end('Hello World');
}).listen(3000);

What It Enables

You can quickly build and run your own web server to share content, test ideas, or learn how the web works.

Real Life Example

Running a local server to test your website during development before publishing it online.

Key Takeaways

Manually handling network communication is complex and error-prone.

Node.js HTTP module simplifies creating servers with minimal code.

This lets you focus on your app's logic, not low-level details.

Practice

1. What does the http.createServer() function do in Node.js?

easy

A. It compiles JavaScript code into machine code.

B. It creates a database connection for storing data.

C. It creates a server that listens for HTTP requests and sends responses.

D. It formats JSON data for sending over the network.

Solution

1. Step 1: Understand the purpose of http.createServer()

   This function sets up a server that waits for HTTP requests from clients like browsers.

2. Step 2: Identify what the server does

   The server uses a function to handle incoming requests and send back responses, enabling communication over the web.

3. Final Answer:

   It creates a server that listens for HTTP requests and sends responses. -> Option C

4. Quick Check:

   HTTP server creation = It creates a server that listens for HTTP requests and sends responses. [OK]

Hint: Remember: createServer sets up the web server [OK]

Common Mistakes:

• Confusing server creation with database connection
• Thinking it compiles code
• Mixing up data formatting with server setup

2. Which of the following is the correct way to start a Node.js HTTP server on port 3000?

easy

A. http.listen(3000);

B. server.listen(3000);

C. server.start(3000);

D. server.run(3000);

Solution

1. Step 1: Identify the method to start the server

   The correct method to make the server listen on a port is listen().

2. Step 2: Match the method with the server object

   Calling server.listen(3000); starts the server on port 3000.

3. Final Answer:

   server.listen(3000); -> Option B

4. Quick Check:

   Start server with listen() = server.listen(3000); [OK]

Hint: Use listen() to start the server on a port [OK]

Common Mistakes:

• Using non-existent methods like start() or run()
• Calling listen() on http instead of server
• Confusing server methods with other modules

3. What will the following Node.js code output when accessed via a browser?

const http = require('http');
const server = http.createServer((req, res) => {
  res.writeHead(200, {'Content-Type': 'text/plain'});
  res.end('Hello World');
});
server.listen(4000);

medium

A. Hello World

B. Error: server.listen is not a function

C. 404 Not Found

D. Hello

Solution

1. Step 1: Analyze the server response setup

   The server sets the HTTP status to 200 (OK) and content type to plain text, then sends 'Hello World' as the response body.

2. Step 2: Understand what the browser receives

   When accessed, the browser will display the exact string 'Hello World' from the server response.

3. Final Answer:

   Hello World -> Option A

4. Quick Check:

   Response text = Hello World [OK]

Hint: Check res.end() content for output text [OK]

Common Mistakes:

• Expecting an error due to incorrect method
• Confusing status codes with output text
• Assuming partial output without reading res.end()

4. Identify the error in this Node.js HTTP server code:

const http = require('http');
const server = http.createServer((req, res) => {
  res.writeHead(200, {'Content-Type': 'text/html'});
  res.write('Welcome');
  res.end();
});
server.listen(8080)
console.log('Server running on port 8080');

medium

A. Incorrect Content-Type header value

B. Using res.write() without res.end() causes error

C. Missing semicolon after server.listen(8080)

D. No error; code runs correctly and serves 'Welcome'

Solution

1. Step 1: Check syntax and method usage

   The code correctly calls res.write() followed by res.end(), which is valid to send response data.

2. Step 2: Verify headers and server start

   The Content-Type is valid as 'text/html', and server.listen(8080) starts the server properly. Missing semicolons are optional in JavaScript.

3. Final Answer:

   No error; code runs correctly and serves 'Welcome' -> Option D

4. Quick Check:

   Valid server code = No error; code runs correctly and serves 'Welcome' [OK]

Hint: res.write() + res.end() is valid to send response [OK]

Common Mistakes:

• Thinking missing semicolons cause errors
• Believing res.write() must be avoided
• Assuming wrong Content-Type causes failure

5. You want to create a Node.js HTTP server that responds with JSON data {"status":"ok"} and sets the correct header. Which code snippet correctly does this?

hard

A. const server = http.createServer((req, res) => {
res.writeHead(200, {'Content-Type': 'application/json'});
res.end(JSON.stringify({status: 'ok'}));
});

B. const server = http.createServer((req, res) => {
res.writeHead(200, {'Content-Type': 'text/plain'});
res.end('{"status":"ok"}');
});

C. const server = http.createServer((req, res) => {
res.writeHead(404, {'Content-Type': 'application/json'});
res.end(JSON.stringify({status: 'ok'}));
});

D. const server = http.createServer((req, res) => {
res.writeHead(200);
res.end({status: 'ok'});
});

Solution

1. Step 1: Set correct Content-Type header for JSON

   The header must be 'application/json' to tell the client the response is JSON data.

2. Step 2: Send JSON string as response body

   Use JSON.stringify() to convert the object to a JSON string before sending with res.end().

3. Final Answer:

   Code snippet with application/json header and JSON.stringify() -> Option A

4. Quick Check:

   JSON header + stringified data = const server = http.createServer((req, res) => { res.writeHead(200, {'Content-Type': 'application/json'}); res.end(JSON.stringify({status: 'ok'})); }); [OK]

Hint: Use application/json header and JSON.stringify() [OK]

Common Mistakes:

• Sending object directly without stringifying
• Using wrong Content-Type header
• Sending JSON string with text/plain header
• Using 404 status instead of 200