Track: Tests

Last modified by Nikita Petrenko on 2025/04/27 14:16

In order to make sure an issue will not reappear inside XWiki, you should write a test to verify the desired behaviour. 

Task 1: Find a test case

Manual testing is done following a test plan. We hold our test cases and run instances in our Manual test reports wiki.

Task 2: Run a test case

You can select any test case from our Tests wiki and run it locally on a recently downloaded XWiki. 

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

If you are not sure what to test, another variant would be to test an issue from our recent releases. See the Test Reports and check where your help is needed. The test cases for a particular XWiki version can be found in the Product Versions livetable.

If you have run tests for an extension, report the compatibility of extensions with XWiki versions. Go to the extension you tested, edit the page, and fill in the Compatibility field.

Task 3: Create an automated test

All manual test cases could be transformed into automated tests. Read more about creating a functional test.

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 or remotely on ci.xwiki.org, which is our continuous integration tool. 

Get Connected