Java Selenium Edge WebDriver自定义目录下载Excel遇方法未定义错误

问题描述 #

尝试通过Java Selenium Edge WebDriver将Excel文件下载到指定自定义文件夹，但文件始终下载到默认路径，且执行代码时出现报错：

The method setExperimentalOption(String, HashMap<String, Object>) is undefined for the type EdgeOptions

原尝试代码：

HashMap<String, Object> edgePrefs = new HashMap<>(); 
edgePrefs.put("download.default_directory", System.getProperty("user.dir") + "\Download-Files");
edgePrefs.put("profile.default_content_settings.popups", 0);
edgePrefs.put("profile.default_content_setting_values.automatic_downloads", 1); 
EdgeOptions options = new EdgeOptions();
options.setExperimentalOption("prefs", edgePrefs);

问题原因 #

1. API过时：新版Selenium（尤其是Selenium 4+）配合EdgeDriver时，EdgeOptions类已移除setExperimentalOption方法，需使用兼容的API设置下载偏好。
2. 路径转义错误：代码中使用单个反斜杠\作为路径分隔符，会被Java解析为转义字符，导致实际路径无效。

解决方案 #

方案一：使用setDownloadPath（推荐，Selenium 4.0+适用） #

该方法是EdgeOptions提供的原生下载路径设置API，简洁且兼容最新版本：

import org.openqa.selenium.edge.EdgeOptions;
import java.io.File;

public class EdgeDownloadConfig {
    public static void main(String[] args) {
        // 构建自定义下载路径，使用File.separator保证跨平台兼容
        String downloadDir = System.getProperty("user.dir") + File.separator + "Download-Files";
        
        // 自动创建文件夹（如果不存在）
        File downloadFolder = new File(downloadDir);
        if (!downloadFolder.exists()) {
            downloadFolder.mkdirs();
        }

        EdgeOptions options = new EdgeOptions();
        // 设置下载路径
        options.setDownloadPath(downloadDir);
        // 禁用弹窗拦截、允许自动下载
        options.addArguments("--disable-popup-blocking");
        options.addArguments("--allow-automatic-downloads");

        // 初始化EdgeDriver
        // EdgeDriver driver = new EdgeDriver(options);
    }
}

方案二：使用setCapability（兼容旧版本） #

如果使用的是较旧版本的Selenium或EdgeDriver，可通过setCapability传递下载偏好：

import org.openqa.selenium.edge.EdgeOptions;
import java.util.HashMap;
import java.io.File;

public class EdgeDownloadConfig {
    public static void main(String[] args) {
        String downloadDir = System.getProperty("user.dir") + File.separator + "Download-Files";
        File downloadFolder = new File(downloadDir);
        if (!downloadFolder.exists()) {
            downloadFolder.mkdirs();
        }

        HashMap<String, Object> edgePrefs = new HashMap<>();
        edgePrefs.put("download.default_directory", downloadDir);
        edgePrefs.put("profile.default_content_settings.popups", 0);
        edgePrefs.put("profile.default_content_setting_values.automatic_downloads", 1);

        EdgeOptions options = new EdgeOptions();
        // 用setCapability替代过时的setExperimentalOption
        options.setCapability("ms:edgeOptions", edgePrefs);

        // EdgeDriver driver = new EdgeDriver(options);
    }
}

注意事项 #

• 确保Selenium与EdgeDriver版本严格匹配，版本不兼容会导致API调用失败。
• 路径分隔符统一使用File.separator或双反斜杠\\，避免转义错误。
• 若仍存在问题，可检查Edge浏览器的默认下载设置是否被浏览器自身配置覆盖。

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