# Running Tests Cases

### **Execute a single test**

You may execute your test from the cases screen by doing the following:

* Inside the cases screen, click on the case you created.
* You can decide who will receive notification for this case.

<figure><img src="/files/uz2KM5wdK63c2oTJmrQw" alt=""><figcaption></figcaption></figure>

* You can schedule the case to run whenever you need.

<figure><img src="/files/qeTkvEq7npksvts7stUA" alt=""><figcaption></figcaption></figure>

* You can use data from a parameters file such as xlsx by uploading it.

<figure><img src="/files/o1tittt5mU8TXed03n9h" alt=""><figcaption></figcaption></figure>

Accessing the parameters in the script:

```
const email = params.email
log.info(email) // 1@gmail.com
```

* Select the browser you wish to run the case on.

<figure><img src="/files/hEa2SxkYsES0sdDBginE" alt=""><figcaption></figcaption></figure>

* Upload the script you wish to run.

<figure><img src="/files/EwPvQd1takZRao3yUm9f" alt=""><figcaption></figcaption></figure>

* (Optional) - Go to settings and select [environment](broken://pages/-LuhbxJGIkshc9yWfyy0) and [releases](broken://pages/-Luhc-IajXZafUOIHNKT) you wish to run it on.

<figure><img src="/files/jdr4QCX2d0K5XoK4k93O" alt=""><figcaption></figcaption></figure>

* Write details and upload relevant files for your case, and then click on Save Changes.

<figure><img src="/files/fWxPgElarhxWF9kqLpiq" alt=""><figcaption></figcaption></figure>

* Click on ‘Run now’ button which appears at the top right, The results will appear under Results tab.

<figure><img src="/files/cKAyHRIOz6WFNiaRT1vO" alt=""><figcaption></figcaption></figure>

* Click on the date, it will open the details about the case, on which browser it ran and it's steps:

<div><figure><img src="/files/T7AJN7jmWR7gAycaSd3s" alt=""><figcaption></figcaption></figure> <figure><img src="/files/EMehNDycRIaH9ar7Gb4v" alt=""><figcaption></figcaption></figure></div>

* When the case opens a website, it also shows the requests happening behind the scenes:

<figure><img src="/files/Iv204DeEz21drTtO8dG1" alt=""><figcaption></figcaption></figure>

* Now, let's open a failed case, we will see the failure reason, as well as all the steps lead to it, on which line it failed, and the screenshot of the failed step. Same as before, we can see the requests.

<div><figure><img src="/files/rW5IoxOXwNoAaGGXygEo" alt=""><figcaption></figcaption></figure> <figure><img src="/files/Ow8PuPN8HJzH2G3RMvtG" alt=""><figcaption></figcaption></figure></div>

## **Execute a test suite**

Running suites is exactly the same as running a single case, except here you can add multiple cases to run together. You may execute your test from the suites screen by doing the following:

* Inside the suites screen, click on the suite you created.

<figure><img src="/files/gLbK46mZnsMgsr3M8aAV" alt=""><figcaption></figcaption></figure>

* Under Cases or Tags, click on add cases:

<div><figure><img src="/files/CsY3bmJKhzHnD6PoOtrc" alt=""><figcaption></figcaption></figure> <figure><img src="/files/lj5O7JB14cKW8dknzS1C" alt=""><figcaption></figcaption></figure></div>

* You may select which cases to run, by default it will run everything, save changes then run now:

<figure><img src="/files/9rcNK1g7ETZ25YnZMaPw" alt=""><figcaption></figcaption></figure>

* White the suite is running, you may see the progress:

<figure><img src="/files/x8jqLl4Tdz5ZAZluz7gU" alt=""><figcaption></figcaption></figure>

* Finally, see the results by clicking on each case:

<figure><img src="/files/YKc3W3zpmQdG5aBkiIQ0" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cloudbeat.io/fundamentals/executing-tests.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
