> For the complete documentation index, see [llms.txt](https://docs.does.qa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.does.qa/test-steps/runner.md).

# Runner

Runner Test Steps act on the Test Runner that is executing the Test Case. Use them to wait for page state, move into frames or windows, set headers, stop early, or generate files for later steps.

## Wait

For Exists, Displayed, Visible, and related Element waits, see [Element states](/test-step-options/element-states.md).

| Test Step                                                                                                    | Use it to                             |
| ------------------------------------------------------------------------------------------------------------ | ------------------------------------- |
| [Pause](/test-steps/runner/pause.md)                                                                         | Wait for a fixed number of seconds    |
| [Wait For Element To Be Displayed](/test-steps/runner/wait-for-element-to-be-displayed.md) and related waits | Wait until an Element reaches a state |
| [Wait For Element Text](/test-steps/runner/wait-for-element-text.md)                                         | Wait until Element text matches       |

Touch and many other Actions already wait and scroll. Add an explicit wait when the Flow needs to pause on a state before the next step.

## Frames and windows

| Test Step                                                              | Use it to                         |
| ---------------------------------------------------------------------- | --------------------------------- |
| [Switch Frame](/test-steps/runner/switch-frame.md)                     | Focus inside an iframe            |
| [Switch To Parent Frame](/test-steps/runner/switch-to-parent-frame.md) | Return focus outside the iframe   |
| [Switch Window](/test-steps/runner/switch-window.md)                   | Switch the current browser window |

## Headers, stop conditions, and generation

| Test Step                                                                                                                                                                                                                                    | Use it to                                       |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- |
| [Add Header](/test-steps/runner/add-header.md) / [Set Header](/test-steps/runner/set-header.md) / [Remove All Headers](/test-steps/runner/remove-all-headers.md)                                                                             | Control request headers                         |
| [Stop When Element Is Displayed](/test-steps/runner/stop-when-element-is-displayed.md) / [Stop When Element Not Displayed](/test-steps/runner/stop-when-element-not-displayed.md) / [Stop When Value](/test-steps/runner/stop-when-value.md) | End the Test Case early when a condition is met |
| [Condition](/test-steps/runner/condition.md)                                                                                                                                                                                                 | Include Test Cases only when a condition is met |
| [Generate File](/test-steps/runner/generate-file.md) / [Generate Image](/test-steps/runner/generate-image.md)                                                                                                                                | Create a file or image during the Run           |
| [Set Webcam](/test-steps/runner/set-webcam.md)                                                                                                                                                                                               | Set the webcam stream for the runner            |