gecko-dev/devtools/docs/tests
Tom Ritter e751bb508a Bug 1592297 - Remove MOZ_QUIET and disable this output by default. r=mccr8,jdescottes
Instead of setting MOZ_QUIET to hide the DOMWINDOW and DOCSHELL log messages, you
now must set a regular logging module to enable them. They are automatically enabled
on tests that rely on these messages are leak checking.

That module is DocShellAndDOMWindowLeak:3

One disadvantage of this change is that you cannot set MOZ_QUIET to hide these
messages when running those tests (primarily browser-chrome).

Differential Revision: https://phabricator.services.mozilla.com/D52413

--HG--
extra : moz-landing-system : lando
2019-12-02 15:41:35 +00:00
..
README.md
debugging-intermittents.md Bug 1500110 - Improve the debuggin intermittents documentation; r=sole 2018-10-19 09:14:20 +00:00
mochitest-chrome.md
mochitest-devtools.md Bug 1558755 - Add docs on how to run mochitests in headless mode, r=pbro,nchevobbe 2019-06-21 07:55:28 +00:00
node-tests.md Bug 1589597 - Mention compatibility node test suite in the docs r=ladybenko 2019-10-18 14:10:29 +00:00
perfherder-compare-link.png
perfherder-compare.png
perfherder-create-gecko-profile.png Bug 1556652 - Document how to create perf profiles on try for DAMP r=nchevobbe 2019-06-04 12:44:57 +00:00
perfherder-damp.png
perfherder-filter-subtests.png
perfherder-subtests.png
performance-tests.md Bug 1587491 - Update DAMP try command documentation r=nchevobbe 2019-10-09 16:08:41 +00:00
regression-graph.png
regression-popup.png
writing-perf-tests-example.md Bug 1576835 - Update DAMP test writing documentation r=ochameau 2019-08-29 06:22:18 +00:00
writing-perf-tests-tips.md Bug 1576835 - Update DAMP test writing documentation r=ochameau 2019-08-29 06:22:18 +00:00
writing-perf-tests.md Bug 1576835 - Update DAMP test writing documentation r=ochameau 2019-08-29 06:22:18 +00:00
writing-tests.md Bug 1568779 - Remove editors settings comments in devtools files. r=pbro. 2019-08-19 12:48:16 +00:00
xpcshell.md

README.md

Automated tests

When working on a patch for DevTools, there's almost never a reason not to add a new test. If you are fixing a bug, you probably should write a new test to prevent this bug from occurring again. If you're implementing a new feature, you should write new tests to cover the aspects of this new feature.

Ask yourself:

  • Are there enough tests for my patch?
  • Are they the right types of tests?

We use three suites of tests:

  • xpcshell: Unit-test style of tests. No browser window, only a JavaScript shell. Mostly testing APIs directly.
  • Chrome mochitests: Unit-test style of tests, but with a browser window. Mostly testing APIs that interact with the DOM.
  • DevTools mochitests: Integration style of tests. Fires up a whole browser window with every test and you can test clicking on buttons, etc.

More information about the different types of tests can be found on the automated testing page at MDN.

To run all DevTools tests, regardless of suite type:

./mach test devtools/*

Have a look at the child pages for more specific commands for running only a single suite or single test in a suite.