​
Overview

The Navigate step allows you to navigate to specific URLs or web pages during your test execution. It supports environment variables and variables assigned from previous steps, making it flexible for different testing scenarios.

​
Form Fields

Field NameTypeRequiredDescription
URLtext/dropdownYesURL to navigate to, or selection from variables declared in previous steps
Use variables ToggletoggleNoUse variables from previous steps instead of manual entry

​
Form Configuration

​
URL Input Options

The form provides two input modes:

​
Manual URL Entry (Default)

  • URL: Standard text input field
  • Supports environment variables using {{VARIABLE_NAME}} syntax
  • Enter complete URLs including protocol (http:// or https://)
  • Supports relative URLs if base URL is configured

​
Use Variables

  • Use variables Toggle: Enable to show dropdown of assigned values
  • URL: Dropdown showing variables from previous steps
  • Available when you have declared variables in previous steps (Extract Text, Run JavaScript, API Request, etc.)

​
Examples

  • URL: https://example.com/login
  • Use variables Toggle: Disabled
  • URL: {{BASE_URL}}/dashboard
  • Use variables Toggle: Disabled
  • Use variables Toggle: Enabled
  • URL: redirectUrl (from dropdown of assigned variables)
  • URL: {{STAGING_URL}}/app
  • Use variables Toggle: Disabled
  • Use variables Toggle: Enabled
  • URL: generatedPath (assigned from previous API call)

​
Best Practices

​
URL Format

  • Always include the protocol (http:// or https://) for absolute URLs
  • Use environment variables for different testing environments
  • Validate URL format before navigation

​
Environment Variables

  • Use {{VARIABLE_NAME}} syntax with uppercase variable names
  • Configure environment variables for different testing stages (dev, staging, prod)
  • Keep sensitive URLs in environment variables rather than hardcoding

​
Using Variables

  • Use Use variables Toggle for dynamic URLs generated during test execution
  • Ensure the variable assignment step completed successfully before navigation
  • Useful for following redirects or navigating to generated endpoints

​
Common Issues

​
Invalid URL Format

  • Ensure URLs include proper protocol (http:// or https://)
  • Check for typos in domain names or paths
  • Validate URL syntax, especially when using variables

​
Environment Variable Problems

  • Verify environment variables are defined in your test environment
  • Use correct {{VARIABLE_NAME}} syntax with uppercase names
  • Ensure variable names match exactly (case-sensitive)

​
Network Issues

  • Handle timeouts for slow-loading pages
  • Account for network connectivity problems
  • Consider using wait conditions after navigation

​
Supatest Variables Issues

  • Use variables Toggle only appears when you have declared variables in previous steps
  • Ensure the variable assignment step executed successfully
  • Verify the assigned variable contains a valid URL

​
Page Load Problems

  • Allow sufficient time for page loading
  • Handle single-page application routing
  • Consider wait conditions for dynamic content after navigation

​
Standard Navigation

  • Replaces current page content completely
  • Triggers full page reload and initialization
  • Clears previous page state

​
SPA (Single Page Application) Considerations

  • May not trigger full page reload
  • Consider client-side routing behavior
  • May need additional wait conditions for content loading