Wiki source code of Track: Tests
Last modified by Nikita Petrenko on 2025/04/27 14:16
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{box cssClass="floatinginfobox" title="**Contents**"}} | ||
| 2 | {{toc/}} | ||
| 3 | {{/box}} | ||
| 4 | |||
| 5 | In order to make sure an issue will not reappear inside XWiki, you should write a test to verify the desired behaviour. | ||
| 6 | |||
| 7 | = Task 1: Find a test case = | ||
| 8 | |||
| 9 | [[Manual testing>>Community.Testing||anchor="HManualtesting"]] is done following a test plan. We hold our test cases and run instances in our [[Manual test reports>>test:Main.WebHome]] wiki. | ||
| 10 | |||
| 11 | {{comment}} | ||
| 12 | = Task 1: Create a test case = | ||
| 13 | |||
| 14 | You should create a new test case on the [[Tests wiki>>test:Main.WebHome]] for an XWiki feature / extension of your choice or on the issue you've reported. Run this test case on the latest XWiki version for multiple browsers, databases. Make sure the test case doesn't already exist. | ||
| 15 | {{/comment}} | ||
| 16 | |||
| 17 | = Task 2: Run a test case = | ||
| 18 | |||
| 19 | You can select any test case from our Tests wiki and run it locally on a recently [[downloaded>>xwiki:Download.WebHome]] XWiki. | ||
| 20 | |||
| 21 | You should use a combination of XWiki versions, Browser type+version, and Database type+version when running your tests to ensure there are no browser incompatibilities. In order to see what browsers and databases we support, you should check XWiki's [[support strategy>>Community.SupportStrategy]]. | ||
| 22 | |||
| 23 | If you are not sure what to test, another variant would be to test an issue from our recent releases. See the [[Test Reports>>xwiki:TestReports.WebHome]] and check where your help is needed. The test cases for a particular XWiki version can be found in the [[Product Versions>>test:QA.Management||anchor="HExistingProductVersions"]] livetable. | ||
| 24 | |||
| 25 | If you have run tests for an extension, report the compatibility of extensions with XWiki versions. Go to the [[extension you tested>>extensions:Main.WebHome]], edit the page, and fill in the Compatibility field. | ||
| 26 | |||
| 27 | = Task 3: Create an automated test = | ||
| 28 | |||
| 29 | All manual test cases could be transformed into automated tests. Read more about creating a [[functional test>>Community.Testing||anchor="HFunctionalTesting"]]. | ||
| 30 | |||
| 31 | All our automated tests are monitored and run for each commit inside XWiki Platform or our Recommended extensions. You can check their pass status [[locally>>Community.Building||anchor="HUsingProfiles"]] or remotely on [[ci.xwiki.org>>http://ci.xwiki.org/]], which is our continuous integration tool. |
