How to upload files to the server using JavaScript

by Janeth Kent Date: 14-06-2023 javascript

In this tutorial we are going to see how you can upload files to a server using Node.js using JavaScript, which is very common. For example, you might want to upload an avatar, a thumbnail, a PDF file or any other image or file in various formats.

We are going to structure this tutorial in several parts. First we will create the project, then we will create the frontend code and finally the backend code for the server.

To understand this tutorial you will need some basic knowledge of the command line. If you have never used the command line before, see the following command line tutorial, which explains some basic commands for the most commonly used operating systems. You will also need to have both Node.js and the npm package manager installed.


Table of Contents

1. Project creation

2. Frontend JavaScript code

3. Node.js Backend Code

4. Testing the application


1. Creating the project


The first thing we are going to do is to configure and create the project. To do this, create an empty directory somewhere, access it via the command line and use the following command to create the project:

npm init

We only need to install two packages. First install express using the following command:

npm install express

Next we will also need a middleware for express called express-fileupload which we can use to manage the files that are sent to the server:

npm install express-fileupload

Next, configure the file that will create the express server. To do this, edit the package.json file, which should contain the line "start": "node index.js" in the scripts section to tell Node which file to run when we start the application:

"name": "ulpload-file-ajax",    
"description": "Tutorial in which an ajax medium file is created",    
"version": "1.0.0",    
"dependencies": {      
  "express": "4.16.2",      
  "express-fileupload": "^1.1.7-alpha.3",      
  "request": "^2.88.2"    
"scripts": {     
  "start": "node index.js"    

Next, we create the index.js file in the root folder of the project and we add the necessary code for the creation of a basic server:

const express = require('express');
const router = express.Router();

const bodyParser = require('body-parser');
const fileupload = require('express-fileupload');
const FileController = require('./controllers/FileController');

const app = express();
const fileController = new FileController();

app.use(bodyParser.urlencoded({ extended: true }));
app.use(fileupload());'/ulpload-file', fileController.uploadFile);

router.use(function(req, res) {
     error: true,
     message: 'Not Found'

app.use('/api', router);

app.get('/', function (req, res) {

var port = 3000;
app.listen(port, function () {
   console.log('Server',, 'listening on port', port);

module.exports = app;

What we have done is to create the server. At the top of the file we have made a require of the express-fileupload module, which is essential for uploading files.

We have included the FileController class, located in the /controllers/FileController.js file, although we haven't created it yet. In the uploadFile function of this controller is where we will add the code in charge of uploading the file.

As for the path that will redirect the request to the controller, we have defined the path /api/upload-file using the following function:'/upload-file', fileController.uploadFile);

We have added the /api prefix to the path using the following statement:

app.use('/api', router);

Please have a look at this file, as we will be creating the frontend code next.


2. Frontend JavaScript code


In this section we will add the frontend code in charge of sending the file from the user's system to the server. To start, create the index.html file in the root folder of the project. Next, edit the file you just created and copy and paste the following code, which we will explain later:

<!DOCTYPE html>  
<html lang="es">    
   <meta charset="utf-8" />      
   <meta http-equiv="x-ua-compatible" content="ie=edge" />      
   <meta name="viewport" content="width=device-width, initial-scale=1" />      
   <title>Ajax Node File Upload Tutorial</title>    
   <h1>Ajax Node File Upload Tutorial</h1>      
   <p><label>Select a new file!</label></p>      
   <input type="file" id="upload_file" />      
   <div id="result"></div>      
   <script type="text/javascript" src="resources/js/scripts.js"></script>    

What we have done is to add a basic HTML5 template. We have also added an HTML input field, which is the field that the user will interact with to upload the file:

<input type="file" id="upload_file" />

As you can see, we've linked to the /resources/js/scripts.js script just before the closing </body> tag. Let's add it, so first create the /resources/js directory and then create and edit the scripts.js file.

Now we are going to add the JavaScript code that will allow us to associate an event to the field we have created in order to upload the file to the server. First we will see the code and then we will explain it:

const uploadImage= event => {
 const files =;
 const data = new FormData();
 data.append('file', files[0]);
 fetch('/api/upload-file', {
    method: 'POST',
    body: data
 .then(response => response.json())
 .then(data => {
   document.getElementById('result').innerHTML = 'The file ' + data.path + ' has been successfully uploaded.';
 .catch(error => {
document.querySelector('#upload_file').addEventListener('change', event => {

In the last block of code we have registered a change event for the input we use to upload the file. In this event we execute the function uploadImage, which receives as parameter the click event itself, from where we will have access to the selected file.

What we do in the uploadImage function is to get the selected file, located in the array. Then we create a FormData object and assign the selected file to it. Finally we use the fetch function to send a POST request to the /api/upload-file path we created on the server.

Then we check if the file upload has been completed successfully, printing in the result field the file path if it has been uploaded correctly, or displaying an error in the console otherwise. We return the path in the path property.


3. Node.js Backend Code


Now let's take a look at the process that is followed on the server to upload the file. The first thing you need to do is create the /uploads directory in the root folder of your project. This is the directory where we will upload the files.

We're going to create the /controllers/FileController.js file as a controller. As before, we'll first look at the code for this file and then explain how it works:

class FileController
  uploadFile = async (req, res, next) =>
   const file = req.files.file;
   const fileName =;
   const path = __dirname + '/../uploads/' + fileName;
   try {, (error) => {
     if (error) {
     res.writeHead(500, {
       'Content-Type': 'application/json'
   res.end(JSON.stringify({ status: 'error', message: error }));
   return res.status(200).send({ status: 'success', path:'/uploads/' + fileName });
  } catch (e) {
    error: true,
    message: e.toString()

module.exports = FileController;

We have created a class called FileController as a controller, in which we have defined the uploadFile function.

The first thing we do is to get the file we have sent, which should be in the variable req.files.file, since file was the name we have given it in the frontend code. Now we can get the name of the file, which will be in the variable

Next, we have defined the path where we are going to copy the file and then, using the function, we copy the file to that path.

In case the file has been copied successfully, we will send the response back in JSON format:

return res.status(200).send({ status: 'success', path:'/uploads/' + fileName });

Otherwise, an error is returned.


4. Testing the app


Let's test the application to verify that everything works correctly. To do this, open a terminal window and go to the root folder of the project. Then run the following command to start the server:

npm start

Then go to the URL http://localhost:3000/ and try uploading a file, such as an image in .png or .jpg format.

And that is all.

by Janeth Kent Date: 14-06-2023 javascript hits : 12521  
Janeth Kent

Janeth Kent

Licenciada en Bellas Artes y programadora por pasión. Cuando tengo un rato retoco fotos, edito vídeos y diseño cosas. El resto del tiempo escribo en MA-NO WEB DESIGN AND DEVELOPMENT.


Related Posts

How to combine multiple objects in JavaScript

In JavaScript you can merge multiple objects in a variety of ways. The most commonly used methods are the spread operator ... and the Object.assign() function.   How to copy objects with…

The Payment Request API: Revolutionizing Online Payments (Part 2)

In the first part of this series, we explored the fundamentals of the Payment Request API and how it simplifies the payment experience. Now, let's delve deeper into advanced features…

The Payment Request API: Revolutionizing Online Payments (Part 1)

The Payment Request API has emerged as the new standard for online payments, transforming the way transactions are conducted on the internet. In this two-part series, we will delve into…

Let's create a Color Picker from scratch with HTML5 Canvas, Javascript and CSS3

HTML5 Canvas is a technology that allows developers to generate real-time graphics and animations using JavaScript. It provides a blank canvas on which graphical elements, such as lines, shapes, images…

How do you stop JavaScript execution for a while: sleep()

A sleep()function is a function that allows you to stop the execution of code for a certain amount of time. Using a function similar to this can be interesting for…

Mastering array sorting in JavaScript: a guide to the sort() function

In this article, I will explain the usage and potential of the sort() function in JavaScript.   What does the sort() function do?   The sort() function allows you to sort the elements of…

Infinite scrolling with native JavaScript using the Fetch API

I have long wanted to talk about how infinite scroll functionality can be implemented in a list of items that might be on any Web page. Infinite scroll is a technique…

Sorting elements with SortableJS and storing them in localStorage

SortableJS is a JavaScript extension that you will be able to use in your developments to offer your users the possibility to drag and drop elements in order to change…

What is a JWT token and how does it work?

JWT tokens are a standard used to create application access tokens, enabling user authentication in web applications. Specifically, it follows the RFC 7519 standard. What is a JWT token A JWT token…

Template Literals in JavaScript

Template literals, also known as template literals, appeared in JavaScript in its ES6 version, providing a new method of declaring strings using inverted quotes, offering several new and improved possibilities. About…

How to use the endsWith method in JavaScript

In this short tutorial, we are going to see what the endsWith method, introduced in JavaScript ES6, is and how it is used with strings in JavaScript. The endsWith method is…

What are javascript symbols and how can they help you?

Symbols are a new primitive value introduced by ES6. Their purpose is to provide us unique identifiers. In this article, we tell you how they work, in which way they…