HTTP caching headers in Node.js - Mini Project: Build & Apply

HTTP Caching Headers with Node.js

📖 Scenario: You are building a simple Node.js server that serves a static message. To improve performance and reduce unnecessary network traffic, you want to add HTTP caching headers.This will help browsers know when they can reuse the cached response instead of asking the server again.

🎯 Goal: Create a Node.js server that sends a plain text response with proper HTTP caching headers set.

📋 What You'll Learn

Create a Node.js HTTP server using the built-in http module

Set the Cache-Control header to cache the response for 60 seconds

Set the Expires header to a date 60 seconds in the future

Send a plain text response with the message Hello, caching!

💡 Why This Matters

🌍 Real World

Web servers use caching headers to improve speed and reduce bandwidth by telling browsers when to reuse stored responses.

💼 Career

Understanding HTTP caching headers is essential for backend developers and anyone working with web performance optimization.

1

Create a basic Node.js HTTP server

Write code to create a Node.js HTTP server using the http module. The server should listen on port 3000 and respond with the text Hello, caching! without any headers.

Node.js

const http = require('http');

// Your code here

Need a hint?

Use http.createServer to create the server and res.end to send the response.

2

Add a cache duration variable

Add a variable called cacheDuration and set it to 60 to represent 60 seconds of caching time.

Node.js

const http = require('http');

// Your code here

const server = http.createServer((req, res) => {
    res.statusCode = 200;
    res.setHeader('Content-Type', 'text/plain');
    res.end('Hello, caching!');
});

server.listen(3000);

Need a hint?

Declare cacheDuration as a constant with the value 60.

3

Set the Cache-Control header

Inside the server callback, add a Cache-Control header to the response. Set it to public, max-age=60 using the cacheDuration variable.

Node.js

const http = require('http');

const cacheDuration = 60;

const server = http.createServer((req, res) => {
    res.statusCode = 200;
    // Your code here
    res.setHeader('Content-Type', 'text/plain');
    res.end('Hello, caching!');
});

server.listen(3000);

Need a hint?

Use res.setHeader with the exact string 'Cache-Control' and template literal for max-age.

4

Set the Expires header

Inside the server callback, add an Expires header. Calculate the expiration date by creating a new Date object, adding cacheDuration seconds, and converting it to UTC string format.

Node.js

const http = require('http');

const cacheDuration = 60;

const server = http.createServer((req, res) => {
    res.statusCode = 200;
    res.setHeader('Cache-Control', `public, max-age=${cacheDuration}`);
    res.setHeader('Content-Type', 'text/plain');
    // Add Expires header here
    res.end('Hello, caching!');
});

server.listen(3000);

Need a hint?

Create a variable expires with the future date and set it as the Expires header.