feat: allow selenium server with internal webserver

Author: daFish

README.md

@@ -498,6 +498,22 @@ class SecondDomainTest extends PantherTestCase
 
 To use a proxy server, set the following environment variable: `PANTHER_CHROME_ARGUMENTS='--proxy-server=socks://127.0.0.1:9050'`
 
+### Using Selenium With the Built-In Web Server
+
+If you want to use [Selenium Grid](https://www.selenium.dev/documentation/grid/) with the built-in web server, you need to configure the Panther client as follows:
+
+```php
+$client = Client::createPantherClient(
+    options: [
+        'browser' => PantherTestCase::SELENIUM,
+    ],
+    managerOptions: [
+        'host' => 'http://selenium-hub:4444', // the host of the Selenium Server (Grid)
+        'capabilities' => DesiredCapabilities::firefox(), // the capabilities of the browser
+    ],
+);
+```
+
 ### Accepting Self-signed SSL Certificates
 
 To force Chrome to accept invalid and self-signed certificates, set the following environment variable: `PANTHER_CHROME_ARGUMENTS='--ignore-certificate-errors'`

src/PantherTestCase.php

@@ -23,6 +23,7 @@ abstract class PantherTestCase extends WebTestCase
 
         public const CHROME = 'chrome';
         public const FIREFOX = 'firefox';
+        public const SELENIUM = 'selenium';
 
         protected function tearDown(): void
         {
@@ -44,6 +45,7 @@ abstract class PantherTestCase extends TestCase
 
         public const CHROME = 'chrome';
         public const FIREFOX = 'firefox';
+        public const SELENIUM = 'selenium';
 
         protected function tearDown(): void
         {

src/PantherTestCaseTrait.php

@@ -186,6 +186,8 @@ protected static function createPantherClient(array $options = [], array $kernel
 
         if (PantherTestCase::FIREFOX === $browser) {
             self::$pantherClients[0] = self::$pantherClient = PantherClient::createFirefoxClient(null, $browserArguments, $managerOptions, self::$baseUri);
+        } elseif (PantherTestCase::SELENIUM === $browser) {
+            self::$pantherClients[0] = self::$pantherClient = PantherClient::createSeleniumClient($managerOptions['host'], $managerOptions['capabilities'] ?? null, self::$baseUri, $options);
         } else {
             try {
                 self::$pantherClients[0] = self::$pantherClient = PantherClient::createChromeClient(null, $browserArguments, $managerOptions, self::$baseUri);