Use lullabot/mink-selenium2-driver and lullabot/php-webdriver for functional browser testing

Created on 5 October 2021, about 3 years ago
Updated 1 April 2024, 9 months ago

Problem/Motivation

Proposed resolution

  • Change our code to use lullabot/php-webdriver & lullabot/mink-selenium2-driver

This prepares the project to move to W3C compliant testing in 📌 Use selenium/standalone-chrome instead of our chromedriver image Needs work . The lullabot driver has supports both W3C and non-W3C modes. In this issue we continue to use a the non-W3C mode and will explore moving to W3C mode testing the aforementioned issue.

Remaining tasks

User interface changes

None

API changes

This issue deprecates support for the chromeOptions key in MINK_DRIVER_ARGS_WEBDRIVER. It is replaced by goog:chromeOptions.

Data model changes

None

Release notes snippet

The chromeOptions key in MINK_DRIVER_ARGS_WEBDRIVER should be renamed goog:chromeOptions.

Dependency evaluations

📌 Task
Status

Fixed

Version

10.3

Component
PHPUnit 

Last updated about 22 hours ago

Created by

🇬🇧United Kingdom alexpott 🇪🇺🌍

Live updates comments and jobs are added and updated live.
  • PHP 8.1

    The issue particularly affects sites running on PHP version 8.1.0 or later.

Sign in to follow issues

Merge Requests

Comments & Activities

Not all content is available!

It's likely this issue predates Contrib.social: some issue and comment data are missing.

  • 🇬🇧United Kingdom justafish London, UK

    I've been working on a drop-in replacement for instaclick/php-webdriver https://github.com/Lullabot/drupal-webdriver/pull/1

  • 🇬🇧United Kingdom justafish London, UK
  • 🇬🇧United Kingdom justafish London, UK

    PR to minkphp/MinkSelenium2Driver for W3C compatibility fixes: https://github.com/minkphp/MinkSelenium2Driver/pull/372

  • Pipeline finished with Failed
    12 months ago
    #74623
  • Pipeline finished with Canceled
    11 months ago
    #84103
  • Pipeline finished with Canceled
    11 months ago
    Total: 1315s
    #84124
  • Pipeline finished with Canceled
    11 months ago
    #84137
  • Pipeline finished with Failed
    11 months ago
    Total: 2440s
    #84145
  • Pipeline finished with Canceled
    11 months ago
    Total: 706s
    #84254
  • Pipeline finished with Failed
    11 months ago
    Total: 1545s
    #84268
  • Pipeline finished with Failed
    11 months ago
    Total: 527206s
    #84855
  • Pipeline finished with Failed
    11 months ago
    Total: 674s
    #88287
  • Pipeline finished with Failed
    11 months ago
    Total: 731s
    #88300
  • Pipeline finished with Failed
    11 months ago
    Total: 688s
    #89704
  • Pipeline finished with Canceled
    11 months ago
    Total: 652s
    #90578
  • Pipeline finished with Failed
    11 months ago
    Total: 698s
    #90588
  • Pipeline finished with Failed
    11 months ago
    Total: 1189s
    #90630
  • Pipeline finished with Failed
    11 months ago
    Total: 1199s
    #91377
  • Pipeline finished with Failed
    11 months ago
    #91531
  • Pipeline finished with Failed
    11 months ago
    Total: 1256s
    #91626
  • Pipeline finished with Failed
    11 months ago
    Total: 1020s
    #92065
  • Pipeline finished with Success
    11 months ago
    Total: 654s
    #92071
  • Pipeline finished with Failed
    11 months ago
    Total: 742s
    #92145
  • Pipeline finished with Failed
    11 months ago
    Total: 708s
    #92152
  • Pipeline finished with Canceled
    10 months ago
    Total: 771s
    #92869
  • Pipeline finished with Canceled
    10 months ago
    Total: 157s
    #92880
  • Pipeline finished with Failed
    10 months ago
    #92883
  • Pipeline finished with Success
    10 months ago
    Total: 686s
    #92902
  • 🇬🇧United Kingdom justafish London, UK
  • 🇬🇧United Kingdom justafish London, UK
  • 🇬🇧United Kingdom justafish London, UK
  • 🇬🇧United Kingdom justafish London, UK
  • Status changed to Needs review 10 months ago
  • 🇬🇧United Kingdom justafish London, UK
  • Pipeline finished with Canceled
    10 months ago
    #92973
  • Pipeline finished with Failed
    10 months ago
    Total: 750s
    #92976
  • Pipeline finished with Success
    10 months ago
    Total: 623s
    #93011
  • Pipeline finished with Failed
    10 months ago
    Total: 668s
    #93018
  • Pipeline finished with Success
    10 months ago
    Total: 761s
    #93083
  • Pipeline finished with Success
    10 months ago
    Total: 701s
    #93089
  • 🇬🇧United Kingdom justafish London, UK

    Ready for review - I did try and pull in the library changes separately (starting from https://git.drupalcode.org/project/drupal/-/commit/557a63899eacf28a117e7... in this MR), over in https://www.drupal.org/project/drupal/issues/3407834 📌 Update Behat from 1.10 to 1.11 Active but I think it's going to be a lot of extra unnecessary work fixing the tests and then re-fixing them as soon as we come back here, that given how small the changeset for this is I don't think it's worth splitting up

  • Pipeline finished with Failed
    10 months ago
    Total: 514s
    #93148
  • Pipeline finished with Failed
    10 months ago
    Total: 170s
    #93158
  • Pipeline finished with Canceled
    10 months ago
    Total: 670s
    #93166
  • Pipeline finished with Failed
    10 months ago
    Total: 674s
    #93173
  • Pipeline finished with Success
    10 months ago
    Total: 633s
    #93181
  • 🇬🇧United Kingdom alexpott 🇪🇺🌍

    alexpott changed the visibility of the branch 3240792-use-php-webdriverwebdriver- to hidden.

  • 🇬🇧United Kingdom alexpott 🇪🇺🌍

    alexpott changed the visibility of the branch 11.x to hidden.

  • 🇬🇧United Kingdom alexpott 🇪🇺🌍

    alexpott changed the visibility of the branch 9.3.x to hidden.

  • Merge request !6578Resolve #3240792 "Lullabot on top of 3407834" → (Closed) created by alexpott
  • 🇬🇧United Kingdom alexpott 🇪🇺🌍

    Crediting @justafish for all the work to get this issue progressing. Nice one.

  • Pipeline finished with Failed
    10 months ago
    Total: 619s
    #93924
  • 🇺🇸United States smustgrave

    @alexpott could you rerun that javascript test please

  • 🇬🇧United Kingdom alexpott 🇪🇺🌍

    Discussed with @justafish - we agreed to split this issue into 2.

    This issue will move us to using a W3C driver for JS testing and then a follow-up issue will look at swapping out our chromedriver image for a selenium standalone image.

    Will create an MR with the minimum change for us to use the W3C driver from lullabot.

  • Merge request !6583Resolve #3240792 "Lullabot only" → (Closed) created by alexpott
  • 🇬🇧United Kingdom alexpott 🇪🇺🌍

    Created the issue to use selenium/standalone-chrome - see 📌 Use selenium/standalone-chrome instead of our chromedriver image Needs work ... going to close the other MRs here and move the bulk of that work over then.

  • 🇬🇧United Kingdom alexpott 🇪🇺🌍

    The one thing I'm wondering here is should we use a composer replace here to indicate that the lullabot dependencies replace the other ones... not sure.

  • 🇬🇧United Kingdom alexpott 🇪🇺🌍

    The lullabot deps already ship with replace sections so #39 is moot. Nice.

  • 🇺🇸United States smustgrave

    Before marking can change record/release notes be added

  • Status changed to Needs work 10 months ago
  • 🇬🇧United Kingdom longwave UK

    Some nits, and yeah it needs a change record and release note.

  • Status changed to Needs review 10 months ago
  • 🇬🇧United Kingdom alexpott 🇪🇺🌍

    I've resolved @longwave's feedback but I have some concerns that we have failures on a more recent chromedriver than the one we're currently using. Moving to https://hub.docker.com/r/justafish/chromedriver/tags to prove this.

  • Status changed to Needs work 10 months ago
  • 🇦🇺Australia mstrelan

    Assume we need to set w3c: true and possibly other things in core/tests/Drupal/Nightwatch/nightwatch.conf.js.

  • Pipeline finished with Failed
    10 months ago
    Total: 205s
    #95774
  • Pipeline finished with Canceled
    10 months ago
    Total: 499s
    #95781
  • Pipeline finished with Failed
    10 months ago
    Total: 340s
    #95792
  • Pipeline finished with Success
    10 months ago
    Total: 479s
    #95790
  • Pipeline finished with Failed
    10 months ago
    Total: 1424s
    #95798
  • Pipeline finished with Failed
    10 months ago
    Total: 160s
    #95816
  • Pipeline finished with Failed
    10 months ago
    Total: 462s
    #95924
  • Pipeline finished with Failed
    10 months ago
    Total: 628s
    #95982
  • Pipeline finished with Success
    10 months ago
    #95993
  • Status changed to Needs review 10 months ago
  • 🇬🇧United Kingdom alexpott 🇪🇺🌍

    Updated issue summary and title inline with current approach on the MR.

    Note we will need to fix https://github.com/Lullabot/php-webdriver/pull/9 before we can get a green run.

  • Pipeline finished with Success
    10 months ago
    #99826
  • Status changed to RTBC 10 months ago
  • 🇺🇸United States smustgrave

    Read both change record and release notes and seem straight forward, so removing those tags

    Trying my best to review MR

    Applied locally and still seem to be able to run tests in phpstorm. Deprecation link work.

    Think this is good. Should it be tagged 10.3 highlight?

  • Status changed to Needs work 10 months ago
  • 🇬🇧United Kingdom longwave UK

    Via @alexpott in Slack

    Been thinking about the deprecation - wanna move it to somewhere better.

  • 🇫🇷France andypost

    Curious is there a way to measure effect of changing driver's protocol?

  • 🇬🇧United Kingdom alexpott 🇪🇺🌍

    @andypost we've not changed the protocol in this issue. W3C is set to false by default here. This is about getting the dependency change done. Chromedriver doesn't care whether you use W3C commands whatever W3C is set to. So in order to prove we're using W3C we have to do 📌 Use selenium/standalone-chrome instead of our chromedriver image Needs work or something similar.

  • Status changed to Needs review 10 months ago
  • 🇬🇧United Kingdom alexpott 🇪🇺🌍

    @smustgrave this is not a highlight yet. We need to fix the underlying Drupal tests to be W3C compatible.

    Moved deprecation to WebDriverTestBase - this will allow us to differentiate between core and custom/contrib tests in the future which might make things easier.

  • 🇫🇷France andypost

    Added comment, probably the TODO needs link

  • 🇬🇧United Kingdom alexpott 🇪🇺🌍

    Addressed @andypost's review

  • Status changed to RTBC 10 months ago
  • 🇫🇷France andypost

    Suppose it ready

  • 🇳🇱Netherlands spokje

    New dependencies require an evaluation: https://www.drupal.org/about/core/policies/core-dependency-policies/depe...

    Does this also need to happen when swapping one dependency for another?

  • Status changed to Needs work 10 months ago
  • 🇬🇧United Kingdom longwave UK

    Yup we should also do a quick dependency evaluation and add it to https://www.drupal.org/about/core/policies/core-dependency-policies-and-... (seems the existing packages are not there, but that shouldn't stop us adding these ones)

    @justafish I assume you/Lullabot are OK to continue maintaining these packages as needed and also handle any security reports?

  • Status changed to RTBC 10 months ago
  • 🇬🇧United Kingdom alexpott 🇪🇺🌍

    Added dependency evaluations. As dev dependencies that are only used for testing I'm not sure that having a security policy is that important. Also in mitigation @justafish is granting access to the repository for me and @longwave - so two Drupal security team members have access.

  • 🇬🇧United Kingdom justafish London, UK

    Yes we're ok to continue maintaining and handle security reports - I've also added longwave and alexpott as maintainers to the repository

  • Pipeline finished with Success
    10 months ago
    Total: 554s
    #113886
    • catch committed ec1aa07a on 10.3.x
      Issue #3240792 by justafish, alexpott, andypost, smustgrave, longwave:...
    • catch committed 5927d8fe on 11.x
      Issue #3240792 by justafish, alexpott, andypost, smustgrave, longwave:...
  • Status changed to Fixed 10 months ago
  • 🇬🇧United Kingdom catch

    Dictionary was the only thing I found...

    Getting off the custom container and also mink which is barely/unmaintained and also towards the w3c standard is all great stuff, even if there's a fair bit more to do.

    Committed/pushed to 11.x and cherry-picked to 10.3.x, thanks!

  • Status changed to Needs work 10 months ago
  • 🇬🇧United Kingdom catch

    If I try to run tests locally, I get a 500 from the chrome container:

    1) Drupal\Tests\node\FunctionalJavascript\NodePreviewLinkTest::testPreviewLinks
    WebDriver\Exception\CurlExec: Curl error thrown for http GET to http://selenium-chrome:4444/wd/hub/session/9f13b12bce7dcb3f66af76e6dcc717cf/source
    
    The requested URL returned error: 500 Internal Server Error
    

    The chrome container log looks like this:

    
    16:28:24.192 WARN [SpanWrappedHttpHandler.execute] - Unable to execute request: GET /session/6b6c1251e90c2ec54fe59cf70a5dc61e/source
    Build info: version: '4.1.4', revision: '535d840ee2'
    System info: host: 'c7da9f0362e9', ip: '192.168.16.6', os.name: 'Linux', os.arch: 'amd64', os.version: '6.5.0-21-generic', java.version: '11.0.14'
    Driver info: driver.version: unknown
    org.openqa.selenium.UnsupportedCommandException: GET /session/6b6c1251e90c2ec54fe59cf70a5dc61e/source
    Build info: version: '4.1.4', revision: '535d840ee2'
    System info: host: 'c7da9f0362e9', ip: '192.168.16.6', os.name: 'Linux', os.arch: 'amd64', os.version: '6.5.0-21-generic', java.version: '11.0.14'
    Driver info: driver.version: unknown
    	at org.openqa.selenium.remote.codec.AbstractHttpCommandCodec.decode(AbstractHttpCommandCodec.java:293)
    	at org.openqa.selenium.remote.codec.AbstractHttpCommandCodec.decode(AbstractHttpCommandCodec.java:127)
    	at org.openqa.selenium.grid.web.ProtocolConverter.execute(ProtocolConverter.java:123)
    	at org.openqa.selenium.grid.node.ProtocolConvertingSession.execute(ProtocolConvertingSession.java:75)
    	at org.openqa.selenium.grid.node.l
    

    This is with ddev and https://github.com/ddev/ddev-selenium-standalone-chrome

    There is a small change upstream to update the ddev config, but that's not the problem, changing the ddev config locally gets rid of the deprecation message but not the fatal error.

    I did a clean drupal core clone in a new directory, ddev config then ddev get ddev/ddev-selenium-standalone-chrome and got the same error. Then I checkout out the commit just before this one, composer installed, and everything runs fine again (with the updated standalone config).

    I can't track it down, but the fact that with an identical ddev setup I can run tests without this change, makes me think it's probably not just me.

  • 🇫🇷France andypost

    @catch it looks like material for DDEV or 📌 Use selenium/standalone-chrome instead of our chromedriver image Needs work

    I'm using image: zenika/alpine-chrome:with-chromedriver image and the test is running fine here

    connection options are MINK_DRIVER_ARGS_WEBDRIVER: '["chrome", {"browserName":"chrome","goog:chromeOptions":{"args":["--disable-gpu","--headless"]}}, "http://172.30.1.3:4444"]'

    docker exec \
    -u 1000:1000 \
    -e SIMPLETEST_BASE_URL=http://172.30.1.2 \
    -e BROWSERTEST_OUTPUT_DIRECTORY='db' \
    core \
    php -dzend.assertions=1 \
    vendor/bin/phpunit -c core/phpunit.xml.dist --colors=always --debug \
    core/modules/node/tests/src/FunctionalJavascript/NodePreviewLinkTest.php
    PHPUnit 9.6.15 by Sebastian Bergmann and contributors.
    
    Testing Drupal\Tests\node\FunctionalJavascript\NodePreviewLinkTest
    Test 'Drupal\Tests\node\FunctionalJavascript\NodePreviewLinkTest::testPreviewLinks' started
    Test 'Drupal\Tests\node\FunctionalJavascript\NodePreviewLinkTest::testPreviewLinks' ended
    
    
    Time: 00:14.990, Memory: 4.00 MB
    
    OK (1 test, 10 assertions)
    
    HTML output was generated
    http://172.30.1.2/sites/simpletest/browser_output/Drupal_Tests_node_FunctionalJavascript_NodePreviewLinkTest-1-13247836.html
    http://172.30.1.2/sites/simpletest/browser_output/Drupal_Tests_node_FunctionalJavascript_NodePreviewLinkTest-2-13247836.html
    http://172.30.1.2/sites/simpletest/browser_output/Drupal_Tests_node_FunctionalJavascript_NodePreviewLinkTest-3-13247836.html
    http://172.30.1.2/sites/simpletest/browser_output/Drupal_Tests_node_FunctionalJavascript_NodePreviewLinkTest-4-13247836.html
    http://172.30.1.2/sites/simpletest/browser_output/Drupal_Tests_node_FunctionalJavascript_NodePreviewLinkTest-5-13247836.html
    
  • 🇬🇧United Kingdom alexpott 🇪🇺🌍

    @catch can you post your MINK_DRIVER_ARGS_WEBDRIVER too?

  • 🇬🇧United Kingdom longwave UK

    I haven't changed my ddev setup since before this was committed, and everything still works for me, I just get the deprecation:

    $ ddev exec vendor/bin/phpunit -c core core/modules/node/tests/src/FunctionalJavascript/NodePreviewLinkTest.php
    PHPUnit 9.6.15 by Sebastian Bergmann and contributors.
    
    Testing Drupal\Tests\node\FunctionalJavascript\NodePreviewLinkTest
    .                                                                   1 / 1 (100%)
    
    Time: 00:11.365, Memory: 4.00 MB
    
    OK (1 test, 10 assertions)
    
    HTML output was generated
    https://drupal8.ddev.site/sites/simpletest/browser_output/Drupal_Tests_node_FunctionalJavascript_NodePreviewLinkTest-1-75597820.html
    https://drupal8.ddev.site/sites/simpletest/browser_output/Drupal_Tests_node_FunctionalJavascript_NodePreviewLinkTest-2-75597820.html
    https://drupal8.ddev.site/sites/simpletest/browser_output/Drupal_Tests_node_FunctionalJavascript_NodePreviewLinkTest-3-75597820.html
    https://drupal8.ddev.site/sites/simpletest/browser_output/Drupal_Tests_node_FunctionalJavascript_NodePreviewLinkTest-4-75597820.html
    https://drupal8.ddev.site/sites/simpletest/browser_output/Drupal_Tests_node_FunctionalJavascript_NodePreviewLinkTest-5-75597820.html
    
    Remaining self deprecation notices (1)
    
      1x: The "chromeOptions" array key is deprecated in drupal:10.3.0 and is removed from drupal:11.0.0. Use "goog:chromeOptions instead. See https://www.drupal.org/node/3422624
        1x in NodePreviewLinkTest::testPreviewLinks from Drupal\Tests\node\FunctionalJavascript
    
    Failed to execute command vendor/bin/phpunit -c core core/modules/node/tests/src/FunctionalJavascript/NodePreviewLinkTest.php: exit status 1
    
  • 🇬🇧United Kingdom catch

    I rebuilt my ddev install to try to rule out any stray old config out, so it's the ones that come with the ddev-selenium-standalone-chrome add-on, just with chromeOptions changed to goog:chromeOptions.

      - MINK_DRIVER_ARGS_WEBDRIVER=[\"chrome\", {\"browserName\":\"chrome\",\"goog:chromeOptions\":{\"w3c\":false,\"args\":[\"--disable-gpu\",\"--headless\", \"--no-sandbox\", \"--disable-dev-shm-usage\"]}}, \"http://selenium-chrome:4444/wd/hub\"]
    

    I'll try dropping that and doing the drupalci/chromedriver:production + 'copy and paste from @mglaman's two year old blog post' approach to see if that gets things running to narrow things down a bit more.

  • 🇬🇧United Kingdom catch

    Going back to drupalci/chromedriver:production worked for me, so can probably wait for https://github.com/ddev/ddev-selenium-standalone-chrome/pull/35 to get merged and/or to flush more issues out in 📌 Use selenium/standalone-chrome instead of our chromedriver image Needs work .

  • Status changed to Fixed 9 months ago
  • 🇬🇧United Kingdom alexpott 🇪🇺🌍

    In light of #68 - marking fixed again.

  • Automatically closed - issue fixed for 2 weeks with no activity.

Production build 0.71.5 2024