Client test runner
The Client Test Runner opens a browser window or tab for running manually-started client automated tests.
You can toggle a client test runner to act as either a manual or scheduled client test runner. For more information about scheduling test suites, see Schedule an automated test suite.
|
Field / UI Element |
Description |
|---|---|
|
Form preferences icon ([Omitted image "Form_PersonalizeFormIcon.png"] Alt text: Personalize form icon) |
Click to display the form preferences panel. |
|
Form preferences panel: Screenshots mode |
Choose among:- Enable for all steps
For additional information, see Set the system property to control when the Automated Test Framework captures screenshots |
|
Form preferences panel: Run scheduled tests only |
Click to toggle between:- On (green): Use this client test runner to run only scheduled tests and suites.
|
--- title: Client test runner description: The Client Test Runner opens a browser window or tab for running manually-started client automated tests. locale: en-US canonical_url: https://www.servicenow.com/docs/r/australia/application-development/automated-test-framework-atf/atf-client-test-runner-module.html release: australia product: Automated Test Framework \(ATF\) classification: automated-test-framework-atf topic_type: reference last_updated: "2026-09-10" reading_time_minutes: 1 breadcrumb: [Run, Automated Test Framework \(ATF\) reference, Automated Test Framework \(ATF\), Testing and debugging applications, Classic app development, Building applications] --- # Client test runner The Client Test Runner opens a browser window or tab for running manually-started client automated tests. You can toggle a client test runner to act as either a manual or scheduled client test runner. For more information about scheduling test suites, see [Schedule an automated test suite](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/atf-sched-suite-steps.md). <table id="table_vtz_r4g_sz"><thead><tr><th> Field / UI Element </th><th> Description </th></tr></thead><tbody><tr><td> Form preferences icon \(\[Omitted image "Form\_PersonalizeFormIcon.png"\] Alt text: Personalize form icon\) </td><td> Click to display the form preferences panel. </td></tr><tr><td> Form preferences panel: Screenshots mode </td><td> Choose among:- Enable for all steps - Enable for failed steps - Disable for all steps For additional information, see [Set the system property to control when the Automated Test Framework captures screenshots](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/atf-screenshot-modes.md) </td></tr><tr><td> Form preferences panel: Run scheduled tests only </td><td> Click to toggle between:- On \(green\): Use this client test runner to run only scheduled tests and suites. - Off \(gray\): Use this client test runner to run only manually-started tests and suites. </td></tr></tbody> </table>**Parent Topic:**[Run](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/application-development/automated-test-framework-atf/run-module.md)
| title | Client test runner |
| description | The Client Test Runner opens a browser window or tab for running manually-started client automated tests. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/australia/application-development/automated-test-framework-atf/atf-client-test-runner-module.html |
| release | australia |
| product | Automated Test Framework \(ATF\) |
| classification | automated-test-framework-atf |
| topic_type | reference |
| last_updated | 2026-09-10 |
| reading_time_minutes | 1 |
| breadcrumb | RunAutomated Test Framework \(ATF\) referenceAutomated Test Framework \(ATF\)Testing and debugging applicationsClassic app developmentBuilding applications |