Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
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.
Contents
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:
- Check out the test plugin containing the tests you want to run, along with any prerequisite plug-ins. All tests need at least the org.junit plugin, and org.eclipse.core.tests.harness.
- 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. For UI tests, the class UiTestSuite can be used to run all tests in that plugin. For core tests, each plugin contains an AutomatedTests class that contains all the tests from that plugin.
- Select Run > Run...
- Choose the "JUnit Plug-in Test" category, and click the button to create a new test
- 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".
- Click Run.
Session tests
See the Session Tests page.
Performance tests
See the Performance Tests How-to