AddressLab · ガイド
海外住所フォームのテスト：同じ1件を保存・再読込・出力で比較
初回公開: · Chrome · 2026-10-24
コピー、保存、再読込、出力を比べる間は、同じレコードを使ってください。途中で再生成すると、保存の不具合とランダムな値の変更を区別できません。今回の郵便番号 03101 は保存後も先頭の0を保持しました。再読込後の上部パネルは初期例に戻りますが、保存したレコードは別に残ります。
海外向けフォームの項目対応やデータ往復を確認する開発・QA担当者向けです。AddressLab のブラウザー保存と出力を実測しました。実店舗の購入、業務DB、配送、税計算は検証していません。画像は日本語の住所ツールです。
New Hampshire のレコードを1件だけ生成する
米国の州別テスト住所ツールで New Hampshire（NH）を選び、住所を生成します。先頭が0の郵便番号を含むテスト入力を得るための選択です。税額を確定する操作ではありません。初期の固定例はコピー・出力できますが、保存はレコードを生成してから使えます。
今回の完全な出力は 3412 Elm St, Manchester, NH 03101, United States でした。次の生成結果は通常異なります。厳密に同じ値を比べる場合は添付のスナップショットを使うか、自分の生成結果を先に記録してください。
| 項目 | 生成・保存・出力した値 |
|---|---|
street | 3412 Elm St |
city | Manchester |
region | New Hampshire (NH) |
postalCode | 03101 |
country | 米国 |
再読込後は「保存済み」を基準に出力する
- 住所をコピーし、通り、市、州、郵便番号が元の表示と一致することを確認します。比較中は再生成しません。
- 1回保存してページを再読込し、保存済み一覧を開きます。上部の現在表示が初期例に戻っていても、保存した行は別に確認できます。
- 保存済みレコードの JSON と CSV を出力します。再読込後の現在パネルを出力すると、別の初期例を比較することになります。
- JSON の型と、テキストとして読み取った CSV の値を照合します。画面の日本語ラベルをそのままAPIのキーとして扱わないでください。
再読込後も保存件数は1件でした。JSON の postalCode は文字列で、CSV の同じ項目にも 03101 が残りました。デスクトップ版 Excel は起動していないため、Excel の自動変換まで確認した結果ではありません。
日本の住所項目と米国の項目を機械的に対応させない
| 元のキー | 対象フォーム | 確認する点 |
|---|---|---|
street | Address Line 1 | 日本の都道府県から始まる順序をそのまま当てはめない。 |
region | State | 標準出力は New Hampshire (NH) という表示名。対象の選択値 NH に対応付ける。出力に独立した regionCode はない。 |
postalCode | ZIP | 米国の5桁を日本の7桁に変換せず、先頭0を含む文字列として扱う。 |
country | 国選択 | 出力は国の表示名。API が US を求める場合は明示的に対応付ける。countryCode が含まれると仮定しない。 |
HTML の address-line1、address-level2、postal-code などの autocomplete は項目の用途を示しますが、住所を検証する機能ではありません。画面だけでなく、送信リクエストと保存後のレスポンスも同じスナップショットに照らしてください。
決済回帰テストでは住所変更と計算結果を分ける
旧「免税州の決済フォーム」ガイドは本節に統合しました。カート、顧客区分、配送方法と住所を固定し、設定した税・配送サービスから期待結果を定義します。宛先を一組ずつ変更し、送信値、サービス応答、表示合計と再表示した下書きを記録してください。
- 州を変更した際に市と ZIP も意図した値になり、前の郵便番号が残らないこと。
- 請求先を配送先と同じにする設定の有効・無効を両方確認し、別の住所を上書きしないこと。
- 州フィルターを税額の計算結果とみなさず、対象システムの設定と応答に照らして判定すること。
ここは自分のステージング環境で行う手順です。今回、注文、支払い、税サービスへの問い合わせは実行していません。実際の配送には受取人が確認した住所を使ってください。
最初に値が変わった地点を特定する
| 最初の差分 | 次に調べる場所 |
|---|---|
| 入力は正しいが送信値が違う | 入力型の変換とAPI項目の対応。 |
| 送信値は正しいが保存値が違う | サーバーの整形、DB型、インポート仕様。 |
| 保存行は正しいが出力が違う | 現在行と保存行の選択、出力項目の対応。 |
| CSVの文字列は正しいが表計算で違う | 郵便番号を文字列としてインポート。元ファイルを保管。 |
不具合報告には、元の行、バージョン、操作手順と必要な応答を添え、実顧客情報は除いてください。国ごとの項目差は国際住所の境界テスト、米国 ZIP の入力判定は9つの ZIP ケースで確認できます。
検証範囲と参照資料
AddressLab が AI の補助を使って構成し、実際のブラウザー操作記録と以下の一次資料を照合しました。2026年10月24日、ローカルの本番ビルドを独立した Chrome で検証し、機能テスト中は外部の広告・解析リクエストを遮断しました。結果は住所の割当、実際の配達、メール所有権、税額を証明するものではありません。