Components

What are components?

Components are groups of steps that are shared across multiple tests. So basically, if you don't want to repeat the most often-used steps, such as visiting the main page and logging in using valid credentials, you create a new component that will contain all those steps and use it easily, and fast across all your tests that will require this action.

Why use components?

Once you create a new component, remember that when you change something inside that group it will be changed in all tests where you used that group.

To save time! This can save you time when you want to work with test automation for complex products. With components, you can change your test only once, instead of re-recording the steps hundreds of times or manually copy-pasting them between tests.

How many components do you need? It's better to have more than less. It's not a problem if all your groups are components.

Example: make a component from click action on your "Sign up" button. All your tests that test user registration can now use such a component and if you change the "Sign up" button selector in the future you can do it only once.

Where are the components?

The "Components" module can be found under the same name in the main navigation. For starters, the list is empty, but this will change as soon as new components are added.

Components page

Components list

When new components are added, they will be displayed on the list, where those that are used in the most tests are displayed at the top.

Components list

How to make a reusable component?

Firstly you need to have a group of steps that are repeatable and useful in many tests.

1. Group test steps

2. Make a component from this group

To create a component go to test view and choose the group of steps that will become your one component. Then click on the MAKE COMPONENT button on their group name.

From now on, every change you make in this component will also apply to other tests that have this component.

Tip: Use "new test from here" to quickly work with tests that use components.

Insert an existing component

You can also add an existing component to an existing test:

This can be also done when creating a completely new test:

Insert a component to a new test

You can browse all your components here and search for a specific one that you want to add:

List of existing components when adding to a new test

Inserting component

Inserting the same component multiple times

You can add the same component multiple times in a single test.

As with components in general, a change to one instance will be reflected in the others.

Inserting component multiple times in a single test

Parametrizing components

If you want to reuse the same component in a test multiple times but with different parameters, you can achieve that using variables and the ability to override them. A typical scenario involves reusing the login component for various roles within the same application. To do that, you have to:

1. Create a {{login}} variable (could be empty by default).

2. Create a {{password}} variable (could be empty by default).

3. Create a component that uses those variables to log in to the application.

4. Create a group before the instance of the component that you want to parametrize.

5. Override login and password variables using the Set variable step.

Parametrizing components with overrided variables

Unlinking components

When you unlink a component, it will convert it to a regular group and append a "duplicate" to the group name. This will only unlink it in this specific test! Use it for making a small modification that is not required in any other test.

Unlink a component from a test

Splitting components

This works exactly the same as splitting a group. You will get two new components after splitting a component and you can immediately rename them. All instances of this component in all tests will also be split.

Removing components from a test

You can remove the component from a specific test.

Removing a component from a test

• "Remove from this test" - This will only remove it from this test, but not from other tests.

Important! When you remove the last instance of a component, it is not removed from your project and will still appear in the "Components" and be available through "Insert an existing component".

Changing back the component to a regular group

You can always change your group back to being a regular one and not a component anymore, simply by clicking on the yellow label with "Component" text:

Important! This won't delete the created component, so you can still preview it on the "Components" page, and use it in your tests.

Edit components

You can edit a component in the context of a specific test. However, remember that this will affect other tests that use it.

Edit is located within the test, and there are two ways to get there - by navigating to the test via the "Tests" page, or by searching for the component in the "Components" page, and then through the list of tests that use it.

Here on its details page click on the "Edit component" button:

Component's details page

Next, click on the linked test from the list to enter the edit mode. On this screen, you will see a list of all the tests in which this component has been used, and you can choose one that best suits you when editing the component.

List of connected tests

Edit mode of a component used in a test

Editing a component won't be possible if it's not linked with any test. To enable editing link it first to any of your tests.

Preview steps that are within a component

When you are in the details of the component, you can see a preview of each step by clicking on it. This is done in the read-only view.

Additional actions on single component

Being on the list of all components or on a view of a single component you can perform additional actions by clicking on the more menu, such as:

• Duplicate - This will duplicate the selected component by adding - duplicate prefix in its name. Also, please remember that by default the duplicated item won't be connected to any test.

• Rename - This will let you change the name of the selected component, which will apply to all tests that use it. Furthermore, the name must be unique.

• Show related tests - This will show you a preview of all related tests with that component. They can be previewed by clicking on any of them in the list (which will open in a new tab). If there are a lot of them, you may also find the search box useful.

  This is accessible in the details of the component:

Show related tests

Also from the "Actions" menu:

Show related tests

List of related tests with a component

If a component isn't linked to any test, this field will be disabled:

No related tests with a component

• Delete - This allows you to delete components you no longer need, to keep the list tidy. Please note that deleting a component will permanently delete all instances of that component and cannot be undone.

Yet to not do it accidentally we distinguish two scenarios.

1. Deleting a component when it's not linked to any test. A confirmation modal will show up:

Deleting a component without any connected test

1. Deleting a component when it's linked to a test you need to additionally confirm this action by typing the safe word on the confirmation modal:

Deleting a component with multiple connected tests

Additional bulk actions on components

For now, you can select multiple components from the list on the Components page and perform bulk actions such as:

• Delete - This will delete all selected components from the list

Delete in bulk

• Deselect all - This will remove the selection