ファイルタイプ検出 vs MIME タイプ変換：5つの npm パッケージを深掘り

ファイルを扱う Web アプリケーションでは、2種類の「タイプ」判定が必要になります。

1. ファイルの中身から実際の形式を特定する（例: .txt という名前だが実際は JPEG）
2. 既知の拡張子や MIME タイプを相互に変換する（例: .png → image/png）

前者には file-type、後者には mime / mime-types / mime-lookup が使われ、mime-db はその基盤データを提供します。それぞれの役割と使いどころを、実際のコードで見ていきましょう。

🔍 ファイルの中身を調べる：file-type

file-type は、ファイルの先頭数バイト（マジックナンバー）を読み取って、拡張子に依存せずに実際のフォーマットを判定します。これは、ユーザーが .jpg という名前で実行ファイルを送ろうとしても検出できるため、セキュリティ上非常に重要です。

Node.js 環境での使用例

import { fileTypeFromBuffer } from 'file-type';
import { readFile } from 'fs/promises';

const buffer = await readFile('unknown-file');
const type = await fileTypeFromBuffer(buffer);

if (type?.mime === 'image/jpeg') {
  console.log('安全な JPEG ファイルです');
} else {
  throw new Error('許可されていないファイル形式');
}

ブラウザ環境での使用例

import { fileTypeFromBlob } from 'file-type';

const handleFile = async (file) => {
  const type = await fileTypeFromBlob(file);
  if (type?.ext === 'png') {
    // 安全に PNG として処理
  }
};

// <input type="file" onchange="handleFile(this.files[0])">

⚠️ 注意: file-type はファイルの一部（通常は最初の 4KB 以内）を読み取る必要があります。完全なファイル読み込みを避けるため、ストリーム対応も可能ですが、フロントエンドでは Blob 対応が主となります。

📄 拡張子と MIME タイプの相互変換

ここからは、既知の拡張子や MIME タイプを変換するためのパッケージを見ていきます。これらはファイルの中身を一切見ず、あくまで「.pdf なら application/pdf」といったルールベースの変換を行います。

mime: オールインワンのシンプルAPI

mime は最も直感的な API を提供します。1つのパッケージで双方向変換が可能です。

import mime from 'mime';

// 拡張子 → MIME
console.log(mime.getType('file.txt')); // 'text/plain'

// MIME → 拡張子
console.log(mime.getExtension('image/png')); // 'png'

// 存在しない場合は null
console.log(mime.getType('unknown.xyz')); // null

mime-types: モジュール設計で型安全

mime-types は、機能は mime とほぼ同じですが、関数が独立しており、TypeScript との相性が良いです。

import * as mimeTypes from 'mime-types';

// 拡張子 → MIME
console.log(mimeTypes.lookup('file.txt')); // 'text/plain'

// MIME → 拡張子
console.log(mimeTypes.extension('image/png')); // 'png'

// デフォルト値を指定可能
console.log(mimeTypes.lookup('unknown.xyz', 'application/octet-stream'));

mime-lookup: 極小の単方向変換

mime-lookup は、拡張子 → MIME の変換のみを提供する超軽量パッケージです。

import lookup from 'mime-lookup';

console.log(lookup('file.txt')); // 'text/plain'
// MIME → 拡張子はできません

もし双方向変換が必要なら、このパッケージだけでは不十分です。

mime-db: 生のデータベース（直接使うことは稀）

mime-db は、JSON 形式の MIME タイプ定義の集合体です。アプリケーションコードで直接使うことはほとんどありません。

import db from 'mime-db';

// 生データ例
console.log(db['image/png']);
// { source: 'iana', extensions: ['png'] }

// 通常は、他のライブラリが内部でこれを使う

実際、mime-types は内部で mime-db を import してデータを取得しています。

🧪 実用シナリオ別：どのパッケージを選ぶべきか？

シナリオ1: ユーザーからの画像アップロード（セキュリティ重視）

• 要件: 拡張子が .jpg でも、実際が PNG かどうかを確認し、悪意あるファイルを弾きたい
• 選択: file-type

// ファイルの実体を検証
const type = await fileTypeFromBuffer(buffer);
if (!['image/jpeg', 'image/png'].includes(type?.mime)) {
  throw new Error('画像以外は禁止');
}

シナリオ2: API レスポンスの Content-Type 設定

• 要件: /download/report.pdf のような URL から、Content-Type: application/pdf を自動設定したい
• 選択: mime または mime-types

// Express 例
app.get('/download/:filename', (req, res) => {
  const mimeType = mime.getType(req.params.filename);
  res.setHeader('Content-Type', mimeType || 'application/octet-stream');
  // ...
});

シナリオ3: 最小限のバンドルサイズを追求する静的サイト

• 要件: .svg → image/svg+xml の変換だけが必要で、逆変換は不要
• 選択: mime-lookup

// 極小バンドル
const mimeType = lookup('icon.svg'); // 'image/svg+xml'

シナリオ4: カスタム MIME データを動的に参照したい

• 要件: IANA 以外の独自 MIME タイプを追加・参照したい
• 選択: mime-db + カスタム処理（ただし、通常は mime の拡張機能を使う方が簡単）

// mime パッケージの拡張機能例
mime.define({ 'application/custom': ['cust'] });
mime.getType('file.cust'); // 'application/custom'

📊 機能比較表

💡 最終的なアドバイス

• ファイルの中身を信用できない環境（例: ユーザーアップロード）では、必ず file-type を使って実体を検証してください。拡張子ベースの判定だけでは危険です。
• 一般的な MIME 変換には、mime か mime-types を選びましょう。違いは API スタイルと TypeScript サポート程度なので、チームの好みで決めて問題ありません。
• mime-lookup は本当に「拡張子 → MIME」だけが必要なとき以外は避けて、mime を使う方が将来の拡張性に優れます。
• mime-db はアプリケーションコードで直接 import する必要はほぼありません — これは「部品」であり、「完成品」ではないからです。

これらのパッケージは目的が明確に分かれているため、自分の要件に合ったものだけを選び、過剰な依存を避けることが重要です。