Skip to main content
Ask AI

Test Navigation

Test Navigation is a visual exploration tool that maps all the URL navigation patterns observed across your test suite's sessions. It helps you understand what pages and flows your tests exercise, identify coverage gaps, and analyze how users move through your application during testing.

Accessing Test Navigation​

Test Navigation is available in two contexts:

  1. Global — Navigate to Test Navigation in the left sidebar (/test-navigation). Shows navigation data across all repositories.
  2. Repository-scoped — Open any repository and click the Test Navigation tab. Shows navigation data filtered to that specific repository only.
Feature flag

The Test Navigation sidebar item and global route are controlled by platform configuration. Contact your administrator if the section is not visible.

Pathfinder view​

The Pathfinder view renders a step-by-step, directed graph of navigation sequences captured from your test sessions. Each node represents a URL or page, and edges represent navigation events (clicks, page.goto() calls, browser back/forward).

The graph uses an ELK (Eclipse Layout Kernel) force-directed layout, making it easy to visually trace the most common test paths through your application.

How to use the Pathfinder:

  1. Select a repository (or use the global view for all repos).
  2. Apply filters to narrow the sessions included in the graph.
  3. Click any node to see the sessions that traversed that page.
  4. Trace paths from entry points to exits to understand test flow coverage.

Tree view​

The Tree view presents the same navigation data as a hierarchical tree, organized by URL depth. This is useful for:

  • Quickly scanning which top-level sections of your app are tested.
  • Identifying leaf nodes (pages reached but never navigated away from, suggesting potential dead ends in test flows).
  • Comparing test coverage against your application's sitemap.

Filters and presets​

The Navigation Filter Bar provides several filtering options:

FilterDescription
RepositoryLimit the graph to one repository's sessions
BranchFilter by Git branch (e.g. only show main branch runs)
Date rangeRestrict which sessions feed the graph
EnvironmentFilter by deployment environment
Test tagsFilter to sessions from tests with specific tags

Filter presets​

You can save commonly used filter combinations as presets. Presets are stored per-user and allow you to quickly switch between different navigation views (e.g. "Last week on staging" vs "All production runs").

To save a preset:

  1. Configure the filters you want.
  2. Click Save as preset in the filter bar.
  3. Name the preset and confirm.

Saved presets appear in the presets dropdown in the filter bar.

Amplitude journey alignment​

When the Amplitude integration is connected, Test Navigation compares your test-observed navigation patterns against real user journeys from Amplitude. This alignment shows:

  • Which flows are covered by tests vs. which are observed only in production.
  • High-traffic user journeys that are not yet covered by any test.

This data is surfaced in the graph as a coverage overlay when the integration is connected and active.

Live vs. sandbox mode​

  • Live mode — Fetches real navigation data from your connected repositories using fetchRepoNavigation.
  • Sandbox mode — Loads demonstration data (a mock Amazon flow map) for exploring the UI without live data. Sandbox mode is active when the platform is running in a non-production environment configuration.

The mode indicator is displayed in the filter bar.