Top Related Projects
Node.js middleware for handling `multipart/form-data`.
A streaming parser for HTML form data for node.js
The most used, flexible, fast and streaming parser for multipart form data. Supports uploading to serverless environments, AWS S3, Azure, GCP or the filesystem. Used in production.
A node.js module for parsing multipart-form data requests which supports streams2
A node.js module for parsing multipart-form data requests which supports streams2
The most used, flexible, fast and streaming parser for multipart form data. Supports uploading to serverless environments, AWS S3, Azure, GCP or the filesystem. Used in production.
Quick Overview
Express-fileupload is a simple Express middleware for handling file uploads in Node.js applications. It provides an easy-to-use interface for managing file uploads, supporting multiple files, file size limits, and various configuration options.
Pros
- Easy integration with Express.js applications
- Supports multiple file uploads
- Customizable file size limits and upload directories
- Provides useful methods for moving and saving uploaded files
Cons
- Limited built-in security features compared to more robust solutions
- May not be suitable for very large file uploads or high-traffic applications
- Lacks advanced features like chunked uploads or resumable uploads
Code Examples
- Basic file upload handling:
app.post('/upload', function(req, res) {
if (!req.files || Object.keys(req.files).length === 0) {
return res.status(400).send('No files were uploaded.');
}
let sampleFile = req.files.sampleFile;
sampleFile.mv('/somewhere/on/your/server/filename.jpg', function(err) {
if (err) return res.status(500).send(err);
res.send('File uploaded!');
});
});
- Handling multiple file uploads:
app.post('/upload-multiple', function(req, res) {
if (!req.files || Object.keys(req.files).length === 0) {
return res.status(400).send('No files were uploaded.');
}
let files = req.files.myFiles;
files.forEach(file => {
file.mv(`./uploads/${file.name}`, function(err) {
if (err) return res.status(500).send(err);
});
});
res.send('Files uploaded!');
});
- Using file size limits:
app.use(fileUpload({
limits: { fileSize: 50 * 1024 * 1024 }, // 50MB file size limit
}));
app.post('/upload', function(req, res) {
if (!req.files || Object.keys(req.files).length === 0) {
return res.status(400).send('No files were uploaded.');
}
let sampleFile = req.files.sampleFile;
sampleFile.mv('/path/to/file', function(err) {
if (err) return res.status(500).send(err);
res.send('File uploaded!');
});
});
Getting Started
-
Install the package:
npm install express-fileupload
-
Require and use the middleware in your Express app:
const express = require('express'); const fileUpload = require('express-fileupload'); const app = express(); app.use(fileUpload()); app.post('/upload', function(req, res) { if (!req.files || Object.keys(req.files).length === 0) { return res.status(400).send('No files were uploaded.'); } let sampleFile = req.files.sampleFile; sampleFile.mv('/path/to/file', function(err) { if (err) return res.status(500).send(err); res.send('File uploaded!'); }); }); app.listen(3000, () => console.log('Server started on port 3000'));
Competitor Comparisons
Node.js middleware for handling `multipart/form-data`.
Pros of multer
- More robust and feature-rich, offering advanced file handling capabilities
- Better performance for handling large files and multiple file uploads
- Widely adopted and well-maintained by the Express.js team
Cons of multer
- Steeper learning curve due to more complex API and configuration options
- Less straightforward for simple file upload scenarios
- Requires additional setup for handling non-multipart form data
Code Comparison
multer:
const multer = require('multer');
const upload = multer({ dest: 'uploads/' });
app.post('/upload', upload.single('file'), (req, res) => {
console.log(req.file);
});
express-fileupload:
const fileUpload = require('express-fileupload');
app.use(fileUpload());
app.post('/upload', (req, res) => {
console.log(req.files.file);
});
Summary
multer is a more powerful and flexible file upload middleware for Express.js, offering advanced features and better performance for complex scenarios. However, it comes with a steeper learning curve and requires more setup. express-fileupload, on the other hand, provides a simpler API and is easier to integrate for basic file upload needs, but may lack some advanced features and optimizations found in multer.
A streaming parser for HTML form data for node.js
Pros of busboy
- Lower-level and more flexible, allowing for fine-grained control over file uploads
- Lighter weight and potentially faster due to its focused functionality
- Can be used in various Node.js environments, not limited to Express
Cons of busboy
- Requires more setup and configuration compared to express-fileupload
- Less user-friendly for beginners or those seeking a quick implementation
- Lacks some built-in convenience features found in express-fileupload
Code Comparison
express-fileupload:
app.use(fileUpload());
app.post('/upload', (req, res) => {
if (!req.files || Object.keys(req.files).length === 0) {
return res.status(400).send('No files were uploaded.');
}
let sampleFile = req.files.sampleFile;
sampleFile.mv('/somewhere/on/your/server/filename.jpg', function(err) {
if (err) return res.status(500).send(err);
res.send('File uploaded!');
});
});
busboy:
const Busboy = require('busboy');
app.post('/upload', (req, res) => {
const busboy = new Busboy({ headers: req.headers });
busboy.on('file', (fieldname, file, filename, encoding, mimetype) => {
const saveTo = path.join('uploads', filename);
file.pipe(fs.createWriteStream(saveTo));
});
busboy.on('finish', () => {
res.writeHead(200, { 'Connection': 'close' });
res.end("That's all folks!");
});
return req.pipe(busboy);
});
The most used, flexible, fast and streaming parser for multipart form data. Supports uploading to serverless environments, AWS S3, Azure, GCP or the filesystem. Used in production.
Pros of formidable
- More flexible and can be used with various Node.js HTTP frameworks, not limited to Express
- Supports parsing of both multipart and JSON data
- Has built-in support for file renaming and custom file storage engines
Cons of formidable
- Requires more setup and configuration compared to express-fileupload
- Less straightforward integration with Express middleware
- May have a steeper learning curve for beginners
Code Comparison
express-fileupload:
app.use(fileUpload());
app.post('/upload', (req, res) => {
if (!req.files || Object.keys(req.files).length === 0) {
return res.status(400).send('No files were uploaded.');
}
let sampleFile = req.files.sampleFile;
sampleFile.mv('/somewhere/on/your/server/filename.jpg', function(err) {
if (err) return res.status(500).send(err);
res.send('File uploaded!');
});
});
formidable:
const form = new formidable.IncomingForm();
app.post('/upload', (req, res) => {
form.parse(req, (err, fields, files) => {
if (err) {
return res.status(500).send(err);
}
const oldPath = files.sampleFile.path;
const newPath = '/somewhere/on/your/server/filename.jpg';
fs.rename(oldPath, newPath, (err) => {
if (err) return res.status(500).send(err);
res.send('File uploaded!');
});
});
});
A node.js module for parsing multipart-form data requests which supports streams2
Pros of multiparty
- More flexible and customizable for handling multipart form data
- Supports streaming, which can be beneficial for large file uploads
- Provides more granular control over parsing and handling of form fields
Cons of multiparty
- Requires more setup and configuration compared to express-fileupload
- Less straightforward for simple file upload scenarios
- May have a steeper learning curve for beginners
Code Comparison
multiparty:
const multiparty = require('multiparty');
const form = new multiparty.Form();
form.parse(req, (err, fields, files) => {
// Handle parsed data
});
express-fileupload:
const fileUpload = require('express-fileupload');
app.use(fileUpload());
app.post('/upload', (req, res) => {
if (!req.files || Object.keys(req.files).length === 0) {
return res.status(400).send('No files were uploaded.');
}
// Handle uploaded files
});
The code comparison shows that multiparty requires more manual setup and parsing, while express-fileupload integrates more seamlessly with Express and provides a simpler API for handling file uploads. multiparty offers more control over the parsing process, which can be advantageous in complex scenarios, but may be overkill for simple file upload tasks. express-fileupload, on the other hand, provides a more straightforward approach for basic file upload functionality out of the box.
A node.js module for parsing multipart-form data requests which supports streams2
Pros of multiparty
- More flexible and customizable for handling multipart form data
- Supports streaming, which can be beneficial for large file uploads
- Provides more granular control over parsing and handling of form fields
Cons of multiparty
- Requires more setup and configuration compared to express-fileupload
- Less straightforward for simple file upload scenarios
- May have a steeper learning curve for beginners
Code Comparison
multiparty:
const multiparty = require('multiparty');
const form = new multiparty.Form();
form.parse(req, (err, fields, files) => {
// Handle parsed data
});
express-fileupload:
const fileUpload = require('express-fileupload');
app.use(fileUpload());
app.post('/upload', (req, res) => {
if (!req.files || Object.keys(req.files).length === 0) {
return res.status(400).send('No files were uploaded.');
}
// Handle uploaded files
});
The code comparison shows that multiparty requires more manual setup and parsing, while express-fileupload integrates more seamlessly with Express and provides a simpler API for handling file uploads. multiparty offers more control over the parsing process, which can be advantageous in complex scenarios, but may be overkill for simple file upload tasks. express-fileupload, on the other hand, provides a more straightforward approach for basic file upload functionality out of the box.
The most used, flexible, fast and streaming parser for multipart form data. Supports uploading to serverless environments, AWS S3, Azure, GCP or the filesystem. Used in production.
Pros of formidable
- More flexible and can be used with various Node.js HTTP frameworks, not limited to Express
- Supports parsing of both multipart and JSON data
- Has built-in support for file renaming and custom file storage engines
Cons of formidable
- Requires more setup and configuration compared to express-fileupload
- Less straightforward integration with Express middleware
- May have a steeper learning curve for beginners
Code Comparison
express-fileupload:
app.use(fileUpload());
app.post('/upload', (req, res) => {
if (!req.files || Object.keys(req.files).length === 0) {
return res.status(400).send('No files were uploaded.');
}
let sampleFile = req.files.sampleFile;
sampleFile.mv('/somewhere/on/your/server/filename.jpg', function(err) {
if (err) return res.status(500).send(err);
res.send('File uploaded!');
});
});
formidable:
const form = new formidable.IncomingForm();
app.post('/upload', (req, res) => {
form.parse(req, (err, fields, files) => {
if (err) {
return res.status(500).send(err);
}
const oldPath = files.sampleFile.path;
const newPath = '/somewhere/on/your/server/filename.jpg';
fs.rename(oldPath, newPath, (err) => {
if (err) return res.status(500).send(err);
res.send('File uploaded!');
});
});
});
Convert designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual CopilotREADME
express-fileupload
Simple express middleware for uploading files.
Help us Improve express-fileupload
This package is still very much supported and maintained. But the more help the better. If you're interested any of the following:
- Ticket and PR triage
- Feature scoping and implementation
- Maintenance (upgrading packages, fixing security vulnerabilities, etc)
...please contact richardgirges '-at-' gmail.com
Install
# With NPM
npm i express-fileupload
# With Yarn
yarn add express-fileupload
Usage
When you upload a file, the file will be accessible from req.files
.
Example:
- You're uploading a file called car.jpg
- Your input's name field is foo:
<input name="foo" type="file" />
- In your express server request, you can access your uploaded file from
req.files.foo
:
app.post('/upload', function(req, res) {
console.log(req.files.foo); // the uploaded file object
});
The req.files.foo object will contain the following:
req.files.foo.name
: "car.jpg"req.files.foo.mv
: A function to move the file elsewhere on your server. Can take a callback or return a promise.req.files.foo.mimetype
: The mimetype of your filereq.files.foo.data
: A buffer representation of your file, returns empty buffer in case useTempFiles option was set to true.req.files.foo.tempFilePath
: A path to the temporary file in case useTempFiles option was set to true.req.files.foo.truncated
: A boolean that represents if the file is over the size limitreq.files.foo.size
: Uploaded size in bytesreq.files.foo.md5
: MD5 checksum of the uploaded file
Notes about breaking changes with MD5 handling:
- Before 1.0.0,
md5
is an MD5 checksum of the uploaded file. - From 1.0.0 until 1.1.1,
md5
is a function to compute an MD5 hash (Read about it here.). - From 1.1.1 until 1.5.1,
md5
is reverted back to MD5 checksum value and also added full MD5 support in case you are using temporary files. - From 1.5.1 onward,
md5
still holds the checksum value, but the checksum is generated with the providedhashAlgorithm
option. The property name remainsmd5
for backwards compatibility.
Examples
Using Busboy Options
Pass in Busboy options directly to the express-fileupload middleware. Check out the Busboy documentation here.
app.use(fileUpload({
limits: { fileSize: 50 * 1024 * 1024 },
}));
Using useTempFile Options
Use temp files instead of memory for managing the upload process.
// Note that this option available for versions 1.0.0 and newer.
app.use(fileUpload({
useTempFiles : true,
tempFileDir : '/tmp/'
}));
Using debug option
You can set debug
option to true
to see some logging about upload process.
In this case middleware uses console.log
and adds Express-file-upload
prefix for outputs.
You can set a custom logger having .log()
method to the logger
option.
It will show you whether the request is invalid and also common events triggered during upload. That can be really useful for troubleshooting and we recommend attaching debug output to each issue on Github.
Output example:
Express-file-upload: Temporary file path is /node/express-fileupload/test/temp/tmp-16-1570084843942
Express-file-upload: New upload started testFile->car.png, bytes:0
Express-file-upload: Uploading testFile->car.png, bytes:21232...
Express-file-upload: Uploading testFile->car.png, bytes:86768...
Express-file-upload: Upload timeout testFile->car.png, bytes:86768
Express-file-upload: Cleaning up temporary file /node/express-fileupload/test/temp/tmp-16-1570084843942...
Description:
Temporary file path is...
says thatuseTempfiles
was set to true and also shows you temp file name and path.New upload started testFile->car.png
says that new upload started with fieldtestFile
and file namecar.png
.Uploading testFile->car.png, bytes:21232...
shows current progress for each new data chunk.Upload timeout
means that no data came duringuploadTimeout
.Cleaning up temporary file
Here finaly we see cleaning up of the temporary file because of upload timeout reached.
Available Options
Pass in non-Busboy options directly to the middleware. These are express-fileupload specific options.
Option | Acceptable Values | Details |
---|---|---|
createParentPath |
| Automatically creates the directory path specified in .mv(filePathName) |
uriDecodeFileNames |
| Applies uri decoding to file names if set true. |
safeFileNames |
| Strips characters from the upload's filename. You can use custom regex to determine what to strip. If set to true , non-alphanumeric characters except dashes and underscores will be stripped. This option is off by default.Example #1 (strip slashes from file names): app.use(fileUpload({ safeFileNames: /\\/g })) Example #2: app.use(fileUpload({ safeFileNames: true })) |
preserveExtension |
| Preserves filename extension when using safeFileNames option. If set to true , will default to an extension length of 3. If set to Number , this will be the max allowable extension length. If an extension is smaller than the extension length, it remains untouched. If the extension is longer, it is shifted.Example #1 (true): app.use(fileUpload({ safeFileNames: true, preserveExtension: true })); myFileName.ext --> myFileName.ext Example #2 (max extension length 2, extension shifted): app.use(fileUpload({ safeFileNames: true, preserveExtension: 2 })); myFileName.ext --> myFileNamee.xt |
abortOnLimit |
| Returns a HTTP 413 when the file is bigger than the size limit if true. Otherwise, it will add a truncated = true to the resulting file structure. |
responseOnLimit |
| Response which will be send to client if file size limit exceeded when abortOnLimit set to true. |
limitHandler |
| User defined limit handler which will be invoked if the file is bigger than configured limits. |
useTempFiles |
| By default this module uploads files into RAM. Setting this option to True turns on using temporary files instead of utilising RAM. This avoids memory overflow issues when uploading large files or in case of uploading lots of files at same time. |
tempFileDir |
| Path to store temporary files. Used along with the useTempFiles option. By default this module uses 'tmp' folder in the current working directory.You can use trailing slash, but it is not necessary. |
parseNested |
| By default, req.body and req.files are flattened like this: {'name': 'John', 'hobbies[0]': 'Cinema', 'hobbies[1]': 'Bike'} When this option is enabled they are parsed in order to be nested like this: {'name': 'John', 'hobbies': ['Cinema', 'Bike']} |
debug |
| Turn on/off upload process logging. Can be useful for troubleshooting. |
logger |
| Customizable logger to write debug messages to. Console is default. |
uploadTimeout |
| This defines how long to wait for data before aborting. Set to 0 if you want to turn off timeout checks. |
hashAlgorithm |
| Allows the usage of alternative hashing algorithms for file integrity checks. This option must be an algorithm that is supported on the running system's installed OpenSSL version. On recent releases of OpenSSL, openssl list -digest-algorithms will display the available digest algorithms. |
Help Wanted
Looking for additional maintainers. Please contact richardgirges [ at ] gmail.com
if you're interested. Pull Requests are welcome!
Thanks & Credit
Brian White for his stellar work on the Busboy Package and the connect-busboy Package
Top Related Projects
Node.js middleware for handling `multipart/form-data`.
A streaming parser for HTML form data for node.js
The most used, flexible, fast and streaming parser for multipart form data. Supports uploading to serverless environments, AWS S3, Azure, GCP or the filesystem. Used in production.
A node.js module for parsing multipart-form data requests which supports streams2
A node.js module for parsing multipart-form data requests which supports streams2
The most used, flexible, fast and streaming parser for multipart form data. Supports uploading to serverless environments, AWS S3, Azure, GCP or the filesystem. Used in production.
Convert designs to code with AI
Introducing Visual Copilot: A new AI model to turn Figma designs to high quality code using your components.
Try Visual Copilot