Use advanced search with Cucumber tag expressions in Scenario Manager

The advanced search allows you to build structured queries using the Cucumber tag expressions to search for features/scenarios.

Search for scenarios using tag expressions

To search for scenarios using tag expressions:

  1. From your project’s sidebar, select Features.

  2. Click Scenario Manager button

  3. Enter your tag expression query.

  4. Your search results will be displayed in the scenarios table.

image-20240229-175625.png
Enter tag expression operators to filter for Scenarios in Scenario Manager

Understanding searching

Read the following article to learn how tags can be used:

Cucumber Reference - Cucumber Documentation

Constructing tag expressions

By default the list of tags without any logical operators is considered as an AND expression. For example

this expression will find only features which have @smoke and @wip and @slow tags.

A more complex expression might look like this:

This expression will find all features that have @smoke and @wip tags but not @slow tag

Setting the precedence of operators

You can use parentheses in complex expression statements to enforce the precedence of operators.

For example, if you want to find all features tagged with @smoke and @wip, as well as all features with @slow tag

Note that if you do not use parentheses, the expression will be evaluated left-to-right.

You can also use parentheses to group clauses, so that you can apply the NOT operator to the group.

for example

Restricted words and characters

Reserved characters

Tag expressions have a list of reserved characters which can not be used as a tags on their own:

“(“, “)”

Reserved words

Tag expressions have a list of reserved words which can not be used as a tags on their own:

“and“, “or“, “not“