blob: a9abf8acbadc672098fee96f7cc861039781d975 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
|
# テスト実行結果
実施日: 2026-09-01
## 1. 単体・結合テスト（自動）
実行環境: Firefox系ブラウザ（Geckoエンジン）で `tests/test.html` を実行。npm / Node.js 不使用の自作ランナー。
**結果: 85 passed, 0 failed**
### カバレッジ
| 領域 | テスト数 | 内容 |
|---|---:|---|
| constants sync (content mirror) | 4 | Content Script複製定数とshared定数の同期担保 |
| ollama host validation | 9 | localhost/127.0.0.1+任意port許可、外部host/LAN/https/credentials拒否 |
| settings schema defaults | 4 | 既定値、不正値のフォールバック、ユーザープロンプト長制限 |
| temperature validation | 4 | 0.1刻み、範囲外・中間値拒否 |
| context length validation | 1 | プリセット6値のみ許可 |
| seed validation | 3 | random/fixed、非整数seed破棄 |
| advanced options validation | 4 | null許容、整数/浮動小数チェック、stop配列 |
| buildOptions | 5 | 未設定除外、seedモード反映、API名マップ、mirostat系不使用 |
| toApiThinking | 3 | off→省略、on→true、low/high→文字列 |
| system prompt builder | 4 | 固定プロンプト先頭、言語指定、ユーザープロンプト結合順序 |
| message validation | 6 | translate/cancel検証、長さ上限境界値、requestId生成 |
| ollama client: listModels | 4 | 正常系、404写像、host拒否（fetch前）、ネットワークエラー写像 |
| ollama client: chatStream | 6 | **JSON境界分断チャンク耐性**、thinking分離、不正行スキップ、エラーペイロード写像、think/options条件付き送信、400/404写像 |
| toExtensionError | 2 | AbortError→REQUEST_ABORTED、デフォルトコード |
| TranslationSession | 2 | 新規要求で旧要求Abort+旧portへの通知、isActive/clear |
| settings service | 3 | 保存/復元ラウンドトリップ、不正値フォールバック、onChangedキャッシュ更新 |
| selectionText validation | 1 | **context menu選択文字列のuntrusted validation**（型/trim/空/control文字/最大長） |
| context menu flow + popup state | 11 | **menus選択→翻訳→popup state streaming/completed**、空選択拒否、streaming状態遷移、Ollama停止時error、新規翻訳で旧state置換、regenerateLast、**popup-state portライブ配信**、誤名port拒否、**初期状態のモデル自動選択（未設定→先頭モデルを自動永続化）**、Ollama停止時のOLLAMA_UNAVAILABLE報告、エラー詳細のユーザー安全化（URL除去・長さ制限・JSON除去） |
| UI smoke (popup) | 1 | popup.js実DOM実行、2モードUI初期化、settings mode初期表示 |
| UI smoke (options) | 1 | options.js実DOM実行、言語/モデル/host反映 |
| message router: port flow | 5 | started/chunk/completed伝送、**A→B新規要求でAがabort+stale chunk廃棄**、不正メッセージ破棄、OLLAMA_UNAVAILABLE、INVALID_SETTINGS |
| message router: listModels | 2 | 正常系、非信頼sender拒否 |
## 2. Firefox実機動作確認
以下は `about:debugging` から一時アドオンとしてロードし、実Ollama環境で確認する項目です。
| # | 確認項目 | 結果 |
|---|---|---|
| 1 | 通常HTMLページで文字列選択後、翻訳アイコンが表示される | ☐ 未実施 |
| 2 | アイコン押下までOllama requestが発生しない | ☐ 未実施 |
| 3 | アイコン押下で翻訳ポップオーバーが表示される | ☐ 未実施 |
| 4 | streaming結果が逐次表示される | ☐ 未実施 |
| 5 | コピーが動作する | ☐ 未実施 |
| 6 | 再生成が動作する | ☐ 未実施 |
| 7 | 閉じる操作が動作する | ☐ 未実施 |
| 8 | 新規翻訳で旧streamがキャンセルされる | ☐ 未実施 |
| 9 | 拡張無効時は翻訳アイコンが出ない | ☐ 未実施 |
| 10 | 設定変更後の値が次回翻訳に反映される | ☐ 未実施 |
| 11 | Firefox再起動後も設定が保持される | ☐ 未実施 |
| 12 | Ollama停止時に適切なエラーとなる | ☐ 未実施 |
| 13 | ページ内のHTMLらしき文字列やscript文字列を選択してもDOM実行されない | ☐ 未実施 |
| 14 | LLM出力にHTML文字列が含まれてもHTMLとして解釈されない | ☐ 未実施 |
## 2.1 PDF Viewer実機動作確認（context menu翻訳）
以下はSpecifications.md §13.4の14項目です。実Firefox + 実Ollamaで確認してください。
| # | 確認項目 | 結果 |
|---|---|---|
| 1 | 通常Webページで文字列を選択する | ☐ 未実施 |
| 2 | context menuに「選択したテキストを翻訳」が表示される | ☐ 未実施 |
| 3 | menuからtranslationを開始できる | ☐ 未実施 |
| 4 | Firefox内蔵PDF ViewerでPDFを開く | ☐ 未実施 |
| 5 | PDF内のテキストを選択する | ☐ 未実施 |
| 6 | context menuに翻訳項目が表示される | ☐ 未実施 |
| 7 | `selectionText` が取得される | ☐ 未実施 |
| 8 | Action Popupが開く | ☐ 未実施 |
| 9 | Ollama streaming結果が逐次表示される | ☐ 未実施 |
| 10 | Copyが動く | ☐ 未実施 |
| 11 | Regenerateが動く | ☐ 未実施 |
| 12 | Ollama停止時に安全なエラー表示になる | ☐ 未実施 |
| 13 | HTML/script風のPDF文字列を選択しても実行されない | ☐ 未実施 |
| 14 | 新しい翻訳開始時に古いrequestが正しくcancelされる | ☐ 未実施 |
## 3. セキュリティチェック
| 項目 | 結果 |
|---|---|
| `innerHTML` / `outerHTML` / `document.write` 不使用 | ✅ 全ソースでgrep確認済み |
| `eval` / `new Function` / 文字列setTimeout不使用 | ✅ 全ソースでgrep確認済み |
| リモートJS/CSS/フォント/CDN不使用 | ✅ 外部資源参照なし |
| inline script不使用（popup/options/options HTML） | ✅ 外部script fileのみ |
| LLM出力・選択文字列の`textContent`描画 | ✅ popover body / status すべてtextContent |
| Content ScriptからのOllama fetchなし | ✅ Ollama clientはbackgroundのみ |
| message validation（型・長さ・requestId） | ✅ shared/messages.js で実施、テストで担保 |
| host制限（localhost/127.0.0.1+portのみ） | ✅ schema validator + client assertAllowedHost の二重防御、テストで担保 |
| `execCommand('copy')` 等deprecated API不使用 | ✅ Clipboard APIのみ（失敗時はメッセージ表示） |
| 不要権限なし（tabs/scripting/cookies/webRequest等） | ✅ manifest.jsonで確認 |
## 4. Firefox API監査チェックリスト（Design §24）
- [x] Manifest V3
- [x] `action` 使用
- [x] `background.scripts` 使用（`type: module`）
- [x] `background.service_worker` 不使用
- [x] `browser_action` 不使用
- [x] `tabs.executeScript()` 不使用
- [x] `runtime.getBackgroundPage()` 不使用
- [x] `window.localStorage` 不使用
- [x] `storage.local` 使用
- [x] `runtime.Port` streaming通信
- [x] Content ScriptからOllama fetchなし
- [x] `eval` / `new Function`なし
- [x] Remote JSなし
- [x] LLM出力への`innerHTML`なし
- [x] 不要permissionsなし
- [x] iframe初期対応なし
|
