NAME

       Weasel::DriverRole - API definition for driver wrappers

VERSION

       0.02

SYNOPSIS

         use Moose;
         use Weasel::DriverRole;

         with 'Weasel::DriverRole';

         ...  # (re)implement the functions in Weasel::DriverRole

DESCRIPTION

       This module defines the API for all Weasel drivers to be implemented.

       By using this role in the driver implementation module, an abstract method is implemented croak()ing if
       it's called.

ATTRIBUTES

       started
           Every  session  is  associated  with a driver instance. The "started" attribute holds a boolean value
           indicating whether or not the driver is ready to receive driver commands.

           The value managed by the "start" and "stop" methods.

METHODS

       implements
           This method returns the version number of the API which it fully implements.

           Weasel::Session may carp (warn) the user about mismatching API levels  in  case  a  driver  is  coded
           against an earlier version than $Weasel::DriverRole::VERSION.

       start
           This  method  allows  setup of the driver. It is invoked before any web driver methods as per the Web
           driver methods section below.

       stop
           This method allows tear-down of the driver. After tear-down, the "start" method may be called  again,
           so the this function should leave the driver in a restartable state.

       restart
           This function stops (if started) and starts the driver.

   Web driver methods
       Terms

       element_id / parent_id
           These are opaque values used by the driver to identify DOM elements.

           Note: The driver should always accept an xpath locator as an id value
             as well as id values returned from earlier driver calls

       API

       find_all( $parent_id, $locator, $scheme )
           Returns the _id values for the elements to be instantiated, matching the $locator using "scheme".

           Depending on array or scalar context, the return value is a list or an arrayref.

           Note:  there's  no  function  to  find  a  single  element.  That  function  is  implemented  on  the
           "Weasel::Session" level.

       get( $url )
           Loads the page at $url into the driver's browser (browser emulator).

           The $url passed in has been expanded by "Weasel::Session", prepending a registered prefix.

       is_displayed($element_id)
           Returns a boolean value indicating whether the element indicated by $element_id is interactable  (can
           be selected, clicked on, etc)

       wait_for( $callback, retry_timeout => $num, poll_delay => $num )
           The driver may interpret the 'poll_delay' in one of two ways:
            1. The 'poll_delay' equals the number of seconds between the start of
               successive poll requests
            2. The 'poll_delay' equals the number of seconds to wait between the end
               of one poll request and the start of the next

           Note: The user should catch inside the callback any exceptions that are
             thrown inside the callback, unless such exceptions are allowed to
             terminate further polling attempts.
             I.e. this function doesn't guard against early termination by
             catching exceptions.

       clear($element_id)
           Clicks on an element if an element id is provided, or on the current mouse location otherwise.

       click( [ $element_id ] )
           Clicks on an element if an element id is provided, or on the current mouse location otherwise.

       dblclick()
           Double clicks on the current mouse location.

       get_attribute($element_id, $attribute_name)
           Returns the value of the attribute named by $attribute_name of the element indicated by $element_id.

       get_page_source($fh)
           Writes a get_page_source of the browser's window to the filehandle $fh.

       get_text($element_id)
           Returns the HTML content of the element identified by $element_id, the so-called 'innerHTML'.

       set_attribute($element_id, $attribute_name, $value)
           Changes  the  value of the attribute named by $attribute_name to $value for the element identified by
           $element_id.

       get_selected($element_id)
       set_selected($element_id, $value)
       screenshot($fh)
           Takes a screenshot and writes the image to the file handle $fh.

           Note: In the current version of the driver, it's assumed the
             driver writes a PNG image. Later versions may add APIs to
             get/set the type of image generated.

       send_keys($element_id, @keys)
           Simulates key input into the element identified by $element_id.

           @keys is an array of (groups of) inputs; multiple multi-character strings  may  be  listed.  In  such
           cases the input will be appended. E.g.

             $driver->send_keys($element_id, "hello", ' ', "world");

           is valid input to enter the text "hello world" into $element_id.

           Note: Special keys are encoded according to the WebDriver spec.
            In case a driver implementation needs differentt encoding of
            special keys, this function should recode from the values
            found in WebDriver::KEYS() to the desired code-set

       tag_name($element_id)
           The name of the HTML tag identified by $element_id.

SEE ALSO

       Weasel

COPYRIGHT

        (C) 2016  Erik Huelsmann

       Licensed under the same terms as Perl.

perl v5.26.1                                       2017-10-05                            Weasel::DriverRole(3pm)