> For the complete documentation index, see [llms.txt](https://docs.puppetry.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.puppetry.app/master/running-tests.md).

# Running tests

When we are ready with our test suite we can run the tests. Click on **Run..** item in the main menu (or press **F6**).

![Run tests menu item](https://2843146877-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LdyKJ-zzeS2hB7DF04J%2F-Lh_4AU-36jaAM8BBrDG%2F-Lh_4MS0_BVJ9fXnADzm%2Frun-tests.png?alt=media\&token=124bd4af-2836-48a7-a3a4-a361f4780655)

You get **Run reports** modal window

![Run reports modal window](https://2843146877-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LdyKJ-zzeS2hB7DF04J%2F-Lh_4AU-36jaAM8BBrDG%2F-Lh_4isNh4JBLSb0YVQK%2Frun-tests-modal-1.png?alt=media\&token=c84ebc69-630e-479b-a33e-94a136864826)

By default Puppetry runs tests in headless mode, meaning it launches Chromium in background. You can make to run the tests in Chrome browser with **Run in browser** switch:

![Chmonim options](https://2843146877-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LdyKJ-zzeS2hB7DF04J%2F-Lh_4AU-36jaAM8BBrDG%2F-Lh_57y6IMojqXU2vGKg%2Frun-tests-modal-2.png?alt=media\&token=88a93dea-a316-4e12-833a-b91258569db6)

This opens an input for [Chromium command line options](https://peter.sh/experiments/chromium-command-line-switches/)

 The modal window also allows you to select a [target environment](https://docs.puppetry.app/template):

![Selecting target environment](https://2843146877-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LdyKJ-zzeS2hB7DF04J%2F-Lh_F3-nu5cviLGb5zei%2F-Lh_F9wkSHAae-ZuBKyV%2Frun-tests-modal-3.png?alt=media\&token=007572d3-fda0-403b-a997-c2d54cb3131a)

Finally we can select which suites we are going to run

After pressing **Run** button Puppetry opens panel **Test report** with test results. When test ran successfully we get a page like that:

![Successful test run ](https://2843146877-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LdyKJ-zzeS2hB7DF04J%2F-Lh_F3-nu5cviLGb5zei%2F-Lh_Huv9P4Ovol73bklZ%2Ftest-report-ok.png?alt=media\&token=044cef2e-4490-4079-83fa-0e40795ea781)

If we click on Open directory with generated screenshots link we can see generated folder named after the test case where we can find the screenshot:

![Generated screenshot](https://2843146877-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LdyKJ-zzeS2hB7DF04J%2F-LhLe3x0LuRGU_qC2O-F%2F-LhLfspmHAqA5yqYGgzv%2Fp-screenshot-folder.png?alt=media\&token=e62abdd2-a4a2-4ddd-9ba5-708d81be1ef1)

However if test failed the page look as follows:

![Errored test run](https://2843146877-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LdyKJ-zzeS2hB7DF04J%2F-Lh_F3-nu5cviLGb5zei%2F-Lh_HxTy-iF-xQh72dOr%2Ftest-report-fail.png?alt=media\&token=49b3687b-487f-4c2f-96f8-5cc9bc853bd9)

If the error message doesn't clarify the failure enough, you can click on **Error details** link:

![Test run error details](https://2843146877-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LdyKJ-zzeS2hB7DF04J%2F-Lh_F3-nu5cviLGb5zei%2F-Lh_HzwhzekG3ElMNu6M%2Ftest-report-fail-details.png?alt=media\&token=29511754-bef3-441f-a2f2-0a048a1e0147)