Overview
Performs a triple-click action on an element. Primarily used to select entire lines or paragraphs in text editors and fields.Syntax
Parameters
Element reference from snapshot (
@e1, @e2, etc.)Response
Response Fields
The action performed (
triple_click)The element reference that was triple-clicked
Element state after the action
AX-First Strategy
The triple-click command follows this hierarchy:- Try native triple-click action via AX
- Three rapid
kAXPressActioncalls - Mouse triple-click at element center
Usage Examples
Select a Line in Text Editor
Select Paragraph
Select and Delete Line
Common Use Cases
- Text Editing: Select lines for deletion or replacement
- Code Editors: Select code lines for copying
- Document Editing: Select paragraphs in word processors
- Terminal: Select command lines in terminal apps
Behavior Differences
| Application Type | Triple-Click Behavior |
|---|---|
| Text Editors | Selects entire line including newline |
| Word Processors | Selects entire paragraph |
| Terminal | Selects command line |
| Web Browsers | Selects paragraph (varies by implementation) |
Error Cases
| Error Code | Cause | Recovery |
|---|---|---|
ELEMENT_NOT_FOUND | Ref doesn’t exist in current refmap | Run snapshot to refresh |
STALE_REF | Element no longer matches saved ref | Run snapshot and use new ref |
ACTION_FAILED | Element doesn’t support triple-click | Try text selection with keyboard shortcuts |
Notes
- Triple-click selection behavior varies by application
- Some apps select line, others select paragraph
- Timing between clicks is platform-optimized
- Use
double-clickfor word selection - Always verify selection before performing operations on it