Getting the Client
We officially support a python client. The latest supported version of the client is available on pypi, so you can download it via pip. This client should be used within a virtual environment to ensure that your environment is pristine:
virtualenv venv source venv/bin/activate pip install marionette_client
If you wish to implement your own client, then you can communicate with the Marionette server via WebDriver commands.
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:
python from marionette import Marionette
Now create the client for this session. Assuming you're using the default port on a Marionette instance running locally:
client = Marionette(host='localhost', 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:
client.execute_script("alert('o hai there!');")
You should now see this alert pop up! How exciting! Okay, let's do something practical. Close the dialog and try this:
Now you're at mozilla.org! You can even verify it using the following:
You can even find an element and click on it. Let's say you want to get the first link:
first_link = client.find_element("tag name", "a") #uses "tag name" as a search strategy. For different strategies, see HTML interaction
first_link now holds a reference to the first link on the page. You can click it:
For more information of what you can do with this client, check out our API.
Using the Client for Testing
See our Marionette Tests section.