Example command reference

Example command reference

Overview

Here is my attempt at helping others learn to use this binding. Others out there who are more experienced with this PHP binding, please add to this page as you get to it please.

Working with elements

NOTE: some examples below may be done shorthand, in single line chained calls from the session object, though if we wanted to perform several actions on the same element, we could save the WebDriverElement into a variable and then make subsequent calls from that element.

Getting text of an element

$result = $session->element('id','signin')->text();

Clicking an element (link, checkbox, etc.)

//POST w/ empty data to click command.  using just click() may work for you too.
$session->element('id','signin')->click("");

Typing into text field

Values must be sent as an array of key presses.

You could use a function from another webdriver php project (https://github.com/chibimagic/WebDriver-PHP):

function split_keys($toSend){
    $payload = array("value" => preg_split("//u", $toSend, -1, PREG_SPLIT_NO_EMPTY));
    return $payload;
}

This can be used:

$session->element("id", "element id")->value(split_keys("I want to send this"))

Or more simply, it may work to just do:

$session->value(array('value' => str_split("I want to send this")));

Or you can try setting the text inputs value directly via javascript like this:

$script = 'arguments[0].value = arguments[1];';
$args = array(array('ELEMENT' => $this->getID()), "I want to send this")));
$session->execute(array('script' => $script, 'args' => $args));

Get attribute of an element

$attr = $session->element('id','signin')->attribute('maxlength');

Get value of an input element

// no direct method to call like $element->value(); since that is not in the protocol
$element->attribute("value");

More commands to come...

Executing JavaScript

Synchronous script execution

Remember that the script you run is implicitly inserted into an anonymous javascript function. That means if you want to access global variables, you have to use the full name of the variable, for example window.document

$sScriptResult = $session->execute(array(
  'script' => 'return window.document.location.hostname',
  'args' => array(),
));

$sScriptResult now holds the value of the current document hostname

Asynchronous script execution

Make sure you tell the server how long it should wait before it gives up on your script and throws a timeout exception.

// wait at most 5 seconds before giving up with a timeout exception
$session->timeouts()->async_script(array('ms'=>5000));

Similar to synchronous script, the async script is wrapped in an anonymous function.

Simple example

$sResult = $session->execute_async(array(
  'script' => 'arguments[arguments.length-1]("done");',
  'args' => array(),
));

$sResult == "done"

More complex example

In the example below, we poll the global window.MY_STUFF_DONE value at regular intervals, waiting for it to exist with a non-false value. Once we see it, we return back to the calling php-webdriver code with the value "done".

// define the javascript code to execute. This just checks at a periodic
// interval to see if your page created the window.MY_STUFF_DONE variable
$sJavascript = <<<END_JAVASCRIPT

var callback = arguments[arguments.length-1], // webdriver async script callback
    nIntervalId; // setInterval id to stop polling

function checkDone() {
  if( window.MY_STUFF_DONE ) {
    window.clearInterval(nIntervalId); // stop polling
    callback("done"); // return "done" to PHP code
  }
}

nIntervalId = window.setInterval( checkDone, 50 ); // start polling
END_JAVASCRIPT;

$sResult = $session->execute_async(array(
  'script' => $sJavascript,
  'args' => array(),
));

$sResult == "done"