Firefox launch geckodriver dependency information

[MikeMcC399]

Situation

[email protected] notes

Cypress now consumes geckodriver to help automate the Firefox browser instead of marionette-client. Addresses #30217.

The mozilla/geckodriver is required to test Firefox. It is not part of the Firefox distribution, nor is it included in Cypress. If the driver is unavailable, then testing against Firefox fails.

This is not mentioned in References > Launching Browsers > Firefox Browsers.

Suggestion

Add an explanation about the use of mozilla/geckodriver and the npm wrapper package geckodriver to References > Launching Browsers > Firefox Browsers and explain how to test with Firefox and without a network connection.

Related

• Cypress tests fail in air-gapped network on Firefox cypress#31036 (comment)
• Cypress tests fail in air-gapped network on Firefox cypress-docker-images#1298
• Cypress cannot open firefox - getaddrinfo EAI_AGAIN error cypress#31230
• Allow Disabling Automated Firefox Extension Installation via Cypress Env Variable cypress#31316

[MikeMcC399]

I will follow up with a suggestion for documentation.

• I also plan to submit a PR to implement Add geckodriver to factory process cypress-docker-images#1351 as the first stage to automate the installation of geckodriver in Cypress Docker images. This would be a good base to add documentation as it would simplify the description of what to do.