Update on Sauce Labs Compatibility with Firefox GeckoDriver Version 0.31.0

If you run cross-browser tests on Firefox using Sauce Labs, please read on for an important update.

What Happened?

Mozilla recently removed the ability to pass the capability --remote-debugging-port in Firefox GeckoDriver version 0.31.0. 

What Do You Need to Know?

On October 4, 2022, Sauce Labs will update the supported Firefox GeckoDriver to version 0.31.0 for tests on Firefox versions 90 and later. If you use the –remote-debugging-port capability, your tests will fail if you do not take action before October 4, 2022.

How to Update Your Firefox Tests

Before October 4, 2022, update your Firefox tests to use the supported capability moz:debuggerAddress.

Java example:

FirefoxOptions browserOptions = new FirefoxOptions(); browserOptions.setPlatformName("Windows 10"); browserOptions.setBrowserVersion("latest"); browserOptions.setCapability("moz:debuggerAddress", true);

How to Check if Your Test is Compatible

To test your changes and ensure compatibility against Firefox GeckoDriver version 0.31.0 before the October 4 update, use the Sauce capability geckodriverVersion in your sauce:options to specify Firefox GeckoDriver version 0.31.0.

Java example:

FirefoxOptions browserOptions = new FirefoxOptions(); Map<String, Object> sauceOptions = new HashMap<>(); sauceOptions.put("geckodriverVersion", "0.31.0"); browserOptions.setCapability("sauce:options", sauceOptions);

You can also use the Sauce Labs Platform Configurator to see how to set capabilities in different programming languages.

Please contact Michelle Chen with any questions.