Puppeteer Mouse 类完全指南坐标移动、点击、滚轮与拖拽的底层实现与实战【免费下载链接】puppeteerJavaScript API for Chrome and Firefox项目地址: https://gitcode.com/GitHub_Trending/puppeteer1/puppeteerPuppeteer 的Mouse类封装了页面级鼠标的模拟能力允许你在页面上按 CSS 像素坐标执行移动、按下/释放按钮、单击、滚轮滚动以及完整的 HTML5 拖拽drag drop操作。本文以 docs/api/puppeteer.mouse.md 为核心骨架结合仓库源码 Input.ts 深入讲解坐标系约定、全部方法签名、可选参数默认值与底层 CDP 指令并给出可复制的画布轨迹、文本选区与缩放页面等实战代码。读完你可以精确控制 Puppeteer 中看不见的鼠标写出接近真实用户交互的自动化脚本。Mouse 类定位与核心坐标系约定在 Puppeteer 中每个page对象都拥有自己独立的 Mouse 实例通过 Page.mouse 属性访问。该类在所有操作中统一使用如下坐标系The Mouse class operates in main-frame CSS pixels relative to the top-left corner of the viewport.也就是说(x, y)坐标是主框架main frame内的 CSS 像素原点为视口左上角。这与 CSS 中getBoundingClientRect()返回的 client 坐标一致——因此在计算元素中心点时可以直接复用元素的 boundingBox 坐标。从类型签名看Mouse是一个抽象基类export declare abstract class Mouse从源码看Puppeteer 正是先在 api/Input.ts 中声明抽象接口再按协议线提供具体实现例如面向 CDP 协议的CdpMouse位于 cdp/Input.ts页面层的abstract get mouse(): Mouse抽象访问器则定义在 api/Page.ts。需要特别说明Mouse 类的构造函数被标记为 internal第三方代码不应直接调用构造函数也不应创建继承Mouse的子类。唯一推荐的使用入口就是page.mouse。全部方法一览Mouse对外暴露 10 个异步方法下表汇总了各自签名与作用方法签名要点作用click(x, y, options?)(x: number, y: number, options?)mouse.move、mouse.down、mouse.up的快捷方式down(options?)(options?: MouseOptions)按下鼠标按钮up(options?)(options?: MouseOptions)释放鼠标按钮move(x, y, options?)(x, y, options?: MouseMoveOptions)把鼠标移动到指定坐标wheel(options?)(options?: MouseWheelOptions)派发mousewheel滚动事件drag(start, target)(Point, Point) PromiseDragData派发drag事件并返回拖拽数据dragEnter(target, data)(Point, DragData)派发dragenter事件dragOver(target, data)(Point, DragData)派发dragover事件drop(target, data)(Point, DragData)依次执行dragenter、dragover、dropdragAndDrop(start, target, options?)(Point, Point, {delay?})依次执行drag、dragenter、dragover、dropreset()()复位鼠标无按钮按下位置回到(0, 0)其中Point类型为{x: number; y: number}详见 puppeteer.point.md。基础操作move / down / up / clickmove平滑移动到目标坐标mouse.move(x, y, options?)把鼠标移动到指定坐标其唯一可选项是 MouseMoveOptionsinterface MouseMoveOptions { steps?: number; // 从当前鼠标位置移动到新位置要分成的步数默认 1 }steps的语义是把整段位移拆成几步逐步移动当steps大于 1 时Puppeteer 会在起点与终点之间插入中间移动这在需要触发页面悬停:hover或逐帧过渡动画、从而更接近真人轨迹的场景中非常有用不传则默认为 1一步直达。down / up按下与释放mouse.down(options?)与mouse.up(options?)分别负责按下与释放鼠标按钮它们共用的选项类型是 MouseOptionsexport interface MouseOptions { /** 决定按下哪个按钮。defaultValue left */ button?: MouseButton; }MouseButton在 api/Input.ts 中被冻结为一个枚举常量对象可选值对应 CDP 协议中的按钮名export const MouseButton Object.freeze({ Left: left, Right: right, Middle: middle, Back: back, Forward: forward, });即默认按下左键需要右键菜单、中键滚轮或前进/后退侧键场景时可显式传入button: right/middle/back/forward。click一键组合mouse.click(x, y, options?)本质上是mouse.move、mouse.down和mouse.up的组合快捷键。其选项类型 MouseClickOptions 在MouseOptions基础上额外增加了两个字段见 api/Input.tsexport interface MouseClickOptions extends MouseOptions { /** 按下后延迟多久再释放毫秒 */ delay?: number; /** 连续点击次数。defaultValue 1 */ count?: number; }delay按下与释放之间的等待毫秒数模拟长按或慢速双击时可设置count点击次数默认 1设置count: 2可派发真正的双击。实战示例用 page.mouse 画一个 100×100 的方块轨迹原文档给出的经典示例是用鼠标在页面上追踪一个正方形——这是理解move/down/up组合的最小完整代码// Using ‘page.mouse’ to trace a 100x100 square. await page.mouse.move(0, 0); await page.mouse.down(); await page.mouse.move(0, 100); await page.mouse.move(100, 100); await page.mouse.move(100, 0); await page.mouse.move(0, 0); await page.mouse.up();这段代码先在(0,0)落下画笔然后依次移动到四个角最后在原点上抬笔。因为按下后持续移动会触发 canvas 的mousemove绘制所以可以用它完成签名画板、白板工具的自动化演示或回归测试。wheel派发滚轮事件mouse.wheel(options?)用于派发mousewheel事件以模拟滚轮滚动选项 MouseWheelOptions 只有两个滚动增量字段export interface MouseWheelOptions { deltaX?: number; deltaY?: number; }deltaY为负表示向上滚动如放大页面为正表示向下滚动。原文档给出了一个真实的缩放元素示例——先把鼠标移动到元素中心再向上滚动实现放大await page.goto( https://mdn.mozillademos.org/en-US/docs/Web/API/Element/wheel_event$samples/Scaling_an_element_via_the_wheel?revision1587366, ); const elem await page.$(div); const boundingBox await elem.boundingBox(); await page.mouse.move( boundingBox.x boundingBox.width / 2, boundingBox.y boundingBox.height / 2, ); await page.mouse.wheel({deltaY: -100});这里注意两点工程细节其一先用boundingBox()拿到元素在视口坐标系中的矩形再取中心点作为滚轮作用位置验证了前面坐标系基于视口 CSS 像素的约定其二wheel的增量不是滚几格而是像素增量通常配合requestAnimationFrame驱动的缩放监听使用。HTML5 拖拽drag / dragEnter / dragOver / drop / dragAndDropHTML5 拖放Drag and Drop依赖DataTransfer对象在dragstart、dragenter、dragover、drop等事件间传递数据。Puppeteer 专门为这类场景提供了一组低层原语需要用到Protocol.Input.DragData即 CDP 协议中Input.dragData包含items与operationsMask等字段mouse.drag(start, target)从start拖到target内部完成一次真实拖动并返回本次拖动的DragData供后续步骤复用mouse.dragEnter(target, data)在target位置派发dragenter事件mouse.dragOver(target, data)在target位置派发dragover事件mouse.drop(target, data)在target位置依次执行dragenter、dragover、dropmouse.dragAndDrop(start, target, options?)把上面四步按顺序拼成一次完整调用。各方法的底层 CDP 指令可在 cdp/Input.ts 中看到均通过Input.dispatchDragEvent派发dragEnter/dragOver/drop事件。dragAndDrop 的 delay 选项dragAndDrop的第三个参数只有一个字段mouse.dragAndDrop(start, target, options?: { /** 在 dragover 与 drop 之间等待的毫秒数。默认 0 */ delay?: number; });delay默认是 0某些页面会在dragover后异步准备放置逻辑此时可以设置delay让drop稍后到达避免因时序问题导致放置失败。若需要对拖起到进入目标的间隙也做更细控制则应使用下面这种拆步方式const data await page.mouse.drag(start, target); // 移动并返回拖拽数据 await page.mouse.dragEnter(target, data); await page.mouse.dragOver(target, data); // 这里可执行其它断言或等待 await page.mouse.drop(target, data);reset一键回到初始状态mouse.reset()会把鼠标恢复到默认状态——没有任何按钮处于按下状态指针位置回到(0, 0)。这在每轮测试用例结束后清理半按住的按钮或游离的指针非常有用避免上一用例的状态泄漏到下一用例。关键限制合成事件 ≠ 真实用户输入原文档明确给出警告这一点务必写进自动化脚本的设计里Note: The mouse events trigger syntheticMouseEvents. This means that it does not fully replicate the functionality of what a normal user would be able to do with their mouse.即page.mouse派发的是合成syntheticMouseEvent并不会完整复刻真实鼠标的所有能力。最典型的例子是用page.mouse拖拽选中文字是不可行的。此时应当改用平台原生能力例如通过DocumentOrShadowRoot.getSelection()构造选区。实战选中两个节点之间的全部文本原文档提供了完整的选区构建示例——利用range.setStartBefore与range.setEndAfter把选区边界锚定在两个节点上await page.evaluate( (from, to) { const selection from.getRootNode().getSelection(); const range document.createRange(); range.setStartBefore(from); range.setEndAfter(to); selection.removeAllRanges(); selection.addRange(range); }, fromJSHandle, toJSHandle, );from、to可以是page.evaluate里返回的 DOM 节点句柄如ElementHandle经序列化后传入。注意getSelection()必须从from.getRootNode()上取以保证在 Shadow DOM 内部也能拿到正确的 selection 对象。实战复制选区内容到剪贴板构造好选区后如果还想把内容复制到剪贴板原文档给出了组合方案。首先要让标签页获得焦点因为剪贴板 API 要求标签页处于聚焦状态// The clipboard api does not allow you to copy, unless the tab is focused. await page.bringToFront(); await page.evaluate(() { // Copy the selected content to the clipboard document.execCommand(copy); // Obtain the content of the clipboard as a string return navigator.clipboard.readText(); });同时读写剪贴板需要显式授权。可以借助browser.defaultBrowserContext().overridePermissions为指定源授予clipboard-read与clipboard-write权限await browser .defaultBrowserContext() .overridePermissions(your origin, [clipboard-read, clipboard-write]);overridePermissions的完整说明见 browsercontext.overridepermissions.md。源码级实现原理从 API 到协议命令为了帮你把 API 层与底层协议对应起来下面补充可验证的源码路径抽象接口层packages/puppeteer-core/src/api/Input.ts 定义了abstract class Mouse的全部抽象方法与MouseButton常量MouseOptions、MouseClickOptions、MouseWheelOptions、MouseMoveOptions四个选项接口也集中在此文件中约 L206-L259。CDP 实现层Chrome/Chromium 等 CDP 协议的浏览器由CdpMouse实现packages/puppeteer-core/src/cdp/Input.ts。可以推断其内部通过this.#client.send(...)调用 CDPInput域命令普通点击/移动路径使用Input.dispatchMouseEventcdp/Input.ts#L374-L470拖拽路径使用Input.dispatchDragEventcdp/Input.ts#L500-L526。页面入口层每个页面对象的鼠标实例通过Page的abstract get mouse(): Mouse获取packages/puppeteer-core/src/api/Page.ts#L2894。从这一分层可以看出 Puppeteer 的设计哲学业务代码只面向page.mouse的稳定抽象 API而具体是走 CDP 的Input.dispatchMouseEvent还是未来其它协议实现都被隔离在Mouse的具体子类中这也是构造函数被标记 internal、禁止第三方继承的原因。小结与最佳实践清单坐标系所有(x, y)都是主框架、相对视口左上角的 CSS 像素可直接与boundingBox()、getBoundingClientRect()的结果对接。组合键与点击click是move down up的快捷键需要延迟释放或双击时用delay/count需要右键等其它按钮时用button。平滑移动move的steps选项可把一次长距离移动切成多步用于触发悬停态与过渡动画。页面缩放 / 长页面滚动用wheel({deltaY})负值向上滚动。HTML5 拖拽优先用dragAndDrop(start, target, {delay})要精细化控制各阶段事件就使用drag→dragEnter→dragOver→drop组合并复用drag返回的DragData。合规预期page.mouse派发的是合成事件无法实现文本拖拽选择这类依赖浏览器原生交互语义的操作需要文本选区与剪贴板时请改用getSelection() Range 剪贴板 API 方案并记得先bringToFront()和授权clipboard-read/clipboard-write。状态清理测试结束后调用mouse.reset()保证指针与按键状态不泄漏。更完整的各方法参数与返回类型可继续查阅 puppeteer.mouse.md 及其关联的 click、down、move、wheel、dragAndDrop 等逐方法 API 文档。【免费下载链接】puppeteerJavaScript API for Chrome and Firefox项目地址: https://gitcode.com/GitHub_Trending/puppeteer1/puppeteer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Puppeteer Mouse 类完全指南：坐标移动、点击、滚轮与拖拽的底层实现与实战
Puppeteer Mouse 类完全指南坐标移动、点击、滚轮与拖拽的底层实现与实战【免费下载链接】puppeteerJavaScript API for Chrome and Firefox项目地址: https://gitcode.com/GitHub_Trending/puppeteer1/puppeteerPuppeteer 的Mouse类封装了页面级鼠标的模拟能力允许你在页面上按 CSS 像素坐标执行移动、按下/释放按钮、单击、滚轮滚动以及完整的 HTML5 拖拽drag drop操作。本文以 docs/api/puppeteer.mouse.md 为核心骨架结合仓库源码 Input.ts 深入讲解坐标系约定、全部方法签名、可选参数默认值与底层 CDP 指令并给出可复制的画布轨迹、文本选区与缩放页面等实战代码。读完你可以精确控制 Puppeteer 中看不见的鼠标写出接近真实用户交互的自动化脚本。Mouse 类定位与核心坐标系约定在 Puppeteer 中每个page对象都拥有自己独立的 Mouse 实例通过 Page.mouse 属性访问。该类在所有操作中统一使用如下坐标系The Mouse class operates in main-frame CSS pixels relative to the top-left corner of the viewport.也就是说(x, y)坐标是主框架main frame内的 CSS 像素原点为视口左上角。这与 CSS 中getBoundingClientRect()返回的 client 坐标一致——因此在计算元素中心点时可以直接复用元素的 boundingBox 坐标。从类型签名看Mouse是一个抽象基类export declare abstract class Mouse从源码看Puppeteer 正是先在 api/Input.ts 中声明抽象接口再按协议线提供具体实现例如面向 CDP 协议的CdpMouse位于 cdp/Input.ts页面层的abstract get mouse(): Mouse抽象访问器则定义在 api/Page.ts。需要特别说明Mouse 类的构造函数被标记为 internal第三方代码不应直接调用构造函数也不应创建继承Mouse的子类。唯一推荐的使用入口就是page.mouse。全部方法一览Mouse对外暴露 10 个异步方法下表汇总了各自签名与作用方法签名要点作用click(x, y, options?)(x: number, y: number, options?)mouse.move、mouse.down、mouse.up的快捷方式down(options?)(options?: MouseOptions)按下鼠标按钮up(options?)(options?: MouseOptions)释放鼠标按钮move(x, y, options?)(x, y, options?: MouseMoveOptions)把鼠标移动到指定坐标wheel(options?)(options?: MouseWheelOptions)派发mousewheel滚动事件drag(start, target)(Point, Point) PromiseDragData派发drag事件并返回拖拽数据dragEnter(target, data)(Point, DragData)派发dragenter事件dragOver(target, data)(Point, DragData)派发dragover事件drop(target, data)(Point, DragData)依次执行dragenter、dragover、dropdragAndDrop(start, target, options?)(Point, Point, {delay?})依次执行drag、dragenter、dragover、dropreset()()复位鼠标无按钮按下位置回到(0, 0)其中Point类型为{x: number; y: number}详见 puppeteer.point.md。基础操作move / down / up / clickmove平滑移动到目标坐标mouse.move(x, y, options?)把鼠标移动到指定坐标其唯一可选项是 MouseMoveOptionsinterface MouseMoveOptions { steps?: number; // 从当前鼠标位置移动到新位置要分成的步数默认 1 }steps的语义是把整段位移拆成几步逐步移动当steps大于 1 时Puppeteer 会在起点与终点之间插入中间移动这在需要触发页面悬停:hover或逐帧过渡动画、从而更接近真人轨迹的场景中非常有用不传则默认为 1一步直达。down / up按下与释放mouse.down(options?)与mouse.up(options?)分别负责按下与释放鼠标按钮它们共用的选项类型是 MouseOptionsexport interface MouseOptions { /** 决定按下哪个按钮。defaultValue left */ button?: MouseButton; }MouseButton在 api/Input.ts 中被冻结为一个枚举常量对象可选值对应 CDP 协议中的按钮名export const MouseButton Object.freeze({ Left: left, Right: right, Middle: middle, Back: back, Forward: forward, });即默认按下左键需要右键菜单、中键滚轮或前进/后退侧键场景时可显式传入button: right/middle/back/forward。click一键组合mouse.click(x, y, options?)本质上是mouse.move、mouse.down和mouse.up的组合快捷键。其选项类型 MouseClickOptions 在MouseOptions基础上额外增加了两个字段见 api/Input.tsexport interface MouseClickOptions extends MouseOptions { /** 按下后延迟多久再释放毫秒 */ delay?: number; /** 连续点击次数。defaultValue 1 */ count?: number; }delay按下与释放之间的等待毫秒数模拟长按或慢速双击时可设置count点击次数默认 1设置count: 2可派发真正的双击。实战示例用 page.mouse 画一个 100×100 的方块轨迹原文档给出的经典示例是用鼠标在页面上追踪一个正方形——这是理解move/down/up组合的最小完整代码// Using ‘page.mouse’ to trace a 100x100 square. await page.mouse.move(0, 0); await page.mouse.down(); await page.mouse.move(0, 100); await page.mouse.move(100, 100); await page.mouse.move(100, 0); await page.mouse.move(0, 0); await page.mouse.up();这段代码先在(0,0)落下画笔然后依次移动到四个角最后在原点上抬笔。因为按下后持续移动会触发 canvas 的mousemove绘制所以可以用它完成签名画板、白板工具的自动化演示或回归测试。wheel派发滚轮事件mouse.wheel(options?)用于派发mousewheel事件以模拟滚轮滚动选项 MouseWheelOptions 只有两个滚动增量字段export interface MouseWheelOptions { deltaX?: number; deltaY?: number; }deltaY为负表示向上滚动如放大页面为正表示向下滚动。原文档给出了一个真实的缩放元素示例——先把鼠标移动到元素中心再向上滚动实现放大await page.goto( https://mdn.mozillademos.org/en-US/docs/Web/API/Element/wheel_event$samples/Scaling_an_element_via_the_wheel?revision1587366, ); const elem await page.$(div); const boundingBox await elem.boundingBox(); await page.mouse.move( boundingBox.x boundingBox.width / 2, boundingBox.y boundingBox.height / 2, ); await page.mouse.wheel({deltaY: -100});这里注意两点工程细节其一先用boundingBox()拿到元素在视口坐标系中的矩形再取中心点作为滚轮作用位置验证了前面坐标系基于视口 CSS 像素的约定其二wheel的增量不是滚几格而是像素增量通常配合requestAnimationFrame驱动的缩放监听使用。HTML5 拖拽drag / dragEnter / dragOver / drop / dragAndDropHTML5 拖放Drag and Drop依赖DataTransfer对象在dragstart、dragenter、dragover、drop等事件间传递数据。Puppeteer 专门为这类场景提供了一组低层原语需要用到Protocol.Input.DragData即 CDP 协议中Input.dragData包含items与operationsMask等字段mouse.drag(start, target)从start拖到target内部完成一次真实拖动并返回本次拖动的DragData供后续步骤复用mouse.dragEnter(target, data)在target位置派发dragenter事件mouse.dragOver(target, data)在target位置派发dragover事件mouse.drop(target, data)在target位置依次执行dragenter、dragover、dropmouse.dragAndDrop(start, target, options?)把上面四步按顺序拼成一次完整调用。各方法的底层 CDP 指令可在 cdp/Input.ts 中看到均通过Input.dispatchDragEvent派发dragEnter/dragOver/drop事件。dragAndDrop 的 delay 选项dragAndDrop的第三个参数只有一个字段mouse.dragAndDrop(start, target, options?: { /** 在 dragover 与 drop 之间等待的毫秒数。默认 0 */ delay?: number; });delay默认是 0某些页面会在dragover后异步准备放置逻辑此时可以设置delay让drop稍后到达避免因时序问题导致放置失败。若需要对拖起到进入目标的间隙也做更细控制则应使用下面这种拆步方式const data await page.mouse.drag(start, target); // 移动并返回拖拽数据 await page.mouse.dragEnter(target, data); await page.mouse.dragOver(target, data); // 这里可执行其它断言或等待 await page.mouse.drop(target, data);reset一键回到初始状态mouse.reset()会把鼠标恢复到默认状态——没有任何按钮处于按下状态指针位置回到(0, 0)。这在每轮测试用例结束后清理半按住的按钮或游离的指针非常有用避免上一用例的状态泄漏到下一用例。关键限制合成事件 ≠ 真实用户输入原文档明确给出警告这一点务必写进自动化脚本的设计里Note: The mouse events trigger syntheticMouseEvents. This means that it does not fully replicate the functionality of what a normal user would be able to do with their mouse.即page.mouse派发的是合成syntheticMouseEvent并不会完整复刻真实鼠标的所有能力。最典型的例子是用page.mouse拖拽选中文字是不可行的。此时应当改用平台原生能力例如通过DocumentOrShadowRoot.getSelection()构造选区。实战选中两个节点之间的全部文本原文档提供了完整的选区构建示例——利用range.setStartBefore与range.setEndAfter把选区边界锚定在两个节点上await page.evaluate( (from, to) { const selection from.getRootNode().getSelection(); const range document.createRange(); range.setStartBefore(from); range.setEndAfter(to); selection.removeAllRanges(); selection.addRange(range); }, fromJSHandle, toJSHandle, );from、to可以是page.evaluate里返回的 DOM 节点句柄如ElementHandle经序列化后传入。注意getSelection()必须从from.getRootNode()上取以保证在 Shadow DOM 内部也能拿到正确的 selection 对象。实战复制选区内容到剪贴板构造好选区后如果还想把内容复制到剪贴板原文档给出了组合方案。首先要让标签页获得焦点因为剪贴板 API 要求标签页处于聚焦状态// The clipboard api does not allow you to copy, unless the tab is focused. await page.bringToFront(); await page.evaluate(() { // Copy the selected content to the clipboard document.execCommand(copy); // Obtain the content of the clipboard as a string return navigator.clipboard.readText(); });同时读写剪贴板需要显式授权。可以借助browser.defaultBrowserContext().overridePermissions为指定源授予clipboard-read与clipboard-write权限await browser .defaultBrowserContext() .overridePermissions(your origin, [clipboard-read, clipboard-write]);overridePermissions的完整说明见 browsercontext.overridepermissions.md。源码级实现原理从 API 到协议命令为了帮你把 API 层与底层协议对应起来下面补充可验证的源码路径抽象接口层packages/puppeteer-core/src/api/Input.ts 定义了abstract class Mouse的全部抽象方法与MouseButton常量MouseOptions、MouseClickOptions、MouseWheelOptions、MouseMoveOptions四个选项接口也集中在此文件中约 L206-L259。CDP 实现层Chrome/Chromium 等 CDP 协议的浏览器由CdpMouse实现packages/puppeteer-core/src/cdp/Input.ts。可以推断其内部通过this.#client.send(...)调用 CDPInput域命令普通点击/移动路径使用Input.dispatchMouseEventcdp/Input.ts#L374-L470拖拽路径使用Input.dispatchDragEventcdp/Input.ts#L500-L526。页面入口层每个页面对象的鼠标实例通过Page的abstract get mouse(): Mouse获取packages/puppeteer-core/src/api/Page.ts#L2894。从这一分层可以看出 Puppeteer 的设计哲学业务代码只面向page.mouse的稳定抽象 API而具体是走 CDP 的Input.dispatchMouseEvent还是未来其它协议实现都被隔离在Mouse的具体子类中这也是构造函数被标记 internal、禁止第三方继承的原因。小结与最佳实践清单坐标系所有(x, y)都是主框架、相对视口左上角的 CSS 像素可直接与boundingBox()、getBoundingClientRect()的结果对接。组合键与点击click是move down up的快捷键需要延迟释放或双击时用delay/count需要右键等其它按钮时用button。平滑移动move的steps选项可把一次长距离移动切成多步用于触发悬停态与过渡动画。页面缩放 / 长页面滚动用wheel({deltaY})负值向上滚动。HTML5 拖拽优先用dragAndDrop(start, target, {delay})要精细化控制各阶段事件就使用drag→dragEnter→dragOver→drop组合并复用drag返回的DragData。合规预期page.mouse派发的是合成事件无法实现文本拖拽选择这类依赖浏览器原生交互语义的操作需要文本选区与剪贴板时请改用getSelection() Range 剪贴板 API 方案并记得先bringToFront()和授权clipboard-read/clipboard-write。状态清理测试结束后调用mouse.reset()保证指针与按键状态不泄漏。更完整的各方法参数与返回类型可继续查阅 puppeteer.mouse.md 及其关联的 click、down、move、wheel、dragAndDrop 等逐方法 API 文档。【免费下载链接】puppeteerJavaScript API for Chrome and Firefox项目地址: https://gitcode.com/GitHub_Trending/puppeteer1/puppeteer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
