@testdriverai/mcp 7.11.36-test → 7.11.37-test
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/ai/skills/testdriver-ci-cd/SKILL.md +41 -0
- package/ai/skills/testdriver-extract/SKILL.md +224 -0
- package/ai/skills/testdriver-find/SKILL.md +1 -5
- package/ai/skills/testdriver:find/SKILL.md +0 -4
- package/docs/_data/examples-manifest.json +42 -42
- package/docs/v7/examples/assert.mdx +1 -1
- package/docs/v7/examples/chrome-extension.mdx +1 -1
- package/docs/v7/examples/element-not-found.mdx +1 -1
- package/docs/v7/examples/findall-coffee-icons.mdx +1 -1
- package/docs/v7/examples/hover-image.mdx +1 -1
- package/docs/v7/examples/hover-text-with-description.mdx +1 -1
- package/docs/v7/examples/hover-text.mdx +1 -1
- package/docs/v7/examples/installer.mdx +1 -1
- package/docs/v7/examples/launch-vscode-linux.mdx +1 -1
- package/docs/v7/examples/parse.mdx +1 -1
- package/docs/v7/examples/press-keys.mdx +1 -1
- package/docs/v7/examples/scroll-keyboard.mdx +1 -1
- package/docs/v7/examples/scroll.mdx +1 -1
- package/docs/v7/examples/type.mdx +1 -1
- package/docs/v7/find.mdx +0 -4
- package/package.json +1 -1
|
@@ -634,6 +634,47 @@ describe("Cross-platform tests", () => {
|
|
|
634
634
|
});
|
|
635
635
|
```
|
|
636
636
|
|
|
637
|
+
## Concurrency limits
|
|
638
|
+
|
|
639
|
+
Your plan allows a fixed number of sandboxes running at once. When a test asks for
|
|
640
|
+
a sandbox and you're already at that limit, the request is **queued** rather than
|
|
641
|
+
failed immediately: the SDK waits for a slot to free up, retrying every 10 seconds,
|
|
642
|
+
then proceeds automatically once one opens. This is what lets a parallel CI matrix
|
|
643
|
+
(many jobs starting at once) work on a plan with fewer slots than jobs — the extra
|
|
644
|
+
jobs simply wait their turn instead of erroring.
|
|
645
|
+
|
|
646
|
+
By default the SDK waits up to **60 seconds** for a slot before giving up with a
|
|
647
|
+
concurrency-limit error. Control that ceiling with `TD_CONCURRENCY_MAX_WAIT`:
|
|
648
|
+
|
|
649
|
+
| Value | Behavior |
|
|
650
|
+
| ----- | -------- |
|
|
651
|
+
| _unset_ | Wait up to **60 seconds** (the default). |
|
|
652
|
+
| `TD_CONCURRENCY_MAX_WAIT=300` | Wait up to **300 seconds** (5 minutes) before giving up. |
|
|
653
|
+
| `TD_CONCURRENCY_MAX_WAIT=0` | **Don't queue** — fail on the first denial. |
|
|
654
|
+
|
|
655
|
+
The value is **in seconds** (fractional values are allowed and rounded to the
|
|
656
|
+
nearest millisecond). Any invalid or negative value falls back to the 60-second
|
|
657
|
+
default. The wait applies per sandbox request, across both the initial allocation
|
|
658
|
+
and the realtime slot-approval handshake.
|
|
659
|
+
|
|
660
|
+
```yaml
|
|
661
|
+
# Example: a large parallel matrix that may queue for a while.
|
|
662
|
+
# Give each job up to 5 minutes to acquire a slot before failing.
|
|
663
|
+
- name: Run TestDriver tests
|
|
664
|
+
env:
|
|
665
|
+
TD_API_KEY: ${{ secrets.TD_API_KEY }}
|
|
666
|
+
TD_CONCURRENCY_MAX_WAIT: "300"
|
|
667
|
+
run: npx vitest run
|
|
668
|
+
```
|
|
669
|
+
|
|
670
|
+
<Tip>
|
|
671
|
+
Raise `TD_CONCURRENCY_MAX_WAIT` when you run more parallel jobs than your plan has
|
|
672
|
+
slots and would rather they queue than fail. Set it to `0` when you'd prefer a job
|
|
673
|
+
to **fail fast** on a busy account (e.g. a quick smoke test that shouldn't sit
|
|
674
|
+
waiting). When jobs routinely give up waiting, that's the signal to
|
|
675
|
+
[add more slots](https://console.testdriver.ai/checkout/pro).
|
|
676
|
+
</Tip>
|
|
677
|
+
|
|
637
678
|
## Viewing Results
|
|
638
679
|
|
|
639
680
|
All test runs are automatically recorded and visible in your TestDriver dashboard at [console.testdriver.ai](https://console.testdriver.ai):
|
|
@@ -0,0 +1,224 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: testdriver:extract
|
|
3
|
+
description: Read information from the screen using AI and return it as a string
|
|
4
|
+
---
|
|
5
|
+
<!-- Generated from extract.mdx. DO NOT EDIT. -->
|
|
6
|
+
|
|
7
|
+
## Overview
|
|
8
|
+
|
|
9
|
+
Extract information from the current screen using AI and return it as a string. Describe what you want in natural language, and the AI reads the screen and returns the matching value — text, numbers, labels, status messages, or any other on-screen content.
|
|
10
|
+
|
|
11
|
+
Unlike [`assert()`](/v7/assert), which returns a boolean verdict, `extract()` returns the actual value so you can store it, compare it, or feed it into later steps and framework assertions.
|
|
12
|
+
|
|
13
|
+
## Syntax
|
|
14
|
+
|
|
15
|
+
```javascript
|
|
16
|
+
const value = await testdriver.extract(description)
|
|
17
|
+
const value = await testdriver.extract({ description })
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
## Parameters
|
|
21
|
+
|
|
22
|
+
<ParamField path="description" type="string" required>
|
|
23
|
+
Natural language description of the information to read from the screen.
|
|
24
|
+
</ParamField>
|
|
25
|
+
|
|
26
|
+
<Info>
|
|
27
|
+
`extract()` also accepts an options object — `extract({ description })` — which is equivalent to the positional form. The bare string form is the most common.
|
|
28
|
+
</Info>
|
|
29
|
+
|
|
30
|
+
## Returns
|
|
31
|
+
|
|
32
|
+
`Promise<string>` — The information read from the screen. Returns the extracted value as text; parse or cast it yourself if you need a number or other type.
|
|
33
|
+
|
|
34
|
+
## Examples
|
|
35
|
+
|
|
36
|
+
### Basic Extraction
|
|
37
|
+
|
|
38
|
+
```javascript
|
|
39
|
+
// Read text content
|
|
40
|
+
const title = await testdriver.extract('the page title');
|
|
41
|
+
const heading = await testdriver.extract('the main heading text');
|
|
42
|
+
|
|
43
|
+
// Read numbers and prices
|
|
44
|
+
const price = await testdriver.extract('the total price shown in the cart');
|
|
45
|
+
const count = await testdriver.extract('the number of items in the list');
|
|
46
|
+
|
|
47
|
+
// Read status and confirmation values
|
|
48
|
+
const status = await testdriver.extract('the order status');
|
|
49
|
+
const orderNumber = await testdriver.extract('the order confirmation number');
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
### Using the Extracted Value
|
|
53
|
+
|
|
54
|
+
```javascript
|
|
55
|
+
// Store and reuse across steps
|
|
56
|
+
const orderNumber = await testdriver.extract('the order confirmation number');
|
|
57
|
+
console.log('Order:', orderNumber);
|
|
58
|
+
|
|
59
|
+
// Combine with framework assertions
|
|
60
|
+
import { expect } from 'vitest';
|
|
61
|
+
|
|
62
|
+
const message = await testdriver.extract('the success message text');
|
|
63
|
+
expect(message).toContain('successfully');
|
|
64
|
+
|
|
65
|
+
// Cast to a number when you need to compare
|
|
66
|
+
const totalText = await testdriver.extract('the cart total as a number without currency symbol');
|
|
67
|
+
expect(Number(totalText)).toBeGreaterThan(0);
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
## Best Practices
|
|
71
|
+
|
|
72
|
+
<Check>
|
|
73
|
+
**Be specific about what to read**
|
|
74
|
+
|
|
75
|
+
Precise descriptions produce cleaner values:
|
|
76
|
+
|
|
77
|
+
```javascript
|
|
78
|
+
// ❌ Too vague — may return extra surrounding text
|
|
79
|
+
const price = await testdriver.extract('price');
|
|
80
|
+
|
|
81
|
+
// ✅ Specific — targets a single value
|
|
82
|
+
const price = await testdriver.extract('the total price in the order summary, digits only');
|
|
83
|
+
```
|
|
84
|
+
</Check>
|
|
85
|
+
|
|
86
|
+
<Check>
|
|
87
|
+
**Ask for the format you want**
|
|
88
|
+
|
|
89
|
+
Steer the output by describing the desired shape in the prompt:
|
|
90
|
+
|
|
91
|
+
```javascript
|
|
92
|
+
// Strip currency symbols
|
|
93
|
+
const total = await testdriver.extract('the order total as a number without the dollar sign');
|
|
94
|
+
|
|
95
|
+
// Isolate a single field
|
|
96
|
+
const email = await testdriver.extract('the email address shown in the profile header');
|
|
97
|
+
```
|
|
98
|
+
</Check>
|
|
99
|
+
|
|
100
|
+
<Check>
|
|
101
|
+
**Extract for detailed assertions**
|
|
102
|
+
|
|
103
|
+
Use `extract()` when a boolean [`assert()`](/v7/assert) isn't enough and you need the actual value to inspect:
|
|
104
|
+
|
|
105
|
+
```javascript
|
|
106
|
+
const confirmation = await testdriver.extract('the confirmation number');
|
|
107
|
+
expect(confirmation).toMatch(/^ORD-\d{6}$/);
|
|
108
|
+
```
|
|
109
|
+
</Check>
|
|
110
|
+
|
|
111
|
+
## Use Cases
|
|
112
|
+
|
|
113
|
+
<AccordionGroup>
|
|
114
|
+
<Accordion title="Capturing Confirmation Details">
|
|
115
|
+
```javascript
|
|
116
|
+
const submitBtn = await testdriver.find('place order button');
|
|
117
|
+
await submitBtn.click();
|
|
118
|
+
|
|
119
|
+
// Read the confirmation the app generated
|
|
120
|
+
const orderNumber = await testdriver.extract('the order confirmation number');
|
|
121
|
+
const eta = await testdriver.extract('the estimated delivery date');
|
|
122
|
+
|
|
123
|
+
console.log(`Order ${orderNumber} arrives ${eta}`);
|
|
124
|
+
```
|
|
125
|
+
</Accordion>
|
|
126
|
+
|
|
127
|
+
<Accordion title="Reading Tooltip and Hover Content">
|
|
128
|
+
```javascript
|
|
129
|
+
const icon = await testdriver.find('info icon next to the price');
|
|
130
|
+
await icon.hover();
|
|
131
|
+
|
|
132
|
+
const tooltipText = await testdriver.extract('the tooltip text');
|
|
133
|
+
expect(tooltipText).toContain('tax included');
|
|
134
|
+
```
|
|
135
|
+
</Accordion>
|
|
136
|
+
|
|
137
|
+
<Accordion title="Verifying Dynamic Values">
|
|
138
|
+
```javascript
|
|
139
|
+
// Read a value before an action
|
|
140
|
+
const before = await testdriver.extract('the account balance');
|
|
141
|
+
|
|
142
|
+
const addBtn = await testdriver.find('add funds button');
|
|
143
|
+
await addBtn.click();
|
|
144
|
+
|
|
145
|
+
// Read it again after and compare
|
|
146
|
+
const after = await testdriver.extract('the account balance');
|
|
147
|
+
expect(Number(after.replace(/[^0-9.]/g, ''))).toBeGreaterThan(
|
|
148
|
+
Number(before.replace(/[^0-9.]/g, ''))
|
|
149
|
+
);
|
|
150
|
+
```
|
|
151
|
+
</Accordion>
|
|
152
|
+
|
|
153
|
+
<Accordion title="Passing Data Between Steps">
|
|
154
|
+
```javascript
|
|
155
|
+
// Read a generated code on one screen...
|
|
156
|
+
const resetCode = await testdriver.extract('the password reset code');
|
|
157
|
+
|
|
158
|
+
// ...and type it into the next
|
|
159
|
+
const codeField = await testdriver.find('reset code input');
|
|
160
|
+
await codeField.click();
|
|
161
|
+
await testdriver.type(resetCode);
|
|
162
|
+
```
|
|
163
|
+
</Accordion>
|
|
164
|
+
</AccordionGroup>
|
|
165
|
+
|
|
166
|
+
## Complete Example
|
|
167
|
+
|
|
168
|
+
```javascript
|
|
169
|
+
import { beforeAll, afterAll, describe, it, expect } from 'vitest';
|
|
170
|
+
import TestDriver from 'testdriverai';
|
|
171
|
+
|
|
172
|
+
describe('Extraction', () => {
|
|
173
|
+
let testdriver;
|
|
174
|
+
|
|
175
|
+
beforeAll(async () => {
|
|
176
|
+
testdriver = new TestDriver(process.env.TD_API_KEY);
|
|
177
|
+
await testdriver.auth();
|
|
178
|
+
await testdriver.connect();
|
|
179
|
+
});
|
|
180
|
+
|
|
181
|
+
afterAll(async () => {
|
|
182
|
+
await testdriver.disconnect();
|
|
183
|
+
});
|
|
184
|
+
|
|
185
|
+
it('should capture the order confirmation', async () => {
|
|
186
|
+
await testdriver.focusApplication('Google Chrome');
|
|
187
|
+
|
|
188
|
+
// Complete a checkout
|
|
189
|
+
const checkoutBtn = await testdriver.find('checkout button');
|
|
190
|
+
await checkoutBtn.click();
|
|
191
|
+
|
|
192
|
+
const placeOrderBtn = await testdriver.find('place order button');
|
|
193
|
+
await placeOrderBtn.click();
|
|
194
|
+
|
|
195
|
+
// Verify we reached confirmation
|
|
196
|
+
await testdriver.assert('the order confirmation page is displayed');
|
|
197
|
+
|
|
198
|
+
// Extract the details the app generated
|
|
199
|
+
const orderNumber = await testdriver.extract('the order confirmation number');
|
|
200
|
+
const total = await testdriver.extract('the order total as a number without currency symbol');
|
|
201
|
+
|
|
202
|
+
// Assert on the extracted values
|
|
203
|
+
expect(orderNumber).toBeTruthy();
|
|
204
|
+
expect(Number(total)).toBeGreaterThan(0);
|
|
205
|
+
});
|
|
206
|
+
});
|
|
207
|
+
```
|
|
208
|
+
|
|
209
|
+
## How It Works
|
|
210
|
+
|
|
211
|
+
1. TestDriver captures a screenshot of the current screen
|
|
212
|
+
2. The image and your description are sent to the TestDriver API
|
|
213
|
+
3. The AI reads the requested information from the screenshot
|
|
214
|
+
4. The extracted value is returned as a string
|
|
215
|
+
|
|
216
|
+
<Note>
|
|
217
|
+
Like [assertions](/v7/making-assertions), `extract()` reads the screen fresh on every call — it is not cached — so it always reflects the current state of the app.
|
|
218
|
+
</Note>
|
|
219
|
+
|
|
220
|
+
## Related Methods
|
|
221
|
+
|
|
222
|
+
- [`assert()`](/v7/assert) - Verify screen state with a boolean AI judgment
|
|
223
|
+
- [`find()`](/v7/find) - Locate elements to interact with
|
|
224
|
+
- [`parse()`](/v7/parse) - Detect all UI elements on screen
|
|
@@ -54,7 +54,7 @@ const element = await testdriver.find(description, options)
|
|
|
54
54
|
</ParamField>
|
|
55
55
|
|
|
56
56
|
<ParamField path="verify" type="boolean" default={false}>
|
|
57
|
-
Enable AI verification of the located element. When `true`, a second AI call checks that the coordinates returned actually correspond to the requested element, catching hallucinated or incorrect positions. Disabled by default for lower latency. Defaults to the global `verify` option set on the SDK constructor when not specified per call.
|
|
57
|
+
Enable AI verification of the located element. When `true`, a second AI call checks that the coordinates returned actually correspond to the requested element, catching hallucinated or incorrect positions. Disabled by default for lower latency. Defaults to the global `verify` option set on the [SDK constructor](/v7/client) when not specified per call.
|
|
58
58
|
</ParamField>
|
|
59
59
|
|
|
60
60
|
<ParamField path="ai" type="object">
|
|
@@ -395,10 +395,6 @@ const element = await testdriver.find('small cancel icon next to the subscriptio
|
|
|
395
395
|
await element.click();
|
|
396
396
|
```
|
|
397
397
|
|
|
398
|
-
<Warning>
|
|
399
|
-
Both `zoom` and `verify` add extra AI calls per `find()` invocation, which increases latency and API usage. When both are enabled, each find may make up to 3 AI calls. **Rate limiting may occur** if many find calls use these options in rapid succession. Use them selectively for critical interactions rather than on every find call.
|
|
400
|
-
</Warning>
|
|
401
|
-
|
|
402
398
|
## Cache Options
|
|
403
399
|
|
|
404
400
|
When a test completes successfully, the result of each `find()` is cached. On later runs, TestDriver reuses the cached match instead of making a fresh AI call, which significantly speeds up locating the same element. The cache lives in your [dashboard](https://console.testdriver.ai/cache) and is shared across runs — see the [Cache](/v7/cache) page for how matching, thresholds, and invalidation work.
|
|
@@ -395,10 +395,6 @@ const element = await testdriver.find('small cancel icon next to the subscriptio
|
|
|
395
395
|
await element.click();
|
|
396
396
|
```
|
|
397
397
|
|
|
398
|
-
<Warning>
|
|
399
|
-
Both `zoom` and `verify` add extra AI calls per `find()` invocation, which increases latency and API usage. When both are enabled, each find may make up to 3 AI calls. **Rate limiting may occur** if many find calls use these options in rapid succession. Use them selectively for critical interactions rather than on every find call.
|
|
400
|
-
</Warning>
|
|
401
|
-
|
|
402
398
|
## Cache Options
|
|
403
399
|
|
|
404
400
|
Control caching behavior to optimize performance, especially when using dynamic variables in prompts.
|
|
@@ -2,16 +2,16 @@
|
|
|
2
2
|
"$schema": "./examples-manifest.schema.json",
|
|
3
3
|
"examples": {
|
|
4
4
|
"assert.test.mjs": {
|
|
5
|
-
"url": "https://console-test.testdriver.ai/runs/
|
|
6
|
-
"lastUpdated": "2026-07-
|
|
5
|
+
"url": "https://console-test.testdriver.ai/runs/6a694a8bbecdb5de72ac4fd5/6a694b84becdb5de72ac5036",
|
|
6
|
+
"lastUpdated": "2026-07-29T00:38:28.175Z"
|
|
7
7
|
},
|
|
8
8
|
"drag-and-drop.test.mjs": {
|
|
9
9
|
"url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b42fc0ac3cc632a918b",
|
|
10
10
|
"lastUpdated": "2026-03-03T00:32:25.275Z"
|
|
11
11
|
},
|
|
12
12
|
"exec-pwsh.test.mjs": {
|
|
13
|
-
"url": "https://console-test.testdriver.ai/runs/
|
|
14
|
-
"lastUpdated": "2026-07-
|
|
13
|
+
"url": "https://console-test.testdriver.ai/runs/6a694a8bbecdb5de72ac4fd5/6a694aa5becdb5de72ac4fd8",
|
|
14
|
+
"lastUpdated": "2026-07-29T00:41:26.046Z"
|
|
15
15
|
},
|
|
16
16
|
"match-image.test.mjs": {
|
|
17
17
|
"url": "https://console-test.testdriver.ai/runs/69c8738614b73310c7839412/69c8738c14b73310c783941d",
|
|
@@ -22,78 +22,78 @@
|
|
|
22
22
|
"lastUpdated": "2026-03-03T00:32:25.282Z"
|
|
23
23
|
},
|
|
24
24
|
"hover-text-with-description.test.mjs": {
|
|
25
|
-
"url": "https://console-test.testdriver.ai/runs/
|
|
26
|
-
"lastUpdated": "2026-07-
|
|
25
|
+
"url": "https://console-test.testdriver.ai/runs/6a694a8bbecdb5de72ac4fd5/6a694ad7c00c8fc8cedd6715",
|
|
26
|
+
"lastUpdated": "2026-07-29T00:42:13.012Z"
|
|
27
27
|
},
|
|
28
28
|
"windows-installer.test.mjs": {
|
|
29
|
-
"url": "https://console-test.testdriver.ai/runs/
|
|
30
|
-
"lastUpdated": "2026-07-
|
|
29
|
+
"url": "https://console-test.testdriver.ai/runs/6a694a8bbecdb5de72ac4fd5/6a694ad9becdb5de72ac4fec",
|
|
30
|
+
"lastUpdated": "2026-07-29T00:58:56.974Z"
|
|
31
31
|
},
|
|
32
32
|
"exec-output.test.mjs": {
|
|
33
|
-
"url": "https://console-test.testdriver.ai/runs/
|
|
34
|
-
"lastUpdated": "2026-07-
|
|
33
|
+
"url": "https://console-test.testdriver.ai/runs/6a694a8bbecdb5de72ac4fd5/6a694adbbecdb5de72ac4fed",
|
|
34
|
+
"lastUpdated": "2026-07-29T00:48:45.394Z"
|
|
35
35
|
},
|
|
36
36
|
"chrome-extension.test.mjs": {
|
|
37
|
-
"url": "https://console-test.testdriver.ai/runs/
|
|
38
|
-
"lastUpdated": "2026-07-
|
|
37
|
+
"url": "https://console-test.testdriver.ai/runs/6a694a8bbecdb5de72ac4fd5/6a694aa3becdb5de72ac4fd7",
|
|
38
|
+
"lastUpdated": "2026-07-29T00:41:23.620Z"
|
|
39
39
|
},
|
|
40
40
|
"launch-vscode-linux.test.mjs": {
|
|
41
|
-
"url": "https://console-test.testdriver.ai/runs/
|
|
42
|
-
"lastUpdated": "2026-07-
|
|
41
|
+
"url": "https://console-test.testdriver.ai/runs/6a694a8bbecdb5de72ac4fd5/6a694abebecdb5de72ac4fe6",
|
|
42
|
+
"lastUpdated": "2026-07-29T00:48:17.483Z"
|
|
43
43
|
},
|
|
44
44
|
"hover-image.test.mjs": {
|
|
45
|
-
"url": "https://console-test.testdriver.ai/runs/
|
|
46
|
-
"lastUpdated": "2026-07-
|
|
45
|
+
"url": "https://console-test.testdriver.ai/runs/6a694a8bbecdb5de72ac4fd5/6a694af4becdb5de72ac4ff7",
|
|
46
|
+
"lastUpdated": "2026-07-29T00:36:04.272Z"
|
|
47
47
|
},
|
|
48
48
|
"installer.test.mjs": {
|
|
49
|
-
"url": "https://console-test.testdriver.ai/runs/
|
|
50
|
-
"lastUpdated": "2026-07-
|
|
49
|
+
"url": "https://console-test.testdriver.ai/runs/6a694a8bbecdb5de72ac4fd5/6a694b22becdb5de72ac5009",
|
|
50
|
+
"lastUpdated": "2026-07-29T00:36:50.202Z"
|
|
51
51
|
},
|
|
52
52
|
"type.test.mjs": {
|
|
53
|
-
"url": "https://console-test.testdriver.ai/runs/
|
|
54
|
-
"lastUpdated": "2026-07-
|
|
53
|
+
"url": "https://console-test.testdriver.ai/runs/6a694a8bbecdb5de72ac4fd5/6a694b53c00c8fc8cedd6740",
|
|
54
|
+
"lastUpdated": "2026-07-29T00:50:36.130Z"
|
|
55
55
|
},
|
|
56
56
|
"press-keys.test.mjs": {
|
|
57
|
-
"url": "https://console-test.testdriver.ai/runs/
|
|
58
|
-
"replayUrl": "https://console-test.testdriver.ai/replay/
|
|
59
|
-
"embedUrl": "https://console-test.testdriver.ai/replay/
|
|
60
|
-
"lastUpdated": "2026-07-
|
|
57
|
+
"url": "https://console-test.testdriver.ai/runs/6a694a8bbecdb5de72ac4fd5/6a694b6cc00c8fc8cedd674e",
|
|
58
|
+
"replayUrl": "https://console-test.testdriver.ai/replay/6a6951f0c00c8fc8cedd67cb?share=iL0hbVjuj0nebzzfNRdtg",
|
|
59
|
+
"embedUrl": "https://console-test.testdriver.ai/replay/6a6951f0c00c8fc8cedd67cb?share=iL0hbVjuj0nebzzfNRdtg&embed=true",
|
|
60
|
+
"lastUpdated": "2026-07-29T01:05:58.439Z"
|
|
61
61
|
},
|
|
62
62
|
"scroll-keyboard.test.mjs": {
|
|
63
|
-
"url": "https://console-test.testdriver.ai/runs/
|
|
64
|
-
"lastUpdated": "2026-07-
|
|
63
|
+
"url": "https://console-test.testdriver.ai/runs/6a694a8bbecdb5de72ac4fd5/6a694bb6c00c8fc8cedd6753",
|
|
64
|
+
"lastUpdated": "2026-07-29T00:52:10.535Z"
|
|
65
65
|
},
|
|
66
66
|
"scroll.test.mjs": {
|
|
67
|
-
"url": "https://console-test.testdriver.ai/runs/
|
|
68
|
-
"lastUpdated": "2026-07-
|
|
67
|
+
"url": "https://console-test.testdriver.ai/runs/6a694a8bbecdb5de72ac4fd5/6a694bd3becdb5de72ac503f",
|
|
68
|
+
"lastUpdated": "2026-07-29T00:46:16.205Z"
|
|
69
69
|
},
|
|
70
70
|
"scroll-until-image.test.mjs": {
|
|
71
|
-
"url": "https://console-test.testdriver.ai/runs/
|
|
72
|
-
"lastUpdated": "2026-07-
|
|
71
|
+
"url": "https://console-test.testdriver.ai/runs/6a694a8bbecdb5de72ac4fd5/6a694bb8becdb5de72ac503e",
|
|
72
|
+
"lastUpdated": "2026-07-29T00:39:20.941Z"
|
|
73
73
|
},
|
|
74
74
|
"prompt.test.mjs": {
|
|
75
|
-
"url": "https://console-test.testdriver.ai/runs/
|
|
76
|
-
"lastUpdated": "2026-07-
|
|
75
|
+
"url": "https://console-test.testdriver.ai/runs/6a694a8bbecdb5de72ac4fd5/6a694bbac00c8fc8cedd6755",
|
|
76
|
+
"lastUpdated": "2026-07-29T00:52:15.080Z"
|
|
77
77
|
},
|
|
78
78
|
"focus-window.test.mjs": {
|
|
79
|
-
"url": "https://console-test.testdriver.ai/runs/
|
|
80
|
-
"lastUpdated": "2026-07-
|
|
79
|
+
"url": "https://console-test.testdriver.ai/runs/6a694a8bbecdb5de72ac4fd5/6a694bbcc00c8fc8cedd6756",
|
|
80
|
+
"lastUpdated": "2026-07-29T00:52:16.956Z"
|
|
81
81
|
},
|
|
82
82
|
"captcha-api.test.mjs": {
|
|
83
83
|
"url": "https://console.testdriver.ai/runs/698f7df69e27ce1528d7d087/698f7fb0d3b320ad547d9d44",
|
|
84
84
|
"lastUpdated": "2026-02-13T19:55:05.951Z"
|
|
85
85
|
},
|
|
86
86
|
"element-not-found.test.mjs": {
|
|
87
|
-
"url": "https://console-test.testdriver.ai/runs/
|
|
88
|
-
"lastUpdated": "2026-07-
|
|
87
|
+
"url": "https://console-test.testdriver.ai/runs/6a694a8bbecdb5de72ac4fd5/6a694bebbecdb5de72ac5041",
|
|
88
|
+
"lastUpdated": "2026-07-29T00:46:40.013Z"
|
|
89
89
|
},
|
|
90
90
|
"formatted-logging.test.mjs": {
|
|
91
91
|
"url": "https://console-test.testdriver.ai/runs/69c8738614b73310c7839412/69c873a714b73310c7839450",
|
|
92
92
|
"lastUpdated": "2026-03-29T00:36:10.628Z"
|
|
93
93
|
},
|
|
94
94
|
"hover-text.test.mjs": {
|
|
95
|
-
"url": "https://console-test.testdriver.ai/runs/
|
|
96
|
-
"lastUpdated": "2026-07-
|
|
95
|
+
"url": "https://console-test.testdriver.ai/runs/6a694a8bbecdb5de72ac4fd5/6a694c03becdb5de72ac5049",
|
|
96
|
+
"lastUpdated": "2026-07-29T00:47:04.963Z"
|
|
97
97
|
},
|
|
98
98
|
"no-provision.test.mjs": {
|
|
99
99
|
"url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62b7706a177a05bccd1cf",
|
|
@@ -138,12 +138,12 @@
|
|
|
138
138
|
"lastUpdated": "2026-02-13T19:55:05.953Z"
|
|
139
139
|
},
|
|
140
140
|
"findall-coffee-icons.test.mjs": {
|
|
141
|
-
"url": "https://console-test.testdriver.ai/runs/
|
|
142
|
-
"lastUpdated": "2026-07-
|
|
141
|
+
"url": "https://console-test.testdriver.ai/runs/6a694a8bbecdb5de72ac4fd5/6a694b9dbecdb5de72ac503a",
|
|
142
|
+
"lastUpdated": "2026-07-29T00:38:53.472Z"
|
|
143
143
|
},
|
|
144
144
|
"parse.test.mjs": {
|
|
145
|
-
"url": "https://console-test.testdriver.ai/runs/
|
|
146
|
-
"lastUpdated": "2026-07-
|
|
145
|
+
"url": "https://console-test.testdriver.ai/runs/6a694a8bbecdb5de72ac4fd5/6a694c1bc00c8fc8cedd6762",
|
|
146
|
+
"lastUpdated": "2026-07-29T00:47:28.336Z"
|
|
147
147
|
},
|
|
148
148
|
"flake-diffthreshold-001.test.mjs": {
|
|
149
149
|
"url": "https://console.testdriver.ai/runs/69a62b3aaa712ecd3dea730a/69a62bcafc0ac3cc632a91aa",
|
|
@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
|
|
|
12
12
|
|
|
13
13
|
{/* assert.test.mjs output */}
|
|
14
14
|
<iframe
|
|
15
|
-
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/
|
|
15
|
+
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a694b84becdb5de72ac5036/replay"
|
|
16
16
|
width="100%"
|
|
17
17
|
height="390"
|
|
18
18
|
style={{ border: "1px solid #333", borderRadius: "8px" }}
|
|
@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
|
|
|
12
12
|
|
|
13
13
|
{/* chrome-extension.test.mjs output */}
|
|
14
14
|
<iframe
|
|
15
|
-
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/
|
|
15
|
+
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a694aa3becdb5de72ac4fd7/replay"
|
|
16
16
|
width="100%"
|
|
17
17
|
height="390"
|
|
18
18
|
style={{ border: "1px solid #333", borderRadius: "8px" }}
|
|
@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
|
|
|
12
12
|
|
|
13
13
|
{/* element-not-found.test.mjs output */}
|
|
14
14
|
<iframe
|
|
15
|
-
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/
|
|
15
|
+
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a694bebbecdb5de72ac5041/replay"
|
|
16
16
|
width="100%"
|
|
17
17
|
height="390"
|
|
18
18
|
style={{ border: "1px solid #333", borderRadius: "8px" }}
|
|
@@ -18,7 +18,7 @@ Watch this test execute in a real sandbox environment:
|
|
|
18
18
|
|
|
19
19
|
{/* findall-coffee-icons.test.mjs output */}
|
|
20
20
|
<iframe
|
|
21
|
-
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/
|
|
21
|
+
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a694b9dbecdb5de72ac503a/replay"
|
|
22
22
|
width="100%"
|
|
23
23
|
height="600"
|
|
24
24
|
style={{ border: "1px solid #333", borderRadius: "8px" }}
|
|
@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
|
|
|
12
12
|
|
|
13
13
|
{/* hover-image.test.mjs output */}
|
|
14
14
|
<iframe
|
|
15
|
-
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/
|
|
15
|
+
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a694af4becdb5de72ac4ff7/replay"
|
|
16
16
|
width="100%"
|
|
17
17
|
height="390"
|
|
18
18
|
style={{ border: "1px solid #333", borderRadius: "8px" }}
|
|
@@ -18,7 +18,7 @@ Watch this test execute in a real sandbox environment:
|
|
|
18
18
|
|
|
19
19
|
{/* hover-text-with-description.test.mjs output */}
|
|
20
20
|
<iframe
|
|
21
|
-
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/
|
|
21
|
+
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a694ad7c00c8fc8cedd6715/replay"
|
|
22
22
|
width="100%"
|
|
23
23
|
height="600"
|
|
24
24
|
style={{ border: "1px solid #333", borderRadius: "8px" }}
|
|
@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
|
|
|
12
12
|
|
|
13
13
|
{/* hover-text.test.mjs output */}
|
|
14
14
|
<iframe
|
|
15
|
-
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/
|
|
15
|
+
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a694c03becdb5de72ac5049/replay"
|
|
16
16
|
width="100%"
|
|
17
17
|
height="390"
|
|
18
18
|
style={{ border: "1px solid #333", borderRadius: "8px" }}
|
|
@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
|
|
|
12
12
|
|
|
13
13
|
{/* installer.test.mjs output */}
|
|
14
14
|
<iframe
|
|
15
|
-
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/
|
|
15
|
+
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a694b22becdb5de72ac5009/replay"
|
|
16
16
|
width="100%"
|
|
17
17
|
height="390"
|
|
18
18
|
style={{ border: "1px solid #333", borderRadius: "8px" }}
|
|
@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
|
|
|
12
12
|
|
|
13
13
|
{/* launch-vscode-linux.test.mjs output */}
|
|
14
14
|
<iframe
|
|
15
|
-
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/
|
|
15
|
+
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a694abebecdb5de72ac4fe6/replay"
|
|
16
16
|
width="100%"
|
|
17
17
|
height="390"
|
|
18
18
|
style={{ border: "1px solid #333", borderRadius: "8px" }}
|
|
@@ -18,7 +18,7 @@ Watch this test execute in a real sandbox environment:
|
|
|
18
18
|
|
|
19
19
|
{/* parse.test.mjs output */}
|
|
20
20
|
<iframe
|
|
21
|
-
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/
|
|
21
|
+
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a694c1bc00c8fc8cedd6762/replay"
|
|
22
22
|
width="100%"
|
|
23
23
|
height="600"
|
|
24
24
|
style={{ border: "1px solid #333", borderRadius: "8px" }}
|
|
@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
|
|
|
12
12
|
|
|
13
13
|
{/* press-keys.test.mjs output */}
|
|
14
14
|
<iframe
|
|
15
|
-
src="https://console-test.testdriver.ai/replay/
|
|
15
|
+
src="https://console-test.testdriver.ai/replay/6a6951f0c00c8fc8cedd67cb?share=iL0hbVjuj0nebzzfNRdtg&embed=true"
|
|
16
16
|
width="100%"
|
|
17
17
|
height="390"
|
|
18
18
|
style={{ border: "1px solid #333", borderRadius: "8px" }}
|
|
@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
|
|
|
12
12
|
|
|
13
13
|
{/* scroll-keyboard.test.mjs output */}
|
|
14
14
|
<iframe
|
|
15
|
-
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/
|
|
15
|
+
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a694bb6c00c8fc8cedd6753/replay"
|
|
16
16
|
width="100%"
|
|
17
17
|
height="390"
|
|
18
18
|
style={{ border: "1px solid #333", borderRadius: "8px" }}
|
|
@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
|
|
|
12
12
|
|
|
13
13
|
{/* scroll.test.mjs output */}
|
|
14
14
|
<iframe
|
|
15
|
-
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/
|
|
15
|
+
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a694bd3becdb5de72ac503f/replay"
|
|
16
16
|
width="100%"
|
|
17
17
|
height="390"
|
|
18
18
|
style={{ border: "1px solid #333", borderRadius: "8px" }}
|
|
@@ -12,7 +12,7 @@ Watch this test execute in a real sandbox environment:
|
|
|
12
12
|
|
|
13
13
|
{/* type.test.mjs output */}
|
|
14
14
|
<iframe
|
|
15
|
-
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/
|
|
15
|
+
src="https://api-test.testdriver.ai/api/v1/testdriver/testcase/6a694b53c00c8fc8cedd6740/replay"
|
|
16
16
|
width="100%"
|
|
17
17
|
height="390"
|
|
18
18
|
style={{ border: "1px solid #333", borderRadius: "8px" }}
|
package/docs/v7/find.mdx
CHANGED
|
@@ -396,10 +396,6 @@ const element = await testdriver.find('small cancel icon next to the subscriptio
|
|
|
396
396
|
await element.click();
|
|
397
397
|
```
|
|
398
398
|
|
|
399
|
-
<Warning>
|
|
400
|
-
Both `zoom` and `verify` add extra AI calls per `find()` invocation, which increases latency and API usage. When both are enabled, each find may make up to 3 AI calls. **Rate limiting may occur** if many find calls use these options in rapid succession. Use them selectively for critical interactions rather than on every find call.
|
|
401
|
-
</Warning>
|
|
402
|
-
|
|
403
399
|
## Cache Options
|
|
404
400
|
|
|
405
401
|
When a test completes successfully, the result of each `find()` is cached. On later runs, TestDriver reuses the cached match instead of making a fresh AI call, which significantly speeds up locating the same element. The cache lives in your [dashboard](https://console.testdriver.ai/cache) and is shared across runs — see the [Cache](/v7/cache) page for how matching, thresholds, and invalidation work.
|