Skip to main content
version: 6.0.0
steps:
  - prompt: go to testdriver.ai and verify the page loads
    commands:
      - command: press-keys
        keys:
          - ctrl
          - l
      - command: type
        text: testdriver.ai
      - command: press-keys
        keys:
          - enter
      - command: wait-for-text
        text: Book a Demo
        timeout: 10000 # 10 seconds

​
Description

The wait-for-text command waits until the specified text is detected on the screen. This is useful for ensuring that textual elements are present before proceeding with the next steps in a test.

​
Arguments

ArgumentTypeDescription
textstringThe text to find on the screen.
timeoutnumber(Optional) The duration in milliseconds to wait for the text to appear. Default is 5000 (5 seconds).
methodenum(Optional) The matching algorithm to use. Possible values are ai and turbo. Default is turbo
invertboolean(Optional) If set to true, the command will wait until the specified text is NOT detected. Default is false.

​
Example usage

command: wait-for-text
text: Copyright 2024
timeout: 5000

​
Protips

  • Use unique and specific text to improve detection accuracy.
  • Adjust the timeout value based on the expected load time of the text to avoid unnecessary delays.

​
Gotchas

  • If the text doesn’t appear within the specified timeout, the command will fail.
  • Ensure the text matches exactly, as variations in font size, style, or screen resolution may affect detection accuracy.
The wait-for-text command is ideal for synchronizing tests with textual elements that may take time to load.