busboy vs multer vs express-fileupload vs formidable
Node.jsにおけるファイルアップロード処理ライブラリの比較
パッケージを検索...
busboymulterexpress-fileuploadformidable類似パッケージ:

Node.jsにおけるファイルアップロード処理ライブラリの比較

busboy、express-fileupload、formidable、multer はすべて Node.js アプリケーションで multipart/form-data フォーム（主にファイルアップロード）を処理するためのライブラリです。これらは HTTP リクエストボディからファイルやフィールドデータを解析し、開発者がファイルを保存・処理できるようにします。busboy は低レベルなストリームベースのパーサーで、他の多くのライブラリの基盤となっています。express-fileupload と multer は Express.js 用のミドルウェアとして設計されており、使いやすさに重点を置いています。formidable は長く使われてきたスタンドアロンのフォームパーサーで、Express 以外の環境でも利用可能です。

npmのダウンロードトレンド

3 年

GitHub Starsランキング

統計詳細

パッケージ
ダウンロード数
Stars
サイズ
Issues
公開日時
ライセンス
busboy23,966,6782,996124 kB37--
multer11,795,02012,01030.6 kB2522日前MIT
express-fileupload508,3121,561119 kB248ヶ月前MIT
formidable0-204 kB-10ヶ月前MIT

Node.js ファイルアップロードライブラリ徹底比較：busboy vs express-fileupload vs formidable vs multer

Node.js でファイルアップロードを実装する際、multipart/form-data の解析は避けて通れません。この分野には複数の選択肢がありますが、それぞれ設計思想や用途が異なります。ここでは、4つの主要ライブラリ — busboy、express-fileupload、formidable、multer — を、実際のコードを交えながら深く比較します。

🧱 基本アーキテクチャ：低レベル vs 高レベル

busboy は、他のライブラリの多くが内部で使っている 低レベルなストリームパーサー です。直接使うと設定が面倒ですが、最大の柔軟性とパフォーマンスを提供します。

// busboy: 生の Node.js HTTP サーバーで使用
const http = require('http');
const Busboy = require('busboy');

const server = http.createServer((req, res) => {
  if (req.method === 'POST' && req.headers['content-type']?.includes('multipart')) {
    const busboy = new Busboy({ headers: req.headers });
    
    busboy.on('file', (fieldname, file, filename) => {
      // ストリームとしてファイルを受け取る
      file.pipe(require('fs').createWriteStream(`./uploads/${filename}`));
    });
    
    busboy.on('finish', () => {
      res.writeHead(200, { 'Content-Type': 'text/plain' });
      res.end('Upload complete');
    });
    
    req.pipe(busboy);
  }
});

express-fileupload と multer は、Express 専用のミドルウェア として設計されています。設定が簡単で、すぐに使い始められます。

// express-fileupload
const express = require('express');
const fileUpload = require('express-fileupload');

const app = express();
app.use(fileUpload());

app.post('/upload', (req, res) => {
  // req.files にファイルが格納される
  const file = req.files.myFile;
  file.mv(`./uploads/${file.name}`, (err) => {
    if (err) return res.status(500).send(err);
    res.send('File uploaded!');
  });
});

// multer
const express = require('express');
const multer = require('multer');
const upload = multer({ dest: 'uploads/' });

const app = express();

app.post('/upload', upload.single('myFile'), (req, res) => {
  // req.file にファイル情報が入る
  res.send(`File saved as ${req.file.path}`);
});

formidable は フレームワーク非依存 のライブラリで、Express でも Koa でも生の HTTP サーバーでも使えます。

// formidable
const express = require('express');
const formidable = require('formidable');

const app = express();

app.post('/upload', (req, res) => {
  const form = new formidable.IncomingForm();
  form.parse(req, (err, fields, files) => {
    if (err) return res.status(500).send(err);
    // files にファイル情報が入る
    res.send(`File saved at ${files.myFile[0].filepath}`);
  });
});

📁 ファイル保存方法：メモリ vs ディスク vs カスタム

各ライブラリのファイル保存戦略は大きく異なります。

  • busboy: ファイルを ストリームとして直接処理 するため、メモリに保持せずディスクや外部サービスに即時書き込み可能。メモリ使用量が最小。

  • express-fileupload: デフォルトでは メモリにファイルを保持（req.files.myFile.data が Buffer）。useTempFiles: true を指定すれば一時ファイルに保存可能。

// express-fileupload with temp files
app.use(fileUpload({ useTempFiles: true, tempFileDir: '/tmp/' }));
  • formidable: デフォルトで 一時ディレクトリにファイルを保存。keepExtensions: true で元の拡張子を維持可能。
// formidable with original extensions
const form = new formidable.IncomingForm({ keepExtensions: true });
  • multer: ディスク保存がデフォルト（dest オプション指定時）。memoryStorage() を使えばメモリ保存も可能。さらに、カスタムストレージエンジン を実装して AWS S3 などに直接保存できる。
// multer with custom storage (e.g., S3)
const storage = multer.memoryStorage(); // or implement your own
const upload = multer({ storage });

⚙️ バリデーションと制限：どれだけ細かく制御できるか

プロダクション環境では、ファイルサイズ、MIME タイプ、フィールド名の制限が必須です。

busboy は制限機能を 自分で実装 する必要があります。例えば、ファイルサイズを監視するにはストリームの data イベントでバイト数をカウントします。

express-fileupload は limits オプションで簡易的な制限が可能ですが、MIME タイプのバリデーションはサポートしていません。

// express-fileupload limits
app.use(fileUpload({
  limits: { fileSize: 5 * 1024 * 1024 }, // 5MB
}));

formidable は maxFileSize や maxFields などのオプションを提供しますが、MIME タイプのチェックは含まれません。

// formidable limits
const form = new formidable.IncomingForm({
  maxFileSize: 5 * 1024 * 1024,
  maxFields: 10
});

multer は 最も包括的なバリデーション機能 を持っています。fileFilter オプションで MIME タイプやファイル名をチェックでき、エラー時にカスタムレスポンスも返せます。

// multer with file validation
const upload = multer({
  dest: 'uploads/',
  fileFilter: (req, file, cb) => {
    if (file.mimetype.startsWith('image/')) {
      cb(null, true);
    } else {
      cb(new Error('Only images allowed!'), false);
    }
  },
  limits: { fileSize: 5 * 1024 * 1024 }
});

// エラーハンドリング
app.use((err, req, res, next) => {
  if (err instanceof multer.MulterError) {
    res.status(400).send('Multer error');
  } else {
    res.status(500).send(err.message);
  }
});

🌐 Express 以外の環境での使用

  • busboy: 純粋な Node.js ライブラリなので、どのフレームワークでも使用可能。
  • express-fileupload: Express 専用。他のフレームワークでは使えません。
  • formidable: フレームワーク非依存。Koa、Fastify、生の HTTP サーバーなど、どこでも動作。
  • multer: Express 専用。ただし、multer のコアロジックは busboy に依存しているため、理論的には他の環境でも再利用可能ですが、公式サポートはありません。

🛠️ 実際のユースケース別推奨

シナリオ1: シンプルな画像アップロード（小規模アプリ）

  • ✅ express-fileupload
  • 理由: 設定が少なく、数行で実装可能。メモリ保存で十分なら最速で導入できる。

シナリオ2: 大容量ファイルアップロード（動画など）

  • ✅ busboy または multer + カスタムストレージ
  • 理由: ストリーム処理でメモリを圧迫せず、S3 などの外部ストレージに直接保存可能。

シナリオ3: 複数のフレームワークで共通のアップロードロジックを使いたい

  • ✅ formidable
  • 理由: Express 以外の環境でも同じコードが使えるため、マイクロサービス間で共通化しやすい。

シナリオ4: 厳格なバリデーションとプロダクション対応が必要

  • ✅ multer
  • 理由: MIME タイプ、ファイルサイズ、フィールド名の制限が組み込みでサポートされ、エラーハンドリングも洗練されている。

📊 まとめ：特徴比較表

機能busboyexpress-fileuploadformidablemulter
対応フレームワーク任意Express 専用任意Express 専用
メモリ効率⭐⭐⭐⭐⭐ (ストリーム)⭐⭐ (デフォルトでメモリ)⭐⭐⭐⭐ (一時ファイル)⭐⭐⭐⭐ (カスタム可)
バリデーション機能❌ (自前実装)⭐ (サイズ制限のみ)⭐⭐ (サイズ・フィールド数)⭐⭐⭐⭐⭐ (MIME含む)
カスタムストレージ⭐⭐⭐⭐⭐ (自由自在)❌⭐⭐ (限定的)⭐⭐⭐⭐⭐ (公式サポート)
学習コスト高低中中

💡 最終的なアドバイス

  • 「とにかく早く動かしたい」 → express-fileupload
  • 「プロダクションで堅牢に運用したい」 → multer
  • 「Express 以外の環境で使いたい」 → formidable または busboy
  • 「完全な制御と最高のパフォーマンスが欲しい」 → busboy

これらのライブラリは目的が異なるため、「どれが一番良い」というより「どの要件に最も合うか」で選ぶのが正解です。特に、ファイルアップロードはセキュリティリスクが高い領域なので、バリデーションとエラーハンドリングを疎かにしないよう注意してください。

選び方: busboy vs multer vs express-fileupload vs formidable

  • busboy:

    busboy は、細かい制御が必要なカスタム実装や、既存の高レベルライブラリでは要件を満たせない場合に選ぶべきです。ストリーム処理によるメモリ効率が高く、大規模なファイルアップロードやリアルタイム処理に向いていますが、設定やエラーハンドリングを自分で実装する必要があります。Express 専用ではなく、生の Node.js HTTP サーバーでも使えます。

  • multer:

    multer は、Express アプリで堅牢かつ柔軟なファイルアップロード処理を実装したい場合に最適です。ストレージエンジンのカスタマイズ、ファイルサイズ制限、フィールド名のバリデーションなど、プロダクション環境で必要な機能が揃っています。AWS S3 やその他のクラウドストレージとの連携もしやすく、中〜大規模アプリケーションでの採用が多いです。

  • express-fileupload:

    express-fileupload は、Express アプリで手軽にファイルアップロード機能を追加したい場合に最適です。設定が非常にシンプルで、ファイルをメモリまたは一時ディレクトリに自動保存し、req.files でアクセスできます。ただし、高度なバリデーションやストレージ統合（例: S3 直接保存）には向かず、小〜中規模プロジェクト向けです。

  • formidable:

    formidable は、Express に依存しない汎用的なフォームパーサーが必要な場合や、複数のフレームワーク間で共通の処理ロジックを使いたい場合に適しています。長い歴史があり安定していますが、API がやや古く感じられ、TypeScript サポートも限定的です。大規模なアップロード処理には対応できますが、Express との統合は multer や express-fileupload ほどスムーズではありません。

busboyと類似したnpmパッケージ

busboyは、Node.js環境でファイルアップロードを処理するための軽量なストリーミングパーサーです。このパッケージは、HTTPリクエストのmultipart/form-dataを効率的に解析し、ファイルやフィールドのデータをリアルタイムで処理することができます。busboyは、特に大きなファイルを扱う際にメモリ使用量を最小限に抑えるため、ストリーミング処理を利用しています。しかし、busboyにはいくつかの代替パッケージがあります。以下にいくつかの選択肢を紹介します。

  • connect-busboyは、busboyをExpress.jsアプリケーションに統合するためのミドルウェアです。このパッケージを使用することで、busboyの機能を簡単にExpressのルートハンドラーに組み込むことができます。connect-busboyは、ファイルアップロードを簡素化し、Expressのリクエストオブジェクトにファイルデータを追加します。
  • express-fileuploadは、Express.jsアプリケーションでファイルアップロードを簡単に処理するためのミドルウェアです。使いやすいAPIを提供し、ファイルのアップロードやバリデーションを簡単に行うことができます。express-fileuploadは、シンプルな構文でファイルのアップロードを行いたい場合に適しています。
  • formidableは、Node.jsでファイルアップロードを処理するための強力なライブラリです。formidableは、multipart/form-dataを解析し、ファイルやフィールドのデータを取得するための多くの機能を提供します。特に、複雑なファイルアップロードのニーズがある場合に適しています。
  • multerは、Express.js用のミドルウェアで、multipart/form-dataを処理するために設計されています。ファイルのアップロードを簡単に管理できるようにし、ストレージオプションやファイルフィルタリング機能を提供します。multerは、特にファイルのアップロードを行う際に広く使用されています。

これらのパッケージの比較については、こちらをご覧ください: busboy vs connect-busboy vs express-fileupload vs formidable vs multer。

multerと類似したnpmパッケージ

multerは、Node.jsのExpressフレームワークでファイルアップロードを処理するためのミドルウェアです。Multerは、HTTPリクエストのmultipart/form-dataを解析し、アップロードされたファイルをサーバーのローカルストレージや他のストレージサービスに保存するための便利な機能を提供します。Multerは、特に画像やドキュメントなどのファイルを扱うWebアプリケーションにおいて非常に役立ちます。しかし、Multerには他にもいくつかの代替ライブラリがあります。以下にいくつかの選択肢を紹介します。

  • busboyは、Node.jsでファイルアップロードを処理するためのストリーミングパーサーです。Busboyは、ファイルのストリーミング処理を行い、メモリ使用量を最小限に抑えることができるため、大きなファイルを扱う際に特に便利です。Busboyは、Multerよりも低レベルのAPIを提供し、より細かい制御が可能です。ストリーミング処理を重視する場合、Busboyは優れた選択肢となります。

  • express-fileuploadは、Expressアプリケーションで簡単にファイルアップロードを処理できるミドルウェアです。シンプルなAPIを提供し、設定が非常に簡単で、すぐに使用を開始できます。Expressアプリケーションにすばやくファイルアップロード機能を追加したい場合、express-fileuploadは良い選択肢です。

  • formidableは、Node.jsでファイルアップロードを処理するためのもう一つの人気のあるライブラリです。Formidableは、ファイルのアップロードを簡単に処理できる機能を提供し、複雑な設定を必要としません。特に、複数のファイルを同時にアップロードする場合や、ファイルのメタデータを取得する必要がある場合に便利です。

これらのライブラリの比較については、こちらをチェックしてください: Comparing busboy vs express-fileupload vs formidable vs multer。

express-fileuploadと類似したnpmパッケージ

express-fileuploadは、Node.jsのExpressフレームワーク用のファイルアップロードミドルウェアです。このパッケージは、簡単にファイルをアップロードできる機能を提供し、特に小規模から中規模のアプリケーションに適しています。express-fileuploadは、シンプルなAPIを通じて、ファイルのアップロードや処理を迅速に行うことができますが、他にも同様の機能を提供するライブラリがあります。以下はそのいくつかの代替ライブラリです。

  • busboyは、ストリームベースのファイルアップロードライブラリで、特に大きなファイルや高いパフォーマンスが求められるアプリケーションに適しています。busboyは、リクエストのストリームを処理し、ファイルを効率的に解析することができるため、大量のデータを扱う際に非常に便利です。
  • connect-multipartyは、Expressのミドルウェアとして動作し、マルチパートフォームデータの解析を行います。このライブラリは、ファイルアップロードを含む複雑なフォームデータを処理するために設計されていますが、他のライブラリと比べるとやや古い印象があります。
  • express-formidableは、Expressアプリケーション用のファイルアップロードミドルウェアで、マルチパートおよびURLエンコードされたデータを処理します。express-formidableは、使いやすさと柔軟性を兼ね備えており、特に複雑なフォームデータを扱う際に役立ちます。
  • formidableは、Node.jsのファイルアップロードライブラリで、ストリームベースのアプローチを採用しています。formidableは、ファイルのアップロードや解析を効率的に行うための機能を提供し、特に大規模なアプリケーションに適しています。
  • multerは、Expressアプリケーション用のミドルウェアで、マルチパートフォームデータを処理するための非常に人気のあるライブラリです。multerは、ファイルの保存やアップロードの設定が簡単で、特にシンプルなAPIが魅力です。

これらのライブラリの比較については、以下のリンクを参照してください: Comparing busboy vs connect-multiparty vs express-fileupload vs express-formidable vs formidable vs multer。

formidableと類似したnpmパッケージ

formidableは、Node.jsアプリケーションでファイルアップロードを処理するための人気のあるライブラリです。このライブラリは、HTTPリクエストからフォームデータを解析し、ファイルをサーバーに保存するためのシンプルで効率的な方法を提供します。formidableは、特に大きなファイルのアップロードや複雑なフォームデータの処理に適していますが、他にもいくつかの代替ライブラリがあります。

  • busboyは、Node.js用のストリーミングファイルアップロードライブラリです。busboyは、リクエストストリームを使用してファイルデータを処理し、メモリ使用量を最小限に抑えつつ、パフォーマンスを向上させることができます。特に、大量のデータを効率的に処理する必要がある場合に適しています。
  • express-fileuploadは、Express.jsアプリケーションで簡単にファイルアップロードを実装できるミドルウェアです。シンプルなAPIを提供し、クライアントからのファイルを簡単に処理できます。express-fileuploadは、迅速な開発を求める開発者にとって便利な選択肢です。
  • form-dataは、HTTPリクエストでフォームデータを簡単に作成するためのライブラリです。主に、ファイルを含むHTTPリクエストを送信するために使用されます。form-dataは、クライアントサイドでの使用が一般的ですが、サーバーサイドでも利用可能です。
  • multerは、Express.jsのためのミドルウェアで、ファイルアップロードを簡単に処理することができます。multerは、リクエストのボディを解析し、アップロードされたファイルを指定したディレクトリに保存するための機能を提供します。特に、Expressアプリケーションでの使用に最適です。

これらのライブラリの比較については、こちらをご覧ください: busboy vs express-fileupload vs form-data vs formidable vs multer。

busboy のREADME

Description

A node.js module for parsing incoming HTML form data.

Changes (breaking or otherwise) in v1.0.0 can be found here.

Requirements

Install

npm install busboy

Examples

  • Parsing (multipart) with default options:
const http = require('http');

const busboy = require('busboy');

http.createServer((req, res) => {
  if (req.method === 'POST') {
    console.log('POST request');
    const bb = busboy({ headers: req.headers });
    bb.on('file', (name, file, info) => {
      const { filename, encoding, mimeType } = info;
      console.log(
        `File [${name}]: filename: %j, encoding: %j, mimeType: %j`,
        filename,
        encoding,
        mimeType
      );
      file.on('data', (data) => {
        console.log(`File [${name}] got ${data.length} bytes`);
      }).on('close', () => {
        console.log(`File [${name}] done`);
      });
    });
    bb.on('field', (name, val, info) => {
      console.log(`Field [${name}]: value: %j`, val);
    });
    bb.on('close', () => {
      console.log('Done parsing form!');
      res.writeHead(303, { Connection: 'close', Location: '/' });
      res.end();
    });
    req.pipe(bb);
  } else if (req.method === 'GET') {
    res.writeHead(200, { Connection: 'close' });
    res.end(`
      <html>
        <head></head>
        <body>
          <form method="POST" enctype="multipart/form-data">
            <input type="file" name="filefield"><br />
            <input type="text" name="textfield"><br />
            <input type="submit">
          </form>
        </body>
      </html>
    `);
  }
}).listen(8000, () => {
  console.log('Listening for requests');
});

// Example output:
//
// Listening for requests
//   < ... form submitted ... >
// POST request
// File [filefield]: filename: "logo.jpg", encoding: "binary", mime: "image/jpeg"
// File [filefield] got 11912 bytes
// Field [textfield]: value: "testing! :-)"
// File [filefield] done
// Done parsing form!
  • Save all incoming files to disk:
const { randomFillSync } = require('crypto');
const fs = require('fs');
const http = require('http');
const os = require('os');
const path = require('path');

const busboy = require('busboy');

const random = (() => {
  const buf = Buffer.alloc(16);
  return () => randomFillSync(buf).toString('hex');
})();

http.createServer((req, res) => {
  if (req.method === 'POST') {
    const bb = busboy({ headers: req.headers });
    bb.on('file', (name, file, info) => {
      const saveTo = path.join(os.tmpdir(), `busboy-upload-${random()}`);
      file.pipe(fs.createWriteStream(saveTo));
    });
    bb.on('close', () => {
      res.writeHead(200, { 'Connection': 'close' });
      res.end(`That's all folks!`);
    });
    req.pipe(bb);
    return;
  }
  res.writeHead(404);
  res.end();
}).listen(8000, () => {
  console.log('Listening for requests');
});

API

Exports

busboy exports a single function:

( function )(< object >config) - Creates and returns a new Writable form parser stream.

  • Valid config properties:

    • headers - object - These are the HTTP headers of the incoming request, which are used by individual parsers.

    • highWaterMark - integer - highWaterMark to use for the parser stream. Default: node's stream.Writable default.

    • fileHwm - integer - highWaterMark to use for individual file streams. Default: node's stream.Readable default.

    • defCharset - string - Default character set to use when one isn't defined. Default: 'utf8'.

    • defParamCharset - string - For multipart forms, the default character set to use for values of part header parameters (e.g. filename) that are not extended parameters (that contain an explicit charset). Default: 'latin1'.

    • preservePath - boolean - If paths in filenames from file parts in a 'multipart/form-data' request shall be preserved. Default: false.

    • limits - object - Various limits on incoming data. Valid properties are:

      • fieldNameSize - integer - Max field name size (in bytes). Default: 100.

      • fieldSize - integer - Max field value size (in bytes). Default: 1048576 (1MB).

      • fields - integer - Max number of non-file fields. Default: Infinity.

      • fileSize - integer - For multipart forms, the max file size (in bytes). Default: Infinity.

      • files - integer - For multipart forms, the max number of file fields. Default: Infinity.

      • parts - integer - For multipart forms, the max number of parts (fields + files). Default: Infinity.

      • headerPairs - integer - For multipart forms, the max number of header key-value pairs to parse. Default: 2000 (same as node's http module).

This function can throw exceptions if there is something wrong with the values in config. For example, if the Content-Type in headers is missing entirely, is not a supported type, or is missing the boundary for 'multipart/form-data' requests.

(Special) Parser stream events

  • file(< string >name, < Readable >stream, < object >info) - Emitted for each new file found. name contains the form field name. stream is a Readable stream containing the file's data. No transformations/conversions (e.g. base64 to raw binary) are done on the file's data. info contains the following properties:

    • filename - string - If supplied, this contains the file's filename. WARNING: You should almost never use this value as-is (especially if you are using preservePath: true in your config) as it could contain malicious input. You are better off generating your own (safe) filenames, or at the very least using a hash of the filename.

    • encoding - string - The file's 'Content-Transfer-Encoding' value.

    • mimeType - string - The file's 'Content-Type' value.

    Note: If you listen for this event, you should always consume the stream whether you care about its contents or not (you can simply do stream.resume(); if you want to discard/skip the contents), otherwise the 'finish'/'close' event will never fire on the busboy parser stream. However, if you aren't accepting files, you can either simply not listen for the 'file' event at all or set limits.files to 0, and any/all files will be automatically skipped (these skipped files will still count towards any configured limits.files and limits.parts limits though).

    Note: If a configured limits.fileSize limit was reached for a file, stream will both have a boolean property truncated set to true (best checked at the end of the stream) and emit a 'limit' event to notify you when this happens.

  • field(< string >name, < string >value, < object >info) - Emitted for each new non-file field found. name contains the form field name. value contains the string value of the field. info contains the following properties:

    • nameTruncated - boolean - Whether name was truncated or not (due to a configured limits.fieldNameSize limit)

    • valueTruncated - boolean - Whether value was truncated or not (due to a configured limits.fieldSize limit)

    • encoding - string - The field's 'Content-Transfer-Encoding' value.

    • mimeType - string - The field's 'Content-Type' value.

  • partsLimit() - Emitted when the configured limits.parts limit has been reached. No more 'file' or 'field' events will be emitted.

  • filesLimit() - Emitted when the configured limits.files limit has been reached. No more 'file' events will be emitted.

  • fieldsLimit() - Emitted when the configured limits.fields limit has been reached. No more 'field' events will be emitted.

npm-compare.com is an independent website designed to help developers choose the most suitable npm packages. We are not affiliated with npm, Inc, the official website for the npm registry. Note that npm is a registered trademark of npm, Inc. Please share your feedback via our GitHub repository. For more details, please refer to our Terms & Privacy.