---
generated_at: 2026-02-25 10:00:00
metrics:
  claims_total: 60
  claims_with_evidence: 56
  claims_without_evidence: 4
confidence_derived: 0.93
---

# 根拠レポート：decap-cms-media-library-uploadcare 単体テストケース一覧

## 本レポートについて

### 目的
本レポートは、生成された設計書・ドキュメントの信頼性を検証し、人間レビュアーが効率的にレビューできるようにすることを目的としています。

### チェック方法
以下の観点でドキュメントの内容（Claim：主張）を検証しています：

1. **根拠の有無確認**：各主張に対して、ソースコード・既存設計書・要件定義書などの根拠（Evidence）が存在するか
2. **根拠との整合性**：主張の内容が根拠と矛盾していないか
3. **網羅性**：参照すべき情報源を適切にカバーしているか

### 信頼度スコアの算出
- **confidence_derived** = 根拠あり件数 / 総主張件数
- 状態「○」：根拠あり、「△」：根拠不足または要確認

### 本レポートの使い方
1. まず「サマリー」で全体の信頼度と優先レビュー項目を確認
2. 「Claims と根拠の対応」で △ の項目を重点的にレビュー
3. 「不足情報」で補完が必要な情報源を確認

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**0.93**
  - 根拠あり：56 / 60、根拠なし：4
- 優先レビュー（高）
  1. **C-29 (UT-UPC-029)**: isFileGroupの空配列に対するJavaScript every()の挙動はソースコードから推測可能だが、実行時の動作確認が望ましい
  2. **C-34 (UT-UPC-034)**: getFileGroupの不正URL入力時のエラー発生はコードから推測されるが、明示的なエラーハンドリングが実装されていない
  3. **C-42 (UT-UPC-042)**: getFilesへの数値入力の処理はコード推測だが、テスト対象として優先度は低い
  4. **C-59 (UT-UPC-059)**: jQueryプロミスとの互換性はコードのstateメソッドチェックから推測されるが、実際のjQueryプロミスオブジェクトの挙動確認が必要

## 2) 参照した情報（Evidence一覧）
> ここに「実在するもの」だけ列挙。抽出フェーズで付けたIDをそのまま出す。

- E-01: `packages/decap-cms-media-library-uploadcare/src/index.js` (メインソースコード、183行)
- E-02: `packages/decap-cms-media-library-uploadcare/src/__tests__/index.spec.js` (既存テストファイル、290行)
- E-03: `packages/decap-cms-media-library-uploadcare/package.json` (パッケージ定義)

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 (UT-UPC-001) | デフォルトエクスポートがnameとinitプロパティを持つ | E-01 (L180-183), E-02 (L67-73) | ○ |
| C-02 (UT-UPC-002) | 名前付きエクスポートがデフォルトと同一 | E-01 (L182-183) | ○ |
| C-03 (UT-UPC-003) | 初期化時にUPLOADCARE_PUBLIC_KEYが設定される | E-01 (L124), E-02 (L77-87) | ○ |
| C-04 (UT-UPC-004) | UPLOADCARE_LIVEがfalseに設定 | E-01 (L5), E-02 (L84) | ○ |
| C-05 (UT-UPC-005) | UPLOADCARE_MANUAL_STARTがtrue | E-01 (L6), E-02 (L85) | ○ |
| C-06 (UT-UPC-006) | effectsタブがpreviewとして登録される | E-01 (L130), E-02 (L89-92) | ○ |
| C-07 (UT-UPC-007) | initがshowメソッドを持つAPIを返す | E-01 (L137-163) | ○ |
| C-08 (UT-UPC-008) | initがenableStandaloneメソッドを持つAPIを返す | E-01 (L172) | ○ |
| C-09 (UT-UPC-009) | 引数なしでも正常動作 | E-01 (L120: デフォルト引数), E-02 (L90) | ○ |
| C-10 (UT-UPC-010) | globalConfigがdefaultConfigにマージされる | E-01 (L121-122) | ○ |
| C-11 (UT-UPC-011) | デフォルト設定でopenDialogが呼ばれる | E-01 (L138-141), E-02 (L102-106) | ○ |
| C-12 (UT-UPC-012) | グローバル設定がopenDialogに渡される | E-01 (L122, L138), E-02 (L108-116) | ○ |
| C-13 (UT-UPC-013) | フィールド単位設定がopenDialogに渡される | E-01 (L138), E-02 (L118-126) | ○ |
| C-14 (UT-UPC-014) | imagesOnlyが独立プロパティとして受付 | E-01 (L137-138), E-02 (L136-145) | ○ |
| C-15 (UT-UPC-015) | allowMultipleがfalseでない場合に複数選択許可 | E-01 (L139), E-02 (L147-157) | ○ |
| C-16 (UT-UPC-016) | allowMultipleがfalseで複数選択無効 | E-01 (L139), E-02 (L159-169) | ○ |
| C-17 (UT-UPC-017) | 単一画像選択時にhandleInsertにURLが渡される | E-01 (L109-110), E-02 (L171-178) | ○ |
| C-18 (UT-UPC-018) | 複数画像選択時にhandleInsertにURL配列が渡される | E-01 (L105-108), E-02 (L180-193) | ○ |
| C-19 (UT-UPC-019) | 既存単一URLがfileFromで変換される | E-01 (L70-73), E-02 (L30-33) | ○ |
| C-20 (UT-UPC-020) | 既存URL配列がファイルグループとして処理 | E-01 (L58-61), E-02 (L35-37) | ○ |
| C-21 (UT-UPC-021) | valueがnullの場合openDialogにnullが渡される | E-01 (L62: nullチェック) | ○ |
| C-22 (UT-UPC-022) | valueがundefinedの場合openDialogにnullが渡される | E-01 (L62: undefinedはfalsyなのでnull返却) | ○ |
| C-23 (UT-UPC-023) | valueが空文字列の場合openDialogにnullが渡される | E-01 (L62: ''はfalsyなのでnull返却) | ○ |
| C-24 (UT-UPC-024) | valueが数値の場合openDialogにnullが渡される | E-01 (L62: typeof !== 'string'でnull返却) | ○ |
| C-25 (UT-UPC-025) | enableStandaloneが常にfalseを返す | E-01 (L172), E-02 (L284-289) | ○ |
| C-26 (UT-UPC-026) | 完全なグループURL配列でisFileGroupがtrue | E-01 (L24-33) | ○ |
| C-27 (UT-UPC-027) | 非グループURL配列でisFileGroupがfalse | E-01 (L24-33) | ○ |
| C-28 (UT-UPC-028) | 不完全グループURLでisFileGroupがfalse | E-01 (L32: everyとsomeの組み合わせ) | ○ |
| C-29 (UT-UPC-029) | 空配列でisFileGroupがtrueを返す | E-01 (L32: Array.every()の仕様から推測) | △ |
| C-30 (UT-UPC-030) | 1件配列で正しく判定される | E-01 (L25-32) | ○ |
| C-31 (UT-UPC-031) | 順序入替グループURLでもtrue | E-01 (L32: some()による順序非依存マッチ) | ○ |
| C-32 (UT-UPC-032) | グループIDを正しく抽出しloadFileGroupが呼ばれる | E-01 (L42-49) | ○ |
| C-33 (UT-UPC-033) | getFileGroupがPromiseを返す | E-01 (L49: new Promise) | ○ |
| C-34 (UT-UPC-034) | 不正URL形式でgetFileGroupがエラーを発生 | E-01 (L42: 正規表現.exec()がnullを返す可能性) | △ |
| C-35 (UT-UPC-035) | 文字列入力でgetFileの結果が返る | E-01 (L62) | ○ |
| C-36 (UT-UPC-036) | 配列入力でグループURLの場合getFileGroupが呼ばれる | E-01 (L60) | ○ |
| C-37 (UT-UPC-037) | 配列入力で非グループURLの場合Promise.allで変換 | E-01 (L60) | ○ |
| C-38 (UT-UPC-038) | Immutable.jsのIterableでtoJS()変換後に処理 | E-01 (L58-59: Iterable.isIterable, toJS) | ○ |
| C-39 (UT-UPC-039) | null入力でnullが返る | E-01 (L62) | ○ |
| C-40 (UT-UPC-040) | undefined入力でnullが返る | E-01 (L62) | ○ |
| C-41 (UT-UPC-041) | 空文字列入力でnullが返る | E-01 (L62: '' && typeof '' === 'string' はfalsy) | ○ |
| C-42 (UT-UPC-042) | 数値入力でnullが返る | E-01 (L62: typeof 123 !== 'string') | △ |
| C-43 (UT-UPC-043) | CDN URLで非グループの場合uploadedタイプでfileFrom | E-01 (L71-73) | ○ |
| C-44 (UT-UPC-044) | CDN URLでグループパターンの場合urlタイプでfileFrom | E-01 (L71-73) | ○ |
| C-45 (UT-UPC-045) | 外部URLの場合urlタイプでfileFrom | E-01 (L72: startsWith(CDN_BASE_URL)がfalse) | ○ |
| C-46 (UT-UPC-046) | 画像でdefaultOperations設定時にURLに操作付加 | E-01 (L90-91), E-02 (L198-216) | ○ |
| C-47 (UT-UPC-047) | 非画像ファイルでdefaultOperationsが付加されない | E-01 (L91: isImage条件) | ○ |
| C-48 (UT-UPC-048) | autoFilenameでファイル名付加 | E-01 (L94-96), E-02 (L261-281) | ○ |
| C-49 (UT-UPC-049) | defaultOperationsとautoFilename両方有効時 | E-01 (L90-96), E-02 (L218-237) | ○ |
| C-50 (UT-UPC-050) | defaultOperationsにファイル名含む場合の上書き防止 | E-01 (L92-93: filenameDefined判定), E-02 (L239-258) | ○ |
| C-51 (UT-UPC-051) | defaultOperationsが/で始まらない場合のwarn | E-01 (L81-85) | ○ |
| C-52 (UT-UPC-052) | autoFilename無効時にファイル名非付加 | E-01 (L94: settings.autoFilename条件) | ○ |
| C-53 (UT-UPC-053) | 単一ファイル選択時のhandleInsert呼び出し | E-01 (L109-110) | ○ |
| C-54 (UT-UPC-054) | グループ選択時のhandleInsert呼び出し | E-01 (L105-108) | ○ |
| C-55 (UT-UPC-055) | defaultConfigにpreviewStep: trueが含まれる | E-01 (L14-17) | ○ |
| C-56 (UT-UPC-056) | defaultConfigにintegrationがUSER_AGENTで含まれる | E-01 (L8, L14-17) | ○ |
| C-57 (UT-UPC-057) | imagesOnlyのデフォルト値がfalse | E-01 (L137: imagesOnly = false) | ○ |
| C-58 (UT-UPC-058) | インスタンス設定がグローバル設定を上書き | E-01 (L138: スプレッド演算子の順序) | ○ |
| C-59 (UT-UPC-059) | jQueryプロミスとの互換性（stateメソッドチェック） | E-01 (L147: files.stateの存在チェック) | △ |
| C-60 (UT-UPC-060) | ネイティブPromiseの場合thenで解決後にopenDialog | E-01 (L148-155) | ○ |

## 4) 不足情報（Unknown / Missing）
- **C-29**: JavaScriptの`Array.prototype.every()`が空配列に対してtrueを返すことはECMAScript仕様だが、ソースコード内に明示的なコメントや空配列チェックがないため、開発者の意図が不明
  - 候補：開発者への確認 / ECMAScript仕様書参照 / 空配列ガード追加の検討
- **C-34**: `getFileGroup`関数に不正URL入力時のエラーハンドリングが実装されていない。L42の正規表現`exec()`がnullを返した場合、`[1]`アクセスでTypeErrorが発生する
  - 候補：try-catchの追加 / 入力バリデーションの追加 / エラーケースの仕様確認
- **C-42**: 数値型入力のテストは型チェックのロジックから推測されるが、実際のユースケースで数値が渡されるケースは考えにくい
  - 候補：TypeScript化による型安全性の確保 / 入力バリデーションの仕様確認
- **C-59**: jQueryプロミスの`state`メソッドの存在チェックによるプロミス種別判定は、コードコメント（L145-146）で意図が説明されているが、実際のjQueryプロミスオブジェクトでの動作確認が必要
  - 候補：uploadcare-widget内のjQuery実装の確認 / 統合テストでの検証

## 5) リスクフラグ（レビュー観点）
- **リスク1 (中リスク)**: `getFileGroup`関数のエラーハンドリング不足 - 不正URLが渡された場合にTypeErrorが発生する可能性がある。テストケースC-34で検出対象としているが、プロダクションコードにも防御的プログラミングが必要な可能性あり
- **リスク0 (低リスク)**: `isFileGroup`の空配列挙動 - `every()`は空配列でtrueを返すため、空配列がグループとして扱われる可能性がある。呼び出し元（`getFiles`）では配列が空になるケースが限定的なため影響は小さい
- **リスク0 (低リスク)**: テストケースの多くはモジュール内部関数（非エクスポート）を対象としている。テスト実装時にはモジュールリファクタリングまたはテストヘルパーが必要になる場合がある

## 6) レビュアーチェックリスト（最小）
- [ ] 全60テストケースが対象モジュールのソースコード（index.js）のpublic/内部関数を網羅しているか確認
- [ ] isFileGroup、getFileGroup、getFiles、getFile、openDialog、init、show、enableStandaloneの各関数に正常系・異常系・境界値テストが含まれているか確認
- [ ] buildUrl（openDialog内部関数）のテストケースがdefaultOperations・autoFilenameの組み合わせを網羅しているか確認
- [ ] 既存テスト（index.spec.js）と生成テストケースに矛盾がないか確認
- [ ] C-29（空配列）、C-34（不正URL）の挙動を実際のコードで検証
- [ ] テストID（UT-UPC-xxx）が連番で欠番なく割り振られているか確認
