Eclipse/Testing

The Eclipse Platform is tested during every build by an extensive suite of automated tests. These tests are written using the JUnit test framework. This page contains links to information about how to run and create automated tests for the platform.

Correctness tests

The majority of automated tests are testing for program correctness. A test failure on these tests implies that program behaviour is not as expected by the tests. These tests are run every build on Windows, Linux, and Mac OSX.

Running tests from within Eclipse

Correctness tests can be run manually from within the Eclipse IDE using a "JUnit Plug-in Test" launch configuration:

1. Check out the test plugin containing the tests you want to run, along with any prerequisite plug-ins. Here are some plug-ins you will likely need:

 * org.junit - The JUnit test framework
 * org.eclipse.test - The basic infrastructure for running Eclipse tests
 * org.eclipse.core.tests.harness - Various utility pieces used by many tests
 * org.eclipse.core.tests.runtime - Tests for the runtime component
 * org.eclipse.core.tests.resources - Tests for the resources component
 * org.eclipse.ui.tests.harness - Various utility pieces used by UI tests
 * org.eclipse.ui.tests - Tests for the Eclipse UI

1. In the Navigator or Package Explorer, select the test or test suite you want to run. Each test package typically contains a TestSuite class that contains all the tests in that package. Suites from multiple packages are then aggregated into higher level suites. Here are some useful suites to know about:

 * org.eclipse.ui.tests.UiTestSuite - runs all UI tests
 * org.eclipse.core.tests.runtime.AutomatedTests - runs all runtime tests
 * org.eclipse.core.tests.resources.AutomatedTests - runs all resource tests

1. Select Run > Run...
2. Choose the "JUnit Plug-in Test" category, and click the button to create a new test
3. On the "Main" tab, select the appropriate application for that test. For UI tests, select "org.eclipse.ui.ide.workbench". For core tests, select "[No Application] - Headless Mode".
4. Click Run.

Session tests

Session Tests in Eclipse are tests that require that a new Eclipse session be launched for every test case run. Thus, they have additional requirements regarding controling the environment test cases are run (VM, set of plug-ins available, configuration, instance location, command line parameters) and how results are communicated back to the test runner.

Performance tests

See the Performance Tests How-to