Basic Workflow

1

Start Recording

Click record and navigate to your application URL
2

Perform Actions

Interact with your application as a user would
3

Add Assertions

Specify what to verify during or after recording
4

Save and Run

Stop recording and execute the test

Recording Interface

Key Components

  1. Record Button - Start/stop recording session
  2. Browser Window - Interact with your application
  3. Action Log - View recorded steps in real-time
  4. Assertion Panel - Add verifications during recording

What Gets Recorded

Captured Automatically

  • Mouse clicks and taps
  • Keyboard input and shortcuts
  • Form submissions
  • Page navigation
  • Scroll actions
  • File uploads

AI Enhancement

Keystone automatically:
  • Generates stable selectors
  • Adds appropriate wait conditions
  • Creates readable step descriptions
  • Groups related actions

Adding Assertions

During Recording

Add verifications while recording:
  • “Welcome message should contain user name”
  • “Cart should show 3 items”
  • “Submit button should be disabled”

After Recording

Enhance your test with additional checks:
  • Verify specific text content
  • Check element visibility
  • Validate data changes
  • Confirm redirects

Common Recording Scenarios

Login Flow

1. Navigate to app
2. Click login button
3. Enter credentials
4. Submit form
5. Verify dashboard loads

E-commerce Purchase

1. Search for product
2. Add to cart
3. Proceed to checkout
4. Fill payment details
5. Confirm order

Form Submission

1. Open form page
2. Fill all fields
3. Handle validation errors
4. Submit successfully
5. Verify confirmation

Recording Best Practices

One Flow Per Recording

Focus on a single user journey

Natural Interactions

Interact as real users would

Add Context

Include descriptive assertions

Handle Variations

Record different paths and states

Advanced Recording Features

Conditional Actions

Handle dynamic content:
  • Close popups if they appear
  • Deal with A/B tests
  • Handle different user states

Data Parameterization

Make recordings reusable:
  • Replace hardcoded values with variables
  • Generate unique test data
  • Use different datasets

Cross-browser Support

Recordings work across:
  • Chrome, Firefox, Safari, Edge
  • Different screen sizes
  • Various operating systems

Post-Recording Optimization

AI Processing

After recording, Keystone:
  1. Optimizes selector strategies
  2. Adds intelligent waits
  3. Groups related steps
  4. Parameterizes test data

Manual Refinement

You can:
  • Edit step descriptions
  • Adjust timing
  • Add additional assertions
  • Configure data handling

Handling Dynamic Elements

Smart Element Detection

Keystone uses multiple strategies:
  • Text content matching
  • Relative positioning
  • ARIA labels
  • CSS selectors
  • XPath fallbacks

Self-healing Tests

Tests adapt to:
  • Minor UI changes
  • Different loading times
  • Content variations
  • Layout shifts

Recording Tips

Before Recording

  1. Plan your test scenario
  2. Prepare test data
  3. Clear browser state
  4. Disable notifications

During Recording

  1. Move at normal speed
  2. Wait for pages to load
  3. Include all necessary steps
  4. Add assertions as you go

After Recording

  1. Review all steps
  2. Add missing verifications
  3. Test the recording
  4. Save with descriptive name

Common Issues and Solutions

Timing Problems

  • Let pages fully load before interacting
  • Add explicit waits for dynamic content
  • Use assertions to verify readiness

Element Selection

  • Click center of elements
  • Use unique identifiers when possible
  • Avoid coordinates-based actions

Data Dependencies

  • Use fresh test data
  • Clean up after tests
  • Handle existing data gracefully

Examples by Feature Type

Authentication

Record login once and reuse:
  • Standard login
  • Social authentication
  • Multi-factor auth
  • Password reset

Shopping Cart

Test cart functionality:
  • Add/remove items
  • Update quantities
  • Apply discounts
  • Calculate totals

User Profile

Validate profile management:
  • Update information
  • Upload avatar
  • Change settings
  • Verify saves
Recording is ideal for capturing complex user flows quickly. For precise control over individual steps, consider building tests manually.