Testim Documentation

Welcome to the Testim documentation. You'll find comprehensive guides to help you get started quickly, example code snippets, and tips for being more productive. You will also find details about advanced features that allow you to customize Testim to fit your environment or special testing conditions. Don't worry, we'll support you if you get stuck. Let's jump right in!

Guides    Changelog

Creating your First Codeless Test in Testim Visual Editor

Welcome aboard!

Upon completion of the signup process, you were redirected to the Testim Home screen.

📘

You can access this screen at any time by clicking the Testim icon in your browser toolbar or by going to https://app.testim.io/.

Now, Let's create your first test!

Tutorial Use Case

Creating a test with Testim starts with going to the relevant website and recording the series of actions that you would like to test. Later you will be able to edit the properties for each of the steps and add validations.
For this tutorial we will be testing Testim’s demo website “Space & Beyond”. We will run a test of the site’s login procedure.

Recording the Test

To record the test:

  1. Click on Create Test.

A new test opens in the Editor. This is where you record the test, add validations and edit the test steps.

  1. Click on the red Record button in the toolbar.
    The Start A New Test window opens.
  1. In the Your app URL field, enter the demo site’s URL “demo.testim.io”, then click Create Test.
    A new browser window opens showing the Space & Beyond website. This is the Application Under Test (AUT) window. The series of actions that you take in this window are recorded and saved as a test in Testim.
  2. In the AUT browser, log in to the system (using any username and password).

Watch Demo

  1. Now, go back to the Testim Visual Editor browser.
    The procedure that you did on the Space & Beyond website is shown as a series of actions in the test window. Each box represents a step in the test procedure. An icon at the top left of the box indicates the type of action (click, enter text, scroll, etc.) that was performed.
  1. Click Save.
    The Save Test window is displayed.

🚧

Whenever you create a new test or make changes to an existing test, make sure to save the test. If you close the browser without first saving the test, your work will be lost.

  1. In the Name field, enter “Space & Beyond Demo 01”, then click OK.
    The test is saved.
    Congratulations, you have created your first test in Testim!

Adding Validation

Whenever you run a test, the system automatically verifies that all of the steps in your flow are executed consecutively. However, this doesn’t ensure that each step has yielded all expected results. You can add additional validation elements to ensure that all desired results of your actions are occurring properly.
For this tutorial we will add a validation to ensure that once the user has logged in, the Login button in the Header bar is replaced by the text “HELLO, JOHN” (on this demo site, John is always shown, independent of the username that was input.).

To record the test:

  1. On the Editor screen of the Space & Beyond Demo 01 test, click on the blue “+” button to the right of the Click “LOG IN” step.

The add action drop-down menu opens.

  1. Scroll down through the menu and select Validate element text.
  2. In the AUT browser, select the words “HELLO, JOHN”.

A new Text Validation step is added to your test.

Watch Demo

To save the results for the current test version:

  1. Click on the Save button in the header bar.
  1. In the Message field, enter a description of the test version (optional), then click OK.
    Congratulations! You have successfully saved your test with the added validation. Now let’s run the test.

Running a Test

To run the test locally:

  1. On the Editor screen, click on the play button in the toolbar.

A new browser opens and runs the test actions on the demo site. When the test is completed a pop-up window indicates whether the test was successful.

  1. Click on the Go back to the Editor link to return to the Editor to view the results.

Viewing Test Results

On the test Editor screen, you can view the test results. Overall run data is shown at the top of the screen. In addition, the colored icons at the top of each step indicate whether or not that action was successful.

If you would like to view detailed results for a specific action, double-click on the step. The action results screen is displayed for that action.

In case of a test failure, detailed info is shown about the cause of the failure. (In the following example, the validation was set to expect “Goodbye” and the value received was “Hello”.)

Support

We are here for you! Click the chat button in the lower-right corner of the screen, and a Testim representative will help you.

Updated 5 months ago


What's Next

Learn more about recording tests in Testim.

How to Record a Test

Creating your First Codeless Test in Testim Visual Editor


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.