Conditions

Reference documentation of Conditions that are available for Currents Actions

An Actions can have one or more condition. You can use AND or OR combinator for multiple conditions.

Fields

File

Test filename path, for example path/to/file.spec.ts.

Field Type	string
Value Type	string | string[] | RegexPattern[]
Supported Operators	Basic operators One to One operators One to Many operators
Supported Actions	Pre-Test Actions Post-Test Actions

Test Title

Test title, for example in test definition test("should open landing page") it is should open landing page.

Field Type	string
Value Type	string | string[] | RegexPattern[]
Supported Operators	Basic operators One to One operators One to Many operators
Supported Actions	Pre-Test Actions Post-Test Actions

Test Title Path

Full title path as an array including named describe statements. See testInfo.titlePath. To match the following example:

[
    "auth.spec.ts", // e.g. spec file name
    "Auth Controller", // e.g. test describe
    "Should login with correct credentials" // e.g. test title
]

Use a string list: auth.spec.ts Auth Controller Should login with correct credentials

Field Type	string[]
Value Type	string | string[] | RegexPattern[]
Supported Operators	Basic operators Many to Many operators
Supported Actions	Pre-Test Actions Post-Test Actions

Test ID

Playwright test id, matching the test case id in the Reporter API.

Field Type	string
Value Type	string | string[]
Supported Operators	Basic operators One to One operators One to Many operators
Supported Actions	Pre-Test Actions Post-Test Actions

Tags

Test tag list. For example, if a test has the following list of tags ['a', 'b'], each value in the list will be evaluated separately.

Field Type	string[]
Value Type	string | string[]
Supported Operators	Basic operators Many to Many operators
Supported Actions	Pre-Test Actions Post-Test Actions

Project

Playwright project name as defined in your playwright.config.ts.

Field Type	string
Value Type	string | string[] | RegexPattern[]
Supported Operators	Basic operators One to One operators One to Many operators
Supported Actions	Pre-Test Actions Post-Test Actions

Error Message

Added in @currents/[email protected]

Used to match a list field (eg Test Title Path) against one or more values.

Error message thrown during the test.

Field Type	string
Value Type	string | string[] | RegexPattern[]
Supported Operators	Basic operators One to One operators One to Many operators
Supported Actions	Post-Test Actions

Git Author Email

Git commit author email. See Commit Information to explore how Currents collects git commit information.

Field Type	string
Value Type	string | string[] | RegexPattern[]
Supported Operators	Basic operators One to One operators One to Many operators
Supported Actions	Pre-Test Actions Post-Test Actions

Git Author Branch

Git commit author name. See Commit Information to explore how Currents collects git commit information.

Field Type	string
Value Type	string | string[] | RegexPattern[]
Supported Operators	Basic operators One to One operators One to Many operators
Supported Actions	Pre-Test Actions Post-Test Actions

Git Branch

Git commit branch name. See Commit Information to explore how Currents collects git commit information.

Field Type	string
Value Type	string | string[] | RegexPattern[]
Supported Operators	Basic operators One to One operators One to Many operators
Supported Actions	Pre-Test Actions Post-Test Actions

Git Message

Git commit message. See Commit Information to explore how Currents collects git commit information.

Field Type	string
Value Type	string | string[] | RegexPattern[]
Supported Operators	Basic operators One to One operators One to Many operators
Supported Actions	Pre-Test Actions Post-Test Actions

Git Remote Origin

Git remote origin URL. See Commit Information to explore how Currents collects git commit information.

Field Type	string
Value Type	string | string[] | RegexPattern[]
Supported Operators	Basic operators One to One operators One to Many operators
Supported Actions	Pre-Test Actions Post-Test Actions

Operators

Basic operators

Operator	Description
is	exact match
is not	the value is different
is any	field returns true for JS expression !!value === true
is empty	field returns false for JS expression !!value === true

One to One operators

Operator	Description
is	exact match
is not	the value is different

One to Many operators

Used to match a single value field (eg Test Title), against a list of values.

Operator	Description
in	one of the values from the list is an exact match
not in	none of the values in the list match

Many to Many operators

Added in @currents/[email protected]

Used to match a list field (eg Test Title Path) against one or more values.

Operator	Description
includes	all of the values in the list can be found in the field
includes some	at least one of the values in the list can be found in the field
missing	all of the values in the list are missing from the field
missing any	any of the values in the list is missing from the field

Examples

Field	Operator	Value	Description
Test Id	is	1234	id is exact match
Git Branch	not in	main,stable	no matches
Tags	includes	featureA	tag matches
Tags	includes some	featA,featB	at least one tag matches
Error Message	is	Int(er|ra)net Error:	Errror Message matches the RegexPattern