Playwright 1.40 无专用拖拽文件API，需用dispatch_event()手动触发dragenter/dragover/drop三件套事件，且必须显式传入含绝对路径的dataTransfer.files，并注意目标元素和事件时机。
Playwright 1.40 并未引入专门针对文件拖拽的“新特性”——它压根没提供 drag_and_drop_file 或类似高层 API。所谓“轻松处理”，其实是靠底层能力组合实现，且容易在路径、事件时机、元素状态上翻车。
为什么 set_input_files() 不能直接用于拖拽场景
很多开发者看到文档里 set_input_files() 能上传，就以为它能模拟拖入动作。但这是两回事：set_input_files() 是直接向 <input type="file"> 写入文件路径，绕过了 dragenter/dragover/drop 等 DOM 事件流。如果页面逻辑依赖监听 drop 事件（比如带预览、校验、分片上传的组件），这个方法完全无效。
实操建议：
- 先用浏览器 DevTools 检查目标区域是否绑定了
drop或dragover监听器（Elements → Event Listeners 面板） - 若存在，必须触发真实拖拽事件链，不能跳过
-
set_input_files()只适用于传统表单提交式上传，别混用
用 dispatch_event() 手动触发拖拽三件套
Playwright 1.40 支持通过 dispatch_event() 向任意元素注入原生事件。拖拽文件本质是三个连续事件：dragenter → dragover → drop。关键不是“怎么发”，而是“发给谁”和“数据怎么塞”。
立即学习“Python免费学习笔记（深入）”；
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
常见错误现象：控制台报 TypeError: Failed to execute 'setData' on 'DataTransfer': Cannot set data without a drag data store —— 这是因为 Playwright 默认不初始化 DataTransfer 对象。
实操建议：
- 必须用
element.dispatch_event("dragenter", {"dataTransfer": {"files": ["/path/to/file.pdf"]}})显式传入dataTransfer.files -
dragover事件必须紧随其后，且同样携带dataTransfer，否则浏览器会取消后续 drop -
drop事件的dataTransfer.files必须是绝对路径，且文件需真实存在（Playwright 不帮你读取内容，只透传路径） - 各事件间加
await page.wait_for_timeout(50)，避免被浏览器合并或丢弃
拖拽目标不是 <input>，而是任意 DOM 元素时的坑
现代上传组件（如 Ant Design Upload、Element Plus Upload）通常把拖拽区做成 <div> 或 <code><section></section>，内部隐藏 <input type="file">。这时候你不能对 <input> 调用 set_input_files()，而必须对可见的拖拽容器 dispatch 事件。
性能与兼容性影响：
- 某些前端框架（如 Vue 3 + Composition API）会用
event.preventDefault()在dragover中阻止默认行为，这是合法的，但意味着你必须确保 dispatch 的dragover也带preventDefault标志（Playwright 1.40 不支持，得靠 JS 注入） - 推荐写法：
await element.evaluate((el, filePath) => { const dt = new DataTransfer(); dt.items.add(new File([], filePath)); const event = new DragEvent("drop", { dataTransfer: dt }); el.dispatchEvent(event); }, "/abs/path/file.jpg") - 注意：
File构造函数第二个参数是文件名，不是路径；真实文件内容不会被加载，仅用于触发逻辑
真正难的不是调哪个 API，而是搞清目标页面到底监听了哪些事件、是否修改了 DataTransfer、有没有阻止默认行为。每次换一个 UI 库，拖拽上传的适配方式都可能不同——别信“通用封装”，老老实实 inspect + log + retry。
