updated-packages

vendor/php-webdriver/webdriver/lib/Remote/CustomWebDriverCommand.php

@@ -0,0 +1,82 @@
+<?php
+
+namespace Facebook\WebDriver\Remote;
+
+use Facebook\WebDriver\Exception\WebDriverException;
+
+class CustomWebDriverCommand extends WebDriverCommand
+{
+    const METHOD_GET = 'GET';
+    const METHOD_POST = 'POST';
+
+    /** @var string */
+    private $customUrl;
+    /** @var string */
+    private $customMethod;
+
+    /**
+     * @param string $session_id
+     * @param string $url
+     * @param string $method
+     * @param array $parameters
+     */
+    public function __construct($session_id, $url, $method, array $parameters)
+    {
+        $this->setCustomRequestParameters($url, $method);
+
+        parent::__construct($session_id, DriverCommand::CUSTOM_COMMAND, $parameters);
+    }
+
+    /**
+     * @throws WebDriverException
+     * @return string
+     */
+    public function getCustomUrl()
+    {
+        if ($this->customUrl === null) {
+            throw new WebDriverException('URL of custom command is not set');
+        }
+
+        return $this->customUrl;
+    }
+
+    /**
+     * @throws WebDriverException
+     * @return string
+     */
+    public function getCustomMethod()
+    {
+        if ($this->customMethod === null) {
+            throw new WebDriverException('Method of custom command is not set');
+        }
+
+        return $this->customMethod;
+    }
+
+    /**
+     * @param string $custom_url
+     * @param string $custom_method
+     * @throws WebDriverException
+     */
+    protected function setCustomRequestParameters($custom_url, $custom_method)
+    {
+        $allowedMethods = [static::METHOD_GET, static::METHOD_POST];
+        if (!in_array($custom_method, $allowedMethods, true)) {
+            throw new WebDriverException(
+                sprintf(
+                    'Invalid custom method "%s", must be one of [%s]',
+                    $custom_method,
+                    implode(', ', $allowedMethods)
+                )
+            );
+        }
+        $this->customMethod = $custom_method;
+
+        if (mb_strpos($custom_url, '/') !== 0) {
+            throw new WebDriverException(
+                sprintf('URL of custom command has to start with / but is "%s"', $custom_url)
+            );
+        }
+        $this->customUrl = $custom_url;
+    }
+}