interactive.rst - mozsearch

Enable keyboard shortcuts

Using the Client Interactively

==============================

Once you installed the client and have Marionette running, you can fire

up your favourite interactive python environment and start playing with

Marionette. Let's use a typical python shell:

.. parsed-literal::

   python

First, import Marionette:

.. parsed-literal::

   from marionette_driver.marionette import Marionette

Now create the client for this session. Assuming you're using the default

port on a Marionette instance running locally:

.. parsed-literal::

   client = Marionette(host='127.0.0.1', port=2828)

   client.start_session()

This will return some id representing your session id. Now that you've

established a connection, let's start doing interesting things:

.. parsed-literal::

   client.navigate("http://www.mozilla.org")

Now you're at mozilla.org! You can even verify it using the following:

.. parsed-literal::

   client.get_url()

You can execute Javascript code in the scope of the web page:

.. parsed-literal::

   client.execute_script("return window.document.title;")

This will you return the title of the web page as set in the head section

of the HTML document.

Also you can find elements and click on those. Let's say you want to get

the first link:

.. parsed-literal::

   from marionette_driver import By

   first_link = client.find_element(By.TAG_NAME, "a")

first_link now holds a reference to the first link on the page. You can click it:

.. parsed-literal::

   first_link.click()