Creating a Test

This section is dedicated to creating a test in Revyl. Follow the steps below to create and run your first test:

​

Step 1: Navigate to the Test Section

1. Click on Tests in the sidebar.
2. Once on the Tests page, click New Test in the top-right corner.

​

Step 2: Enter Test Details

1. Fill in the required test details:

   • Test Case Description: Provide a meaningful name.
   • Platform: Select between Web, Mobile, etc.
   • Test Website: Enter the URL of the site you want to test.
   • Schedule: (Optional) Define a cron schedule for automated runs.

​

Step 3: Add Test Steps

1. Manually add steps by clicking Add Step and entering detailed instructions, such as:

   • Clicking a button.
   • Entering text into a field.
   • Navigating to a specific section.

2. Alternatively, use the recording feature to automatically create steps based on interactions.

​

Step 4: Save and Run the Test

1. Click Save Test to store your progress.
2. Click Run to execute the test and view results.

​

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)

​

Tips and Tricks

​

Step Selection

• Use Ctrl/Command + Click to select multiple steps for execution.
• To test a subset of steps, select the steps and click Run Selected.

​

Recording

• The recording feature is the fastest way to create tests.
• More information on recording can be found in the Recording Guide.

Now you’re all set to create and run tests efficiently in Revyl AI!