如何在JavaScript + Selenium中实现元素悬停？报错求助

问题根源 #

你遇到的TypeError: driver.actions(...).moveToElement is not a function报错，是因为Selenium 4.x版本重构了Actions API，原有的moveToElement方法被移除，替换为更简洁的moveTo方法，同时旧版本的{ bridge: true }参数也不再需要。

正确实现代码 #

基础悬停（无偏移） #

先确保你已经正确定位到目标元素task（需是已解析的WebElement对象，而非Promise），然后使用以下代码：

// 先定位元素（示例）
const task = await driver.findElement(By.css('.task-selector'));
// 执行悬停
await driver.actions().moveTo(task).perform();

带偏移量的悬停（可选） #

如果需要将鼠标悬停在元素的指定坐标（相对于元素左上角），可以传入偏移参数：

// xOffset: 水平偏移量，yOffset: 垂直偏移量
await driver.actions().moveTo(task, 10, 10).perform();

额外注意事项 #

• 元素定位必须完成：确保task是通过await解析后的WebElement，不能直接使用未等待的driver.findElement()返回的Promise，否则会导致动作执行失败。
• Headless模式兼容：如果在无头模式下运行浏览器（如Chrome），需使用新版无头模式参数--headless=new，旧版--headless不支持鼠标交互动作：

const chromeOptions = new chrome.Options().addArguments('--headless=new');
const driver = await new Builder().forBrowser('chrome').setChromeOptions(chromeOptions).build();

内容的提问来源于stack exchange，提问作者vdkmvx