ADR: 自動テスト（Selenium）実行中であることをアプリケーション内で検知可能にする

[takaokouji]

Context and Problem Statement - コンテキストと問題の説明

Seleniumでのファイルアップロード時にブラウザのダイアログが開くと制御が困難になるため、テスト時のみこの挙動を抑制したい。

Decision Date - 決定日付

2026/01/25

Decision Makers - 意思決定者

@takaokouji

Decision Drivers - 決定要因

• URLパラメーター test=1 を検知して Redux の isTest フラグを立てる。
• SeleniumHelper.loadUri でこのパラメーターを自動付与する。
• SBFileUploaderHOC で isTest が真の場合、click() をスキップする。

Considered Options - 検討した選択肢

案1: URLパラメータによる判定（推奨）
SeleniumHelper.loadUri で読み込むURLに、テスト用フラグ（例: ?seleniumTest=true）を付与し、HOC内でそれを判定します。

• 実装イメージ: createFileObjects 内で window.location.search を確認し、フラグがない場合のみ this.inputElement.click() を実行する。
• メリット: テストコード側（loadUri）で制御が完結し、本番環境への影響が最も少ない。

案2: navigator.webdriver による判定
多くのモダンブラウザが提供している、自動操縦下にあることを示す標準プロパティを参照します。

• 実装イメージ: if (!navigator.webdriver) { this.inputElement.click(); } とする。
• メリット: コードの変更が最小限で済み、URLパラメータの管理も不要。
• デメリット: 「テスト中だが手動でダイアログを開きたい」といった特殊なケース（デバッグ時など）に対応できない可能性がある。

案3: グローバル定数（windowプロパティ）による判定
Seleniumから executeScript を用いて、初期化時に window.IS_SELENIUM = true といった値を注入します。

• 実装イメージ: if (!window.IS_SELENIUM) { this.inputElement.click(); } とする。
• メリット: URLを汚さず、かつ明示的に「このタイミングからテストモード」という切り替えができる。
• デメリット: SeleniumHelper 側の初期化処理（各テストの開始時など）にフラグ注入の処理を追加する必要がある。

Decision - 決定

内容

理由

Consequences - 結果

―

Confirmation - 確認

―

Pros and Cons of the Options - 選択肢の長所と短所

Seleniumから <input type="file"> に対して直接 sendKeys(path) を行えるようになり、テストの安定性が向上した。

More Information - 詳細情報

―