Recording Tests

Preflight enables you to record all actions, including uploading files, signing in, and working with PDFs. For a full list of recordable actions, see Step Types.

If you have integrated with Eyes Visual AI, the Preflight recording extension will appear with additional features to enable full page checkpoints.

This topic includes:


While Preflight uses your browser to record tests, these tests will be run in the cloud without your browser's state. Follow the instructions in this topic to ensure that tests will be successful when running for the first time in the cloud.

To ensure the tests will run successfully:

  • Log out of your web app.
  • Clear cookies if you need to show modals to first time users.
  • To record localhost, install ngrok.
  • Ensure that all input fields that you want to record are empty.
  • Preflight uses a Google Chrome extension to record and create tests, so you will need Chrome. You can, however, use your web app from any desktop browser.

Starting the Recorder

In order to record tests, you need to install the Preflight chrome extension. Click here to install it.

The Preflight Recorder works on any Chrome-based browser and on any operating system.

There are two ways to start recording a test:

  • From Preflight
  • From your web app

It is recommended that you start by recording a login test.

Recording From Preflight

To Record from Preflight

  1. Click the New Test button on the left navigation bar.

    New Test Button

  2. Click Record & Play in the pop-up.

  3. In the pop-up that appears in the top right corner of the screen, enter the URL of the app you want to test in the Enter Test Start URL field.

    Extension after clicking on New Test Button

    Preflight will record each action.

    Extension Started Recording on YourWeb.App

    If you have integrated with Eyes Visual AI, the Preflight extension will appear as follows:


  4. Click Start Test.

  5. If you haven't recorded a `Login` test, the extension will open your dashboard in a logged-in state. If this is not what you want, cancel the recording, log out and then record a login test.

Recording From Your Web App

To Record from Your Web App

  1. Select the Preflight Recorder extension from the browser's extensions menu.

    Preflight Chrome Extension Icon on Browser

  2. Click Start Test. Preflight will record each action.

    Preflight Extension after clicking on Extension Icon

  3. To record a hover action over a specific element, move the mouse to the element, right-click and select Preflight Recorder > Hover Element.

  4. Add checkpoints to your test to ensure that the text or graphics that should always be displayed appear as expected. For example, if you are recording a login test and the user is meant to received a Welcome message, or be shown a specific graphic, use checkpoints to ensure that these elements appear. For more information see Checkpoints.

  5. Add variables to your tests to enable the value that appears in a field to be randomized or reused. For more information, see Variables. If you try to open the recorder from another site, before completing the current test, click Go to tab to complete the recording on the original tab, or Continue from here to continue the original recording in the current tab.

Saving Your Recording

To Save Your Recording

  1. Click Finish Test to complete the recording.

  2. Click Confirm.

  3. In Test Name enter a name for your test.

  4. By default, the test is run immediately. If you don't want to run it immediately, turn off the Run Immediately toggle.

  5. To run a login test prior to this test so you don't have to re-record your login each time, click Add Login Flow.

    You can also add your Log-out flow. In order to do that, check here.

  6. To assign a group to the test, click Advanced Settings and select a group from the list.

  7. To assign tag(s) to the test, click Advanced Settings and select tag(s) from the list.

  8. Click Save Test. You will be redirected to Preflight and your test will start running.

Re-recording a Test

You can overwrite an existing test by re-recording it.

To Re-record a Test

  1. Click Tests to display all tests.

  2. Select your test to open it.

  3. Click the Test Settings button on the top right of the page.

  4. Under Re-record click Start.

    Your web app opens in a new tab, and you can start recording as usual.

Switching Tabs During Recording

If you'd like to switch to another tab and resume your recording, click on the Preflight Recorder extension and click Continue From Here.

Related topics

Creating a Login Test

Creating a Signing Up and Verification Email Test

Testing PDFs

Running Tests

Defining Global Testing Defaults

Defining the Testing Frequency