@dlenroc/appium-html-driver v0.2.0

Appium HTML Driver ·

Appium HTML Driver is a WebDriver that allows controlling applications written using web technologies, regardless of the device they are running on.

Installation

appium driver install --source npm @dlenroc/appium-html-driver

Usage

1. Instrumentation

   Inject the following code in every HTML file that belongs to your application.

   <script src="{origin}/appium-html-driver/js?udid={udid}&handle={handle}"></script>

   Where:

   • origin - address of the Appium server, for example: http://192.168.0.2:4723.
   • udid (optional) - identifier that represent your device, default to client's IP address.
   • handle (optional) - identifier that will represent the window handle.

2. Attach and run test

   await driver = await remote({
     'capabilities': {
       'platformName': 'html',
       'appium:automationName': 'html',
       'appium:udid': udid
     },
   });
   
   /**
    * Load instrumented page manually, via cli or in any other way
    *
    * NOTE: that is not driver's responsibility
    */
   
   // Attach to target
   const handles = await driver.getWindowHandles();
   await driver.switchToWindow(handles[0]);
   
   // Conduct testing
   await driver.getUrl()
     .should.eventually.be.fulfilled;

Capabilities

Commands