The HTTP module in Node.js is a core module that provides utilities for creating HTTP servers and clients. It allows Node.js to communicate over the HTTP protocol, which is essential for most web applications. Using the HTTP module, you can handle incoming HTTP requests, send responses, create servers, and interact with other web servers.

Basic Usage of the HTTP Module

The HTTP module allows you to create a basic HTTP server to listen to client requests and send responses. Below is a simple example that demonstrates how to create an HTTP server that listens on a specific port and responds with a message.


const http = require('http');

// Create the server
const server = http.createServer((req, res) => {
  // Set the response HTTP header
  res.writeHead(200, { 'Content-Type': 'text/plain' });

  // Send the response body
  res.end('Hello, world!');
});

// The server listens on port 3000
server.listen(3000, () => {
  console.log('Server is running at http://localhost:3000/');
});

In this example:

http.createServer() creates a new HTTP server.
The callback function (req, res) receives the request object (req) and response object (res).
res.writeHead(200) sends the status code (200 for OK) and the response headers.
res.end() sends the response body and ends the request-response cycle.

When you visit http://localhost:3000/ in your browser, you will see the message "Hello, world!".

Handling Routes and Request Methods

In real-world applications, you often need to handle different routes (like / and /about) and HTTP request methods (GET, POST, etc.). The following example demonstrates how to handle multiple routes and methods.


const http = require('http');

const server = http.createServer((req, res) => {
  // Handle GET request on the root route
  if (req.method === 'GET' && req.url === '/') {
    res.writeHead(200, { 'Content-Type': 'text/html' });
    res.end('Welcome to the Home Page');
  }
  // Handle GET request on the /about route
  else if (req.method === 'GET' && req.url === '/about') {
    res.writeHead(200, { 'Content-Type': 'text/html' });
    res.end('About Us');
  }
  // Handle any other routes
  else {
    res.writeHead(404, { 'Content-Type': 'text/html' });
    res.end('Page Not Found');
  }
});

server.listen(3000, () => {
  console.log('Server running on http://localhost:3000');
});

In this example, the server handles two routes: / (Home Page) and /about (About Us). If the user requests any other route, the server responds with a 404 Page Not Found message.

Advanced Usage of the HTTP Module

The HTTP module can also be used for making HTTP requests to external servers (as a client). Below is an example that demonstrates how to send a GET request to an external API, such as OpenWeatherMap.


const http = require('http');

// Making a GET request to an external API
http.get('http://api.openweathermap.org/data/2.5/weather?q=London&appid=your_api_key', (response) => {
  let data = '';

  // A chunk of data has been received
  response.on('data', (chunk) => {
    data += chunk;
  });

  // The response has been completely received
  response.on('end', () => {
    const weatherData = JSON.parse(data);
    console.log('Weather in London:', weatherData.weather[0].description);
  });
}).on('error', (err) => {
  console.log('Error:', err.message);
});

In this example:

The http.get() method sends a GET request to an external API (in this case, OpenWeatherMap).
The response is streamed in chunks, and we use response.on('data', ...) to capture these chunks.
Once all data is received, response.on('end', ...) triggers, and we parse the JSON data to display the weather description.

Handling POST Requests and Request Bodies

When handling POST requests, you often need to read the body of the request. Below is an example where the server accepts a JSON payload and writes it to a file.


const http = require('http');
const fs = require('fs');

const server = http.createServer((req, res) => {
  if (req.method === 'POST' && req.url === '/submit') {
    let body = '';

    // Read the data chunks from the request body
    req.on('data', (chunk) => {
      body += chunk;
    });

    // When the entire body has been received, parse it
    req.on('end', () => {
      const parsedData = JSON.parse(body);

      // Save data to a file (as an example)
      fs.writeFileSync('data.json', JSON.stringify(parsedData));

      res.writeHead(200, { 'Content-Type': 'application/json' });
      res.end(JSON.stringify({ message: 'Data received successfully' }));
    });
  } else {
    res.writeHead(404, { 'Content-Type': 'text/html' });
    res.end('Page Not Found');
  }
});

server.listen(3000, () => {
  console.log('Server is running on http://localhost:3000');
});

In this example:

The server handles the POST request to the /submit route.
We accumulate the request data (since POST bodies can be large) using req.on('data', ...).
Once all the data is received (req.on('end', ...)), we parse it and write it to a file.
Finally, we send a success message back to the client.

Handling Timeouts and Custom Error Handling

You can also handle timeouts and custom error responses in the HTTP server. Below is an example where we set a timeout for a request and handle potential errors.


const http = require('http');

const server = http.createServer((req, res) => {
  // Set timeout for the request
  req.setTimeout(5000, () => {
    res.writeHead(408, { 'Content-Type': 'text/html' });
    res.end('Request Timeout');
  });

  // Simulate a delayed response (for testing timeout)
  setTimeout(() => {
    res.writeHead(200, { 'Content-Type': 'text/html' });
    res.end('Request Completed');
  }, 6000); // Delay the response by 6 seconds, exceeding the timeout
});

server.listen(3000, () => {
  console.log('Server is running on http://localhost:3000');
});

In this example:

We set a timeout of 5000 milliseconds (5 seconds) on the incoming request using req.setTimeout().
If the request takes longer than the set timeout, a 408 Request Timeout error is returned.
We simulate a delayed response using setTimeout(), which intentionally exceeds the timeout and triggers the error.

Node.js Introduction	Learn Practice
V8 Engine	Learn Practice
Event Loop	Learn Practice
Global Objects	Learn Practice
Modules System	Learn Practice
CommonJS Modules	Learn Practice
ES6 Modules	Learn Practice
Package.json	Learn Practice
npm Basics	Learn Practice
yarn Basics	Learn Practice
Asynchronous Programming	Learn Practice
Callbacks	Learn Practice
Promises	Learn Practice
async/await	Learn Practice
File System Module	Learn Practice