Environments Overview
An Environment defines how TestOwl runs your tests. It contains the configuration required to execute a test, such as the browser, device, viewport, location, timezone, network settings, and other runtime options.
A single test can be executed across multiple environments to verify that your application works consistently across different browsers, devices, and configurations.
“Build once. Test across every browser, device, and environment.”
— TestOwl Team
Creating an environment
To create an environment:
- 1Open Environments from the sidebar.
- 2Click New Environment.
- 3Configure the environment details.
The environment editor contains multiple tabs. Start with the General tab:
| Field | Description |
|---|---|
| Name | A unique name used to identify the environment when running tests. Example: Production Chrome |
| Description | Optional information to help your team understand the purpose of the environment. |
| Type | Defines the environment category: Development, Staging, Production, or Others. |
The remaining configuration options are organized into separate tabs:
Browser, Device & Viewport
Network, Proxy & Storage
Location & Locale
Permissions, Appearance & Advanced
Masking Rules are also configured from the environment editor.
Marking an environment as Production
An environment is considered a Production environment when its Type is set to Production in the General tab.
Production environments have an additional safety check: Draft-status test cases cannot be executed against them. This prevents unfinished tests from accidentally running against live applications.
Duplicating an environment
You can duplicate an existing environment to quickly create a similar configuration.
This is useful when creating variations such as:
- The same staging setup with a different browser.
- A desktop environment with a mobile device configuration.
- Multiple environments that share most settings but differ in a few options.
After duplication, update only the settings that need to change.
Deleting and restoring environments
Deleted environments are moved to trash and can be restored within the 15-day retention period.
Selecting an environment when running tests
When you trigger a run, you can select one or more environments for execution.
Each selected environment runs independently and generates its own result. This makes it easy to identify environment-specific issues, such as a test failing only on mobile Safari or a particular browser version.
TestOwl