bug 1547700: remote: document headless mode for M-bc tests; r=me a=doc
authorAndreas Tolfsen <ato@sny.no>
Mon, 29 Apr 2019 14:24:33 +0100
changeset 471737 c59a8b50305b960e027e5dc83c04d3f8a95b68ff
parent 471736 5ce9edd26ca11e54d49980e92afc2ac73eca3383
child 471738 a14cf357555a477bc2fcfbe746a3d9d33ffee171
push id35933
push usercsabou@mozilla.com
push dateMon, 29 Apr 2019 16:02:45 +0000
treeherdermozilla-central@e8aebe488b2f [default view] [failures only]
perfherder[talos] [build metrics] [platform microbench] (compared to previous push)
reviewersme, doc
bugs1547700
milestone68.0a1
first release with
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
last release without
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
bug 1547700: remote: document headless mode for M-bc tests; r=me a=doc DONTBUILD
remote/doc/Testing.md
--- a/remote/doc/Testing.md
+++ b/remote/doc/Testing.md
@@ -29,9 +29,21 @@ Functional tests
 We also have a set of functional [browser chrome] tests located
 under _remote/test/browser_:
 
 	% ./mach mochitest remote/test/browser/browser_cdp.js
 
 The functional tests will appear under the `M` (for _mochitest_)
 category in the `bc` (_browser-chrome_) jobs on Treeherder.
 
+As the functional tests will sporadically pop up new Firefox
+application windows, a helpful tip is to run them in [headless
+mode]:
+
+	% ./mach mochitest --headless remote/test/browser
+
+The `--headless` flag is equivalent to setting the `MOZ_HEADLESS`
+environment variable.  You can additionally use `MOZ_HEADLESS_WIDTH`
+and `MOZ_HEADLESS_HEIGHT` to control the dimensions of the virtual
+display.
+
 [browser chrome]: https://developer.mozilla.org/en-US/docs/Mozilla/Browser_chrome_tests
+[headless mode]: https://developer.mozilla.org/en-US/Firefox/Headless_mode