自动化测试 / 系统课时

执行拖拽操作

执行拖拽操作

拖拽测试的关键不是“把鼠标从 A 移到 B”,而是让页面真实经历源元素按下、移动到目标区域并释放的交互。本节使用 Locator.dragTo() 完成常规拖放,并通过目标区域的最终状态判断操作是否真正生效。

学习目标

  • 使用 Locator.dragTo() 在源元素与目标区域之间执行拖放。
  • 用页面状态断言验证拖拽结果,而不是只判断调用是否报错。
  • 识别拖拽位置、可操作性检查和自定义交互造成的常见失败。

用 Locator 表达源与目标

常规拖放优先使用 Locator,而不是手工计算整条鼠标轨迹。先分别定位可拖动元素和接收区域,再由源 Locator 调用 dragTo()。Playwright 会围绕这两个元素执行拖拽动作,因此定位器稳定性直接决定测试稳定性。

下面的测试用本地 HTML 构造一个独立场景:源元素带有 draggable 属性,目标区域在收到 drop 后更新文本。测试最后断言目标文本,确认业务状态确实发生变化。

ts
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());
});

预期输出

text
已放置

测试运行器还会输出用例名称和耗时等信息;这里列出的是该示例通过 console.log 产生的关键结果。

控制起点与落点

默认情况下,dragTo() 会在源元素和目标元素的可见区域内选择可操作位置。对于棋盘、排序列表或只接受局部落点的组件,可以使用 sourcePosition 和 targetPosition 指定相对元素左上角的坐标,让按下点和释放点落在业务要求的位置。

位置参数应该服务于真实交互规则,而不是用来掩盖错误定位。如果测试必须依赖大量精确坐标,先确认页面是否提供了更稳定的角色、文本、测试 ID 或可定位子元素。

拖拽失败时检查动作链

拖拽失败通常沿着“源元素不可操作、移动未触发组件逻辑、目标区域不接受释放、释放后状态未更新”这条链路定位。先确认源和目标都可见且未被遮挡,再观察页面是否要求特定落点、额外的 dragover 处理或自定义 Pointer Events。

对于普通 DOM 拖放,优先保持“稳定定位器 + dragTo() + 最终状态断言”的组合。只有组件确实依赖特殊移动轨迹、长按或画布坐标时,才需要进一步使用底层鼠标 API。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

执行拖拽操作

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通