Selenium-Java 3.11中如何为GeckoDriver添加DesiredCapabilities

嘿，我刚好碰到过类似的问题！从Selenium 3.x版本开始，直接通过new FirefoxDriver(capabilities)传入DesiredCapabilities的构造方法确实已经被废弃了，官方现在推荐用FirefoxOptions来管理浏览器的所有配置项——不管是原来的DesiredCapabilities还是Firefox专属的偏好设置，都可以通过它来实现。

下面给你两种贴合你代码场景的可行方案：

方案1：将已有的DesiredCapabilities合并到FirefoxOptions中 #

如果你已经写好了DesiredCapabilities的配置，可以通过merge()方法把它合并到FirefoxOptions里，不用改动太多原有代码：

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;
import org.openqa.selenium.firefox.FirefoxOptions;
import org.openqa.selenium.remote.DesiredCapabilities;

public static WebDriver createDriver(String userAgentKey) {
    // 初始化你的DesiredCapabilities配置
    DesiredCapabilities capabilities = DesiredCapabilities.firefox();
    // 示例：设置user-agent、启用Marionette驱动等
    capabilities.setCapability("marionette", true);
    capabilities.setCapability("general.useragent.override", userAgentKey);
    // 其他你需要的capability都可以在这里添加

    // 关键步骤：把capabilities合并到FirefoxOptions
    FirefoxOptions options = new FirefoxOptions();
    options.merge(capabilities);

    // 用FirefoxOptions初始化驱动
    WebDriver driver = new FirefoxDriver(options);
    return driver;
}

方案2：直接用FirefoxOptions配置（更推荐） #

官方更推荐直接使用FirefoxOptions来设置所有参数，代码更直观，也更符合后续版本的设计方向：

import org.openqa.selenium.WebDriver;
import org.openqa.selenium.firefox.FirefoxDriver;
import org.openqa.selenium.firefox.FirefoxOptions;

public static WebDriver createDriver(String userAgentKey) {
    FirefoxOptions options = new FirefoxOptions();
    
    // 设置Marionette驱动（Firefox 59默认启用，但显式设置更稳妥）
    options.setCapability("marionette", true);
    // 设置自定义user-agent
    options.addPreference("general.useragent.override", userAgentKey);
    // 示例：添加其他配置，比如允许不安全证书
    options.setCapability("acceptInsecureCerts", true);
    // 更多Firefox专属偏好可以用addPreference()设置

    // 初始化驱动
    WebDriver driver = new FirefoxDriver(options);
    return driver;
}

补充说明 #

• Firefox 59及以上版本默认使用Marionette驱动，marionette这个capability可以不用强制设置，但显式声明能避免一些版本兼容问题；
• 如果需要设置Firefox的专属配置（比如浏览器偏好），用options.addPreference()是更直接的方式，比通过DesiredCapabilities传递更清晰；
• 这种方式完全兼容Selenium 3.11版本，同时也能适配更高版本的Selenium和Firefox。

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