testdriverai 6.0.27-canary.3bcd63c.0 → 6.0.27-canary.ea72c58.0

package/.vscode/settings.json

@@ -3,5 +3,8 @@
     "source.organizeImports": "explicit"
   },
   "editor.formatOnSave": true,
-  "editor.defaultFormatter": "esbenp.prettier-vscode"
+  "editor.defaultFormatter": "esbenp.prettier-vscode",
+  "yaml.schemas": {
+    "https://raw.githubusercontent.com/testdriverai/testdriverai/main/schema.json": "file:///Users/kid/Desktop/td/internal/testdriverai/testdriver.yaml"
+  }
 }

package/agent/lib/commander.js

@@ -134,6 +134,7 @@ commands:
             object.description,
             object.action,
             object.method,
+            object.timeout,
           );
           break;
         case "hover-image":

package/agent/lib/commands.js

@@ -339,11 +339,12 @@ const createCommands = (
       description = null,
       action = "click",
       method = "turbo",
+      timeout = 5000, // we pass this to the subsequent wait-for-text block
     ) => {
       text = text ? text.toString() : null;
 
       // wait for the text to appear on screen
-      await commands["wait-for-text"](text, 5000);
+      await commands["wait-for-text"](text, timeout);
 
       description = description ? description.toString() : null;
 

package/docs/commands/hover-text.mdx

@@ -18,12 +18,13 @@ The `hover-text` command is used to locate text on the screen based on a descrip
 
 ## Arguments
 
-|   Argument    |   Type   | Description                                                                                                                                                                                                                 |
-| :-----------: | :------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-|    `text`     | `string` | The text to find on the screen. Longer and unique is better.                                                                                                                                                                |
-| `description` | `string` | A description of the text and what it represents. The actual text itself shouldn't be included here.                                                                                                                        |
+|   Argument    |   Type   | Description                                             |
+| :-----------: | :------: | :------------------------------------------------------ |
+|    `text`     | `string` | The text to find on the screen. Longer and unique is better.   |
+| `description` | `string` | A description of the text and what it represents. The actual text itself shouldn't be included here. |
 |   `action`    | `string` | The action to take when the text is found. Available actions are: `click`, `right-click`, `double-click`, `hover`. Also supports `drag-start` and `drag-end` for [dragging text](/commands/hover-image#drag-functionality). |
-|   `method`    |  `enum`  | The matching algorithm to use. Possible values are `turbo` (default) and `ai`.                                                                                                                                              |
+|   `method`    |  `enum`  | The matching algorithm to use. Possible values are `turbo` (default) and `ai`.|
+| `timeout`     | `number` | **(Optional)** The duration in milliseconds to wait for the text to appear. Default is `5000` (5 seconds).|
 
 ## Example usage
 
@@ -32,11 +33,12 @@ command: hover-text
 text: Sign Up
 description: link in the header
 action: click
+timeout: 10000 # 10 seconds
 ```
 
 ## Gotchas
 
-- If the text can't be located, the command will fail. Ensure the text is visible on the screen and matches exactly.
+- If the text can't be located, it will internally call the [wait-for-text](/commands/wait-for-text) command and wait for the text to appear. The wait `timeout` is 5 seconds by default, and the command fails if the text is not found.
 - Variations in font size, style, or screen resolution may affect detection accuracy.
 
 ## Notes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testdriverai",
-  "version": "6.0.27-canary.3bcd63c.0",
+  "version": "6.0.27-canary.ea72c58.0",
   "description": "Next generation autonomous AI agent for end-to-end testing of web & desktop",
   "main": "index.js",
   "bin": {

package/schema.json

@@ -415,6 +415,9 @@
               "ai",
               "turbo"
             ]
+          },
+          "timeout": {
+            "type": "integer"
           }
         }
       },

package/testdriver/acceptance/hover-text.yaml

@@ -1,4 +1,4 @@
-version: 5.7.7
+version: 6.0.0
 session: 682f5aab811bd5a322c0e5a1
 steps:
   - prompt: click on sign in
@@ -9,5 +9,6 @@ steps:
         text: Sign In
         description: black button below the password field
         action: click
+        timeout: 5000
       - command: assert
         expect: an error shows that fields are required