Sylvestre Ledru
8f033c8241
Convert testing/{awsy,condprofile,docs,geckodriver,marionette,
mozbase,mozharness,perfdocs,performance,raptor,talos,web-platform}
RST documentation files to MyST-flavored Markdown.
Skips testing/perfdocs/generated/* (auto-generated by mach perfdocs)
and testing/web-platform/tests/* (third-party test trees).
- Move treeherder-try frontmatter substitutions under the new myst
topmatter key.
- Allow the pre-existing autodoc Unknown target warning for
mozprofile.permissions to keep the build clean.
- Refresh allowed-warnings glob for manifest-sandbox download from
.rst to .md.
Differential Revision: https://phabricator.services.mozilla.com/D304228
1.6 KiB
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()