Execute
Execute
Create end to end tests on our test editor page
Execute
The Execute feature in Revyl allows you to create and manage end-to-end tests directly from the test editor page. Here’s a guide on how to use this feature effectively:
Managing Devices
Starting a Device
To begin testing, a cloud device must be started:
- Click the “Start Device” button in the test editor
- This initializes a virtual device where tests can be executed
- Adjust viewport size through the dropdown menu
Already Running Devices
When you have a device running, you can:
- Stop Device: Halt the testing process and manage resources effectively
- Restart Device: Stop the current device and start a new one (useful for clearing cookies)
- Check Pages: Force check for other pages open on the device
Creating Test Steps
You can create various types of steps in your test, such as clicking buttons, entering text, or navigating through the application. Each step can be defined using commands or by recording actions.
Broad Steps Types
| Type | Description | Parameters |
|---|---|---|
| Instruction | Natural language instruction (e.g., Sign-in) | step (str) |
| Validation | Test if a condition is true (e.g., Confirm that the user is on the checkout page) | validation (str) |
| Extract | Parse data from the current state into a JSON structure | extraction (str) |
Manual Actions
| Action | Description | Parameters |
|---|---|---|
| Navigate | Go to a specific URL | (str) URL to navigate to |
| Back | Go back to the previous page | None |
| Forward | Go forward to the next page | None |
| Refresh | Refresh the current page | None |
| Wait | Wait for a specific amount of time | (int) seconds to wait |
Explicit Action Types
| Action | Description | Parameters |
|---|---|---|
| Click | Click on an element in the page | (str) component to click on |
| Input Text | Input text to a field (e.g., Input {{[email protected]}} into the email field) | (str) text to input |
| Scroll Down | Scroll down on the page | (str) component to scroll on |
| Scroll Up | Scroll up on the page | Optional (str) component to scroll up on |
| Scrape | Scrape specific JSON data from the state | Pydantic model type |
| Swipe | Horizontal swiping | Optional (str) Component to swipe on |
| Select | Choose a selector from dropdown | (str) selector to choose from |
| Hover | Hover over a component | (str) Component to hover over |
| File Upload | Upload a file to the page | (file) File to upload |
Step Settings
Clicking on the 3 dots on a step will expand the step to show the settings for the step:
- Vision: Use a screenshot while running the step (useful when DOM doesn’t explicitly identify components)
- Download: Download a file from the page (appears in test report)
- Locate: Highlight a component on the page
- Input Selector: Cached selector for the step (xpath, CSS selector, or text value)