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
// 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
const fileItem = await ai.find('README.md file');
await fileItem.doubleClick();
Direct Double-Click with Selector
await ai.doubleClick('README.md in the file list');
Opening Files in VS Code
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();
});
Opening Folders in File Manager
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');
});
Selecting Text with Double-Click
// 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