To switch into Gherkin Text Editor Mode use the mode buttons in the footer section of the editor panel
note that in the Data Center version of the app the mode buttons are located on the left and the Save & Cancel buttons on the right
Syntax Highlighting
Gherkin Keywords
All Gherkin keywords are highlighted using colour and bold font
No '*'
Note that using * (asterisk character) as a step keyword is not supported as it does not improve readability of the examples
User Story Keywords
The commonly used set of user story keywords (As a, I want to, So that) can be entered in the Feature title section like below:
User story keywords don’t need to be at the start of the line and you can use either lower or upper case as needed
The 'to’ part in the “I want to“ keyword can be omitted and in the “As a” keyword you can enter either “As a“ or “As an”
Simple Step Parameters
Simple parameters (those that are on the same line as the step keyword) can be highlighted by simply wrapping them in single or double quotes
Scenario Outline Parameters
<> delimited step parameters which are used as part of Scenario Template or Scenario Outline are highlighted automatically in orange
Use autocomplete
Use autocompletion support to quickly populate Examples table header section with the names of the parameters that you have used in parameterized steps above. Simply press 'Ctrl+Space' to bring up the auto completion menu
Scenario outline parameters are also supported inside tabular step parameters
Doc String Step Parameters
Doc strings are highlighted in purple colour
Backticks ```
The use of backtick characters instead of quotes is supported
XML Step Parameters
If you enter 'xml' after the opening characters of a doc strings parameter then any XML that you enter before the closing doc strings characters is automatically syntax highlighted
Tags
Tags are highlighted in grey colour
Comments
Comments are highlighted in grey colour
Fold comments
Comments spanning several lines can be conveniently folded using fold/unfold gutter icons
Questions & Answers
A comment prefix character '#' is used followed by ‘Q:' or 'A:’ to highlight questions and answers respectively. Or the more elaborate version: “Question:“ and “Answer:”
Tip - you can turn off the showing of gutter icons on the left via an editor menu option shown below
Invalid text
If there is any text that according to the Cucumber Gherkin syntax does not belong to any of the Feature file elements, then it is underlined in red and an error icon is shown in the gutter
Note that such errors to be highlighted the 'Errors' option in the Gutter options drop down menu must be turned on as shown below
Autocomplete
Press keyboard shortcut Ctrl+Space or Alt+Click to bring up the autocomplete options menu.
Gherkin keywords
Available options are dependent on where the cursor is currently positioned within the feature file.
Tip - to quickly change the Step keyword simply hover over and do Alt+Click to show the autocomplete options menu. Picking an option will replace the already entered keyword that is temporarily highlighted in yellow.
Examples table header
Inside the header row of an example table the autocomplete menu contains names of the scenario parameters that have been entered above using the <> step parameter syntax.
Autocomplete can also be triggered if the cursor is inside the already entered column header text to easily replace the header value with another
Autocomplete can also be triggered by placing the cursor after the last header column and pressing 'Ctrl+Space'
Once the option is picked the autocomplete will also enter the necessary '|' divider characters for the new column and place the cursor in the next cell down
If you need to rename a scenario parameter that you have already entered in several of the scenario steps, do it by updating the last occurrence that is in the Examples header section.
This way the other occurrences above will be updated automatically and momentarily highlighted in yellow as you type to indicate the automatic renaming.
Syntax Checking
Any Gherkin syntax errors are automatically highlighted so that they could be easily corrected.
Out of order Gherkin keywords
Hovering over the highlighted error will give more details in a pop up message
Missing data table header names
Missing data table cells
Missing Examples table value
Unused Scenario parameter
Duplicate Examples table column
Incorrect indentation
A warning is shown for any lines that are not at expected indentation level according to Gherkin syntax
Tip - to correct indentation of a data table, simply place the cursor before the leading cell of any of the rows and press Space or Tab key to adjust indentation of all rows together
To unindent press Delete key or Shift+Tab
Add Comment