Skip to main content

Overview

OpenSteer provides convenience methods for double-clicking and right-clicking elements. These are shortcuts for using the main click() method with specific options.

dblclick()

Double-click an element. Equivalent to click({ ..., clickCount: 2 }).
await opensteer.dblclick(options: ClickOptions): Promise<ActionResult>
options
ClickOptions
required
Same options as click() - supports description, element, selector, and other click options

Examples

Double-click to select text

await opensteer.dblclick({ description: 'filename' })

Double-click with element counter

await opensteer.snapshot({ mode: 'action' })
await opensteer.dblclick({ element: 7 })

Double-click with selector

await opensteer.dblclick({ selector: '.editable-cell' })

rightclick()

Right-click an element to open context menu. Equivalent to click({ ..., button: 'right' }).
await opensteer.rightclick(options: ClickOptions): Promise<ActionResult>
options
ClickOptions
required
Same options as click() - supports description, element, selector, and other click options

Examples

Right-click to open context menu

await opensteer.rightclick({ description: 'image' })

// Select menu option
await opensteer.click({ description: 'Save image as' })

Right-click with element counter

await opensteer.snapshot({ mode: 'action' })
await opensteer.rightclick({ element: 12 })

Right-click in editor

await opensteer.rightclick({ selector: '.code-editor' })
await opensteer.click({ description: 'format document' })

Comparison with click()

These methods are pure convenience wrappers:
// These are equivalent:
await opensteer.dblclick({ description: 'word' })
await opensteer.click({ description: 'word', clickCount: 2 })

// These are equivalent:
await opensteer.rightclick({ description: 'file' })
await opensteer.click({ description: 'file', button: 'right' })
Use whichever is more readable for your use case.

Common patterns

Text selection

// Double-click to select word
await opensteer.dblclick({ description: 'paragraph' })

// Copy selected text (Ctrl+C / Cmd+C)
await opensteer.pressKey('Control+c')

Context menu interaction

// Right-click element
await opensteer.rightclick({ description: 'table row' })

// Wait for menu to appear
await opensteer.waitForText('Delete row')

// Click menu option
await opensteer.click({ description: 'Delete row' })

// Confirm deletion
await opensteer.click({ description: 'Confirm' })

File operations

// Right-click file in file manager
await opensteer.rightclick({ description: 'document.pdf' })

// Open with specific application
await opensteer.click({ description: 'Open with' })
await opensteer.click({ description: 'Adobe Reader' })

Canvas/diagram editing

// Double-click to edit
await opensteer.dblclick({ description: 'text box' })

// Type new content
await opensteer.type('Updated text')

// Click outside to finish editing
await opensteer.click({ description: 'canvas background' })
  • click() - Main click method with all options
  • hover() - Hover over elements
  • pressKey() - Press keyboard keys
  • type() - Type text character-by-character