/testdriver-double-click

name: testdriver:double-click
description: Perform a double-click action on an element or at specific coordinates

<!-- Generated from double-click.mdx. DO NOT EDIT. -->

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 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()`](/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