当前支持什么，暂不支持什么
TestMax 适用于常规网页业务流程的自动化测试。为保证用例稳定执行，请在编写用例前了解当前支持范围与操作限制。
说明：以下内容以用户可见的网页操作描述能力范围，不涉及产品内部执行指令或技术实现。能力范围会随版本持续更新。
当前支持的网页操作
适合登录、查询、新增、编辑、删除、审批、表格校验等常见 Web 业务流程。
单击与双击网页元素
支持单击或双击按钮、链接、菜单、标签页、列表项、表格行、复选框、单选框以及网页内部弹窗中的操作项。
输入、清空与键盘按键
支持在输入框、搜索框和文本区域中填写或清空内容，也支持在目标元素上按 Enter、Tab、方向键、Esc 等常用按键，以及明确描述的页面级快捷键。
选择与勾选
支持普通下拉框、可搜索下拉框、日期选择、复选框、单选框等常见表单控件。
鼠标悬停
支持悬停显示菜单、提示信息或隐藏按钮，再继续完成后续网页操作。
自动滚动到目标
执行点击、输入、悬停或按键等操作前，会尽量将已识别的目标元素自动带入可视区域。
等待页面状态
支持明确的短时等待；页面打开、文字和 Toast 校验会在限定时间内自动轮询。查询、搜索、刷新或切换标签页后，可单独增加等待步骤。
页面结果校验
支持校验页面文字、元素可见性、Toast、选中态、禁用态、网址、表格记录和字段值，并在失败时保留截图证据。
配置后的业务 iframe
在配置中心启用 iframe 架构并填写稳定选择器后，可在主业务 iframe 中定位、操作和校验元素。
网页内部弹窗
支持操作由网页实现的对话框、抽屉、浮层、提示框和确认窗口，不包含 JavaScript 原生弹窗、浏览器或操作系统弹窗。
哪些网页元素可以被操作
TestMax 需要先识别网页元素的用途，才能稳定地点击、输入或选择。标准 HTML 控件通常可直接识别；自定义控件需要提供明确的可交互语义。
可直接识别的标准元素
优先使用浏览器原生控件，通常无需额外配置。
- 按钮与链接：
button、a - 输入控件：
input、textarea - 下拉选项：
select、option - 其他控件：
summary、可编辑元素
自定义元素需要语义
如果使用 div、span 等元素实现按钮、菜单或选项，请添加与实际用途一致的 role 属性。
- 按钮：
role="button" - 下拉选项：
role="option" - 菜单项：
role="menuitem" - 标签页：
role="tab" - 复选或单选：
role="checkbox"、role="radio"
同步暴露控件状态
元素状态应随页面实际状态更新，便于自动化准确判断。
- 选中状态：
aria-selected="true" - 勾选状态：
aria-checked="true" - 禁用状态：原生
disabled或aria-disabled="true" - 展开状态：
aria-expanded="true"
元素必须真实可见
目标元素应已显示在当前页面中，并且没有被遮罩层覆盖。隐藏、尺寸为零、已移出页面或尚未展开的选项无法被稳定操作。可滚动列表中的目标项，应先进入可视区域。
role="listbox"，每个选项设置 role="option"，并使用 aria-selected="true" 表示当前选中项。完整语义更有利于无障碍访问和自动化稳定性。当前暂不支持的网页操作
以下场景暂不建议写入关键自动化流程，可能需要人工处理或调整测试方案。
上传文件
暂不支持依赖系统文件选择窗口完成文件上传，也不建议将上传作为关键回归步骤。
下载文件
暂不支持稳定完成文件下载、保存位置选择以及本地文件内容校验。
系统复制与粘贴
可以点击网页中的“复制”按钮，但暂不支持读取、写入或校验系统剪贴板内容。
拖拽与滑块
暂不支持拖动网页元素排序、拖动进度条、拖动验证滑块或将文件拖入页面。
验证码与扫码
不支持自动识别图片或滑块验证码，也无法代替用户扫码、接收短信或完成手机端确认。
浏览器与系统弹窗
不支持文件选择器、保存窗口、浏览器权限询问、证书提示等非网页界面。
新标签页与新窗口
当前自动化在单个浏览器页面内执行，不支持在多个浏览器标签页或窗口之间切换。
精确滚动指令
页面会尽量自动将目标带入可视区域，但暂不支持按距离、屏数或指定容器进行精确滚动。