File Uploading in Node.js

When adding a feature to let users upload files to your Node.js application, it’s important to do it well to keep users happy and data secure. We’ll talk about using Formidable, a tool that helps read form data and files. We will learn how to create a form for uploading, understand the uploaded file and store it on the server. This will help you add this feature correctly.

Introduction to File Uploading in Node.js Using the Formidable Module

File uploading is a common requirement in web applications, allowing users to submit documents, images, and other files. Node.js, with its vast ecosystem of modules, simplifies this task, and one of the standout modules for handling file uploads is Formidable. It’s designed to parse form data, especially file uploads, efficiently.

Why Formidable?

Users often need to upload files to websites to send documents, pictures and more. Node.js, with its many tools, makes this easy, and Formidable is an excellent tool for this job. It helps to read form data and files faster.

Getting Started

To begin, ensure you have Node.js installed on your system. Then, create a new directory for your project and initialize a new Node.js application by running npm init in your terminal. You’ll need to install Formidable using npm:

npm install formidable

Step 1: Create an Upload Form

First, you need an HTML form for users to select the file they want to upload. Here’s a simple form that does just that:

<!DOCTYPE html>
<form action="upload" method="post" enctype="multipart/form-data">
  <input type="file" name="filetoupload"><br>
  <input type="submit">

The enctype="multipart/form-data" attribute is essential for sending files.

Step 2: Setup Your Node.js Server

Using the http module, set up a basic server:

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

http.createServer((req, res) => {
  if (req.url === '/upload' && req.method.toLowerCase() === 'post') {
    // Parse the uploaded file
    const form = new formidable.IncomingForm();
    form.parse(req, (err, fields, files) => {
      if (err) {
        res.writeHead(500, { 'Content-Type': 'text/plain' });
        res.end('Error parsing the file');
      // Step 3: Save the File
      const oldPath = files.filetoupload.path;
      const newPath = './uploads/' +;

      // Move the file
      fs.rename(oldPath, newPath, (err) => {
        if (err) throw err;
        res.write('File uploaded and moved!');
  } else {
    // Display the upload form
    res.writeHead(200, { 'Content-Type': 'text/html' });
    res.end('<form action="upload" method="post" enctype="multipart/form-data">' +
            '<input type="file" name="filetoupload"><br>' +
            '<input type="submit">' +
}).listen(8080, () => console.log('Server listening on port 8080'));

Step 3: Save the File

Within the form parsing callback, you use Node.js’s File System (fs) module to move the uploaded file from its temporary directory to a designated location. This process is demonstrated in the code snippet above, where fs.rename is used to move the file.

Handling Multiple File Uploads

Formidable can handle multiple files; you just need to adjust your form to accept multiple files by adding the multiple attribute to your file input, like so:

<input type="file" name="files" multiple>

Then, in your Node.js script, you would iterate over the files object in the callback of form.parse.

Security Considerations

When implementing file uploads, always consider security. Validate file types, limit the size of uploads, and sanitize file names to prevent injection attacks. Formidable allows you to set limits on the size of the files being uploaded and the number of files, which helps mitigate denial of service (DoS) attacks.


Adding a feature to let users upload files in Node.js with Formidable is easy and useful. This guide shows you how to do that step by step, so you can make your apps better and more fun. Always think about safety and be careful with files. Knowing how to do this means you can make your Node.js applications better.