Skip to content

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: ${}`);
Copy link

codeofnode commented Oct 31, 2015

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

Copy link

rjpcasalino commented Nov 3, 2015

Thanks for this! Works great!

Copy link

luismanolo commented Dec 30, 2015

Many thanks.

Copy link

gino8080 commented Jan 14, 2016

great thank you!

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

Copy link

mofengfly commented Mar 2, 2016


Copy link

notyalca commented Apr 15, 2016

Yeah, thanks for this. Nice and concise.

Copy link

behnoodk commented Apr 19, 2016

thank you for this!

Copy link

jkuler commented May 23, 2016

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

Copy link

jkuler 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 }

Copy link

MaySnow commented Jul 18, 2016


Copy link

madrus commented Jul 25, 2016

Works like a charm. Thanks.

Copy link

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?


Copy link

daslicht commented Jan 19, 2017

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

Copy link

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?

Copy link

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?

Copy link

bilalk1 commented Mar 18, 2019

It is very helping!

Copy link

yogesh-xseed commented Jun 8, 2020

if the file size is less then 15 kb its not working

Copy link

jbarros35 commented Dec 8, 2020

most of these old samples wont compile anymore.

Copy link

aishadeshmukh commented Jan 11, 2021

Thank you so much the demo. It really helped 👍

Copy link

riteshkkr commented Jan 13, 2022

updated code

		method: "POST",
		path: "/upload",
		handler: clientController.postClientFile,
		config: {
			description: "Home",
			auth: false,
			payload: {
				maxBytes: 209715200,
				parse: true,
				allow: "multipart/form-data",
				multipart: { output: "stream" },

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