美国地址自动填充怎么做｜浏览器扩展一键填表、Chrome 地址簿与脚本方案对照

联调注册页、结账页或做回归测试时，一套完整的美国地址有 8~10 个字段：First/Last Name、Street、City、State、ZIP Code、电话、邮箱。手动填一遍要一两分钟，一天测几十遍就是纯粹的时间浪费。

更麻烦的是字段之间有一致性要求：City、State、ZIP Code、电话区号必须属于同一地区，随手编的组合会被表单的区域校验拦下。所以自动填充的前提是先有一套字段匹配的地址数据，再谈怎么填进去。

AddressMock 浏览器扩展把生成和填充合成一步：点工具栏图标，在弹窗里选州（或免税州模式）生成一条字段严格匹配的地址，然后点「自动填充」，当前页面表单的姓名、街道、城市、州、邮编、电话一次填好。

字段匹配按三层识别：input 的 autocomplete 属性、name/id 关键词、label 文本，State 字段同时兼容下拉框（选中对应选项）和文本框（填两位缩写）。对 React、Vue 等框架的受控输入，扩展会触发原生 setter 和 input/change 事件，让框架状态同步更新——这是大多数简易填表脚本会漏的点。

所有地址在浏览器本地生成，与网页版同一套 USPS/NANPA 口径的数据，不联网上传、不需要账号。装好后测试节奏变成：换个州 → 生成 → 一键填充 → 提交，单次几秒钟。

1. 从 Chrome 应用商店安装 AddressMock 扩展（Edge 用户也可直接安装 Chrome 版，Edge 兼容 Chrome 扩展）；
2. 把图标固定到工具栏，点击打开弹窗；
3. 选州或免税州模式，点「生成」；
4. 在带表单的页面点「自动填充」，或逐字段点击复制。

浏览器设置里的「地址和其他信息」（chrome://settings/addresses）可以保存地址，之后表单聚焦时会弹出自动填充建议。适合只需要一两套固定测试地址的轻量场景。

局限也明显：地址要预先手动录入、切换州要维护多套记录、对字段命名不规范的表单识别率一般，而且填的始终是同一套数据——需要大量不同地址做去重和边界测试时就不够用了。

跑 Playwright、Cypress 这类端到端测试时，填表应该发生在脚本里而不是手上。可以用批量生成页一次导出 100 条 CSV/JSON 当测试夹具，或在用例里直接请求免费 API（GET /api/addresses，无需 Key、支持 CORS），每次运行拿到新鲜且字段匹配的地址。

三种方案不冲突：日常手工测试用扩展，固定回归数据用 CSV 夹具，CI 里的用例走 API。

任何填表工具都可能在个别表单上失灵，按这个顺序排查：

• 表单在 iframe 里（常见于支付页）：扩展默认只作用于当前页面主文档，iframe 内的字段需要逐项复制粘贴；
• 字段没有规范的 name/autocomplete 属性：识别率下降，可用逐字段复制兜底；
• State 是自定义组件（非原生 select/input）：点开下拉后手动选，值用两位缩写（如 CA）；
• ZIP 以 0 开头被吃掉前导零：说明表单把邮编当数字处理，这本身是个值得上报的 bug；
• 填充后提交仍报「地址无效」：检查 City/State/ZIP 是否同区——如果用的是随手编的地址，换成生成器产出的匹配组合再试。

自动填充的地址是格式正确的测试样例：城市、州、邮编、区号真实匹配，但门牌号为虚构，不验证可投递性。适用于开发、测试、演示；不要用于真实收货、冒充身份或绕过服务条款。