公開画面から整理した設計・テスト案です。内部実装、DOMセレクタ、処理速度は確認していません。
画像を円形にする機能は、マスク処理だけでなく、入力・編集・出力の契約を持ちます。要件を先に表にすると、見た目の確認とファイルの確認を分けられます。
要件表
| 領域 | 要件 | テスト観点 |
|---|---|---|
| 入力 | ファイル、貼り付け、URL | 形式エラーと再入力 |
| 編集 | 位置、ズーム、円/楕円 | 形変更後の状態保持 |
| 装飾 | 境界線、余白、背景 | プレビュー即時反映 |
| 出力 | PNG、WEBP、JPEG | 透明性と拡張子 |
| サイズ | プリセット、任意px | 数値境界と縦横比 |
| キュー | 複数画像 | 個別調整と一括操作 |
公開 CircleCropImage では、上記の入力と編集の流れが一つのブラウザ画面に整理されています。ページの説明にあるブラウザ内処理は、データ送信を避けたいケースの確認ポイントになります。
状態遷移を確認する
空の状態から画像を読み込み、プレビューを開き、設定を変更し、ダウンロードするまでを一つのテストシナリオにします。元画像を差し替えたとき、前の設定を残すのか初期化するのかは、仕様として明示すべきです。
例示的なPlaywright観点
// セレクタと文言は例示。実ページで確認してから採用する。
await page.getByRole('tab', { name: 'Upload' }).click();
await page.getByRole('button', { name: /download/i }).isVisible();
確認項目は、キーボードフォーカス、色入力のラベル、極端に小さい画像、長いファイル名、モバイル幅です。ダウンロードしたPNGを実際に開き、四隅が透明かを画像ビューアでも確認します。
具体的な入口は Circle Crop Image です。出力の精度や対応ブラウザを推測せず、観測できる状態と受け入れ条件を別々に記録することが、再利用できるQAになります。
