---
title: 配布物ゼロライブラリ単一HTML開発講座 (1)
tags: 
author: [smile_yukiko_it](https://image.docswell.com/user/smile_yukiko_it)
site: [Docswell](https://www.docswell.com/)
thumbnail: https://bcdn.docswell.com/page/L7L8P9Z3JR.jpg?width=480
description: 配布物ゼロライブラリ単一HTML開発講座 (1) by smile_yukiko_it
published: November 19, 26
canonical: https://image.docswell.com/s/smile_yukiko_it/Z9NPPM-2026-11-19-124305
---
# Page. 1

![Page Image](https://bcdn.docswell.com/page/L7L8P9Z3JR.jpg)

単一HTMLツール実践開発講座
開発用ライブラリを配布物に入れない
単一HTMLツールの作り方
前半：講義編 (Why・What) ／ 後半：実践編 (How)

# Page. 2

![Page Image](https://bcdn.docswell.com/page/4EM64ZVM7W.jpg)

全体構成
本日の講座ロードマップ
1 前半・講義編
WHY：なぜ配布物に混ぜないのか
軽量配布と導入ゼロの理由を学ぶ。
2 前半・講義編
WHAT：守るべき6つの仕様ルール
開発時と配布時の構造を理解する。
3 後半・実践編
HOW：ひな形構築から検証・配布
1手ずつ確認しながら手を動かす。

# Page. 3

![Page Image](https://bcdn.docswell.com/page/PERPW62L79.jpg)

前半：講義編 ／ PART 1
WHY：なぜライブラリを入れないのか
開発の生産性と配布の身軽さを両立する設計思想

# Page. 4

![Page Image](https://bcdn.docswell.com/page/P7X3PMP6EX.jpg)

WHY ／ 基本の考え方
本棚と一緒に「のこぎり」は渡さない
ライブラリは「作る道具」
esbuild や vitest は検証と統合のみに使用。
超軽量な配布物：ひな形はわずか1.5KBで完結。
インストール不要：利用者はブラウザで開くだけ。
ライセンス負担軽減：配布物への権利表記が不要。

# Page. 5

![Page Image](https://bcdn.docswell.com/page/37KYDGDGED.jpg)

WHY ／ 実測サイズの比較
ライブラリ有無による配布サイズの差
35.4 KB
外部ライブラリなしの本格音声ツール実測値
※ ライブラリをHTMLに内蔵した版は約1.4MB（約40倍）に肥大化

# Page. 6

![Page Image](https://bcdn.docswell.com/page/LJ39RNR5J5.jpg)

前半：講義編 ／ PART 2
WHAT：全体構造と6つの仕様ルール
開発環境と配布ファイルを明確に分離する仕組み

# Page. 7

![Page Image](https://bcdn.docswell.com/page/8JDGYWYYJG.jpg)

WHAT ／ 開発時と配布時の違い
ビルドによるファイルの変換と分離
開発するとき（手元）
src/：自分で書いた分割コード
esbuild：ばらばらのJSを1つに統合
vitest：ロジックの自動テスト実行
→
ビルド
配るとき（dist/ 2ファイル）
tool.html：自分のコードだけの単一HTML
config.js：環境別の設定ファイル
配布対象外：node_modules は一切渡さない

# Page. 8

![Page Image](https://bcdn.docswell.com/page/VEP3696278.jpg)

WHAT ／ 開発の鉄則
この作り方を守る6つの仕様 (R1～R6)
番号 決まり 理由・確かめ方
R1 devDependencies のみ使用 dependencies を空にして混入防止
R2 バージョン固定・lock管理 別環境でも同じ道具で再現可能
R3 src/ でライブラリを import 禁止 esbuild によるHTML内蔵を防ぐ
R4 配布は tool.html と config.js のみ check:dist でファイル数を検証
R5 環境設定は config.js に分離 HTMLにキーやURLを直書きしない
R6 node_modules・本物設定は Git 除外 肥大化と秘密情報の漏洩を防止

# Page. 9

![Page Image](https://bcdn.docswell.com/page/27V43M3XEQ.jpg)

WHAT ／ 迷わないための環境整理
3つの動かし方と接続先（迷い防止）
① 開発環境（自動テスト）
npm test / verify
ブラウザ不要・費用0円で高速検証。
② 模擬サーバー（画面確認）
npm run dev (localhost)
費用0円で画面操作や異常系を確認。
③ 本番環境（実配布版）
配布フォルダ（本番API）
本番キー設定・短時間音声で疎通。

# Page. 10

![Page Image](https://bcdn.docswell.com/page/5JG13G3R7L.jpg)

後半：実践編 ／ PART 3
HOW：10分で動かすハンズオン手順
1手ずつ「確かめること」を確認しながら進める

# Page. 11

![Page Image](https://bcdn.docswell.com/page/47QD5X5YEP.jpg)

HOW ／ 実践ステップ前半 (手順1～4)
ひな形コピーからビルドまで
手順1
ひな形をコピー
src と tests の存在を確認。
手順2
npm ci で道具導入
esbuild と vitest を確認。
手順3
npm test で検証
Tests 4 passed を確認。
手順4
npm run build
dist に成果物出力を確認。

# Page. 12

![Page Image](https://bcdn.docswell.com/page/KE4Z969ZJ1.jpg)

HOW ／ 品質ゲートと模擬試験
配布前の自動検査と形式別モック検証
npm run verify：単体テスト・ビルド・混入検査を一括実行。
形式別・異常系モック：実ファイル適合や通信エラーを模擬検証。
MD5ハッシュ一致確認：開発版と配布版の同一性を保証。
配布物作成の2パターン
通常配布：HTML本体＋設定サンプルの2ファイル構成
納品一式：npm run package で鍵混入を防ぎZIP化
安全装置：APIキー混入時はビルドを自動停止

# Page. 13

![Page Image](https://bcdn.docswell.com/page/L71RKVKD7G.jpg)

HOW ／ 現場で迷わないための対処法
よくあるつまずきと安全運用の鉄則
ポート8787使用中エラー：既存の模擬サーバーやVS Codeポート転送を停止。
「設定が読み込めません」表示：HTMLと同じフォルダに config.js を配置して書き換え。
本番キーの厳重管理：開発環境やGitには絶対に入れず配布フォルダのみ記載。
ロジックと画面の分離：計算 (core) と画面 (app.js) を分けてこまめに検証。

# Page. 14

![Page Image](https://bcdn.docswell.com/page/G7W1DLD8J2.jpg)

HOW ／ 実務の保守・改修サイクル
仕様変更からリリースまでの8ステップ
1. 仕様更新
spec.md 修正
要件と基準を先に確定。
2. テスト先行
失敗テスト作成
要件ID名で先に追加。
3. 実装・単体
src 修正・verify
全テストと整合を突破。
4. 実ファイル適合
conformance 検証
生成データで境界確認。
5. 実機自動テスト
Selenium 15件
実Chromeと模擬で全走。
6. 本番疎通
短時間データ確認
手動で最小コスト検証。
7. 配布リポジトリ反映
MD5一致でPR
配布HTMLのみを提出。
8. 仕様台帳更新
結果と版を記録
実機とAI試験を分離記録。

# Page. 15

![Page Image](https://bcdn.docswell.com/page/4JZPGMG973.jpg)

HOW ／ 実機自動テストの仕組み
Python＋Seleniumによる実機E2E自動化
自動制御の3連携（費用0円）
1. 模擬サーバー制御：試験ごとにシナリオ起動・停止
2. 実Chrome操作：新規起動でキャッシュ分離・操作
3. リソース監視：psutilで全プロセスメモリ計測
データ駆動テスト表：1試験=1行の辞書でケース追加が容易。
送信ログと突合判定：画面表示とサーバー受信CSVを両方検証。
証跡の自動出力：全体スクショ・推移Excel・MD5を保存。

# Page. 16

![Page Image](https://bcdn.docswell.com/page/YE6MYNYDJV.jpg)

HOW ／ ゼロライブラリを支える標準技術
ブラウザ標準API活用とテストしやすい設計
省メモリ分割読込
Blob.slice と型付配列で大容量を軽量処理。
外部依存の注入設計
通信や待機を外から渡し待ち時間ゼロで試験。
定時自動実行と安全弁
タスクスケジューラ連携と本番API誤送信防止。

# Page. 17

![Page Image](https://bcdn.docswell.com/page/GE5ZG5G874.jpg)

HOW ／ 開発用ライブラリと混入防止策
使った開発用ライブラリと配布物に入れない方法
開発で使ったライブラリ (MIT)
esbuild：ばらばらのJSを1ファイルに統合
vitest：単体・結合テストの高速自動実行
jsdom：ブラウザDOMの擬似画面スモーク試験
※ すべて devDependencies のみ（配布ライセンス表記不要）
配布物に1つも入れない4つの方法
1. 導入コマンド：npm install -D --save-exact で固定追加
2. 参照遮断 (R3)：src/ からライブラリを import しない
3. 自動検査：npm run check:dist で混入・CDNを検知
4. 配布限定：tool.html と config.js の2枚だけコピー

# Page. 18

![Page Image](https://bcdn.docswell.com/page/972RYNYVER.jpg)

HOW ／ 例外対応と最終確認
ライブラリ内蔵時の方針変更と出荷チェック
どうしても配布物に入れる場合
事前決定：採用理由・固定版・容量増を先に合意
権利対応：ライセンスとソースをHTMLから保存可能に
実測例：音声変換内蔵版は約1.4MB（なし版は35.4KB）
配布前の最終チェックリスト
[✓] 依存分離：dependencies が空で版が固定済み
[✓] 検証合格：npm run verify と実ブラウザ動作OK
[✓] 除外徹底：node_modules・本番キーは配布・Git外

# Page. 19

![Page Image](https://bcdn.docswell.com/page/DJYDGPGQJM.jpg)

受講者特典① ／ コピペで使える実務テンプレート
コピペ即戦力：package.json と build.mjs
package.json (開発依存のみ固定)
{
  &quot;type&quot;: &quot;module&quot;,
  &quot;scripts&quot;: {
    &quot;test&quot;: &quot;vitest run&quot;,
    &quot;build&quot;: &quot;node build.mjs&quot;,
    &quot;check:dist&quot;: &quot;node scripts/check-dist.mjs&quot;,
    &quot;verify&quot;: &quot;npm test &amp;&amp; npm run build &amp;&amp; npm run check:dist&quot;
  },
  &quot;devDependencies&quot;: {
    &quot;esbuild&quot;: &quot;0.24.0&quot;,
    &quot;vitest&quot;: &quot;2.1.0&quot;
  }
}
build.mjs (単一HTML化・安全置換)
import { build } from &quot;esbuild&quot;;
import { readFileSync, writeFileSync, mkdirSync } from &quot;node:fs&quot;;
mkdirSync(&quot;dist&quot;, { recursive: true });
const r = await build({
  entryPoints: [&quot;src/app.js&quot;], bundle: true, write:
  false, format: &quot;iife&quot;
});
const js = r.outputFiles[0].text.replace(/&lt;\/script/gi,
&quot;&lt;\\/script&quot;);
const html = readFileSync(&quot;src/template.html&quot;, &quot;utf8&quot;)
  .replace(&quot;/*CSS*/&quot;, () =&gt;
readFileSync(&quot;src/style.css&quot;, &quot;utf8&quot;))
  .replace(&quot;&quot;, &#039;&#039;)
  .replace(&quot;&quot;, () =&gt; `${js}`);
writeFileSync(&quot;dist/tool.html&quot;, html);

# Page. 20

![Page Image](https://bcdn.docswell.com/page/V7N6G5G278.jpg)

受講者特典② ／ 混入防止検査と設定分離コード
コピペ即戦力：混入検査スクリプトと設定分離
scripts/check-dist.mjs (自動ゲート)
import { readdirSync, readFileSync } from &quot;node:fs&quot;;
const files = readdirSync(&quot;dist&quot;).sort();
if (files.join(&quot;,&quot;) !== &quot;config.js,tool.html&quot;) throw new
Error(&quot;NG: 余分なファイル&quot;);
const html = readFileSync(&quot;dist/tool.html&quot;, &quot;utf8&quot;);
const ng = [/node_modules/, /esbuild/, /vitest/,
/https?:\/\/.*\.css/i];
if (ng.some((r) =&gt; r.test(html))) throw new Error(&quot;NG: ラ
イブラリや外部CSS混入&quot;);
console.log(&quot;✓ 配布物の確認: OK&quot;);
config.sample.js (file:// 対応設定)
// JSONではなくJSにすることでfile://でも読込可能
window.APP_CONFIG = {
  apiEndpoint: &quot;https://example.com/api&quot;,
  apiKey: &quot;&lt;ここにAPIキー&gt;&quot;,
  timeoutMs: 30000
};
// 画面側で「&lt;...&gt;」が残っていたら未設定エラー表示

# Page. 21

![Page Image](https://bcdn.docswell.com/page/YJ9LWYWDE3.jpg)

困ったときの逆引き辞典
現場トラブル即効レスキュー表
起きた症状・エラー 主な原因 即効の対処コマンド・手順
check:dist が NG で停止 src/ でライブラリを import import を削除しブラウザ標準APIへ置換
EADDRINUSE:8787 前の模擬サーバーが残存 既存プロセスやVS Codeポート転送を停止
画面で「設定読込エラー」 config.js 未配置・仮文字のまま HTMLと同階層に置き接続先・キーを記載
修正が画面に反映されない ビルド忘れ・古いHTML閲覧 npm run build 実行後にMD5と再読込確認
sufficient permission コンテナ(root)でgit操作 sudo chown -R $USER . 実行しWSLでgit操作

# Page. 22

![Page Image](https://bcdn.docswell.com/page/GJ8XN6N57D.jpg)

まとめ・実践アクション
道具は手元に、配布物は身軽に。
まずは npm run verify を通そう！
ご受講ありがとうございました。質問・演習のサポートはいつでもお声がけください。

