JavaScript と HTML による独自ファイルアップローダーの作成
ネイティブのファイル入力を残し、その周囲に独自のインターフェースを構築します。このチュートリアルでは、フレームワークを使わずに、キーボードでの選択、ドラッグ&ドロップ、進捗表示、再試行に対応する JavaScript アップローダーを作成します。さらに、受信したバイト列を選択ファイルの SHA-256 チェックサムと照合するローカルサーバーも用意します。

ローカルアップロードプロジェクトの準備
Node.js 24 以降、ブラウザー、ターミナルが必要です。この例では Node.js 組み込みの Request API と File APIを使用するため、パッケージのインストールは不要です。Linux 上で Node.js 24.2.0、26.5.0、26.8.1 と Chromium 145、152 を使って動作を確認しています。
アップロードするのは、空ではない JPEG、PNG、PDF のいずれかで、一度にひとつ、最大 10 MiB です。各試行でファイル全体を multipart フォームデータとして送信します。これにより、チャンクを結合するプロトコルを実装せずに、ブラウザー側とサーバー側のコードを小さく保ち、両方を一緒に実行できます。
実験用のディレクトリから、Bash などの POSIX シェルで次を実行してください。
mkdir custom-uploader &&
cd custom-uploader &&
touch index.html styles.css script.js server.ts
このコマンドは既存のディレクトリを受け付けません。途中で失敗した場合は、いったん止めて問題を解消してから続行してください。必要に応じて、別の新しいディレクトリ名を選んでください。作成した空のファイルに、続く四つのサンプルを貼り付けます。アップロードによってファイルが作成されたり上書きされたりすることはありません。受信サーバーはメモリ上でバイト列のハッシュを計算し、応答後に破棄します。再実行すると、バイト列を再び検証します。このデモは自分のマシン内でのみ使用してください。
HTML 構造の設定
次の内容を index.html として保存してください。ラベル付きのファイル入力は表示したままにし、Tab キーで移動できるようにします。ドロップ領域でもファイルを選択でき、別に配置した Upload ボタンでリクエストを開始します。ステータスメッセージは polite ライブリージョンに表示し続けます。
<!doctype html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>Custom file uploader</title>
<link rel="stylesheet" href="styles.css" />
<script src="script.js" defer></script>
</head>
<body>
<main>
<h1>Upload a file</h1>
<form id="upload-form" aria-label="File upload">
<section id="drop-zone" aria-label="Drop a file">
<label for="file-input">Choose a file</label>
<input id="file-input" type="file" accept="image/jpeg,image/png,application/pdf"
aria-describedby="file-help selection" />
<p id="file-help">Choose or drop one JPEG, PNG, or PDF, up to 10 MiB.</p>
</section>
<p id="selection">No file selected.</p>
<button id="upload" type="submit" disabled>Upload</button>
<button id="retry" type="button" disabled>Retry</button>
</form>
<p><label for="progress">Request body sent</label></p>
<progress id="progress" max="100" value="0"></progress>
<p id="status" role="status" aria-live="polite" aria-atomic="true">Choose a file to begin.</p>
<pre id="receipt" aria-label="Server receipt"></pre>
<noscript>This uploader needs JavaScript enabled.</noscript>
</main>
</body>
</html>
CSS によるファイルアップローダーのスタイル設定
次の内容を styles.css として保存してください。入力要素を隠さずに、ファイル選択ボタンとフォーカスの輪郭線のスタイルを設定します。display: none を使うと、キーボード操作や支援技術から利用できなくなります。MDN のファイル入力の例を参照してください。
body {
font: 1rem/1.5 system-ui, sans-serif;
margin: 2rem auto;
padding: 0 1rem;
max-width: 40rem;
color: #172b4d;
background: #fff;
}
#drop-zone {
border: 2px dashed #52647c;
border-radius: 0.5rem;
padding: 1.5rem;
}
#drop-zone.dragover { background: #e8f1ff; }
label { display: block; font-weight: bold; }
input { max-width: 100%; }
button, input::file-selector-button {
font: inherit;
padding: 0.5rem 1rem;
margin: 0.5rem 0;
cursor: pointer;
}
:focus-visible { outline: 3px solid #075ac7; outline-offset: 3px; }
button:disabled { cursor: default; }
progress { width: 100%; }
#status { min-height: 3rem; }
pre { white-space: pre-wrap; overflow-wrap: anywhere; }
ファイル選択とアップロードを処理する JavaScript の実装
次の内容を script.js として保存してください。XMLHttpRequest はアップロード進捗イベントを提供します。このイベントが測定するのは、multipart のオーバーヘッドを含むリクエスト本文の送信量です。100% に達しても、サーバーがファイルを受理したとは限りません。HTTP 200 応答を受け取り、サイズとチェックサムが一致した場合にのみ「Accepted」と表示します。
処理中の動作方針は明確に定めます。ファイル選択と各ボタンを無効にし、ドロップや追加の送信を無視し、リクエストの処理が完了するまで現在のファイルを保持します。ネットワークエラー、タイムアウト、サーバーエラーが発生すると Retry が有効になりますが、試行は選択ごとに最大三回までです。再試行ではファイル全体を再送信し、自動では再試行しません。リクエストが拒否された場合や受領情報が不正な場合は、選択し直す必要があります。
const form = document.getElementById('upload-form')
const input = document.getElementById('file-input')
const zone = document.getElementById('drop-zone')
const selection = document.getElementById('selection')
const upload = document.getElementById('upload')
const retry = document.getElementById('retry')
const progress = document.getElementById('progress')
const status = document.getElementById('status')
const receipt = document.getElementById('receipt')
const allowedTypes = ['image/jpeg', 'image/png', 'application/pdf']
const maxSize = 10 * 1024 * 1024
let selected = null
let busy = false
let attempts = 0
let retryable = false
function updateControls() {
input.disabled = busy
upload.disabled = busy || !selected || attempts > 0
retry.disabled = busy || !selected || !retryable || attempts >= 3
}
function choose(files) {
if (busy) return
selected = null
attempts = 0
retryable = false
progress.value = 0
receipt.textContent = ''
selection.textContent = 'No file selected.'
const file = files[0]
if (files.length !== 1) {
status.textContent = 'Choose exactly one file.'
} else if (!allowedTypes.includes(file.type)) {
status.textContent = 'Choose a JPEG, PNG, or PDF with a recognized MIME type.'
} else if (file.size === 0 || file.size > maxSize) {
status.textContent = 'The file must be nonempty and no larger than 10 MiB.'
} else {
selected = file
selection.textContent = file.name
status.textContent = 'Ready to upload.'
}
updateControls()
}
input.addEventListener('change', () => {
choose(Array.from(input.files))
// Retain the File ourselves so selecting the same file can fire change again.
input.value = ''
})
zone.addEventListener('dragover', (event) => {
event.preventDefault()
if (!busy) zone.classList.add('dragover')
})
zone.addEventListener('dragleave', () => zone.classList.remove('dragover'))
zone.addEventListener('drop', (event) => {
event.preventDefault()
zone.classList.remove('dragover')
choose(Array.from(event.dataTransfer.files))
})
function send(file, sha256) {
return new Promise((resolve) => {
const xhr = new XMLHttpRequest()
xhr.upload.addEventListener('progress', (event) => {
if (event.lengthComputable) progress.value = (event.loaded / event.total) * 100
})
xhr.upload.addEventListener('load', () => {
progress.value = 100
status.textContent = 'Body sent. Waiting for server acceptance…'
})
xhr.addEventListener('load', () => {
const result = xhr.response
if (xhr.status === 200 && result?.bytes === file.size && result?.sha256 === sha256) {
resolve({ ok: true, result })
} else {
resolve({
ok: false,
retryable: xhr.status >= 500,
message: xhr.status === 200
? 'Invalid server receipt.'
: `Server rejected the upload (HTTP ${xhr.status}).`,
})
}
})
xhr.addEventListener('error', () => {
resolve({ ok: false, retryable: true, message: 'Network error.' })
})
xhr.addEventListener('timeout', () => {
resolve({ ok: false, retryable: true, message: 'Request timed out.' })
})
xhr.open('POST', '/upload')
xhr.responseType = 'json'
xhr.timeout = 30000
const body = new FormData()
body.append('file', file)
body.append('sha256', sha256)
xhr.send(body)
})
}
async function startUpload() {
if (busy || !selected || attempts >= 3 || (attempts > 0 && !retryable)) return
busy = true
retryable = false
attempts += 1
updateControls()
progress.value = 0
receipt.textContent = ''
status.textContent = `Preparing attempt ${attempts} of 3…`
try {
const digest = await crypto.subtle.digest('SHA-256', await selected.arrayBuffer())
const sha256 = Array.from(new Uint8Array(digest), (byte) =>
byte.toString(16).padStart(2, '0'),
).join('')
status.textContent = `Uploading ${selected.name} (attempt ${attempts} of 3)…`
const outcome = await send(selected, sha256)
if (outcome.ok) {
status.textContent = `Accepted: ${selected.name}. Size and SHA-256 match. No file was saved.`
receipt.textContent = JSON.stringify(outcome.result, null, 2)
} else {
retryable = outcome.retryable
const next = retryable && attempts < 3
? 'Choose Retry to send it again.'
: 'Select a file to start again.'
status.textContent = `${outcome.message} ${next}`
}
} catch {
status.textContent = 'Could not prepare or send this file. Select it again.'
} finally {
busy = false
updateControls()
}
}
form.addEventListener('submit', (event) => {
event.preventDefault()
void startUpload()
})
retry.addEventListener('click', () => void startUpload())
ブラウザーは
crypto.subtle.digest()でチェックサムを計算します。この処理では、小さなファイル全体をメモリに読み込みます。Web Crypto を利用できるよう、下記のサーバーが出力するループバック URL からページを配信してください。index.html を直接開かないでください。Content-Type は設定しないでください。FormData が multipart の境界文字列を自動で設定します。
ローカル受信サーバーの追加
次の内容を server.ts として保存してください。このサーバーは、作成した三つのブラウザー用ファイルだけを配信し、multipart フィールドは
file と sha256 のふたつだけを受け付けます。本文のサイズ制限には、10 MiB のファイルに加えて、multipart ヘッダー用の 16 KiB を確保しています。受信サーバーは応答前に独自にチェックサムを計算します。
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 = 10 * 1024 * 1024
const allowedTypes = ['image/jpeg', 'image/png', 'application/pdf']
const assets = new Map<string, { body: Buffer; type: string }>()
for (const [route, file, type] of [
['/', 'index.html', 'text/html; charset=utf-8'],
['/styles.css', 'styles.css', 'text/css'],
['/script.js', 'script.js', 'text/javascript'],
]) {
assets.set(route, { body: await readFile(new URL(file, import.meta.url)), type })
}
let origin = ''
function reply(res: ServerResponse, status: number, data: object): void {
res.writeHead(status, { '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
}
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 size = 0
// Keep the socket open long enough to return 413 when stopping iteration early.
for await (const chunk of req.iterator({ destroyOnReturn: false })) {
if (!Buffer.isBuffer(chunk)) throw new Error('Expected request bytes')
size += chunk.length
if (size > maxSize + 16 * 1024) {
reply(res, 413, { error: 'Request body is too large.' })
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 === 0 || file.size > maxSize) {
reply(res, 413, { error: 'File must be nonempty and no larger than 10 MiB.' })
return
}
if (!allowedTypes.includes(file.type)) {
reply(res, 415, { error: 'Unsupported declared MIME type.' })
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, { name: file.name, bytes: file.size, sha256 })
}
const server = createServer((req, res) => {
void handle(req, res).catch(() => {
reply(res, 500, { error: 'Unable to process the upload.' })
})
})
server.requestTimeout = 30000
server.listen(0, '127.0.0.1', () => {
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}`)
})
accept 属性はファイル選択のヒントであり、検証ではありません。ブラウザーとこの受信サーバーは、どちらも宣言された MIME タイプを確認します。バイト列が有効で安全な画像や PDF であることを証明するものではありません。チェックサムが確認するのはバイト列の一致であり、信頼性ではありません。このデモには、ユーザーアカウント、永続ストレージ、コンテンツのセキュリティスキャン、フォーマットのデコードはありません。ループバックにバインドしてブラウザーのオリジンを確認しますが、これらはユーザー認証ではありません。公開サービスには、独自の認可、Cookie ベースのセッション向けの
CSRF 対策、コンテンツ検証、ストレージポリシーが必要です。
実行と結果の確認
custom-uploader 内で、次を実行してください。
node server.ts
出力された URL(例:http://127.0.0.1:49152)を開いてください。サーバーは利用可能なポートを選ぶため、再起動時にポートが変わる場合があります。ブラウザー用のファイルは起動時に読み込むので、編集後はサーバーを再起動してください。使い終わったら Ctrl+C で停止します。
Tab キーで「Choose a file」にフォーカスを移し、キーボードでファイル選択画面を開いて、小さな PNG を選択してください。Tab キーで Upload に移動し、実行します。最終ステータスに「Accepted」と表示され、受領情報にはファイル名、バイト長、64 文字の SHA-256 値が表示されるはずです。ブラウザーはこの値を自身で計算したチェックサムと照合しています。サーバーには何も保存されていません。
次のエラーケースや操作も試してください。
- 枠線で囲まれた領域にファイルをひとつドロップし、アップロードします。ふたつドロップすると、ひとつだけ選ぶよう求められるはずです。
- 空のファイル、テキストファイル、10 MiB を超えるファイルを試します。いずれもリクエストを開始せず、理由が画面に表示され続けるはずです。MIME タイプが空または認識できないファイルも、拡張子が適切に見えても拒否されます。
- ブラウザーのネットワークツールでアップロード速度を落とします。処理中はファイル選択と各ボタンが無効になり、ドロップしても現在の選択は変わらないはずです。サーバーの受理を待っているというステータスのまま、バーが 100% に達することがあります。
- ページを読み込んだ状態でブラウザーをオフラインに切り替え、アップロードします。「Network error」が表示されたらオンラインに戻し、Retry を選択してください。同じ選択ファイルで成功するはずです。三回ともオフラインのまま試行すると、再試行の上限を確認できます。その後、同じファイルを選択し直すと、新たに試行を開始できます。
リクエストが HTTP 400 を返す場合は、multipart のフィールド名を確認してください。403 は、オリジンまたはホストが出力された URL と一致していないことを意味します。HTTP 413 はサイズ制限、415 は未対応の宣言済み MIME タイプ、422 はチェックサムの不一致を示します。100% に達した後でこれらのエラーが発生した場合も、アップロードは失敗です。クライアント側の 30 秒の期限は、リクエストと応答の両方を対象とします。低速な回線で試す場合は、その点を考慮して期限を延ばしてください。
再開可能なアップロードが必要な場合
ここでの再試行とは、ページを開いている間にファイル全体を再送信することです。再読み込みすると、選択内容と試行回数は失われます。永続ストレージを追加する場合は、成功応答が失われるケースに対応してください。再試行でレコードが重複して作成されてはいけません。このワークフローでは、サーバー側で適用する冪等性キーを使用してください。
以前に受理されたバイトオフセットから送信を再開する必要がある大きなファイルには、tus クライアントとサーバーを使用してください。そのためには、両側で再開可能なプロトコルに対応する必要があります。ブラウザーの JavaScript だけでファイルをチャンクに分割しても、再開可能にはなりません。
