@testdriverai/agent 7.11.229-canary → 7.11.232-test

package/docs/docs.json

@@ -16,34 +16,36 @@
       {
         "group": "Overview",
         "pages": [
-          "/agent",
-          "/what-is-testdriver",
           {
-            "group": "Quickstart",
+            "group": "Get started",
             "icon": "rocket",
             "pages": [
               "/quickstart",
               "/quickstart-github",
+              "/quickstart-claude",
+              "/quickstart-vscode",
               "/mcp-setup"
             ]
           },
+          "/agent",
+          "/what-is-testdriver",
           {
             "group": "Examples",
             "icon": "code",
             "pages": [
               "/examples/assert",
-              "/examples/element-not-found",
-              "/examples/findall-coffee-icons",
-              "/examples/hover-image",
-              "/examples/hover-text-with-description",
-              "/examples/hover-text",
-              "/examples/installer",
-              "/examples/launch-vscode-linux",
-              "/examples/parse",
+              "/examples/type",
+              "/examples/click-button",
+              "/examples/click-icon",
+              "/examples/add-to-cart",
               "/examples/press-keys",
-              "/examples/scroll-keyboard",
               "/examples/scroll",
-              "/examples/type"
+              "/examples/navigate-and-scroll",
+              "/examples/findall-coffee-icons",
+              "/examples/element-not-found",
+              "/examples/parse",
+              "/examples/installer",
+              "/examples/launch-vscode-linux"
             ]
           }
         ]
@@ -52,15 +54,15 @@
         "group": "Using TestDriver",
         "pages": [
           "/generating-tests",
+          "/performing-actions",
           "/copilot/running-tests",
           "/debugging-with-screenshots",
           "/caching",
-          "/performing-actions",
           "/copilot/auto-healing"
         ]
       },
       {
-        "group": "Building & Maintaining Tests",
+        "group": "Building & maintaining tests",
         "pages": [
           "/quickstart-manual",
           {
@@ -114,7 +116,6 @@
             "group": "Integrations",
             "icon": "plug",
             "pages": [
-              "/github",
               "/ci-cd"
             ]
           },
@@ -124,7 +125,7 @@
             "pages": [
               "/hosted",
               {
-                "group": "Self-Hosting",
+                "group": "Self-hosting",
                 "icon": "server",
                 "pages": [
                   "/self-hosted",
@@ -137,7 +138,7 @@
         ]
       },
       {
-        "group": "Advanced Topics",
+        "group": "Advanced topics",
         "pages": [
           "/variables",
           "/secrets",
@@ -157,14 +158,14 @@
   "navbar": {
     "links": [
       {
-        "label": "Join Discord",
-        "icon": "discord",
-        "href": "https://discord.com/invite/cWDFW8DzPm"
+        "label": "Book a Demo",
+        "icon": "calendar",
+        "href": "https://testdriver.ai/enterprise/"
       },
       {
         "icon": "gauge-high",
         "label": "Dashboard",
-        "href": "https://console-canary.testdriver.ai"
+        "href": "https://console.testdriver.ai"
       }
     ]
   },
@@ -548,6 +549,62 @@
     {
       "source": "/v7/:slug*",
       "destination": "/:slug*"
+    },
+    {
+      "source": "/examples/hover-image",
+      "destination": "/examples/click-icon"
+    },
+    {
+      "source": "/examples/hover-text",
+      "destination": "/examples/click-button"
+    },
+    {
+      "source": "/examples/hover-text-with-description",
+      "destination": "/examples/add-to-cart"
+    },
+    {
+      "source": "/examples/scroll-keyboard",
+      "destination": "/examples/navigate-and-scroll"
+    },
+    {
+      "source": "/examples/ai",
+      "destination": "/generating-tests"
+    },
+    {
+      "source": "/examples/captcha-api",
+      "destination": "/captcha"
+    },
+    {
+      "source": "/examples/chrome-extension",
+      "destination": "/provision"
+    },
+    {
+      "source": "/examples/drag-and-drop",
+      "destination": "/mouse-down"
+    },
+    {
+      "source": "/examples/formatted-logging",
+      "destination": "/dashcam"
+    },
+    {
+      "source": "/examples/match-image",
+      "destination": "/find"
+    },
+    {
+      "source": "/examples/scroll-until-text",
+      "destination": "/scroll"
+    },
+    {
+      "source": "/claude-mcp-plugin",
+      "destination": "/quickstart-claude"
+    },
+    {
+      "source": "/github",
+      "destination": "/quickstart-github"
+    },
+    {
+      "source": "/elements",
+      "destination": "/find"
     }
   ],
   "integrations": {

package/docs/double-click.mdx

@@ -1,102 +1,82 @@
 ---
-title: "doubleClick"
-description: "Perform a double-click action on an element or at specific coordinates"
+title: "doubleClick()"
+sidebarTitle: "doubleClick"
+description: "Double-click an element you found, for example to open a file or select a word."
 icon: "hand-pointer"
 ---
 
-## Overview
-
-The `doubleClick()` method does a double-click action on an element. You can call it on an [`Element`](/core-concepts/elements) instance. Or you can use it with a selector.
-
-## Syntax
+Double-click an element you've located with [`find()`](/find):
 
 ```javascript
-// Double-click on an element
-await element.doubleClick();
-
-// Double-click using a selector
-await ai.doubleClick('selector');
+await testdriver.find('report.pdf in the file list').doubleClick();
 ```
 
-## Parameters
+## element.doubleClick()
 
-When called on an `Element`, no parameters are required.
+Double-clicks the element at the point where `find()` located it. It's the same as `element.click('double-click')`.
 
-When called directly on the AI client:
+```typescript
+element.doubleClick(): Promise<void>
+```
 
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `selector` | `string` | The selector describing the element to double-click |
+It takes no parameters.
 
-## Returns
+### Errors
 
-It returns a `Promise<void>`. The promise resolves when the double-click action completes.
+Throws an `ElementNotFoundError` if `find()` didn't locate the element. See [click()](/click#errors) for how to check `found()` first.
 
-## Examples
+## Double-click at coordinates
 
-### Double-Click on Found Element
+The client has no `doubleClick()` method. To double-click a point on the screen, pass `action: 'double-click'` to [`testdriver.click()`](/click#testdriver-click-options):
 
 ```javascript
-const fileItem = await ai.find('README.md file');
-await fileItem.doubleClick();
+await testdriver.click({ x: 640, y: 360, action: 'double-click' });
 ```
 
-### Direct Double-Click with Selector
+Prefer `element.doubleClick()`, which keeps working when the layout or screen size changes.
 
-```javascript
-await ai.doubleClick('README.md in the file list');
-```
+## Examples
 
-### Opening Files in VS Code
+### Open a file in VS Code
 
 ```javascript
-import { test } from 'vitest';
-import { vscode } from '@testdriver/sdk';
-
-test('opens a file by double-clicking', async () => {
-  const { ai } = await vscode();
-  
-  // Double-click to open a file in the explorer
-  await ai.doubleClick('package.json in the file explorer');
-  
-  // Verify the file opened
-  const editor = await ai.find('text editor showing package.json');
-  expect(editor).toBeTruthy();
-});
+await testdriver.find('package.json in the Explorer sidebar').doubleClick();
+await testdriver.assert('package.json is open in the editor');
 ```
 
-### Opening Folders in File Manager
+### Select a word
 
 ```javascript
-import { test } from 'vitest';
-import { chrome } from '@testdriver/sdk';
-
-test('navigates folders in Google Drive', async () => {
-  const { ai } = await chrome('https://drive.google.com');
-  
-  // Double-click to open a folder
-  await ai.doubleClick('Documents folder');
-  
-  // Wait for folder to open
-  await ai.find('breadcrumb showing Documents');
-});
+await testdriver.find('the word "Checkout" in the page heading').doubleClick();
+await testdriver.pressKeys(['ctrl', 'c']);
 ```
 
-### Selecting Text with Double-Click
+## Complete example
 
-```javascript
-// Double-click to select a word
-await ai.doubleClick('word "TestDriver" in the paragraph');
+```javascript tests/open-file.test.mjs
+import { describe, expect, it } from 'vitest';
+import { TestDriver } from 'testdriverai/vitest/hooks';
 
-// Verify selection
-const selectedText = await ai.exec('window.getSelection().toString()');
-expect(selectedText).toBe('TestDriver');
+describe('VS Code', () => {
+  it('opens a file from the Explorer', async (context) => {
+    const testdriver = TestDriver(context);
+    await testdriver.exec({
+      language: 'sh',
+      code: 'mkdir -p /tmp/my-project && echo "{}" > /tmp/my-project/package.json',
+    });
+    await testdriver.provision.vscode({ workspace: '/tmp/my-project' });
+
+    await testdriver.find('package.json in the Explorer sidebar').doubleClick();
+
+    const result = await testdriver.assert('package.json is open in the editor');
+    expect(result).toBe(true);
+  });
+});
 ```
 
-## Related Methods
+## Related
 
-- [`click()`](/click) - Single click on an element
-- [`rightClick()`](/right-click) - Right-click to open context menu
-- [`mouseDown()`](/mouse-down) - Press mouse button without releasing
-- [`mouseUp()`](/mouse-up) - Release mouse button
-- [`hover()`](/hover) - Move mouse over element without clicking
+- [click()](/click): single clicks, and clicks at coordinates
+- [rightClick()](/right-click): open a context menu
+- [find()](/find): locate the element to double-click
+- [Perform actions](/performing-actions): every kind of action in one guide