​
Description

The if command is used to conditionally execute a set of commands based on whether a specified condition evaluates to true or false. If the condition is true, the commands in the then block are executed. Otherwise, the commands in the else block are executed.

​
Arguments

ArgumentTypeDescription
conditionstringThe condition to evaluate.
thenlist of commandsThe commands to run if the condition is true.
elselist of commandsThe commands to run if the condition is false. It is an optional command.

​
Example usage

- prompt: click on sign up, if cookie banner appears close it
  commands:
    - command: if
      condition: the text "Accept Cookies" is visible
      then:
        - command: hover-text
          text: Accept Cookies
          description: cookie banner button
          action: click
      else:
        - command: hover-text
          text: Sign Up
          description: link in the header
          action: click

​
Protips

  • Ensure the condition is clearly defined and evaluates correctly to avoid unexpected behavior.
  • Use descriptive then and else blocks to handle both outcomes effectively.

​
Gotchas

  • The else block is optional, if the condition fails and there is no else block, the execution will continue from the next available command.
  • If the condition is invalid or can’t be evaluated, the command will fail.
  • Ensure all commands in the then and else blocks are valid and properly formatted.
The if command is useful for creating conditional logic in your tests, allowing for more dynamic and flexible workflows.