Reflect Docs

Quick Start

Welcome to Reflect! To get things kicked off, here's a brief overview to get you started in creating your first Reflect tests.

Recording a Test

To record a test, simply click the ‘Create Test’ button. In the modal that opens, you can configure the properties of the new test such as the name, starting URL and device profile. Reflect supports profiles for Desktop, Mobile and Tablet devices.

After choosing your starting URL, you’ll see it load up in a content area on our Recording page. Simply perform the test steps you wish to record as if you were performing a manual test. As you interact with your site, you’ll see test steps automatically added to your test plan on the left rail.

“Image 2”

Reflect is capable of recording tests across multiple pages and across multiple sites. To prevent recording actions which will result in a failed test, Reflect disables all inputs to your test recording while a page is loading. This will be indicated via the ‘Loading’ vs. ‘Recording’ indicator at the top-right of the screen. You’ll notice that the recording will be in the ‘Loading’ state any time a new page is loading (e.g. after clicking a link, but before the page’s ‘oncontentloaded’ event has fired).

One feature of note is our Visual Validation functionality, which is triggered by clicking the “Add a Visual Validation” button that appears on the toolbar above the recording. Visual Validations allow you to create test steps that verify the appearance of an element on the page. Additionally, if you’re verifying a text element, Reflect validates the text value as well. To create a Visual Validation step, click the “Add a Visual Validation” button. Then, click-and-drag to select the region you’d like to screenshot, and click “Save”.

“Image 3”

After you’ve run through all of the steps that you’d like to test, click the “Save” button on the bottom left of the application. A modal will display prompting you to confirm the test details. After saving the test, Reflect immediately executes the test to verify it was recorded successfully.

Tags and Scheduling

A subset of tests can be organized into what we call a Tag. Tags serve two purposes. First, they’re an organizational tool that let you keep things tidy as your test suite grows. Second, they allow you to group a set of tests to be executed on a specific schedule. All tests you record will go into the default ‘All Tests’ tag, but new Tags can be created at any time by clicking the ‘+’ icon next to the ‘Tags’ heading on the left rail.

To change how often the group of tests in a Tag executes, click the ‘Add Schedule’ or ‘Change Schedule’ link at the top of the Test List. Tags are not required to execute on a schedule.

“Image 1”

You can execute tests in a Tag as frequently as once per hour or as infrequently as once per month.

If a scheduled test fails, you’ll receive an email notification with a link to the failing test run.

Executing a Test

Tests can be rerun on demand by clicking the “Run Test” button on the Test List page, or the “Run Now” button if you’re viewing an existing test run. You’ll receive a toast notification when the test run completes.

Viewing Previous Test Runs

To view the results of previous test runs, including scheduled test runs, click the ‘Results’ tab on the Test List page. You can also click on the name of any test under the ‘Tests’ tab to see the results of the latest run of that test. Each test run includes a full-fidelity video recording, as well as a log of network requests and JavaScript console log statements.

For any questions or support along the way, please email us at support@reflect.run so we can assist. We value all feedback as we continue to enhance our features and capabilities!

Copyright © 2020 Reflect Software Inc. All Rights Reserved.