express-form-post

Express Form Post

A simple solution to handling file and form submissions

Installation

$ npm install express-form-post --save

Usage

The information for the file uploaded will be available in the files and body object in the request object. express-form-post can be dropped in as middleware or used as a function to handle file upload.

Quick Start

var express = require("express");
var app = express();
var efp = require("express-form-post");
var formPost = efp();

app.use(formPost.middleware());

Disk Storage

var express = require("express");
var app = express();
var efp = require("express-form-post");
const formPost = efp({
	store: "disk",
	directory: path.join(__dirname, "tmp"),
	maxfileSize: 10000,
	filename: function(filename, fieldname, mimetype) {
		return Date.now() + "-" + filename;
	},
	validate: function(fieldname, filename, mimetype) {
		console.log(mimetype);
		if(mimetype != "application/pdf") {
			return false;
		}
	}
});

app.use(formPost.middleware(function(err) {
	if(err) console.log(err);
	console.log("Here are my files:", req.files);
}));

Usage with S3

$ npm install aws-sdk --save

var express = require("express");
var app = express();
var efp = require("express-form-post");
const formPost = efp({
	store: "aws-s3",
	maxfileSize: 100000,
	filename: function(filename, fieldname, mimetype) {
		return filename;
	},
	keys: {
		accessKeyId: process.env.AWS_ACCESS_KEY_ID,
		secretAccessKey: process.env.secretAccessKey,
		bucketName: process.env.S3_BUCKET_NAME,
		ACL: "public-read"
	}
})

app.use(formPost.middleware(function(err) {
	if(err) console.log(err);
	console.log("Here are my files", req.files);
}));

As a async function

app.post("*", (req, res, next) => { 
	formPost.upload(req, res, (err) => {
		if(err) {
			console.log(err);
		}
		console.log("My files are located here:", req.files);
		res.redirect("/");
	});
}

API

Further API documentation will be implemented soon.

efp(opts)

express-form-post accepts an "optional" options parameter

Key	Description	Note
store	The type of store	check below for available store methods
directory	The folder to which the file will be saved	defaults to current directory
filename	function to determine file save name	defaults to the file's name on the user's computer
maxfileSize	Size of the file in bytes	defaults to infiniti
validate	function to validate uploaded file
keys	The name of the file within the destination	used for cloud storage

Available storage methods

• disk storage
• aws s3

Will be available soon

• google drive
• dropbox