JavaScript で HTML5 ファイルをドラッグ&ドロップでアップロード
バッチアップロードでは、あるリクエストが失敗しても、すべてのファイルの結果が必要です。複数のファイルを選択またはドロップし、一度にひとつずつ送信する JavaScript アップローダーを構築します。各ファイルの進捗とサーバーの受領確認は表示したままにします。
ローカルのバッチアップローダーの準備
ブラウザー、Bash などの POSIX シェル、および保守対象の 24.x 系列の Node.js 24.15 以降、または 26.x 系列の Node.js 26.5 以降が必要です。パッケージのインストールやビルド作業は不要です。サーバーは Node 組み込みの Request、File、およびマルチパート解析 API を使います。拡張子は .mts のままにしてください。CommonJS プロジェクト内でも、Node は ES モジュールとして扱います。
このチュートリアルは Linux 上で Node.js 24.15.0、26.5.0、26.8.1、および Chromium 145 を使って検証しました。
このサンプルはバイトの一致を確認し、アップロードされたデータを破棄します。空のファイルを含むあらゆる種類のファイルを受け付けます。上限は各ファイル 5 MiB、選択ごとに最大 10 ファイルです。手動で再試行する単一ファイルのアップロードだけが必要な場合は、単一ファイルアップローダーのチュートリアルを参照してください。
実験用のディレクトリで、新しいフォルダーを作成します。
mkdir html5-upload-demo
すでに存在する場合はここで止め、別のディレクトリ名を選んでください。既存のプロジェクトは上書きしないでください。次の四つのコードブロックを、そのフォルダー内に index.html、styles.css、upload.js、server.mts として保存します。
基本的なドラッグ&ドロップフォームの準備
index.html として保存します。ネイティブの入力要素は表示されたままで、キーボードで操作できます。multiple 属性により、一度の選択で複数のファイルを指定できます。待機中に選択し直すと、キューが置き換わります。
<!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Batch file uploader</title>
<link rel="stylesheet" href="styles.css" />
<script src="upload.js" defer></script>
</head>
<body>
<main>
<h1>Upload a batch of files</h1>
<form id="upload-form" aria-label="Batch upload">
<section id="drop-zone" aria-label="Drop files">
<label for="file-input">Choose files</label>
<input id="file-input" type="file" multiple aria-describedby="file-help" />
<p id="file-help">Choose or drop up to 10 files, each no larger than 5 MiB.</p>
</section>
<button id="upload-button" type="submit" disabled>Upload batch</button>
</form>
<p id="batch-status" role="status" aria-atomic="true">Choose files to begin.</p>
<ol id="queue" aria-label="File queue"></ol>
<noscript>This uploader needs JavaScript enabled.</noscript>
</main>
</body>
</html>
キューのスタイル設定
styles.css として保存します。システムカラーはブラウザーのライトテーマまたはダークテーマに従います。長い名前やチェックサムは、ページを横に広げずに折り返します。
:root { color-scheme: light dark; }
body {
font: 1rem/1.5 system-ui, sans-serif;
max-width: 45rem;
margin: 2rem auto;
padding: 0 1rem;
color: CanvasText;
background: Canvas;
}
#drop-zone { border: 2px dashed currentColor; padding: 1rem; }
#drop-zone.drag-over { outline: 3px solid Highlight; }
label { display: block; font-weight: bold; }
input { max-width: 100%; }
button, input::file-selector-button { font: inherit; padding: 0.5rem; }
button { margin-top: 1rem; }
:focus-visible { outline: 3px solid Highlight; outline-offset: 3px; }
#queue { padding-left: 1.5rem; }
#queue li { margin-block: 1rem; overflow-wrap: anywhere; }
progress { display: block; width: 100%; }
ドラッグ&ドロップ操作の実装
upload.js として保存します。送信前に、キューの各行にファイル名とバイト数を表示します。このサンプルでは画像プレビュー用のファイルのデコードは行いません。選択時の検証で即座にフィードバックを表示し、受信側でも独立してファイルとリクエストボディーの上限を適用します。
リクエストボディーの進捗には、XMLHttpRequest.uploadを使います。各バーはひとつのファイルに対応し、マルチパートのオーバーヘッドを含みます。100% はボディーの送信完了を意味しますが、その行は引き続き応答を待ちます。期待するバイト数と SHA-256 を含む HTTP 200 の場合にのみ、受領済みの結果になります。
バッチ全体の処理中はキューをロックします。ファイル選択と送信ボタンを無効にし、ドロップや追加の送信操作を無視し、個々の失敗があっても処理を続けます。各リクエストには、応答待ちも含めて30 秒の制限時間があります。結果は次の選択まで表示され、完了済みの同じキューを再送信することはできません。
const form = document.getElementById('upload-form')
const input = document.getElementById('file-input')
const zone = document.getElementById('drop-zone')
const button = document.getElementById('upload-button')
const status = document.getElementById('batch-status')
const list = document.getElementById('queue')
const maxSize = 5 * 1024 * 1024
const number = new Intl.NumberFormat('en-US')
let queue = []
let busy = false
let started = false
function updateControls() {
input.disabled = busy
button.disabled = busy || started || queue.length === 0
}
function choose(files) {
if (busy || files.length === 0) return
queue = []
started = false
list.replaceChildren()
const oversized = files.find((file) => file.size > maxSize)
if (files.length > 10) {
status.textContent = 'Choose at most 10 files.'
} else if (oversized) {
status.textContent = `${oversized.name}: exceeds the 5 MiB limit. Select the batch again.`
} else {
queue = files.map((file, index) => {
const row = document.createElement('li')
const name = document.createElement('strong')
name.textContent = `${file.name} (${number.format(file.size)} bytes)`
const label = document.createElement('label')
label.htmlFor = `progress-${index}`
label.textContent = `Request body sent: ${file.name}`
const progress = document.createElement('progress')
progress.id = label.htmlFor
progress.setAttribute('aria-label', label.textContent)
progress.max = 100
progress.value = 0
const message = document.createElement('p')
message.textContent = 'Queued.'
row.append(name, label, progress, message)
list.append(row)
return { file, progress, message }
})
status.textContent = `${queue.length} files ready. Choose Upload batch to start.`
}
updateControls()
}
input.addEventListener('change', () => {
choose(Array.from(input.files))
// Keep our File objects; allow the same selection to fire change next time.
input.value = ''
})
zone.addEventListener('dragover', (event) => {
event.preventDefault()
if (!busy) zone.classList.add('drag-over')
})
zone.addEventListener('dragleave', () => zone.classList.remove('drag-over'))
zone.addEventListener('drop', (event) => {
event.preventDefault()
zone.classList.remove('drag-over')
choose(Array.from(event.dataTransfer.files))
})
function send(item, sha256) {
return new Promise((resolve) => {
const xhr = new XMLHttpRequest()
xhr.upload.addEventListener('progress', (event) => {
if (event.lengthComputable) item.progress.value = (event.loaded / event.total) * 100
else item.progress.removeAttribute('value')
})
xhr.upload.addEventListener('load', () => {
item.progress.value = 100
item.message.textContent = 'Body sent. Waiting for server acknowledgment…'
})
xhr.addEventListener('load', () => {
const receipt = xhr.response
if (xhr.status === 200 && receipt?.bytes === item.file.size && receipt?.sha256 === sha256) {
item.message.textContent = `Accepted. ${number.format(receipt.bytes)} bytes; SHA-256 ${receipt.sha256}.`
resolve(true)
} else {
item.message.textContent = xhr.status === 200
? 'Failed: invalid server receipt.'
: `Failed: server returned HTTP ${xhr.status}.`
resolve(false)
}
})
xhr.addEventListener('error', () => {
item.message.textContent = 'Failed: network error. Server acceptance is unknown.'
resolve(false)
})
xhr.addEventListener('timeout', () => {
item.message.textContent = 'Failed: request timed out. Server acceptance is unknown.'
resolve(false)
})
xhr.open('POST', '/upload')
xhr.responseType = 'json'
xhr.timeout = 30000
const body = new FormData()
body.append('file', item.file)
body.append('sha256', sha256)
xhr.send(body)
})
}
async function uploadBatch() {
if (busy || started || queue.length === 0) return
busy = true
started = true
updateControls()
let accepted = 0
let failed = 0
for (const item of queue) {
status.textContent = `Uploading ${item.file.name}…`
item.message.textContent = 'Preparing checksum…'
try {
const digest = await crypto.subtle.digest('SHA-256', await item.file.arrayBuffer())
const sha256 = Array.from(new Uint8Array(digest), (byte) =>
byte.toString(16).padStart(2, '0'),
).join('')
item.message.textContent = 'Sending request body…'
if (await send(item, sha256)) accepted += 1
else failed += 1
} catch {
item.message.textContent = 'Failed: could not prepare or send this file.'
failed += 1
}
}
status.textContent = `Batch finished: ${accepted} accepted, ${failed} failed. Select files for a new batch.`
busy = false
updateControls()
}
form.addEventListener('submit', (event) => {
event.preventDefault()
void uploadBatch()
})
チェックサムには crypto.subtle.digest()を使い、ファイルをひとつずつメモリーに読み込みます。Web Crypto を利用できるよう、表示されたループバック URL からページを配信してください。Content-Type は設定しないでください。ブラウザーが
FormData 用のマルチパート境界を設定します。
各ファイルの受領を確認する受信サーバーの追加
server.mts として保存します。ブラウザー用の三つのアセットのみを配信し、リクエストごとにひとつの file とひとつの sha256 フィールドを受け付けます。解析前にボディー全体を読み込み、ファイルの上限 5 MiB に加えて、マルチパートのオーバーヘッドを 16 KiB まで許容します。ボディーの上限を超えたリクエストには HTTP 413 を返します。成功応答のチェックサムは、受信側が実際に読み込んだバイトから計算します。
import type { IncomingMessage, ServerResponse } from 'node:http'
import { createHash } from 'node:crypto'
import { readFile } from 'node:fs/promises'
import { createServer } from 'node:http'
const maxSize = 5 * 1024 * 1024
const maxBody = maxSize + 16 * 1024
let origin = ''
const assets = new Map<string, { body: Buffer; type: string }>()
function reply(res: ServerResponse, code: number, data: object): void {
res.writeHead(code, { 'Content-Type': 'application/json', 'Cache-Control': 'no-store' })
res.end(JSON.stringify(data))
}
async function handle(req: IncomingMessage, res: ServerResponse): Promise<void> {
if (req.headers.host !== new URL(origin).host) {
reply(res, 403, { error: 'Use the printed loopback URL.' })
return
}
if (req.method === 'GET' && req.url === '/favicon.ico') {
res.writeHead(204).end()
return
}
const asset = assets.get(req.url ?? '')
if (req.method === 'GET' && asset) {
res.writeHead(200, { 'Content-Type': asset.type })
res.end(asset.body)
return
}
if (req.method !== 'POST' || req.url !== '/upload') {
reply(res, 404, { error: 'Not found.' })
return
}
if (req.headers.origin !== origin) {
reply(res, 403, { error: 'Use the uploader on this server.' })
return
}
const chunks: Buffer[] = []
let bytes = 0
// Keep the socket available for an error response when leaving iteration early.
for await (const chunk of req.iterator({ destroyOnReturn: false })) {
if (!Buffer.isBuffer(chunk)) throw new Error('Expected request bytes')
bytes += chunk.length
if (bytes > maxBody) {
reply(res, 413, { error: 'Request body exceeds the limit.' })
req.resume()
return
}
chunks.push(chunk)
}
let data: FormData
try {
data = await new Request(origin, {
method: 'POST',
headers: { 'Content-Type': req.headers['content-type'] ?? '' },
body: Buffer.concat(chunks),
}).formData()
} catch {
reply(res, 400, { error: 'Invalid multipart body.' })
return
}
const file = data.get('file')
const expected = data.get('sha256')
if ([...data.keys()].length !== 2 || !(file instanceof File) || typeof expected !== 'string') {
reply(res, 400, { error: 'Expected one file and one checksum.' })
return
}
if (file.size > maxSize) {
reply(res, 413, { error: 'File exceeds the 5 MiB limit.' })
return
}
const sha256 = createHash('sha256').update(new Uint8Array(await file.arrayBuffer())).digest('hex')
if (sha256 !== expected) {
reply(res, 422, { error: 'Checksum does not match.' })
return
}
reply(res, 200, { bytes: file.size, sha256 })
}
async function main(): Promise<void> {
const portText = process.env.PORT ?? '0'
const port = Number(portText)
if (!/^\d+$/.test(portText) || !Number.isInteger(port) || port < 0 || port > 65535) {
throw new Error('PORT must be an integer from 0 to 65535.')
}
for (const [route, file, type] of [
['/', 'index.html', 'text/html; charset=utf-8'],
['/styles.css', 'styles.css', 'text/css'],
['/upload.js', 'upload.js', 'text/javascript'],
]) {
assets.set(route, { body: await readFile(new URL(file, import.meta.url)), type })
}
const server = createServer((req, res) => {
void handle(req, res).catch(() => {
if (!res.destroyed && !res.writableEnded) reply(res, 500, { error: 'Unable to process upload.' })
})
})
server.requestTimeout = 35000
await new Promise<void>((resolve, reject) => {
server.once('error', reject)
server.listen(port, '127.0.0.1', resolve)
})
const address = server.address()
if (!address || typeof address === 'string') throw new Error('Missing TCP address')
origin = `http://127.0.0.1:${address.port}`
console.log(`Open ${origin}`)
}
main().catch((error: unknown) => {
const code = error instanceof Error && 'code' in error ? error.code : ''
console.error(code === 'EADDRINUSE'
? 'Port is already in use. Choose another PORT or leave it unset.'
: 'Could not start uploader. Check PORT and the three browser files.')
process.exitCode = 1
})
サーバーはループバックにバインドし、PORT が未設定またはゼロの場合は空いているポートを選びます。固定ポートが必要な場合は、サーバーの環境変数で
PORT を設定できます。アセットの欠落、無効な PORT、ポートの使用中のいずれかがあると、ゼロ以外の終了ステータスで起動を中止します。
バッチの実行と結果の確認
html5-upload-demo を作成した親ディレクトリで、次を貼り付けます。
(cd html5-upload-demo && node server.mts)
http://127.0.0.1:49152 など、表示された URL を開きます。ターミナルは開いたままにしてください。Ctrl+C でサーバーが停止し、親ディレクトリに戻ります。サーバーは起動時にアセットを読み込むため、編集後は再起動してください。
Tab キーで Choose files に移動し、ファイル選択画面を開いて、サイズの異なるふたつのファイルを選びます。Tab キーで Upload batch に移動して実行します。各行に Accepted.、バイト数、SHA-256 チェックサムが表示されるはずです。最終ステータスには、受領済みのファイルがふたつ、失敗したファイルがゼロと表示されます。サーバーには何も保存されていません。
次の選択では、枠で囲まれた領域へのドロップを試してください。バッチの実行中は入力要素とボタンが無効になり、ほかのファイルをドロップしても現在の行は変わりません。高速なローカル接続では、バーが一気に 100% になることもあります。進捗イベントは滑らかなアニメーションではなく、サーバーの処理状況を示すものでもありません。
リクエストが拒否されると、失敗した行がそのまま残り、キューの次のファイルの処理が実行されます。HTTP 400 は不正なマルチパートデータまたは誤ったフィールド、403 はオリジンまたはホストの不一致、413 はサイズ制限、422 はチェックサムの不一致を示します。HTTP 200 の受領応答でも、形式が不正または内容に矛盾があれば失敗となります。受信サーバーに接続できなくなった場合や制限時間を超えた場合、受領されたかどうかは不明です。応答がないだけでは、サーバーが処理を完了したかどうかは判断できません。再試行するには、失敗したファイルを新しいバッチとして選択してください。再試行のたびにファイルの内容全体を再送信します。ページを再読み込みするとキューは失われます。
公開アップローダーに必要な要素の検討
このローカル受信サーバーは、サイズとバイトの一致を確認し、任意の内容を受け付けて破棄します。チェックサムでは、ファイルの安全性や完全にデコードできることは確認できません。ホストとオリジンの検証はユーザー認証ではありません。公開サービスでアップロードを保存する前に、認可、内容の検証、ストレージポリシー、および Cookie ベースのセッションで必要な場合は CSRF 対策を追加してください。OWASP のアップロードガイダンスで、これらの対策を説明しています。保存するアップロードはウェブルートの外に置き、受領確認が失われてもレコードが重複しないようにしてください。たとえば、サーバー側で強制する冪等性キーを使います。
UI を変更する際も、表示されたファイル入力要素、ラベル付きの進捗バー、フォーカスの輪郭、バッチのライブリージョンを維持してください。失敗はテキストで表示し、色に依存せずに読み取れるようにします。バッチ全体を単一のパーセンテージで示すには、重み付けの方針を定義する必要があります。パーセンテージを平均すると、小さなファイルと大きなファイルに同じ重みが与えられます。
より充実したインターフェースには、Uppy の XHRUpload プラグインが、互換性のある受信サーバーへのマルチパートアップロードに対応しています。再開可能なアップロードを行うには、tus プラグインに
tus 互換サーバーが必要です。どちらを選んでも、この /upload 受信サーバーでアップロードを再開できるようになるわけではありません。
