Skip to content


The Jikken CLI tool supports configuration of the runtime and of variable definitions to be used for tests. These settings can be defined in configuration files or environment variables.


Settings allow you to customize the runtime environment. This modifies how the CLI tool behaves when executing tests.

SettingDefault ValueDescription
Continue on FailurefalseThe Continue on Failure setting controls whether the runtime exits after a single test fails. The default behavior is that as soon as a test fails, the application exits with an error code. When this setting is enabled, the test runner will execute all tests regardless of failures.
EnvironmentThe Environment setting is used to specify which environment label should be applied for the test runner’s execution. This label can be used to organize and filter test runs in the dashboard, and allows you to define triggers and metrics tracking specific to an environment. It can be any string value and is limited to 50 characters. By default, no environment is attached to the test runs.
API KeyThe API Key setting is what allows you to send telemetry information to the Jikken cloud platform.


Variables allow you to embed values into tests at runtime. This is useful for injecting URL paths that are environment-specific. For more information on variables in general, see the Variables page of the User Guide.

Configuration Files

The Jikken CLI tool looks for a .jikken file in the folder it is being executed from. The .jikken file is defined in the TOML format.

continueOnFailurefalseWhen running Jikken, by default, it will stop execution as soon as it encounters a test failure. The continueOnFailure setting allows you to execute all tests regardless of prior test execution. It is possible some test failures may cause other tests to fail, but for independent tests, it can be useful to get a full picture of the pass/fail state of all tests.
environmentJikken provides multiple ways to provide an environment label. This setting provides a label at the configuration file level, which will apply it to all tests. This value will be overridden by the env field if it is provided in a test definition.
apiKeyThe apiKey setting is used to provide a key for reporting test runs and status with the cloud platform. This key is associated with your account and can be obtained from the web application.

Globals are a way to define global variables which are used across all of your tests. This is useful for values such as base URLs for API endpoints, environment variables, and authentication credentials.

Environment Variables

Jikken supports environment variables as overrides to the .jikken configuration file.

JIKKEN_CONTINUE_ON_FAILUREbooleanOverrides the continueOnFailure setting, as defined in the .jikken configuration file.
JIKKEN_ENVIRONMENTstringOverrides the environment setting, as defined in the .jikken configuration file.
JIKKEN_API_KEYstringOverrides the apiKey setting, as defined in the .jikken configuration file.

Jikken also supports global variable definition as environment variables. These may override values in the .jikken configuration file, or simply define new ones that are not contained in the file. These variables must have a prefix of JIKKEN_GLOBAL_.

Terminal window
export JIKKEN_GLOBAL_newUrl=https://localhost:5001
export JIKKEN_GLOBAL_oldUrl=https://localhost:5002

The prefix should be in all caps (JIKKEN_GLOBAL_) but everything after that can be whatever case you prefer, as long as it matches the case of the variable definition in the test file(s).