appium-mcp 1.8.10 → 1.8.12

package/src/resources/submodules/appium/packages/base-driver/README.md

@@ -1,15 +0,0 @@
-# @appium/base-driver
-
-> Base class for creating other Appium drivers
-
-[![NPM version](http://img.shields.io/npm/v/@appium/base-driver.svg)](https://npmjs.org/package/@appium/base-driver)
-[![Downloads](http://img.shields.io/npm/dm/@appium/base-driver.svg)](https://npmjs.org/package/@appium/base-driver)
-
-This is the parent class that all Appium drivers inherit from. This driver should not be installed
-directly as it does nothing on its own. Instead, you should extend this driver when creating your
-*own* Appium drivers. Check out the [Building Drivers](https://appium.io/docs/en/latest/developing/build-drivers/)
-documentation for more details.
-
-## License
-
-Apache-2.0

package/src/resources/submodules/appium/packages/base-driver/docs/mjsonwp/errors.md

@@ -1,82 +0,0 @@
-## Mobile JSON Wire Protocol Errors
-
-This package exports a number of classes and methods related to Selenium error handling. There are error classes for each Selenium error type (see [here](https://code.google.com/p/selenium/wiki/JsonWireProtocol#Response_Status_Codes), as well as the context errors in the [mobile spec](https://github.com/SeleniumHQ/mobile-spec/blob/master/spec-draft.md#webviews-and-other-contexts)).
-
-These classes, which are constructed with a string message (defaulting to the "Details" below), are available through the `errors` object exported by the module. They are
-
-| Code | Class Name                       | Details
-| -----|----------------------------------|-----------------------------------------------
-|      | `MJSONWPError`<sup>1</sup>       | Base class for other errors
-| 6    | `NoSuchDriverError`              | A session is either terminated or not started
-| 7    | `NoSuchElementError`             | An element could not be located on the page using the given search parameters
-| 8    | `NoSuchFrameError`               | A request to switch to a frame could not be satisfied because the frame could not be found
-| 9    | `UnknownCommandError`            | The requested resource could not be found, or a request was received using an HTTP method that is not supported by the mapped resource
-| 10   | `StaleElementReferenceError`     | An element command failed because the referenced element is no longer attached to the DOM
-| 11   | `ElementNotVisibleError`         | An element command could not be completed because the element is not visible on the page
-| 12   | `InvalidElementStateError`       | An element command could not be completed because the element is in an invalid state (e.g., attempting to click a disabled element)
-| 13   | `UnknownError`                   | An unknown server-side error occurred while processing the command
-| 405   | `NotYetImplementedError`        | The operation requested is not yet implemented by the driver
-| 405   | `NotImplementedError`           | The operation requested will not be implemented by the driver
-| 15   | `ElementIsNotSelectableError`    | An attempt was made to select an element that cannot be selected
-| 17   | `JavaScriptError`                | An error occurred while executing user supplied JavaScript
-| 19   | `XPathLookupError`               | An error occurred while searching for an element by XPath
-| 21   | `TimeoutError`                   | An operation did not complete before its timeout expired
-| 23   | `NoSuchWindowError`              | A request to switch to a different window could not be satisfied because the window could not be found
-| 24   | `InvalidCookieDomainError`       | An illegal attempt was made to set a cookie under a different domain than the current page
-| 25   | `UnableToSetCookieError`         | A request to set a cookie's value could not be satisfied
-| 26   | `UnexpectedAlertOpenError`       | A modal dialog was open, blocking this operation
-| 27   | `NoAlertOpenError`               | An attempt was made to operate on a modal dialog when one was not open
-| 28   | `ScriptTimeoutError`             | A script did not complete before its timeout expired
-| 29   | `InvalidElementCoordinatesError` | The coordinates provided to an interactions operation are invalid
-| 30   | `IMENotAvailableError`           | Input Method Editor was not available
-| 31   | `IMEEngineActivationFailedError` | An Input Method Editor engine could not be started
-| 32   | `InvalidSelectorError`           | Argument was an invalid selector (e.g., XPath/CSS)
-| 33   | `SessionNotCreatedError`         | A new session could not be created
-| 34   | `MoveTargetOutOfBoundsError`     | Target provided for a move action is out of bounds
-| 35   | `NoSuchContextError`             | Context provided (e.g., `WEBVIEW_42`) does not exist
-| 36   | `InvalidContextError`            | The operation could not be performed in the current context
-|      |                                  |
-|      | `BadParametersError`<sup>2</sup> | The parameters specified for the operation are incorrect
-
-<sup>1</sup> `MJSONWPError` is the base class for all errors that are part of the Selenium specification (i.e., all errors except `BadParametersError`), and not itself part of that specification.
-<sup>2</sup> `BadParametersError` is not part of the Selenium specification, but deals with request management.
-
-There are, in addition, two helper methods for dealing with errors
-
-`isErrorType (err, type)`
-
-- checks if the `err` object is a Mobile JSON Wire Protocol error of a particular type
-- arguments
-  - `err` - the error object to test
-  - `type` - the error class to test against
-- usage
-  ```js
-  import { errors, isErrorType } from 'appium-base-driver';
-
-  try {
-    // do some stuff...
-  } catch (err) {
-    if (isErrorType(err, errors.InvalidCookieDomainError)) {
-      // process...
-    }
-  }
-  ```
-
-`errorFromCode (code, message)`
-
-- retrieve the appropriate error for an error code, with the supplied message.
-- arguments
-  - `code` - the integer error code for a Mobile JSON Wire Protocol error
-  - `message` - the message to be encapsulated in the error
-- usage
-  ```js
-  import { errors, errorFromCode } from 'appium-base-driver';
-
-  let error = errorFromCode(6, 'an error has occurred');
-
-  console.log(error instanceof errors.NoSuchDriverError);
-  // => true
-
-  console.log(error.message === 'an error has occurred');
-  // => true
-  ```

package/src/resources/submodules/appium/packages/base-driver/docs/mjsonwp/protocol-methods.md

@@ -1,182 +0,0 @@
-## Currently supported endpoints
-
-The following are endpoints that are currently supported by the Appium server. Particular drivers may or may not implement functionality depending on the underlying system.
-
-### WebDriver endpoints
-
-See the WebDriver [W3C](https://w3c.github.io/webdriver/webdriver-spec.html#list-of-endpoints) and [JSON Wire Protocol](https://github.com/SeleniumHQ/selenium/wiki/JsonWireProtocol) specifications.
-
-HTTP Method | Path                                                                   | Details
-------------|------------------------------------------------------------------------|---------
-GET         | `status`                                                       | Retrieve the server’s current status.
-POST        | `session`                                                      | Create a new session.
-GET         | `sessions`                                                     | Retrieve a list of currently active sessions.
-GET         | `session/{sessionId}`                                          | Retrieve the capabilities of the specified session.
-DELETE      | `session/{sessionId}`                                          | Delete the session.
-POST        | `session/{sessionId}/timeouts`                                 | Configure the amount of time that a particular type of operation can execute for before they are aborted and a |Timeout| error is returned to the client.
-POST        | `session/{sessionId}/timeouts/async_script`                    | Set the amount of time that asynchronous scripts executed by `/session/{sessionId/execute_async` are permitted to run before they are aborted.
-POST        | `session/{sessionId}/timeouts/implicit_wait`                   | Set the amount of time the driver should wait when searching for elements.
-GET         | `session/{sessionId}/window_handle`                            | Retrieve the current window handle.
-GET         | `session/{sessionId}/window_handles`                           | Retrieve the list of all window handles available to the session.
-GET         | `session/{sessionId}/url`                                      | Retrieve the URL of the current page.
-POST        | `session/{sessionId}/url`                                      | Navigate to a new URL.
-POST        | `session/{sessionId}/forward`                                  | Navigate forwards in the browser history, if possible.
-POST        | `session/{sessionId}/back`                                     | Navigate backwards in the browser history, if possible.
-POST        | `session/{sessionId}/refresh`                                  | Refresh the current page.
-POST        | `session/{sessionId}/execute`                                  | Inject a snippet of JavaScript into the page for execution in the current context.
-POST        | `session/{sessionId}/execute_async`                            | Inject a snippet of JavaScript into the page for asynchronous execution in the context of the currently selected frame.
-GET         | `session/{sessionId}/screenshot`                               | Take a screenshot of the current page.
-GET         | `session/{sessionId}/ime/available_engines`                    | List all available input engines on the machine.
-GET         | `session/{sessionId}/ime/active_engine`                        | Get the name of the active IME engine.
-GET         | `session/{sessionId}/ime/activated`                            | Indicates whether IME input is active at the moment (not if it is available).
-POST        | `session/{sessionId}/ime/deactivate`                           | De-activates the currently-active IME engine.
-POST        | `session/{sessionId}/ime/activate`                             | Make an engine that is available active.
-POST        | `session/{sessionId}/frame`                                    | Change focus to another frame on the page.
-POST        | `session/{sessionId}/window`                                   | Change focus to another window.
-GET         | `session/{sessionId}/window/{windowhandle}/size`               | Get the size of the specified window.
-POST        | `session/{sessionId}/window/{windowhandle}/maximize`           | Maximize the specified window if not already maximized.
-GET         | `session/{sessionId}/cookie`                                   | Retrieve all cookies visible to the current page.
-POST        | `session/{sessionId}/cookie`                                   | Set a cookie.
-DELETE      | `session/{sessionId}/cookie`                                   | Delete all cookies visible to the current page.
-DELETE      | `session/{sessionId}/cookie/{name}`                            | Delete the cookie with the given name.
-GET         | `session/{sessionId}/source`                                   | Get the current page source.
-GET         | `session/{sessionId}/title`                                    | Get the current page title.
-POST        | `session/{sessionId}/element`                                  | Search for an element on the page, starting from the document root.
-POST        | `session/{sessionId}/elements`                                 | Search for multiple elements on the page, starting from the document root.
-POST        | `session/{sessionId}/element/active`                           | Get the element on the page that currently has focus.
-POST        | `session/{sessionId}/element/{elementId}/element`              | Search for an element on the page, starting from the identified element.
-POST        | `session/{sessionId}/element/{elementId}/elements`             | Search for multiple elements on the page, starting from the identified element.
-POST        | `session/{sessionId}/element/{elementId}/click`                | Click on an element.
-POST        | `session/{sessionId}/element/{elementId}/submit`               | Submit a form element.
-GET         | `session/{sessionId}/element/{elementId}/text`                 | Returns the visible text for the element.
-POST        | `session/{sessionId}/element/{elementId}/value`                | Send a sequence of key strokes to an element.
-POST        | `session/{sessionId}/keys`                                     | Send a sequence of key strokes to the active element.
-GET         | `session/{sessionId}/element/{elementId}/name`                 | Query for an element's tag name.
-POST        | `session/{sessionId}/element/{elementId}/clear`                | Clear a text element's value.
-GET         | `session/{sessionId}/element/{elementId}/selected`             | Determine if an element is currently selected.
-GET         | `session/{sessionId}/element/{elementId}/enabled`              | Determine if an element is currently enabled.
-GET         | `session/{sessionId}/element/{elementId}/attribute/{name}`     | Get the value of an element's attribute.
-GET         | `session/{sessionId}/element/{elementId}/equals/{otherId}`     | Test if two element IDs refer to the same element.
-GET         | `session/{sessionId}/element/{elementId}/displayed`            | Determine if an element is currently displayed.
-GET         | `session/{sessionId}/element/{elementId}/location`             | Determine an element's location on the page.
-GET         | `session/{sessionId}/element/{elementId}/location_in_view`     | Determine an element's location on the screen once it has been scrolled into view.
-GET         | `session/{sessionId}/element/{elementId}/size`                 | Determine an element's size in pixels.
-GET         | `session/{sessionId}/element/{elementId}/css/{propertyName}`   | Query the value of an element's computed CSS property.
-GET         | `session/{sessionId}/orientation`                              | Get the current device orientation.
-POST        | `session/{sessionId}/orientation`                              | Set the device orientation
-GET         | `session/{sessionId}/alert_text`                               | Gets the text of the currently displayed dialog
-POST        | `session/{sessionId}/alert_text`                               | Sends keystrokes to the currently displayed dialog
-POST        | `session/{sessionId}/accept_alert`                             | Accepts the currently displayed alert dialog.
-POST        | `session/{sessionId}/dismiss_alert`                            | Dismisses the currently displayed alert dialog.
-POST        | `session/{sessionId}/moveto`                                   | Move the pointer by an offset of the specified element.
-POST        | `session/{sessionId}/click`                                    | Click on the current pointer position.
-POST        | `session/{sessionId}/touch/click`                              | Single tap on the touch enabled device.
-POST        | `session/{sessionId}/touch/down`                               | Finger down on the screen.
-POST        | `session/{sessionId}/touch/up`                                 | Finger up on the screen.
-POST        | `session/{sessionId}/touch/move`                               | Finger move on the screen.
-POST        | `session/{sessionId}/touch/longclick`                          | Long press on the touch screen using finger motion events.
-POST        | `session/{sessionId}/touch/flick`                              | Flick on the touch screen using finger motion events.
-GET         | `session/{sessionId}/location`                                 | Get the current geo location.
-POST        | `session/{sessionId}/location`                                 | Set the current geo location.
-POST        | `session/{sessionId}/log`                                      | Get the log for a given log type.
-GET         | `session/{sessionId}/log/types`                                | Get available log types.
-
-
-### Mobile JSON Wire Protocol endpoints
-
-See https://github.com/SeleniumHQ/mobile-spec/blob/master/spec-draft.md
-
-HTTP Method | Path                                                                   | Details
-------------|------------------------------------------------------------------------|---------
-GET         | `session/{sessionId}/context`                                  | Retrieves the current context.
-POST        | `session/{sessionId}/context`                                  | Switches to the given context.
-GET         | `session/{sessionId}/contexts`                                 | Retrieves an array of strings representing available contexts.
-GET         | `session/{sessionId}/element/{elementId}/pageIndex`            |
-GET         | `session/{sessionId}/network_connection`                       | Retrieves the current network connection type.
-POST        | `session/{sessionId}/network_connection`                       | Sets the network connection to the given type.
-POST        | `session/{sessionId}/touch/perform`                            | Perform the given touch action sequence.
-POST        | `session/{sessionId}/touch/multi/perform`                      | Perform the given multi-touch action sequence.
-POST        | `session/{sessionId}/receive_async_response`                   | Callback url for asynchronous execution of JavaScript.
-
-
-### Appium extension endpoints
-
-See https://w3c.github.io/webdriver/webdriver-spec.html#protocol-extensions
-
-HTTP Method | Path                                                                   | Details
-------------|------------------------------------------------------------------------|---------
-POST        | `session/{sessionId}/appium/device/shake`                      | Perform a shake action on the device.
-POST        | `session/{sessionId}/appium/device/lock`                       | Lock the device.
-POST        | `session/{sessionId}/appium/device/unlock`                     | Unlock the device.
-POST        | `session/{sessionId}/appium/device/is_locked`                  | Check whether the device is locked or not.
-POST        | `session/{sessionId}/appium/start_recording_screen`            | start recording the screen.
-POST        | `session/{sessionId}/appium/stop_recording_screen`             | stop recording the screen.
-POST        | `session/{sessionId}/appium/performanceData/types`             | returns the information types of the system state which is supported to read as like cpu, memory, network traffic, and battery.
-POST        | `session/{sessionId}/appium/getPerformanceData`                | returns the information of the system state which is supported to read as like cpu, memory, network traffic, and battery.
-POST        | `session/{sessionId}/appium/device/press_keycode`              | Press a particular key code on the device.
-POST        | `session/{sessionId}/appium/device/long_press_keycode`         | Press and hold a particular key code on the device.
-POST        | `session/{sessionId}/appium/device/keyevent`                   | Send a key code to the device.
-GET         | `session/{sessionId}/appium/device/current_activity`           | Retrieve the current activity running on the device.
-GET         | `session/{sessionId}/appium/device/current_package`            | Retrieve the current package running on the device.
-POST        | `session/{sessionId}/appium/device/install_app`                | Install the given app onto the device.
-POST        | `session/{sessionId}/appium/device/remove_app`                 | Remove an app from the device.
-POST        | `session/{sessionId}/appium/device/app_installed`              | Check whether the specified app is installed on the device.
-POST        | `session/{sessionId}/appium/device/hide_keyboard`              | Hide the soft keyboard.
-GET         | `session/{sessionId}/appium/device/is_keyboard_shown`          | Whether or not the soft keyboard is shown.
-POST        | `session/{sessionId}/appium/device/push_file`                  | Place a file onto the device in a particular place.
-POST        | `session/{sessionId}/appium/device/pull_file`                  | Retrieve a file from the device's file system.
-POST        | `session/{sessionId}/appium/device/pull_folder`                | Retrieve a folder from the device's file system.
-POST        | `session/{sessionId}/appium/device/toggle_airplane_mode`       | Switch the state of airplane mode.
-POST        | `session/{sessionId}/appium/device/toggle_data`                | Switch the state of data service.
-POST        | `session/{sessionId}/appium/device/toggle_wifi`                | Switch the state of the wifi service.
-POST        | `session/{sessionId}/appium/device/toggle_location_services`   | Switch the state of the location service.
-POST        | `session/{sessionId}/appium/device/open_notifications`         | Open the notifications pane on the device.
-POST        | `session/{sessionId}/appium/device/start_activity`             | Start the specified activity on the device.
-GET         | `session/{sessionId}/appium/device/system_bars`                | Retrieve visibility and bounds information of the status and navigation bars.
-GET         | `session/{sessionId}/appium/device/display_density`            | Retrieve the display density of the device.
-POST        | `session/{sessionId}/appium/simulator/toggle_touch_id_enrollment` | Toggle enrollment of touch id on the simulator.
-POST        | `session/{sessionId}/appium/simulator/touch_id`                | Simulate a successful or failed touch id event on the simulator.
-POST        | `session/{sessionId}/appium/app/launch`                        | Launch the given application on the device.
-POST        | `session/{sessionId}/appium/app/close`                         | Close the given application.
-POST        | `session/{sessionId}/appium/app/reset`                         | Reset the device.
-POST        | `session/{sessionId}/appium/app/background`                    | Send the current application to the background.
-POST        | `session/{sessionId}/appium/app/end_test_coverage`             | End test coverage on the device.
-POST        | `session/{sessionId}/appium/app/strings`                       | Retrieve the application's strings file.
-POST        | `session/{sessionId}/appium/element/{elementId}/value`         | Retrieve the value from the given element.
-POST        | `session/{sessionId}/appium/element/{elementId}/replace_value` | Replace the value of the given element.
-GET         | `session/{sessionId}/appium/settings`                          | Retrieve a JSON hash of all the currently specified settings.
-POST        | `session/{sessionId}/appium/settings`                          | Update the current setting on the device.
-POST        | `session/{sessionId}/appium/receive_async_response`            | Callback url for asynchronous execution of JavaScript.
-
-
-
-
-### Not implemented
-
-The following routes are not implemented by any Appium driver, and will throw an error.
-
-HTTP Method | Path                                                                   | Details
-------------|------------------------------------------------------------------------|---------
-POST        | `session/{sessionId}/frame/parent`                             | Change focus to the parent frame.
-POST        | `session/{sessionId}/window/{windowhandle}/size`               | Change the size of the specified window.
-GET         | `session/{sessionId}/window/{windowhandle}/position`           | Get the position of the specified window.
-POST        | `session/{sessionId}/window/{windowhandle}/position`           | Change the position of the specified window.
-GET         | `session/{sessionId}/element/{elementId}`                      | Describe the identified element.
-POST        | `session/{sessionId}/buttondown`                               | Click and hold the left mouse button (at the coordinates set by the last moveto command).
-POST        | `session/{sessionId}/buttonup`                                 | Releases the mouse button previously held (where the mouse is currently at).
-POST        | `session/{sessionId}/doubleclick`                              | Double-clicks at the current mouse coordinates (set by moveto).
-POST        | `session/{sessionId}/touch/scroll`                             | Scroll on the touch screen using finger based motion events.
-POST        | `session/{sessionId}/touch/doubleclick`                        | Double tap on the touch screen using finger motion events.
-GET         | `session/{sessionId}/local_storage`                            | Get all keys of the storage.
-POST        | `session/{sessionId}/local_storage`                            | Set the storage item for the given key.
-DELETE      | `session/{sessionId}/local_storage`                            | Clear the storage.
-GET         | `session/{sessionId}/local_storage/key/{key}`                  | Get the storage item for the given key.
-DELETE      | `session/{sessionId}/local_storage/key/{key}`                  | Remove the storage item for the given key.
-GET         | `session/{sessionId}/local_storage/size`                       | Get the number of items in the storage.
-GET         | `session/{sessionId}/session_storage`                          | Get all keys of the storage.
-POST        | `session/{sessionId}/session_storage`                          | Set the storage item for the given key.
-DELETE      | `session/{sessionId}/session_storage`                          | Clear the storage.
-GET         | `session/{sessionId}/session_storage/key/{key}`                | Get the storage item for the given key.
-DELETE      | `session/{sessionId}/session_storage/key/{key}`                | Remove the storage item for the given key.
-GET         | `session/{sessionId}/session_storage/size`                     | Get the number of items in the storage.
-GET         | `session/{sessionId}/application_cache/status`                 | Get the status of the html5 application cache.