Fix #87 W3C error strings

Author: robocoder

lib/WebDriver/Exception.php

@@ -122,6 +122,35 @@ abstract class Exception extends \Exception
         self::UNEXPECTED_PARAMETERS => array('UnexpectedParameters', 'This command does not expect this number of parameters.'),
         self::INVALID_REQUEST => array('InvalidRequest', 'This command does not support this HTTP request method.'),
         self::UNKNOWN_LOCATOR_STRATEGY => array('UnknownLocatorStrategy', 'This locator strategy is not supported.'),
+
+        //  @link https://w3c.github.io/webdriver/#errors
+        'element click intercepted' => array('ElementClickIntercepted', 'The Element Click command could not be completed because the element receiving the events is obscuring the element that was requested clicked.'),
+        'element not interactable' => array('ElementNotInteractable', 'A command could not be completed because the element is not pointer- or keyboard interactable.'),
+        'insecure certificate' => array('InsecureCertificate', 'Navigation caused the user agent to hit a certificate warning, which is usually the result of an expired or invalid TLS certificate.'),
+        'invalid argument' => array('InvalidArgument', 'The arguments passed to a command are either invalid or malformed.'),
+        'invalid cookie domain' => array('InvalidCookieDomain', 'An illegal attempt was made to set a cookie under a different domain than the current page.'),
+        'invalid element state' => array('InvalidElementState', 'A command could not be completed because the element is in an invalid state, e.g. attempting to clear an element that isn\'t both editable and resettable.'),
+        'invalid selector' => array('InvalidSelector', 'Argument was an invalid selector.'),
+        'invalid session id' => array('InvalidSessionID', 'Occurs if the given session id is not in the list of active sessions, meaning the session either does not exist or that it\'s not active.'),
+	'javascript error' => array('JavaScriptError', 'An error occurred while executing JavaScript supplied by the user.'),
+	'move target out of bounds' => array('MoveTargetOutOfBounds', 'The target for mouse interaction is not in the browser\'s viewport and cannot be brought into that viewport.'),
+        'no such alert' => array('NoSuchAlert', 'An attempt was made to operate on a modal dialog when one was not open.'),
+        'no such cookie' => array('NoSuchCookie', 'No cookie matching the given path name was found amongst the associated cookies of the current browsing context\'s active document.'),
+        'no such element' => array('NoSuchElement', 'An element could not be located on the page using the given search parameters.'),
+        'no such frame' => array('NoSuchFrame', 'A command to switch to a frame could not be satisfied because the frame could not be found.'),
+        'no such window' => array('NoSuchWindow', 'A command to switch to a window could not be satisfied because the window could not be found.'),
+        'script timeout' => array('ScriptTimeout', 'A script did not complete before its timeout expired.'),
+        'script timeout error' => array('ScriptTimeout', 'A script did not complete before its timeout expired.'),
+        'session not created' => array('SessionNotCreated', 'A new session could not be created.'),
+        'stale element reference' => array('StaleElementReference', 'A command failed because the referenced element is no longer attached to the DOM.'),
+        'timeout' => array('Timeout', 'An operation did not complete before its timeout expired.'),
+        'unable to set cookie' => array('UnableToSetCookie', 'A command to set a cookie\'s value could not be satisfied.'),
+        'unable to capture screen' => array('UnableToCaptureScreen', 'A screen capture was made impossible.'),
+        'unexpected alert open' => array('UnexpectedAlertOpen', 'A modal dialog was open, blocking this operation.'),
+        'unknown command' => array('UnknownCommand', 'A command could not be executed because the remote end is not aware of it.'),
+        'unknown error' => array('UnknownError', 'An unknown error occurred in the remote end while processing the command.'),
+        'unknown method' => array('UnknownMethod', 'The requested command matched a known URL but did not match an method for that URL.'),
+        'unsupported operation' => array('UnsupportedOperation', 'Indicates that a command that should have executed properly cannot be supported for some reason.'),
     );
 
     /**
@@ -136,12 +165,8 @@ abstract class Exception extends \Exception
     public static function factory($code, $message = null, $previousException = null)
     {
         // unknown error
-        if (!isset(self::$errs[$code])) {
-            if (trim($message) === '') {
-                $message = 'Unknown Error';
-            }
-
-            return new \Exception($message, $code, $previousException);
+        if (! isset(self::$errs[$code])) {
+            $code = self::UNKNOWN_ERROR;
         }
 
         $errorDefinition = self::$errs[$code];

lib/WebDriver/Exception/ElementClickIntercepted.php

@@ -0,0 +1,33 @@
+<?php
+/**
+ * Copyright 2019-2019 Facebook. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @package WebDriver
+ *
+ * @author Anthon Pang <apang@softwaredevelopment.ca>
+ */
+
+namespace WebDriver\Exception;
+
+use WebDriver\Exception as BaseException;
+
+/**
+ * WebDriver\Exception\ElementClickIntercepted class
+ *
+ * @package WebDriver
+ */
+final class ElementClickIntercepted extends BaseException
+{
+}

lib/WebDriver/Exception/ElementNotInteractable.php

@@ -0,0 +1,33 @@
+<?php
+/**
+ * Copyright 2019-2019 Facebook. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @package WebDriver
+ *
+ * @author Anthon Pang <apang@softwaredevelopment.ca>
+ */
+
+namespace WebDriver\Exception;
+
+use WebDriver\Exception as BaseException;
+
+/**
+ * WebDriver\Exception\ElementNotInteractable class
+ *
+ * @package WebDriver
+ */
+final class ElementNotInteractable extends BaseException
+{
+}

lib/WebDriver/Exception/InsecureCertificate.php

@@ -0,0 +1,33 @@
+<?php
+/**
+ * Copyright 2019-2019 Facebook. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @package WebDriver
+ *
+ * @author Anthon Pang <apang@softwaredevelopment.ca>
+ */
+
+namespace WebDriver\Exception;
+
+use WebDriver\Exception as BaseException;
+
+/**
+ * WebDriver\Exception\InsecureCertificate class
+ *
+ * @package WebDriver
+ */
+final class InsecureCertificate extends BaseException
+{
+}

lib/WebDriver/Exception/InvalidArgument.php

@@ -0,0 +1,33 @@
+<?php
+/**
+ * Copyright 2019-2019 Facebook. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @package WebDriver
+ *
+ * @author Anthon Pang <apang@softwaredevelopment.ca>
+ */
+
+namespace WebDriver\Exception;
+
+use WebDriver\Exception as BaseException;
+
+/**
+ * WebDriver\Exception\InvalidArgument class
+ *
+ * @package WebDriver
+ */
+final class InvalidArgument extends BaseException
+{
+}

lib/WebDriver/Exception/InvalidSessionID.php

@@ -0,0 +1,33 @@
+<?php
+/**
+ * Copyright 2019-2019 Facebook. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @package WebDriver
+ *
+ * @author Anthon Pang <apang@softwaredevelopment.ca>
+ */
+
+namespace WebDriver\Exception;
+
+use WebDriver\Exception as BaseException;
+
+/**
+ * WebDriver\Exception\InvalidSessionID class
+ *
+ * @package WebDriver
+ */
+final class InvalidSessionID extends BaseException
+{
+}

lib/WebDriver/Exception/NoSuchAlert.php

@@ -0,0 +1,33 @@
+<?php
+/**
+ * Copyright 2019-2019 Facebook. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @package WebDriver
+ *
+ * @author Anthon Pang <apang@softwaredevelopment.ca>
+ */
+
+namespace WebDriver\Exception;
+
+use WebDriver\Exception as BaseException;
+
+/**
+ * WebDriver\Exception\NoSuchAlert class
+ *
+ * @package WebDriver
+ */
+final class NoSuchAlert extends BaseException
+{
+}

lib/WebDriver/Exception/NoSuchCookie.php

@@ -0,0 +1,33 @@
+<?php
+/**
+ * Copyright 2019-2019 Facebook. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @package WebDriver
+ *
+ * @author Anthon Pang <apang@softwaredevelopment.ca>
+ */
+
+namespace WebDriver\Exception;
+
+use WebDriver\Exception as BaseException;
+
+/**
+ * WebDriver\Exception\NoSuchCookie class
+ *
+ * @package WebDriver
+ */
+final class NoSuchCookie extends BaseException
+{
+}

lib/WebDriver/Exception/UnableToCaptureScreen.php

@@ -0,0 +1,33 @@
+<?php
+/**
+ * Copyright 2019-2019 Facebook. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @package WebDriver
+ *
+ * @author Anthon Pang <apang@softwaredevelopment.ca>
+ */
+
+namespace WebDriver\Exception;
+
+use WebDriver\Exception as BaseException;
+
+/**
+ * WebDriver\Exception\UnableToCaptureScreen class
+ *
+ * @package WebDriver
+ */
+final class UnableToCaptureScreen extends BaseException
+{
+}

lib/WebDriver/Exception/UnknownMethod.php

@@ -0,0 +1,33 @@
+<?php
+/**
+ * Copyright 2019-2019 Facebook. All Rights Reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ *
+ * @package WebDriver
+ *
+ * @author Anthon Pang <apang@softwaredevelopment.ca>
+ */
+
+namespace WebDriver\Exception;
+
+use WebDriver\Exception as BaseException;
+
+/**
+ * WebDriver\Exception\UnknownMethod class
+ *
+ * @package WebDriver
+ */
+final class UnknownMethod extends BaseException
+{
+}