gecko-dev/testing/marionette
Andreas Tolfsen e8b0dd1386 Bug 1442543 - Add type checks for WebDriver:{ExecuteScript,ExecuteAsyncScript}. r=whimboo
Adds type checks for the WebDriver:ExecuteScript and
WebDriver:ExecuteAsyncScript commands.  This should help prevent
accidental programming mistakes with the Marionette Python client.

MozReview-Commit-ID: JjKgG9OWrdL

--HG--
extra : rebase_source : cd652717f6d4b98d396386e2b971d51a7e737725
2018-03-02 13:25:59 +00:00
..
chrome Bug 1331037 - Fix failures in test_localization.py for Fennec. r=ato 2017-01-18 09:47:58 +01:00
client Bug 1436113 - Part 2: Refactor "shield-recipe-client" to "normandy" r=Gijs 2018-03-02 11:18:59 -08:00
components Bug 1428795 - Reset Marionette state when initialisation fails. r=automatedtester 2018-02-26 20:37:58 +00:00
doc Merge mozilla-central to autoland 2018-02-27 12:02:38 +02:00
harness Bug 1426082 - Enable test_transport.py. r=whimboo 2018-02-26 20:09:28 +00:00
prefs Bug 1169290 - Reintroduce marionette.enabled pref. r=maja_zf 2018-01-27 19:03:18 +00:00
puppeteer Bug 1440333 - Part 2 - Rename the "current" attribute to "visible". r=Gijs 2018-02-26 14:31:35 +00:00
.eslintrc.js Bug 1420577 - Add template literals to eslint max-len ignore list. r=ato 2017-12-05 08:06:17 +01:00
CONTRIBUTING.md NO BUG - Fix links in contribution advice. r=me 2018-01-02 14:08:25 +00:00
README.md Bug 1425708 - Link to contribution and source docs in Marionette README. r=maja_zf 2018-01-02 12:20:05 +00:00
accessibility.js Bug 1432992, part 1 - Remove definitions of Ci, Cr, Cc, and Cu. r=florian 2018-02-06 09:36:57 -08:00
action.js Bug 1429338 - Marionette has to honor "moz:useNonSpecCompliantPointerOrigin" capability. r=maja_zf 2018-01-23 17:31:06 +01:00
addon.js Bug 1431533: Part 5a - Auto-rewrite code to use ChromeUtils import methods. r=florian 2018-01-29 15:20:18 -08:00
assert.js Bug 1431533: Part 5a - Auto-rewrite code to use ChromeUtils import methods. r=florian 2018-01-29 15:20:18 -08:00
atom.js Bug 1354211 - Remove clearElement atom. r=automatedtester 2017-12-31 14:57:11 +00:00
browser.js Bug 1432992, part 1 - Remove definitions of Ci, Cr, Cc, and Cu. r=florian 2018-02-06 09:36:57 -08:00
capture.js Bug 1441228 - Correct error returned for invalid input to capture.highlight_. r=whimboo 2018-02-26 17:42:56 +00:00
cert.js Bug 1432992, part 1 - Remove definitions of Ci, Cr, Cc, and Cu. r=florian 2018-02-06 09:36:57 -08:00
cookie.js Bug 1441019 - Migrate cookie module docs to RST. r=whimboo 2018-02-26 10:34:00 +00:00
dom.js Bug 1441019 - Migrate dom module docs to RST. r=whimboo 2018-02-26 11:21:14 +00:00
driver.js Bug 1442543 - Add type checks for WebDriver:{ExecuteScript,ExecuteAsyncScript}. r=whimboo 2018-03-02 13:25:59 +00:00
element.js Bug 1435666 - Part 3: Remove nsIDOMXPathResult. r=bz 2018-02-05 11:39:18 +08:00
error.js Backed out changeset fbe5a80f2f5b (bug 1441226) for linting Doc failures. CLOSED TREE 2018-03-01 16:55:25 +02:00
evaluate.js Bug 1432992, part 1 - Remove definitions of Ci, Cr, Cc, and Cu. r=florian 2018-02-06 09:36:57 -08:00
event.js Bug 1441019 - Remove duplicate namespace declaration. r=whimboo 2018-02-26 11:31:28 +00:00
format.js Bug 1431533: Part 5a - Auto-rewrite code to use ChromeUtils import methods. r=florian 2018-01-29 15:20:18 -08:00
interaction.js Bug 1433463 - WebDriver:ElementSendKeys should not run unfocussing steps. r=automatedtester 2018-02-22 11:26:01 +00:00
jar.mn Bug 1431155 - Move WindowState to Marionette browser module. r=automatedtester 2018-01-17 17:56:25 +00:00
l10n.js Bug 1431533: Part 5a - Auto-rewrite code to use ChromeUtils import methods. r=florian 2018-01-29 15:20:18 -08:00
legacyaction.js Bug 1432992, part 1 - Remove definitions of Ci, Cr, Cc, and Cu. r=florian 2018-02-06 09:36:57 -08:00
listener.js Bug 1442543 - Add type checks for WebDriver:{ExecuteScript,ExecuteAsyncScript}. r=whimboo 2018-03-02 13:25:59 +00:00
mach_commands.py Bug 1441019 - Remove "./mach marionette doc" command. r=whimboo 2018-02-26 11:48:48 +00:00
mach_test_package_commands.py Bug 1407763 - Enable py2 and py3 compat linters for testing/marionette. r=ahal 2018-01-17 16:14:43 +01:00
message.js Bug 1431533: Part 5a - Auto-rewrite code to use ChromeUtils import methods. r=florian 2018-01-29 15:20:18 -08:00
modal.js Bug 1432992, part 1 - Remove definitions of Ci, Cr, Cc, and Cu. r=florian 2018-02-06 09:36:57 -08:00
moz.build Backed out 2 changesets (bug 1403519) for bustage on \python\mozbuild\mozbuild\test\frontend\test_reader.py on a CLOSED TREE 2018-01-17 07:23:40 +02:00
navigate.js Bug 1432992, part 1 - Remove definitions of Ci, Cr, Cc, and Cu. r=florian 2018-02-06 09:36:57 -08:00
packets.js Bug 1432992, part 1 - Remove definitions of Ci, Cr, Cc, and Cu. r=florian 2018-02-06 09:36:57 -08:00
proxy.js Backed out 6 changesets (bug 888600) for beta simulation failures: build bustage on Linux and Windows opt (bug 1442036) and devtools failure browser_net_view-source-debugger.js (bug 1441961). a=backout 2018-03-01 11:51:09 +02:00
reftest.js Bug 1432992, part 1 - Remove definitions of Ci, Cr, Cc, and Cu. r=florian 2018-02-06 09:36:57 -08:00
reftest.xul Bug 1363428 - Add reftest-specific endpoints to Marionette, r=ato 2017-06-24 12:03:11 +01:00
server.js Bug 1428795 - Set MOZ_MARIONETTE in component. r=automatedtester 2018-02-26 20:34:54 +00:00
session.js Bug 1429338 - Marionette has to honor "moz:useNonSpecCompliantPointerOrigin" capability. r=maja_zf 2018-01-23 17:31:06 +01:00
stream-utils.js Bug 1441460 - ESLint's no-define-cc-etc looks at the wrong property item when checking for Cc/Ci/Cu/Cr usage. r=florian 2018-02-23 20:42:17 +00:00
sync.js Bug 1441019 - Migrate sync module docs to RST. r=whimboo 2018-02-26 11:44:32 +00:00
test_action.js Bug 1432992, part 1 - Remove definitions of Ci, Cr, Cc, and Cu. r=florian 2018-02-06 09:36:57 -08:00
test_assert.js Bug 1432992, part 1 - Remove definitions of Ci, Cr, Cc, and Cu. r=florian 2018-02-06 09:36:57 -08:00
test_browser.js Bug 1432992, part 1 - Remove definitions of Ci, Cr, Cc, and Cu. r=florian 2018-02-06 09:36:57 -08:00
test_cookie.js Bug 1432992, part 1 - Remove definitions of Ci, Cr, Cc, and Cu. r=florian 2018-02-06 09:36:57 -08:00
test_dom.js Bug 1432992, part 1 - Remove definitions of Ci, Cr, Cc, and Cu. r=florian 2018-02-06 09:36:57 -08:00
test_element.js Bug 1432992, part 1 - Remove definitions of Ci, Cr, Cc, and Cu. r=florian 2018-02-06 09:36:57 -08:00
test_error.js Backed out changeset fbe5a80f2f5b (bug 1441226) for linting Doc failures. CLOSED TREE 2018-03-01 16:55:25 +02:00
test_evaluate.js Bug 1432992, part 1 - Remove definitions of Ci, Cr, Cc, and Cu. r=florian 2018-02-06 09:36:57 -08:00
test_format.js Bug 1432992, part 1 - Remove definitions of Ci, Cr, Cc, and Cu. r=florian 2018-02-06 09:36:57 -08:00
test_message.js Bug 1432992, part 1 - Remove definitions of Ci, Cr, Cc, and Cu. r=florian 2018-02-06 09:36:57 -08:00
test_navigate.js Bug 1432992, part 1 - Remove definitions of Ci, Cr, Cc, and Cu. r=florian 2018-02-06 09:36:57 -08:00
test_session.js Bug 1429338 - Marionette has to honor "moz:useNonSpecCompliantPointerOrigin" capability. r=maja_zf 2018-01-23 17:31:06 +01:00
test_sync.js Bug 1432992, part 1 - Remove definitions of Ci, Cr, Cc, and Cu. r=florian 2018-02-06 09:36:57 -08:00
transport.js Bug 1441019 - Differentiate WorkerDebuggerTransport implementations. r=whimboo 2018-02-26 11:36:24 +00:00
unit.ini Bug 1410796 - Add basic evaluate.toJSON tests. r=whimboo 2017-10-31 20:02:07 +00:00
wm.js Bug 1431155 - Move WindowState to Marionette browser module. r=automatedtester 2018-01-17 17:56:25 +00: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.

Contributing

If you want to help improve Marionette, we have more information in <CONTRIBUTING.md>. You will find additional development documentation at https://firefox-source-docs.mozilla.org/testing/marionette/marionette.

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.