Multer middleware setup in Express - Mini Project: Build & Apply

Multer middleware setup

📖 Scenario: You are building a simple Express server that accepts file uploads from users. To handle file uploads safely and easily, you will use the multer middleware.This project will guide you step-by-step to set up multer in your Express app.

🎯 Goal: Build an Express server with multer middleware configured to accept single file uploads under the field name profilePic.

📋 What You'll Learn

Create an Express app instance

Import and configure multer middleware with a destination folder

Use multer middleware in a POST route to handle single file upload with field name 'profilePic'

Send a success response after file upload

💡 Why This Matters

🌍 Real World

File uploads are common in web apps for user profile pictures, documents, or media. Multer helps handle these uploads safely and easily.

💼 Career

Backend developers often need to implement file upload features using Express and multer in real projects.

1

Create Express app and import multer

Write code to import express and multer modules, then create an Express app instance called app.

Express

// Import express and multer
// Create an Express app instance called app
// Your code here

Hint

Use require('express') and require('multer') to import modules. Then call express() to create the app.

2

Configure multer storage destination

Create a multer storage configuration that saves uploaded files to a folder named uploads/. Then create a multer instance called upload using this storage.

Express

const express = require('express');
const multer = require('multer');

const app = express();

// Configure multer storage to save files in 'uploads/' folder
// Create multer instance called upload
// Your code here

Hint

Use multer.diskStorage to set the destination folder. Then pass this storage to multer() to create the upload middleware.

3

Add POST route with multer middleware

Add a POST route at /upload that uses the upload.single('profilePic') middleware to handle a single file upload with field name profilePic. The route handler should send a JSON response with message 'File uploaded successfully'.

Express

const express = require('express');
const multer = require('multer');

const app = express();

const storage = multer.diskStorage({
  destination: function (req, file, cb) {
    cb(null, 'uploads/');
  },
  filename: function (req, file, cb) {
    cb(null, file.originalname);
  }
});

const upload = multer({ storage: storage });

// Add POST route '/upload' using upload.single('profilePic') middleware
// Send JSON response { message: 'File uploaded successfully' }
// Your code here

Hint

Use app.post with the path '/upload'. Add upload.single('profilePic') as middleware. Then send a JSON response inside the handler.

4

Start the Express server

Add code to start the Express server listening on port 3000. Use app.listen with port 3000 and a callback function.

Express

const express = require('express');
const multer = require('multer');

const app = express();

const storage = multer.diskStorage({
  destination: function (req, file, cb) {
    cb(null, 'uploads/');
  },
  filename: function (req, file, cb) {
    cb(null, file.originalname);
  }
});

const upload = multer({ storage: storage });

app.post('/upload', upload.single('profilePic'), (req, res) => {
  res.json({ message: 'File uploaded successfully' });
});

// Start server on port 3000
// Your code here

Hint

Use app.listen(3000, () => { ... }) to start the server and log a message.

Practice

1. What is the primary purpose of the multer middleware in an Express application?

easy

A. To serve static files like images and CSS

B. To parse JSON data in request bodies

C. To handle file uploads from client requests

D. To manage user sessions and cookies

Solution

1. Step 1: Understand middleware role

   Multer is middleware designed specifically to handle multipart/form-data, which is used for uploading files.

2. Step 2: Compare with other middleware

   Other middleware like body-parser handle JSON, and express.static serves static files, but multer focuses on file uploads.

3. Final Answer:

   To handle file uploads from client requests -> Option C

4. Quick Check:

   Multer = file upload handler [OK]

Hint: Multer is for file uploads, not JSON or sessions [OK]

Common Mistakes:

• Confusing multer with body-parser for JSON parsing
• Thinking multer manages sessions or cookies
• Assuming multer serves static files

2. Which of the following is the correct way to set up multer to accept a single file upload with the field name 'avatar'?

easy

A. const upload = multer().single('avatar');

B. const upload = multer.single('avatar');

C. const upload = multer().array('avatar');

D. const upload = multer().multi('avatar');

Solution

1. Step 1: Correct multer initialization

   Multer must be called as a function to create an instance: multer().

2. Step 2: Use .single() for single file

   To accept one file, use upload.single('fieldname'). Here, 'avatar' is the field name.

3. Final Answer:

   const upload = multer().single('avatar'); -> Option A

4. Quick Check:

   multer() + .single('avatar') = correct setup [OK]

Hint: Always call multer() before .single() or .array() [OK]

Common Mistakes:

• Calling multer.single() without parentheses
• Using .array() instead of .single() for one file
• Using non-existent .multi() method

3. Given this Express route setup with multer:

const multer = require('multer');
const upload = multer({ dest: 'uploads/' });

app.post('/profile', upload.single('photo'), (req, res) => {
  res.send(req.file.path);
});

What will be the response when a user uploads a file named 'pic.jpg' in the 'photo' field?

medium

A. Undefined, because req.file is not set

B. The original filename 'pic.jpg'

C. An error because 'dest' is not a valid option

D. The path where the file is saved, like 'uploads/abc123'

Solution

1. Step 1: Understand multer storage with 'dest'

   Setting 'dest' tells multer to save files to that folder with a generated filename, not the original name.

2. Step 2: Check what req.file.path contains

   req.file.path contains the full path to the saved file, e.g., 'uploads/abc123'.

3. Final Answer:

   The path where the file is saved, like 'uploads/abc123' -> Option D

4. Quick Check:

   dest option saves file with generated name = path returned [OK]

Hint: dest saves file with random name; req.file.path shows saved path [OK]

Common Mistakes:

• Expecting original filename in req.file.path
• Thinking 'dest' is invalid option
• Assuming req.file is undefined without upload

4. Consider this code snippet:

const multer = require('multer');
const upload = multer({ dest: 'uploads/' });

app.post('/upload', upload.single('file'), (req, res) => {
  console.log(req.files);
  res.send('Upload complete');
});

What is the problem with this code?

medium

A. Incorrect destination folder name

B. Using req.files instead of req.file for single file upload

C. Missing call to multer() function

D. upload.single() should be upload.array() for single file

Solution

1. Step 1: Check multer method used

   upload.single('file') handles one file and stores it in req.file (singular).

2. Step 2: Identify incorrect property usage

   The code logs req.files (plural), which is undefined for single file uploads.

3. Final Answer:

   Using req.files instead of req.file for single file upload -> Option B

4. Quick Check:

   single() sets req.file, not req.files [OK]

Hint: Use req.file for single, req.files for multiple uploads [OK]

Common Mistakes:

• Confusing req.file and req.files
• Not calling multer() before .single()
• Using upload.array() when single file expected

5. You want to customize multer to store uploaded files in a folder named 'images' and rename each file to include the current timestamp before the original filename. Which setup correctly achieves this?

hard

A. const storage = multer.diskStorage({ destination: 'images', filename: (req, file, cb) => { cb(null, Date.now() + '-' + file.originalname); } }); const upload = multer({ storage });

B. const storage = multer.diskStorage({ destination: (req, file, cb) => { cb(null, images); }, filename: (req, file, cb) => { cb(null, Date.now() + '-' + file.originalname); } }); const upload = multer({ storage });

C. const storage = multer.diskStorage({ destination: 'images', filename: (req, file, cb) => { cb(null, file.originalname); } }); const upload = multer({ storage });

D. const upload = multer({ dest: 'images', filename: (req, file, cb) => { cb(null, Date.now() + '-' + file.originalname); } });

Solution

1. Step 1: Understand diskStorage options

   diskStorage accepts destination as string or function(req, file, cb); filename must be function(req, file, cb).

2. Step 2: Verify timestamp renaming

   Filename function must call cb(null, Date.now() + '-' + file.originalname).

3. Step 3: Identify correct setup

   const storage = multer.diskStorage({ destination: 'images', filename: (req, file, cb) => { cb(null, Date.now() + '-' + file.originalname); } }); const upload = multer({ storage }); uses valid string destination and correct filename.

4. Final Answer:

   const storage = multer.diskStorage({ destination: 'images', filename: (req, file, cb) => { cb(null, Date.now() + '-' + file.originalname); } }); const upload = multer({ storage }); -> Option A

5. Quick Check:

   destination string + filename(Date.now()) [OK]

Hint: destination: string or fn(); filename: fn() always [OK]

Common Mistakes:

• Using unquoted path in destination function (images vs 'images')
• Passing filename option directly to multer instead of diskStorage
• Not using callback cb in destination or filename