自动化测试 / 系统课时
执行拖拽操作
执行拖拽操作
拖拽测试的关键不是“把鼠标从 A 移到 B”,而是让页面真实经历源元素按下、移动到目标区域并释放的交互。本节使用 Locator.dragTo() 完成常规拖放,并通过目标区域的最终状态判断操作是否真正生效。
学习目标
- 使用
Locator.dragTo()在源元素与目标区域之间执行拖放。 - 用页面状态断言验证拖拽结果,而不是只判断调用是否报错。
- 识别拖拽位置、可操作性检查和自定义交互造成的常见失败。
用 Locator 表达源与目标
常规拖放优先使用 Locator,而不是手工计算整条鼠标轨迹。先分别定位可拖动元素和接收区域,再由源 Locator 调用 dragTo()。Playwright 会围绕这两个元素执行拖拽动作,因此定位器稳定性直接决定测试稳定性。
下面的测试用本地 HTML 构造一个独立场景:源元素带有 draggable 属性,目标区域在收到 drop 后更新文本。测试最后断言目标文本,确认业务状态确实发生变化。
import { test, expect } from '@playwright/test';
test('drag item to drop zone', async ({ page }) => {
// 用本地 HTML 构造可重复运行的拖放场景。
await page.setContent(`
<div id="source" draggable="true">任务卡</div>
<div id="target">待放置</div>
<script>
const target = document.querySelector('#target');
target.addEventListener('dragover', event => event.preventDefault());
target.addEventListener('drop', event => {
event.preventDefault();
target.textContent = '已放置';
});
</script>
`);
const source = page.locator('#source');
const target = page.locator('#target');
await source.dragTo(target);
// 用最终页面状态验收拖拽,而不是只看 dragTo 是否完成。
await expect(target).toHaveText('已放置');
console.log(await target.textContent());
});预期输出
已放置测试运行器还会输出用例名称和耗时等信息;这里列出的是该示例通过 console.log 产生的关键结果。
控制起点与落点
默认情况下,dragTo() 会在源元素和目标元素的可见区域内选择可操作位置。对于棋盘、排序列表或只接受局部落点的组件,可以使用 sourcePosition 和 targetPosition 指定相对元素左上角的坐标,让按下点和释放点落在业务要求的位置。
位置参数应该服务于真实交互规则,而不是用来掩盖错误定位。如果测试必须依赖大量精确坐标,先确认页面是否提供了更稳定的角色、文本、测试 ID 或可定位子元素。
拖拽失败时检查动作链
拖拽失败通常沿着“源元素不可操作、移动未触发组件逻辑、目标区域不接受释放、释放后状态未更新”这条链路定位。先确认源和目标都可见且未被遮挡,再观察页面是否要求特定落点、额外的 dragover 处理或自定义 Pointer Events。
对于普通 DOM 拖放,优先保持“稳定定位器 + dragTo() + 最终状态断言”的组合。只有组件确实依赖特殊移动轨迹、长按或画布坐标时,才需要进一步使用底层鼠标 API。