Interaction Steps
Navigate
Navigate to web pages and URLs
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 Name | Type | Required | Description |
|---|---|---|---|
| URL | text/dropdown | Yes | URL to navigate to, or selection from variables declared in previous steps |
| Use variables Toggle | toggle | No | Use 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 Value, Run JavaScript, API Request, etc.)
Examples
Navigate to Static URL
- URL:
https://example.com/login - Use variables Toggle: Disabled
Navigate Using Environment Variable
- URL:
{{BASE_URL}}/dashboard - Use variables Toggle: Disabled
Navigate to Assigned Variable
- Use variables Toggle: Enabled
- URL:
redirectUrl(from dropdown of assigned variables)
Navigate to Different Environment
- URL:
{{STAGING_URL}}/app - Use variables Toggle: Disabled
Navigate Using Dynamic Path
- 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
Navigation Behavior
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
Related Steps
- Wait for Element - For waiting on content after navigation
- Check Text - For verifying page content after navigation
- Extract Value - For extracting URLs to navigate to later