express.static middleware

Introduction

express.static middleware helps your Express app serve files like images, CSS, and JavaScript easily to users without extra code.

You want to show images or styles on your website.

You need to serve JavaScript files for your frontend.

You want to share downloadable files like PDFs or documents.

You want to serve a whole folder of public files quickly.

You want to keep your server code clean by letting Express handle static files.

Syntax

Express

app.use(express.static('folderName'))

Replace 'folderName' with the folder where your static files are stored.

This middleware makes files inside the folder accessible via URL paths matching their names.

Examples

Serves all files inside the 'public' folder at the root URL.

Express

app.use(express.static('public'))

Serves files from 'assets' folder but URLs start with '/static'. For example, '/static/image.png'.

Express

app.use('/static', express.static('assets'))

Uses an absolute path to serve files from 'files' folder in your project, accessible under '/files' URL path.

Express

app.use('/files', express.static(path.join(__dirname, 'files')))

Sample Program

This Express app serves files from the 'public' folder. When you visit '/', it shows a welcome message and an image loaded from 'public/logo.png'.

Express

import express from 'express';
import path from 'path';

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

// Serve static files from 'public' folder
app.use(express.static('public'));

app.get('/', (req, res) => {
  res.send('<h1>Welcome!</h1><img src="/logo.png" alt="Logo">');
});

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

Important Notes

Make sure the folder you serve exists and contains the files you want users to access.

Static middleware should be added before routes that might conflict with static file paths.

You can serve multiple static folders by calling app.use(express.static()) multiple times.

Summary

express.static middleware makes serving files like images and CSS easy.

It maps a folder to URLs so users can access files directly.

Use it to keep your server code simple and organized.

Practice

1. What is the main purpose of express.static middleware in an Express app?

easy

A. To handle database connections automatically

B. To manage user authentication and sessions

C. To parse JSON data from incoming requests

D. To serve static files like images, CSS, and JavaScript directly to clients

Solution

1. Step 1: Understand what static files are

   Static files are files like images, CSS, and JavaScript that do not change dynamically and need to be sent as-is to the client.

2. Step 2: Role of express.static

   The express.static middleware serves these files directly from a folder, making them accessible via URLs.

3. Final Answer:

   To serve static files like images, CSS, and JavaScript directly to clients -> Option D

4. Quick Check:

   express.static serves static files = B [OK]

Hint: express.static serves files like images and CSS [OK]

Common Mistakes:

• Thinking it handles database or authentication
• Confusing it with body parsing middleware
• Assuming it runs server-side logic

2. Which of the following is the correct way to use express.static to serve files from a folder named public?

easy

A. app.use.static(express('public'))

B. app.static('public')

C. app.use(express.static('public'))

D. express.use.static('public')

Solution

1. Step 1: Recall the syntax for middleware usage

   Middleware in Express is added using app.use() with the middleware function inside.

2. Step 2: Correct usage of express.static

   The express.static function takes the folder name as a string and returns middleware, so app.use(express.static('public')) is correct.

3. Final Answer:

   app.use(express.static('public')) -> Option C

4. Quick Check:

   Use app.use with express.static('folder') = D [OK]

Hint: Use app.use(express.static('folder')) to serve static files [OK]

Common Mistakes:

• Calling express.static incorrectly
• Using app.static instead of app.use
• Passing wrong arguments or chaining wrongly

3. Given this Express code snippet:

app.use('/assets', express.static('public'));

// Client requests: GET /assets/image.png

Which file path will Express try to serve?

medium

A. public/image.png

B. public/assets/image.png

C. assets/public/image.png

D. image.png

Solution

1. Step 1: Understand the URL prefix in app.use

   The URL path '/assets' is the prefix that maps to the 'public' folder.

2. Step 2: Map the requested URL to the file system

   The request is for '/assets/image.png', so Express removes '/assets' and looks for 'image.png' inside 'public'.

3. Final Answer:

   public/image.png -> Option A

4. Quick Check:

   URL prefix removed, file served from folder = A [OK]

Hint: URL prefix is removed before looking in folder [OK]

Common Mistakes:

• Thinking prefix is part of folder path
• Confusing URL path with file system path
• Assuming files are nested under prefix folder

4. What is wrong with this Express code snippet?

app.use(express.static('public'));
app.use('/static', express.static('public'));

When a client requests /static/style.css, what happens?

medium

A. The server crashes due to middleware conflict

B. The file is served correctly from public/style.css

C. The request results in 404 Not Found error

D. The file is served from public/static/style.css

Solution

1. Step 1: Analyze middleware order and paths

   The first middleware serves files from root URL, the second serves files under '/static' URL prefix.

2. Step 2: Understand request mapping for /static/style.css

   The second middleware matches '/static/style.css', removes '/static', and serves 'style.css' from 'public'.

3. Final Answer:

   The file is served correctly from public/style.css -> Option B

4. Quick Check:

   Multiple static middlewares can serve different URL prefixes = C [OK]

Hint: Multiple static middlewares can coexist with different URL prefixes [OK]

Common Mistakes:

• Assuming middleware conflicts cause crashes
• Thinking 404 occurs due to multiple static uses
• Confusing URL path with folder structure

5. You want to serve static files from two folders: public at root URL and uploads at /files. Which code correctly sets this up?

hard

A. app.use(express.static('public'));
app.use('/files', express.static('uploads'));

B. app.use('/files', express.static('public'));
app.use(express.static('uploads'));

C. app.use(express.static('uploads'));
app.use('/files', express.static('public'));

D. app.use('/public', express.static('public'));
app.use('/uploads', express.static('uploads'));

Solution

1. Step 1: Map 'public' folder to root URL

   Using app.use(express.static('public')) serves files from 'public' at root URL.

2. Step 2: Map 'uploads' folder to '/files' URL prefix

   Using app.use('/files', express.static('uploads')) serves files from 'uploads' folder under '/files' URL.

3. Final Answer:

   app.use(express.static('public')); app.use('/files', express.static('uploads')); -> Option A

4. Quick Check:

   Root and prefixed static folders set correctly = A [OK]

Hint: Root folder no prefix, others use URL prefix in app.use [OK]

Common Mistakes:

• Swapping folder and URL prefix
• Using wrong folder names in middleware
• Assigning prefixes incorrectly