Studio tools
While a recording is live, the studio on the web is where you add checks, add steps you cannot click, and fix the steps you have.
How the studio works
You click through the flow in the recording browser. You say what you expect in the studio, on the web page. The flow is drawn in the middle, the tools for adding a step sit under it, and the Assistant sits beside it.
The tools have five tabs: Action, Assertion, Run Code, Insert test and Pause. Everything you add is run against the live page first. A step is kept only if it works.
Pick an element
Actions and assertions are about one element: the target. The target follows what you do. After you click Save in the recording browser, the target is Save.
To target an element without using it, click Pick an element, then click the element in the recording browser.
- That click is not recorded as a step.
- You can pick elements a normal click cannot reach, such as a disabled button.
- Press Escape to cancel.
Action
The Action tab performs a step for you. Use it for steps you cannot record by clicking. A browser ignores a click on a disabled control, so that click records nothing.
Pick an element, choose what to do to it and click Add action. The choices are:
- click it
- double-click it
- fill it with
- press a key in it
- check it
- uncheck it
- select an option in it
- hover it
Navigate to is here too, and needs no element. It sends the browser to a path or URL, for a jump the flow makes on purpose.
Force performs the action even when the element is not ready for it. It is switched on for you when the element is disabled. That is how you record “click the disabled Save button, then check nothing changed”.
Assertion
An assertion is a check: something that must be true at this point in the flow. Pick an element, choose a check under Assert that it, fill in its value and click Add assertion.
| Check | Passes when |
|---|---|
| is visible | The element is on the page and can be seen. |
| is hidden | The element is not shown. |
| contains text | The element's text includes the text you give. |
| reads exactly | The element's text is exactly the text you give. |
| is enabled | The control can be used. |
| is disabled | The control cannot be used. |
| is checked | The checkbox or radio button is on. |
| is not checked | The checkbox or radio button is off. |
| has the value | The field holds the value you give. |
| has the CSS property | A style has the value you give, such as background-color: rgb(255, 0, 0). |
| has the attribute | An attribute has the value you give, such as aria-expanded: true. |
| has the class | The element carries the class you give. |
| appears N times | The page has this many matching elements. |
| the page URL is | The browser is at the address you give. |
The text, value and URL checks can also match a regular expression. Write colours the way a browser reports them, such as rgb(255, 0, 0).
Every check is run against the live page before it is kept. A check that fails is not added without telling you: you see what the page gave and what the check expected.
Describe the check instead Paid plan
If you can describe a check but not name it, type it under Or describe it, such as “this button should be red”, and click Create. verifAIed writes assertions for the picked element, and each one is run against the page like any other.
Run Code
The Run Code tab runs a script in the page, like typing it into the browser's developer console. Click Add script and it runs in the recording browser right away, then joins the flow as a step.
Insert test
The Insert test tab runs another recorded test at this point in the flow. Choose a test and click Insert. Its steps run against the page now and join the flow as one named block. Only that test's own steps go in, not its pre-steps, and you can insert the same test more than once.
- With Keep linked off, the steps are a copy. They are yours from then on and never change by themselves.
- With Keep linked on, the block follows the test it came from. When that test is re-recorded, the next run of this test updates the block.
To run a test before this one starts, use a pre-step instead. See Pre-steps.
Pause
The Pause tab adds a wait between two steps, from 0.1 to 30 seconds. Use it to let the viewer of the video take in a screen. The replay waits there, unless the video is switched off for that run.
The Assistant
The Assistant Paid plan takes several steps at once, in your own words: “fill my email and password, sign in, and check the dashboard heading shows”.
- It writes the steps from the page as it is now, then runs them one at a time, in order.
- It stops at the first step that fails. The steps after it are not run.
- When a check it wrote fails, it reads the page again and repairs the step by itself where it can. It asks you only when the page really disagrees with what you described.
- Every step in the flow has a number. Say “step 3 failed, try the heading instead” or “change step 2 to check the heading” and the new step takes that step's place.
- When the branch has coverage uploaded, it can read your source code to ground a check in what your app does. Each file it opens shows as a line in its reply.
- You can also ask it a question and get an answer.
Change or delete a step
While the recording is live, you can edit or delete every step: the ones you added here and the clicks the recorder wrote down. An edited step is run against the page again and takes the place of the original.
The one step you cannot change is the opening navigation. Without it the test has nowhere to start.
After the test is saved, see Edit a test.
Captions and holds
Two things make the video easy to follow. Each step gets a caption: a short line in plain English, drawn at the bottom of the video while the step runs. Each check gets a hold: the video stays on the page for a moment after the check passes, two seconds by default.
- The studio writes a caption for each step as it lands Paid plan. Without a paid plan, type the captions yourself.
- Open a step to change its caption under Caption on the video: type one, click Generate to have one written, or switch it off. A caption can be up to 120 characters.
- Open a check to change its hold under Hold after it passes (seconds): 0 for no hold, or 0.1 to 30 seconds.
- Settings, beside Variables, changes both for this recording only: Hold after each check (seconds) and Caption each step as it lands.
To change the defaults for every recording, see Repository settings. Replay videos covers the rest of what the video shows.
Variables in a step
A step can use a variable in place of a typed value, such as a login email or a password. The Action and Assertion tabs offer your environment's variables beside the value box, and Variables lists them all. Use on a variable fills the picked element with it. In the flow the step shows the name, like ${login_email}, not the value.
See Variables.