Instantly share code, notes, and snippets.

What would you like to do?
Form/file uploads with hapi.js

Demo of multipart form/file uploading with hapi.js.


npm install
npm run setup
npm run server

Then ...

npm run test

... or try:

curl --form file=@data.csv    \
     --form firstName=Melvin  \
     --form lastName=Mooney   \

See also

Other multipart/form-data demos:

a b c
1 2 3
"name": "file-upload-demo",
"version": "0.0.0",
"description": "multipart form/file upload demo with hapi.js",
"main": "server.js",
"scripts": {
"setup": "[ -d uploads ] || mkdir uploads",
"test": "curl --form file=@data.csv --form user=Jones http://localhost:8080/submit",
"server": "node server.js"
"keywords": [
"author": "J. Voigt",
"license": "BSD-2-Clause",
"dependencies": {
"hapi": "^17.5.4"
const fs = require('fs');
const Hapi = require('hapi');
const server = Hapi.server({
host: 'localhost',
port: Number(process.argv[2] || 8080)
method: 'POST',
path: '/submit',
handler: (request, h) => {
const data = request.payload;
if (data.file) {
const name = data.file.hapi.filename;
const path = __dirname + "/uploads/" + name;
const file = fs.createWriteStream(path);
file.on('error', (err) => console.error(err));
data.file.on('end', (err) => {
const ret = {
filename: data.file.hapi.filename,
headers: data.file.hapi.headers
return JSON.stringify(ret);
return 'ok';
options: {
payload: {
output: 'stream',
parse: true,
allow: 'multipart/form-data'
const init = async () => {
await server.start();
console.log(`Server running at: ${}`);

This comment has been minimized.

codeofnode commented Oct 31, 2015

i use the exact same code and i am getting request.payload.file as undefined in handler.


This comment has been minimized.

Gusbenz commented Nov 3, 2015

Thanks for this! Works great!


This comment has been minimized.

luismanolo commented Dec 30, 2015

Many thanks.


This comment has been minimized.

gino8080 commented Jan 14, 2016

great thank you!

how to track progress of the upload? bytes loaded / bytes total


This comment has been minimized.

mofengfly commented Mar 2, 2016



This comment has been minimized.

notyalca commented Apr 15, 2016

Yeah, thanks for this. Nice and concise.


This comment has been minimized.

behnoodk commented Apr 19, 2016

thank you for this!


This comment has been minimized.

Jportofolio commented May 23, 2016

Thanks !
Would you give you advice about iterating through a FileList object and write each one of them async ?


This comment has been minimized.

Jportofolio commented May 24, 2016

I finally get how to to receive multiple text and files here the code:

const Home = {
files: {
relativeTo: Path.join(__dirname, '../static/src')
handler: (req, res) => {
var data = req.payload;
for(var i = 0; i < Object.keys(data).length; i++){
if (data.hasOwnProperty('file-'+i)){
var g = "file-"+i;
var name = data[g].hapi.filename;
var path = Path.join(__dirname, '../uploadFiles/'+name);
var file = Fs.createWriteStream(path);

       file.on('error', function (err){

       data[g].on('end', function (err){

               var ret = {
               filename: data[g].hapi.filename,
               headers: data[g].hapi.headers
           }, 200);



payload: {
    output : 'stream',
    parse: true,
    uploads: 'up_files',
    timeout: 30034,
    // allow: 'multipart/form-data',
    failAction: 'log',
    maxBytes: 3000000


//Root Loading
const Root = {
files: {
relativeTo: Path.join(__dirname, '../static/src')
handler: (req, res) => {

module.exports = [
{ method: 'GET', path:'/{static*}', config: Static },
{ method: 'POST', path: '/home', config: Home },
{ method: 'GET', path: '/', config: Root }


This comment has been minimized.

MaySnow commented Jul 18, 2016



This comment has been minimized.

madrus commented Jul 25, 2016

Works like a charm. Thanks.


This comment has been minimized.

moogway commented Sep 23, 2016


Thanks for the code. I have a question though.

Instead of using data.file.on('end',...) as the trigger to send response, wouldn't it be better to use file.on('finish',...) as the trigger? Would it ensure that the buffer stream has indeed been written into the file before a response is sent?

Could you have time to discuss this?



This comment has been minimized.

daslicht commented Jan 19, 2017

so uploading files in haps works without any external module (as in exporess) ?


This comment has been minimized.

dgfreecodecamper commented Jul 29, 2017

Thank you for the code above - works fine with the curl command when I test. However, when I try to use it from an HTML file the server just hangs? /submit is the url and testcsvfile.csv is the file I am trying to upload. Can I not simply use an HTML form as below?

<form action="/submit" method="post" enctype="multipart/form-data">
  <input type="file" name="testcsvfile">
  <input type="submit" value="upload">

I also tried making the call using postman which received the following response

    "statusCode": 415,
    "error": "Unsupported Media Type",
    "message": "Unsupported Media Type"

The file is a simple csv text file? Any ideas would be helpful?


This comment has been minimized.

Stephiev commented Aug 30, 2017

I'm using content-type as application/octet-stream and data.file is undefined. Any ideas? I'm using application/octet-stream as the service i'm going to pass the file to needs that, not quite sure if having application/octet-stream is required in the hapi path?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment