AddressLab ガイド

生成された住所データをフォーム検証テストに使う方法

生成された架空の住所データ（ダミーデータ）は、実際の個人情報をテスト環境に保存することなく、フォーム入力バリデーション、決済（チェックアウト）、エクスポート、ローカライズの動作を検証するのに役立ちます。

ダミー住所データが必要な場面

開発、品質保証（QA）、デモ、またはデータベース初期値（シードデータ）の作成において、リアルな住所レコードが必要な場合にジェネレーターを使用します。適切なテスト用レコードには、氏名、電話番号、メールアドレス、通り、市区町村、都道府県/州、郵便番号、国名、そして書式設定された完全な住所表記が含まれている必要があり、単一のテキスト欄だけでなくワークフロー全体を検証できるようにします。

サインアップとプロフィールフォーム

会員登録フォームなどでは、必須項目、任意入力、入力エラー表示、保存後のマイページ表示が組み合わされています。生成されたデータを使ってテストすることで、入力欄の長さが足りているか、コピーしたテキストがDBに正しく保存されるか、保存後の表示順序が崩れていないかを確認できます。

決済（チェックアウト）と税計算テスト

決済フォームは住所によって送料、消費税、合計金額、カード決済審査画面が変化するため、入念なテストが必要です。米国の住所で基本テストを行い、免税州の住所（オレゴンやデラウェアなど）で特定地域の無税決済ロジックを検証し、複数国の住所で海外決済フォームのレイアウトを確認します。

CSV、JSON、およびDBシードデータ

データのエクスポート/インポートはバグが頻出する領域です。生成されたテストレコードを複数保存し、選択した項目を CSV や JSON としてエクスポートした後、テスト用データベースにインポートしてみてください。カンマの区切り、郵便番号の「前ゼロ（例: 02108 が 2108 に化けていないか）」、特殊文字（日本語の漢字やヨーロッパの変音記号）が破損していないかをチェックします。

ローカライズと海外住所フォーム

海外の住所形式は、UIやデータモデルにおける隠れた仮定（例: すべての住所にZIPコードが存在するなど）を暴くのに有効です。日本、カナダ、イギリス、香港、オーストラリア、ドイツ、インド、トルコなどの住所サンプルを使用し、国コード選択、都道府県ラベル、郵便番号の桁数制限、住所の表記順がグローバル対応できているか検証します。

安全かつ適切なダミーデータの使用

生成された住所は、システムテスト用の合成ダミーデータです。実際の配送先としての使用、第三者へのなりすまし、不正登録、脱税、あるいはプラットフォーム利用規約を回避するための行為には絶対に使用しないでください。AddressLab のメール欄は予約済みの .test ドメインを使うため受信できません。配信確認にはチーム管理の QA メールボックスを使用してください。

推奨されるワークフロー

標準的な米国の住所を1つ生成し、すべての必須入力欄の動作を確認する。
免税州（Alaska, Delaware, Montana, New Hampshire, Oregon）のサンプルを生成し、カート内の税率が正しく0％になるか検証する。
複数国の住所形式でテストし、フォーム入力順序やラベルのローカライズをチェックする。
保存した複数のレコードを CSV または JSON でエクスポートし、データ移行やインポートテストを行う。
配信できない .test メール欄を使い、入力形式、保存、表示、エクスポートを確認する。