Use own exception hierachy

src/Client.php

@@ -39,6 +39,8 @@
 use Symfony\Component\Panther\DomCrawler\Crawler as PantherCrawler;
 use Symfony\Component\Panther\DomCrawler\Form as PantherForm;
 use Symfony\Component\Panther\DomCrawler\Link as PantherLink;
+use Symfony\Component\Panther\Exception\InvalidArgumentException;
+use Symfony\Component\Panther\Exception\LogicException;
 use Symfony\Component\Panther\ProcessManager\BrowserManagerInterface;
 use Symfony\Component\Panther\ProcessManager\ChromeManager;
 use Symfony\Component\Panther\ProcessManager\FirefoxManager;
@@ -138,18 +140,18 @@ public function start(): void
 
     public function getRequest(): object
     {
-        throw new \LogicException('HttpFoundation Request object is not available when using WebDriver.');
+        throw new LogicException('HttpFoundation Request object is not available when using WebDriver.');
     }
 
     public function getResponse(): object
     {
-        throw new \LogicException('HttpFoundation Response object is not available when using WebDriver.');
+        throw new LogicException('HttpFoundation Response object is not available when using WebDriver.');
     }
 
     public function followRedirects($followRedirects = true): void
     {
         if (!$followRedirects) {
-            throw new \InvalidArgumentException('Redirects are always followed when using WebDriver.');
+            throw new InvalidArgumentException('Redirects are always followed when using WebDriver.');
         }
     }
 
@@ -161,7 +163,7 @@ public function isFollowingRedirects(): bool
     public function setMaxRedirects($maxRedirects): void
     {
         if (-1 !== $maxRedirects) {
-            throw new \InvalidArgumentException('There are no max redirects when using WebDriver.');
+            throw new InvalidArgumentException('There are no max redirects when using WebDriver.');
         }
     }
 
@@ -173,28 +175,28 @@ public function getMaxRedirects(): int
     public function insulate($insulated = true): void
     {
         if (!$insulated) {
-            throw new \InvalidArgumentException('Requests are always insulated when using WebDriver.');
+            throw new InvalidArgumentException('Requests are always insulated when using WebDriver.');
         }
     }
 
     public function setServerParameters(array $server): void
     {
-        throw new \InvalidArgumentException('Server parameters cannot be set when using WebDriver.');
+        throw new InvalidArgumentException('Server parameters cannot be set when using WebDriver.');
     }
 
     public function setServerParameter($key, $value): void
     {
-        throw new \InvalidArgumentException('Server parameters cannot be set when using WebDriver.');
+        throw new InvalidArgumentException('Server parameters cannot be set when using WebDriver.');
     }
 
     public function getServerParameter($key, $default = ''): mixed
     {
-        throw new \InvalidArgumentException('Server parameters cannot be retrieved when using WebDriver.');
+        throw new InvalidArgumentException('Server parameters cannot be retrieved when using WebDriver.');
     }
 
     public function getHistory(): History
     {
-        throw new \LogicException('History is not available when using WebDriver.');
+        throw new LogicException('History is not available when using WebDriver.');
     }
 
     public function click(Link $link, array $serverParameters = []): Crawler
@@ -255,18 +257,18 @@ public function refreshCrawler(): PantherCrawler
     public function request(string $method, string $uri, array $parameters = [], array $files = [], array $server = [], ?string $content = null, bool $changeHistory = true): PantherCrawler
     {
         if ('GET' !== $method) {
-            throw new \InvalidArgumentException('Only the GET method is supported when using WebDriver.');
+            throw new InvalidArgumentException('Only the GET method is supported when using WebDriver.');
         }
         if (null !== $content) {
-            throw new \InvalidArgumentException('Setting a content is not supported when using WebDriver.');
+            throw new InvalidArgumentException('Setting a content is not supported when using WebDriver.');
         }
         if (!$changeHistory) {
-            throw new \InvalidArgumentException('The history always change when using WebDriver.');
+            throw new InvalidArgumentException('The history always change when using WebDriver.');
         }
 
         foreach (['parameters', 'files', 'server'] as $arg) {
             if ([] !== $$arg) {
-                throw new \InvalidArgumentException(\sprintf('The parameter "$%s" is not supported when using WebDriver.', $arg));
+                throw new InvalidArgumentException(\sprintf('The parameter "$%s" is not supported when using WebDriver.', $arg));
             }
         }
 
@@ -286,7 +288,7 @@ protected function createCrawler(): PantherCrawler
 
     protected function doRequest($request)
     {
-        throw new \LogicException('Not useful in WebDriver mode.');
+        throw new LogicException('Not useful in WebDriver mode.');
     }
 
     public function back(): PantherCrawler
@@ -315,7 +317,7 @@ public function reload(): PantherCrawler
 
     public function followRedirect(): PantherCrawler
     {
-        throw new \LogicException('Redirects are always followed when using WebDriver.');
+        throw new LogicException('Redirects are always followed when using WebDriver.');
     }
 
     public function restart(): void

src/DomCrawler/Crawler.php

@@ -19,6 +19,8 @@
 use Facebook\WebDriver\WebDriverElement;
 use Symfony\Component\CssSelector\CssSelectorConverter;
 use Symfony\Component\DomCrawler\Crawler as BaseCrawler;
+use Symfony\Component\Panther\Exception\InvalidArgumentException;
+use Symfony\Component\Panther\Exception\LogicException;
 use Symfony\Component\Panther\ExceptionThrower;
 
 /**
@@ -206,12 +208,12 @@ public function nodeName(): string
     public function text(?string $default = null, bool $normalizeWhitespace = true): string
     {
         if (!$normalizeWhitespace) {
-            throw new \InvalidArgumentException('Panther only supports getting normalized text.');
+            throw new InvalidArgumentException('Panther only supports getting normalized text.');
         }
 
         try {
             return $this->getElementOrThrow()->getText();
-        } catch (\InvalidArgumentException $e) {
+        } catch (InvalidArgumentException $e) {
             if (null === $default) {
                 throw $e;
             }
@@ -230,7 +232,7 @@ public function html(?string $default = null): string
             }
 
             return $this->attr('outerHTML', (string) $default);
-        } catch (\InvalidArgumentException $e) {
+        } catch (InvalidArgumentException $e) {
             if (null === $default) {
                 throw $e;
             }
@@ -299,7 +301,7 @@ public function link($method = 'get'): Link
     {
         $element = $this->getElementOrThrow();
         if ('get' !== $method) {
-            throw new \InvalidArgumentException('Only the "get" method is supported in WebDriver mode.');
+            throw new InvalidArgumentException('Only the "get" method is supported in WebDriver mode.');
         }
 
         return new Link($element, $this->webDriver->getCurrentURL());
@@ -352,7 +354,7 @@ public function registerNamespace($prefix, $namespace): void
 
     public function getNode($position): ?\DOMElement
     {
-        throw new \InvalidArgumentException('The "getNode" method cannot be used in WebDriver mode. Use "getElement" instead.');
+        throw new InvalidArgumentException('The "getNode" method cannot be used in WebDriver mode. Use "getElement" instead.');
     }
 
     public function getElement(int $position): ?WebDriverElement
@@ -423,7 +425,7 @@ private function getElementOrThrow(): WebDriverElement
     {
         $element = $this->getElement(0);
         if (!$element) {
-            throw new \InvalidArgumentException('The current node list is empty.');
+            throw new InvalidArgumentException('The current node list is empty.');
         }
 
         return $element;
@@ -510,12 +512,12 @@ public function findElements(WebDriverBy $locator): array
     }
 
     /**
-     * @throws \LogicException If the CssSelector Component is not available
+     * @throws LogicException If the CssSelector Component is not available
      */
     private function createCssSelectorConverter(): CssSelectorConverter
     {
         if (!class_exists(CssSelectorConverter::class)) {
-            throw new \LogicException('To filter with a CSS selector, install the CssSelector component ("composer require symfony/css-selector"). Or use filterXpath instead.');
+            throw new LogicException('To filter with a CSS selector, install the CssSelector component ("composer require symfony/css-selector"). Or use filterXpath instead.');
         }
 
         return new CssSelectorConverter();

src/DomCrawler/Field/ChoiceFormField.php

@@ -16,6 +16,8 @@
 use Facebook\WebDriver\WebDriverSelect;
 use Facebook\WebDriver\WebDriverSelectInterface;
 use Symfony\Component\DomCrawler\Field\ChoiceFormField as BaseChoiceFormField;
+use Symfony\Component\Panther\Exception\InvalidArgumentException;
+use Symfony\Component\Panther\Exception\LogicException;
 use Symfony\Component\Panther\WebDriver\WebDriverCheckbox;
 
 /**
@@ -47,12 +49,12 @@ public function select($value): void
     /**
      * Ticks a checkbox.
      *
-     * @throws \LogicException When the type provided is not correct
+     * @throws LogicException When the type provided is not correct
      */
     public function tick(): void
     {
         if ('checkbox' !== $type = $this->element->getAttribute('type')) {
-            throw new \LogicException(\sprintf('You cannot tick "%s" as it is not a checkbox (%s).', $this->element->getAttribute('name'), $type));
+            throw new LogicException(\sprintf('You cannot tick "%s" as it is not a checkbox (%s).', $this->element->getAttribute('name'), $type));
         }
 
         $this->setValue(true);
@@ -61,12 +63,12 @@ public function tick(): void
     /**
      * Ticks a checkbox.
      *
-     * @throws \LogicException When the type provided is not correct
+     * @throws LogicException When the type provided is not correct
      */
     public function untick(): void
     {
         if ('checkbox' !== $type = $this->element->getAttribute('type')) {
-            throw new \LogicException(\sprintf('You cannot tick "%s" as it is not a checkbox (%s).', $this->element->getAttribute('name'), $type));
+            throw new LogicException(\sprintf('You cannot tick "%s" as it is not a checkbox (%s).', $this->element->getAttribute('name'), $type));
         }
 
         $this->setValue(false);
@@ -108,13 +110,13 @@ public function getValue(): array|string|null
      *
      * @param string|array|bool $value The value of the field
      *
-     * @throws \InvalidArgumentException When value type provided is not correct
+     * @throws InvalidArgumentException When value type provided is not correct
      */
     public function setValue($value): void
     {
         if (\is_bool($value)) {
             if ('checkbox' !== $this->type) {
-                throw new \InvalidArgumentException(\sprintf('Invalid argument of type "%s"', \gettype($value)));
+                throw new InvalidArgumentException(\sprintf('Invalid argument of type "%s"', \gettype($value)));
             }
 
             if ($value) {
@@ -183,18 +185,18 @@ public function disableValidation(): static
     /**
      * Initializes the form field.
      *
-     * @throws \LogicException When node type is incorrect
+     * @throws LogicException When node type is incorrect
      */
     protected function initialize(): void
     {
         $tagName = $this->element->getTagName();
         if ('input' !== $tagName && 'select' !== $tagName) {
-            throw new \LogicException(\sprintf('A ChoiceFormField can only be created from an input or select tag (%s given).', $tagName));
+            throw new LogicException(\sprintf('A ChoiceFormField can only be created from an input or select tag (%s given).', $tagName));
         }
 
         $type = strtolower((string) $this->element->getAttribute('type'));
         if ('input' === $tagName && 'checkbox' !== $type && 'radio' !== $type) {
-            throw new \LogicException(\sprintf('A ChoiceFormField can only be created from an input tag with a type of checkbox or radio (given type is %s).', $type));
+            throw new LogicException(\sprintf('A ChoiceFormField can only be created from an input tag with a type of checkbox or radio (given type is %s).', $type));
         }
 
         $this->type = 'select' === $tagName ? 'select' : $type;

src/DomCrawler/Field/FileFormField.php

@@ -14,6 +14,7 @@
 namespace Symfony\Component\Panther\DomCrawler\Field;
 
 use Symfony\Component\DomCrawler\Field\FileFormField as BaseFileFormField;
+use Symfony\Component\Panther\Exception\LogicException;
 
 /**
  * @author Robert Freigang <[email protected]>
@@ -61,18 +62,18 @@ public function setFilePath(string $path): void
     /**
      * Initializes the form field.
      *
-     * @throws \LogicException When node type is incorrect
+     * @throws LogicException When node type is incorrect
      */
     protected function initialize(): void
     {
         $tagName = $this->element->getTagName();
         if ('input' !== $tagName) {
-            throw new \LogicException(\sprintf('A FileFormField can only be created from an input tag (%s given).', $tagName));
+            throw new LogicException(\sprintf('A FileFormField can only be created from an input tag (%s given).', $tagName));
         }
 
         $type = strtolower($this->element->getAttribute('type'));
         if ('file' !== $type) {
-            throw new \LogicException(\sprintf('A FileFormField can only be created from an input tag with a type of file (given type is %s).', $type));
+            throw new LogicException(\sprintf('A FileFormField can only be created from an input tag with a type of file (given type is %s).', $type));
         }
 
         $value = $this->element->getAttribute('value');

src/DomCrawler/Field/InputFormField.php

@@ -14,6 +14,7 @@
 namespace Symfony\Component\Panther\DomCrawler\Field;
 
 use Symfony\Component\DomCrawler\Field\InputFormField as BaseInputFormField;
+use Symfony\Component\Panther\Exception\LogicException;
 
 /**
  * @author Kévin Dunglas <[email protected]>
@@ -42,22 +43,22 @@ public function setValue($value): void
     /**
      * Initializes the form field.
      *
-     * @throws \LogicException When node type is incorrect
+     * @throws LogicException When node type is incorrect
      */
     protected function initialize(): void
     {
         $tagName = $this->element->getTagName();
         if ('input' !== $tagName && 'button' !== $tagName) {
-            throw new \LogicException(\sprintf('An InputFormField can only be created from an input or button tag (%s given).', $tagName));
+            throw new LogicException(\sprintf('An InputFormField can only be created from an input or button tag (%s given).', $tagName));
         }
 
         $type = strtolower((string) $this->element->getAttribute('type'));
         if ('checkbox' === $type) {
-            throw new \LogicException('Checkboxes should be instances of ChoiceFormField.');
+            throw new LogicException('Checkboxes should be instances of ChoiceFormField.');
         }
 
         if ('file' === $type) {
-            throw new \LogicException('File inputs should be instances of FileFormField.');
+            throw new LogicException('File inputs should be instances of FileFormField.');
         }
     }
 }

src/DomCrawler/Field/TextareaFormField.php

@@ -14,6 +14,7 @@
 namespace Symfony\Component\Panther\DomCrawler\Field;
 
 use Symfony\Component\DomCrawler\Field\TextareaFormField as BaseTextareaFormField;
+use Symfony\Component\Panther\Exception\LogicException;
 
 /**
  * @author Kévin Dunglas <[email protected]>
@@ -30,13 +31,13 @@ public function setValue(?string $value): void
     /**
      * Initializes the form field.
      *
-     * @throws \LogicException When node type is incorrect
+     * @throws LogicException When node type is incorrect
      */
     protected function initialize(): void
     {
         $tagName = $this->element->getTagName();
         if ('textarea' !== $tagName) {
-            throw new \LogicException(\sprintf('A TextareaFormField can only be created from a textarea tag (%s given).', $tagName));
+            throw new LogicException(\sprintf('A TextareaFormField can only be created from a textarea tag (%s given).', $tagName));
         }
     }
 }

src/DomCrawler/Form.php

@@ -27,6 +27,8 @@
 use Symfony\Component\Panther\DomCrawler\Field\FileFormField;
 use Symfony\Component\Panther\DomCrawler\Field\InputFormField;
 use Symfony\Component\Panther\DomCrawler\Field\TextareaFormField;
+use Symfony\Component\Panther\Exception\LogicException;
+use Symfony\Component\Panther\Exception\RuntimeException;
 use Symfony\Component\Panther\ExceptionThrower;
 use Symfony\Component\Panther\WebDriver\WebDriverCheckbox;
 
@@ -60,7 +62,7 @@ private function setElement(WebDriverElement $element): void
                 try {
                     $form = $this->webDriver->findElement(WebDriverBy::id($formId));
                 } catch (NoSuchElementException $e) {
-                    throw new \LogicException(\sprintf('The selected node has an invalid form attribute (%s).', $formId));
+                    throw new LogicException(\sprintf('The selected node has an invalid form attribute (%s).', $formId));
                 }
 
                 $this->element = $form;
@@ -72,11 +74,11 @@ private function setElement(WebDriverElement $element): void
                 try {
                     $element = $element->findElement(WebDriverBy::xpath('..'));
                 } catch (NoSuchElementException $e) {
-                    throw new \LogicException('The selected node does not have a form ancestor.');
+                    throw new LogicException('The selected node does not have a form ancestor.');
                 }
             } while ('form' !== $element->getTagName());
         } elseif ('form' !== $tagName = $element->getTagName()) {
-            throw new \LogicException(\sprintf('Unable to submit on a "%s" tag.', $tagName));
+            throw new LogicException(\sprintf('Unable to submit on a "%s" tag.', $tagName));
         }
 
         $this->element = $element;
@@ -323,7 +325,7 @@ private function getValue(WebDriverElement $element)
     {
         if (null === $webDriverSelect = $this->getWebDriverSelect($element)) {
             if (!$this->webDriver instanceof JavaScriptExecutor) {
-                throw new \RuntimeException('To retrieve this value, the browser must support JavaScript.');
+                throw new RuntimeException('To retrieve this value, the browser must support JavaScript.');
             }
 
             return $this->webDriver->executeScript('return arguments[0].value', [$element]);