Skip to main content

Core Principles

1. Descriptive Elements

Prompting BasicBasic but sometimes insufficient
Prompting PositionalBetter - adds positional context
Prompting SurroundingBest - provides complete context

2. Verify States

Always begin with ‘Verify’ to check for:
  • Element presence Verify Ex 3
  • Content Validation Verify Ex 4

Writing Steps

Each test step is one of the 4 types: ACTION, VERIFICATION, JAVASCRIPT, EXTRACT

Action

Click, Type, Hover, Scroll, Wait, Upload, or Select operations for user interactions

Verify

Check elements, states, and conditions on the page

JavaScript

Run custom JavaScript code for complex operations

Extract

Pull and store data from the page for later use

Best Practices

  1. Start Simple: Begin with discrete actions for common interactions
  2. Validate Early: Use verification actions to catch issues quickly
  3. Extract Strategically: Only extract data you need for subsequent steps
  4. JavaScript as Backup: Use JavaScript actions when other options aren’t sufficient

Common Pitfalls

  1. Multiple Actions: Combining multiple actions in one step
  2. Vague Descriptions: Using unclear element descriptions
  3. Missing Brackets: Forgetting to enclose values or elements
  4. Skipping Verifications: Not validating important states
  5. Implicit Waits: Not specifying wait durations

Next Steps