Skip to main content

Environment Object

The environment object describes the execution environment, system configuration, and build context for the test run. It captures metadata about where and how tests were executed, enabling correlation with CI/CD pipelines and infrastructure.

Properties​

NameTypeRequiredDescription
reportNameStringOptionalA human-readable name for this report.
appNameStringOptionalThe name of the application under test.
appVersionStringOptionalThe version of the application under test.
buildIdStringOptionalA unique identifier for the CI/CD build.
buildNameStringOptionalThe name of the CI/CD build or pipeline.
buildNumberIntegerOptionalA sequential build number.
buildUrlStringOptionalURL to the CI/CD build for easy navigation.
repositoryNameStringOptionalThe name of the source code repository.
repositoryUrlStringOptionalURL of the source code repository.
commitStringOptionalGit commit SHA or VCS revision identifier.
branchNameStringOptionalGit branch or VCS branch name.
osPlatformStringOptionalOperating system platform (e.g., linux, darwin, win32).
osReleaseStringOptionalOperating system release version.
osVersionStringOptionalOperating system version string.
testEnvironmentStringOptionalLogical test environment (e.g., staging, production, local).
shardIdStringOptionalIdentifies the shard or partition that produced this document. Values should be unique among documents sharing the same runId.
healthyBooleanOptionalIndicates if the run is considered healthy based on defined criteria.
extraObjectOptionalExtension point for arbitrary environment-related metadata.

Example​

"environment": {
"reportName": "Nightly Regression Suite",
"appName": "my-web-app",
"appVersion": "2.1.0",
"buildName": "main-pipeline",
"buildNumber": 1542,
"buildUrl": "https://ci.example.com/builds/1542",
"repositoryName": "my-web-app",
"repositoryUrl": "https://github.com/example/my-web-app",
"commit": "a1b2c3d4e5f6",
"branchName": "main",
"shardId": "shard-1-of-4",
"osPlatform": "linux",
"testEnvironment": "staging"
}