browser_form_fill
Fill form fields on a target URL for automated testing. Supports batch filling with CSS selectors or field names, and smart filling with generated test data by field type.
Instructions
表单填充工具(v1.9.5 起合并 browser_smart_fill)。通过 mode 参数区分子模式:basic(默认,批量填充表单字段并可选提交检测,支持 CSS 选择器模式和字段名模式)/ smart(智能填充单个字段,按 fieldType 自动生成符合格式的测试数据,等价于已废弃的 browser_smart_fill)。
中文详情:
用途:批量或智能填充表单字段并可选提交检测
何时使用:登录/注册表单批量填写时;多字段表单快速测试时;表单提交流程端到端验证时;需要 mock 数据填充表单时
输出:basic 模式返回 { ok, url, filledFields, submitResult, timestamp };smart 模式返回 { success, selector, fieldType, value }
参数:
mode (string, 可选):basic(默认)/ smart
url (string, basic 模式必填):目标页面 URL
selector (string, 可选):表单选择器(basic 模式)或字段选择器(smart 模式必填)
fields (object, basic 模式可选):手动指定的字段值
fieldType (string, smart 模式必填):字段类型(email/phone/name/address/idCard/number/text/url/date/password)
options (object, smart 模式可选):数据生成选项
submit (boolean, 可选):basic 模式填充后是否自动提交,默认 true
submitSelector (string, 可选):提交按钮选择器
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | 目标页面URL(必填) | |
| mode | No | 填充模式:basic(默认,批量填充表单)/ smart(智能填充单个字段,自动生成符合 fieldType 的测试数据,等价于已废弃的 browser_smart_fill) | basic |
| fields | No | 手动指定的字段值。支持两种key格式:1) CSS选择器模式(key以#/./[/[/>/:/*开头,如 {"#login-email": "user@test.com", "#login-password": "pass123"});2) 字段名模式(key为input的name属性,如 {"email": "user@test.com", "password": "pass123"})。CSS选择器模式的字段会直接用Playwright定位填充,字段名模式的字段会通过表单自动发现机制匹配。 | |
| submit | No | 填充后是否自动提交 | |
| options | No | smart 模式可选:数据生成选项(如 locale、format 等) | |
| selector | No | 表单选择器,默认 'form' | form |
| fieldType | No | smart 模式必填:字段类型(email/phone/name/address/idCard/number/text/url/date/password) | |
| submitSelector | No | 提交按钮选择器,默认自动查找 submit 按钮 |