gecko-dev/testing/marionette
Henrik Skupin cb6d8c72b5 Bug 1414322 - Use WebDriver conformant interactability checks for sendKeysToElement. r=ato
Enables webdriver spec keyboard interactability tests for 'Element Send Keys'
by default by re-using the same capability 'moz:webdriverClick' from
'Element Click'. It can be disabled by turning off this preference.

Also various webplatform tests for webdriver spec have been added which
cover both the scroll into view action, and keyboard interactability check.

Existing Marionette unit tests will be run in both modes, until we can
get rid of the legacy mode.

MozReview-Commit-ID: dFB8sQ6CN5

--HG--
extra : rebase_source : 9f6a3c3e42f779f039f61d0b239f9f5925ecdcf5
2017-11-10 20:29:04 +01:00
..
chrome
client Bug 1420098 - Release Marionette driver 2.5.0 and harness 4.3.0. r=ato 2017-11-30 15:20:36 +01:00
components Bug 1405279 - Remove unused variables. r=whimboo 2017-10-03 14:35:47 +01:00
doc Bug 1352497 - Remove about:healthreport. r=gfritzsche,nechen 2017-11-28 11:38:15 +01:00
harness Bug 1414322 - Use WebDriver conformant interactability checks for sendKeysToElement. r=ato 2017-11-10 20:29:04 +01:00
prefs Bug 1376128 - Expose unrecognised eslint globals; r=automatedtester 2017-06-28 11:04:14 -07:00
puppeteer Bug 1408044 - fix miscellaneous tests that depended on about: existing, r=dao 2017-11-15 17:19:33 +00:00
.eslintrc.js Bug 1371293 - Upgrade ESLint to version 4.8.0, configuration changes. r=mossop 2017-10-09 10:54:16 +01:00
.jsdoc.js Bug 1405757 - Generate Marionette API docs to testing/marionette/doc/api. r=me 2017-10-04 18:35:12 +01:00
CONTRIBUTING.md NO BUG - Add Marionette contribution guide. r=me 2017-11-23 11:24:51 +00:00
README.md Bug 1407990 - Move protocol definition to doc/Protocol.md. r=maja_zf 2017-10-13 17:08:57 +01:00
accessibility.js Bug 1405279 - Remove unused variables. r=whimboo 2017-10-03 14:35:47 +01:00
action.js Bug 1385476 - Synthesize dblclick MouseEvent when performing webdriver actions; r=maja_zf 2017-11-24 15:53:57 -05:00
addon.js Bug 1408066 - Addon.js install fails if path is incorrect. r=whimboo 2017-10-19 23:31:52 -07:00
assert.js Bug 1106913 - Add assert.acyclic for testing for cyclic objects. r=whimboo 2017-11-24 18:21:03 +00:00
atom.js Bug 1275273 - Remove isElementSelected atom. r=maja_zf 2017-10-11 15:24:03 +01:00
browser.js Backed out changeset 286a5ba56cec (bug 1408508) for eslint failure at testing/marionette/driver.js:881:50 | 'resp' is defined but never used. r=backout 2017-10-18 20:28:15 +02:00
capture.js Bug 1384517 - Fix testing/marionette API docs; r=automatedtester 2017-07-26 13:11:53 +01:00
cert.js Bug 1405279 - Remove unused variables. r=whimboo 2017-10-03 14:35:47 +01:00
cookie.js Bug 1415828 - Accept cookie domains with leading dot character r=ato 2017-11-23 15:33:30 +00:00
dom.js Bug 1405279 - Remove unused variables. r=whimboo 2017-10-03 14:35:47 +01:00
driver.js Bug 1420431 - Return no such element error when on no active element. r=maja_zf 2017-11-24 16:23:02 +00:00
element.js Bug 1414322 - Refactor sendKeysToElement methods. r=ato 2017-11-09 20:39:51 +01:00
error.js Bug 1408454 - Move error.pprint to format.pprint. r=whimboo 2017-10-13 17:59:30 +01:00
evaluate.js Bug 1106913 - Detect cyclic objects when marshaling objects. r=whimboo 2017-11-24 18:21:17 +00:00
event.js Bug 1385476 - Synthesize dblclick MouseEvent when performing webdriver actions; r=maja_zf 2017-11-24 15:53:57 -05:00
format.js Bug 1405474 - Add more attributes for elements in pprint output. r=ato 2017-10-18 20:54:13 +02:00
frame.js Bug 1384956 - Get log level from main process when script is reloaded. r=whimboo 2017-11-11 17:43:24 -08:00
interaction.js Bug 1414322 - Use WebDriver conformant interactability checks for sendKeysToElement. r=ato 2017-11-10 20:29:04 +01:00
jar.mn Bug 1409379 - Move WindowState to new wm module. r=maja_zf 2017-10-17 14:20:52 +01:00
l10n.js Bug 1408044 - stop using about.dtd as an example in firefox-ui/puppeteer/marionette docs/tests, r=whimboo 2017-11-14 23:37:04 +00:00
legacyaction.js Bug 1400256 - Marshal IPC messages to and from frame script. r=whimboo 2017-10-05 17:57:17 +01:00
listener.js Bug 1414322 - Use WebDriver conformant interactability checks for sendKeysToElement. r=ato 2017-11-10 20:29:04 +01:00
mach_commands.py Bug 1390595 - Exit with jsdoc return code from "mach marionette doc". r=whimboo 2017-08-15 20:00:42 +01:00
mach_test_package_commands.py
message.js Bug 1419538 - Marionette log entries should show object details. r=ato 2017-11-30 15:09:32 +01:00
modal.js Bug 1407925 - Don't use application name but ID to determine Firefox. r=ato 2017-10-12 13:21:17 +02:00
moz.build Bug 1411433 - Add docs for marionette and geckodriver to Mozilla Source Tree Docs; r=ato 2017-10-24 18:53:02 -04:00
navigate.js Bug 1406150 - Always throw exceptions by using 'new'. r=maja_zf 2017-10-06 14:07:13 +02:00
packets.js Bug 1406150 - Always throw exceptions by using 'new'. r=maja_zf 2017-10-06 14:07:13 +02:00
proxy.js Bug 1400256 - Serialise IPC messages with evaluate.toJSON. r=whimboo 2017-10-05 17:50:34 +01:00
reftest.js Bug 1411368 - Automatically fix no-multi-spaces issues raised when using ESLint 4. r=mossop 2017-10-26 11:47:01 +01:00
reftest.xul Bug 1363428 - Add reftest-specific endpoints to Marionette, r=ato 2017-06-24 12:03:11 +01:00
server.js Bug 1352497 - Remove about:healthreport. r=gfritzsche,nechen 2017-11-28 11:38:15 +01:00
session.js Bug 1321516 - Switch to WebDriver conformant interactability checks. r=ato 2017-11-01 22:18:39 +01:00
stream-utils.js Bug 1405279 - Remove unused variables. r=whimboo 2017-10-03 14:35:47 +01:00
sync.js Bug 1404946 - Have PollPromise accept an options dictionary. r=whimboo 2017-10-02 17:13:57 +01:00
test_action.js Bug 1400256 - Adapt actions for implicitly unmarshaled elements. r=automatedtester 2017-10-09 19:55:27 +01:00
test_assert.js Bug 1106913 - Add assert.acyclic for testing for cyclic objects. r=whimboo 2017-11-24 18:21:03 +00:00
test_browser.js Backed out changeset 286a5ba56cec (bug 1408508) for eslint failure at testing/marionette/driver.js:881:50 | 'resp' is defined but never used. r=backout 2017-10-18 20:28:15 +02:00
test_cookie.js Bug 1415828 - Accept cookie domains with leading dot character r=ato 2017-11-23 15:33:30 +00:00
test_dom.js Bug 1400225 - Subscribe to and relay web content DOM events. r=automatedtester,whimboo 2017-09-15 17:07:41 +01:00
test_element.js Bug 1410796 - Drop element.isSVGElement. r=whimboo 2017-10-31 19:57:40 +00:00
test_error.js Bug 1405474 - Add more attributes for elements in pprint output. r=ato 2017-10-18 20:54:13 +02:00
test_evaluate.js Bug 1410796 - Add basic evaluate.toJSON tests. r=whimboo 2017-10-31 20:02:07 +00:00
test_format.js Bug 1405474 - Add more attributes for elements in pprint output. r=ato 2017-10-18 20:54:13 +02:00
test_message.js Bug 1403577 - Rename TYPE identifier to Type. r=whimboo 2017-09-30 18:28:32 +01:00
test_navigate.js Bug 1374672 - Don't wait for page load events for identical hash parameters. r=automatedtester 2017-07-07 17:34:27 +02:00
test_session.js Bug 1321516 - Switch to WebDriver conformant interactability checks. r=ato 2017-11-01 22:18:39 +01:00
test_sync.js Bug 1404946 - Have PollPromise accept an options dictionary. r=whimboo 2017-10-02 17:13:57 +01:00
transport.js Bug 1405279 - Remove unused variables. r=whimboo 2017-10-03 14:35:47 +01:00
unit.ini Bug 1410796 - Add basic evaluate.toJSON tests. r=whimboo 2017-10-31 20:02:07 +00:00
wm.js Bug 1409379 - Move WindowState to new wm module. r=maja_zf 2017-10-17 14:20:52 +01:00

README.md

Marionette

Marionette is the remote protocol that lets OOP programs communicate with, instrument, and control Gecko.

Description

Marionette is an automation driver for Mozillas Gecko engine. It can remotely control either the UI or the internal JavaScript of Gecko-based browsers, such as Firefox and Fennec. It can control both the chrome and the content document, giving a high level of control and ability to replicate user interaction. In addition to performing actions on the browser, Marionette can also ready properties and attributes of the DOM.

Usage

Marionette can be activated by passing the -marionette flag. To start Firefox with the remote protocol turned on:

% firefox -marionette
…
1491228343089	Marionette	INFO	Listening on port 2828

This binds to a TCP socket, over which clients can communicate with Marionette using the protocol.

Clients

Clients may be implemented in any language that is capable of writing and receiving data over TCP socket. A reference client is provided. Clients may be implemented both synchronously and asynchronously, although the latter is impossible in protocol levels 2 and earlier due to the lack of message sequencing.

Bugs

Bugs are tracked in the Testing :: Marionette component.

Communication

The mailing list for discussion is tools-marionette@lists.mozilla.org (subscribe, archive). If you prefer real-time chat, there is often someone in the #ateam IRC channel on irc.mozilla.org. Dont ask if you can ask a question, just ask, and please wait for an answer as we might not be in your timezone.