Files
sousa-gecko/testing/marionette/harness
Sylvestre Ledru b49829840c Bug 2038819 - Update marionette-harness setup.py to read README.md r=jdescottes
D304228 renamed testing/marionette/harness/README.rst to README.md but
left setup.py reading README.rst, breaking the marionette-harness pip
install (egg_info) in every test task that pulls in
marionette_requirements.txt.

Differential Revision: https://phabricator.services.mozilla.com/D309405
2026-07-04 10:18:20 +00:00
..

marionette-harness

Marionette is an automation driver for Mozilla's Gecko engine. It can remotely control either the UI or the internal JavaScript of a Gecko platform, such as Firefox. It can control both the chrome (i.e. menus and functions) or the content (the webpage loaded inside the browsing context), giving a high level of control and ability to replicate user actions. In addition to performing actions on the browser, Marionette can also read the properties and attributes of the DOM.

The marionette_harness package contains the test runner for Marionette, and allows you to run automated tests written in Python for Gecko based applications. Therefore it offers the necessary testcase classes, which are based on the unittest framework.

For more information and the repository please checkout:

Example

The following command will run the tests as specified via a manifest file, or test path, or test folder in Firefox:

marionette --binary %path_to_firefox% [manifest_file | test_file | test_folder]

To get an overview about all possible option run marionette --help.