troubleshooting.md

Troubleshooting

Having a little trouble with the MFTF? See some common errors and fixes below.

AcceptanceTester class issues

If you see the following error:

AcceptanceTester class doesn't exist in suite folder.
Run the 'build' command to generate it

Reason

Something went wrong during the mftf build:project command that prevented the creation of the AcceptanceTester class.

Solution

This issue is fixed in the MFTF 2.5.0.

In versions of the MFTF lower than 2.5.0 you should:

1. Open the functional.suite.yml file at:

   <magento root directory>/dev/tests/acceptance/tests/functional.suite.yml
   

2. Add quotation marks (") around these values:

   1. %SELENIUM_HOST%
   2. %SELENIUM_PORT%
   3. %SELENIUM_PROTOCOL%
   4. %SELENIUM_PATH%

3. Run the vendor/bin/mftf build:project command again.

4. You should see the AcceptanceTester class is created at:

   <magento root directory>/vendor/magento/magento2-functional-testing-framework/src/Magento/FunctionalTestingFramework/AcceptanceTester.php
   

WebDriver issues

Troubleshoot your WebDriver issues on various browsers.

PhantomJS

You are unable to upload file input using the MFTF actions and are seeing the following exception:

[Facebook\WebDriver\Exception\NoSuchDriverException]
No active session with ID e56f9260-b366-11e7-966b-db3e6f35d8e1

Reason

Use of PhantomJS is not supported by the MFTF.

Solution

For headless browsing, the Headless Chrome{:target="_blank"} has better compatibility with the MFTF.