Overview
The doubleClick() method does a double-click action on an element. You can call it on an Element instance. Or you can use it with a selector.
Syntax
javascript// Double-click on an element await element.doubleClick(); // Double-click using a selector await ai.doubleClick('selector');
Parameters
When called on an Element, no parameters are required.
When called directly on the AI client:
| Parameter | Type | Description |
|---|---|---|
selector | string | The selector describing the element to double-click |
Returns
It returns a Promise<void>. The promise resolves when the double-click action completes.
Examples
Double-Click on Found Element
javascriptconst fileItem = await ai.find('README.md file'); await fileItem.doubleClick();
Direct Double-Click with Selector
javascriptawait ai.doubleClick('README.md in the file list');
Opening Files in VS Code
javascriptimport { 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(); });
Opening Folders in File Manager
javascriptimport { 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'); });
Selecting Text with Double-Click
javascript// Double-click to select a word await ai.doubleClick('word "TestDriver" in the paragraph'); // Verify selection const selectedText = await ai.exec('window.getSelection().toString()'); expect(selectedText).toBe('TestDriver');
Related Methods
click()- Single click on an elementrightClick()- Right-click to open context menumouseDown()- Press mouse button without releasingmouseUp()- Release mouse buttonhover()- Move mouse over element without clicking


