Configuration List

The Configuration List page shows all of the test configurations that were created and available to use for your tests, whether you run them locally or with your CLI. A test’s configuration determines the system specifications used to run the test. If you intend to run a test locally then the configuration should match your local environment. If you intend to run a test on the Testim Grid, then Testim simulates the environment that you specified. You can include a test configuration when running tests with your CLI by using the test-config parameter. For more information, see Test Config. The test configurations in this list can be created and modified in the Configuration Library or in the Setup step in the Test Editor.

• Configuration Library – You can create a new configuration in your configuration library. This configuration will apply to all steps run in a test that is set with that configuration (including tests run via CLI or Scheduler). For more information on test configuration, see Setting the Test Configuration. For more information about the CLI, see Command line interface: Test Config. For more information about the Scheduler, see Scheduler.
• Setup Step in the Test Editor – Every test has its own default configuration accessible from the property panel of the test’s Setup step. The configuration parameters that are set in the test’s default configuration will apply unless the test is run from the CLI or a scheduler with a different configuration.

📘

When the test is run in the CLI, you can override the default configuration by specifying a new test configuration in the run command, see Command line interface.

🚧

If you run a test locally on a system that doesn’t correspond with the test configuration, then the test will run with the available configuration and a warning message will be shown.

Creating and modifying test configurations in the Configuration Library

In the Configuration Library you can create new test configurations. You can also clone, modify, rename, and delete current configurations.

Creating a new test configuration

To create a new test configuration:

1. In the left menu, navigate to Runs > Configuration List.

The Configuration Library is shown.

2. Click the + Create New button.

The Add New Config settings are shown.

3. Enter the basic options as follows:

• In the Name field, enter a name for this new configuration.
• In the Browser section, click the dropdown arrow and select your desired browser.
• In the OS section, click the dropdown arrow and select your desired operating system.
• In the Resolution section, click the dropdown arrow and select your desired resolution.

4. Click Advanced.
   The advanced configuration options are shown.

5. In the General section, modify the Step timeout, Step delay, and Setup step timeout settings as desired. For more information, see Test Configuration Parameters.
6. In the Before/After hooks section, modify the settings as desired. For more information, see Before & after hooks.
7. Click Add.
   The configuration is created and added to the Configuration Library.

Cloning a test configuration

To clone a test configuration:

1. In the left menu, navigate to Runs > Configuration List.

The Configuration Library is shown.

2. Click on the row of the test configuration you wish to clone.
   Context tools are shown.

3. Click the Clone icon.

📘

Alternatively, you can right-click the row, and select Clone.

The Clone Configuration options are shown.

4. In the Name field, enter a name for the cloned configuration.
5. Click Clone.
   The configuration is cloned and is shown in the Configuration Library.

Modifying a test configuration

To modify a test configuration:

1. In the left menu, navigate to Runs > Configuration List.

The Configuration Library is shown.

2. Double-click on the row of the test configuration you wish to modify.
   The Edit Config settings are shown.

3. Modify the basic options as follows:

• In the Name field, enter a name for this new configuration.
• In the Browser section, click the dropdown arrow and select your desired browser.
• In the OS section, click the dropdown arrow and select your desired operating system.
• In the Resolution section, click the dropdown arrow and select your desired resolution.

4. Click Advanced.
   The advanced configuration options are shown.

5. In the General section, modify the Step timeout, Step delay, and Setup step timeout settings as desired. For more information, see Test Configuration Parameters.
6. In the Before/After hooks section, modify the settings as desired. For more information, see Before & after hooks.
7. Click Change.
   The configuration is modified.

Renaming a test configuration

To rename a test configuration:

1. In the left menu, navigate to Runs > Configuration List.

The Configuration Library is shown.

2. Click on the row of the test configuration you wish to rename.
   Context tools are shown.

3. Click the Rename icon.

📘

Alternatively, you can right-click the row, and select Rename.

The Edit Name settings are shown.

4. In the New name field, enter a new name for this configuration.
5. Click OK.
   The configuration is renamed.

Deleting a test configuration

To delete a test configuration:

1. In the left menu, navigate to Runs > Configuration List.

The Configuration Library is shown.

2. Click on the row of the test configuration you wish to delete.
   Context tools are shown.

3. Click the Delete icon.

📘

Alternatively, you can right-click the row, and select Delete.

A confirmation dialogue is shown.

4. Click Delete.
   The configuration is removed from the Configuration Library.

Filtering the Configuration Library

You can apply filters to the Configuration Library to only display items that meet a specific criteria.

To filter the Configuration Library:

1. Navigate to Runs > Configuration List.
2. Click the Advanced Filters button in the action menu.

3. Select the desired filters from the Filter Configuration panel and click the Apply button.

The list of scheduled runs is now filtered based on your filter selections. To learn more about saving this filtered view, see Saving a Filtered View.

Creating and modifying test configurations in the Test Editor

Test configurations that are modified in the Test Editor are added to the Configuration Library if the configuration includes a name and the test is saved. The newly added test configuration can be used for future tests.

To modify a test configuration within a test:

1. Hover over a test's Setup step (the first step) and click the Show properties () icon.

The Properties panel opens on the right hand side.

2. In the Configuration section, click on the Edit Configuration icon.

The Edit Configuration settings are shown.

3. Modify the options as follows:

• In the Name field, enter a name for this configuration. (If you don’t enter a name, the test configuration will NOT be saved in the Configuration Library.)
• In the Browser section, click the dropdown arrow and select your desired browser.
• In the Os section, click the dropdown arrow and select your desired operating system.
• In the Resolution section, select your desired resolution.
• Modify the Step timeout, Step delay, and Setup step timeout settings as desired. For more information, see Test Configuration Parameters.
• In the Before/After hooks section, modify the settings as desired. For more information, see Before & after hooks.

4. Click the back arrow to close the Edit Configuration settings.

5. Click Save.

The Change Message window opens.

6. In the Message field, optionally enter a description of the changes made in this version.
7. Click OK.
   The test is saved. If you entered a name in the Name field in the Configuration settings, the configuration will be listed in the Configuration Library.