Vitest Explorer

Renders clickable status icons in the editor gutter next to each test case, allowing developers to run individual tests without switching to a terminal or sidebar. Uses VSCode's native TestController API to register test items and bind gutter decorations to test execution commands, with real-time status updates (pass/fail/skip/queued) displayed as colored indicators.

Automatically discovers and parses Vitest test files in the workspace, building a hierarchical tree structure in the Testing sidebar that reflects test suites, describe blocks, and individual test cases. Uses Vitest's native test discovery mechanism (integrated with Vite's file watching) to populate the TestController with test items, enabling folder-level, file-level, and suite-level test execution and filtering.

Automatically detects and loads Vitest configuration from the workspace, respecting single-folder and multi-folder workspace layouts. The extension resolves vitest.config.ts or vitest.config.js relative to the workspace root and applies configuration settings (test patterns, environment, globals, etc.) to test discovery and execution without requiring manual configuration in VSCode settings.

Supports multiple test execution modes through toolbar buttons and context menu actions: run all tests, run tests in current file, run single test, run with coverage, and debug mode. The extension maps each mode to a specific Vitest command or configuration and manages the execution lifecycle (startup, progress reporting, result collection) through VSCode's TestController API.

Provides a toolbar button to enable/disable Vitest's watch mode, which automatically re-runs affected tests whenever source files or test files change. The extension wraps Vitest's native watch mode implementation, displaying a visual indicator (e.g., 'Watch' button state) in the Testing view toolbar and managing the watch process lifecycle through VSCode's extension API.

Enables developers to debug individual tests or test suites by launching the VSCode debugger with Vitest as the debug target. The extension registers debug configurations that attach VSCode's native debugger to the Vitest process, allowing breakpoint setting, step-through execution, variable inspection, and conditional breakpoints within test code. Supports standard breakpoint types (line, conditional, logpoint, triggered) through VSCode's native debugging UI.

Collects code coverage metrics during test execution using Vitest's built-in coverage provider (typically Istanbul/nyc) and displays coverage data in the editor as line-level indicators and a coverage summary in the Testing view. The extension parses coverage reports generated by Vitest and renders visual feedback (e.g., green/red line numbers) in the editor gutter, with detailed coverage statistics accessible via the Testing sidebar.

Captures console.log, console.error, and other console output from test execution and displays it inline in the editor or in the Testing view's output panel. The extension intercepts Vitest's console output stream and renders it with syntax highlighting and log-level indicators (info, warn, error), allowing developers to see test-related logs without switching to a terminal.

Provides a search/filter UI in the Testing view that allows developers to filter the test tree by test name, file path, or custom patterns. The extension uses VSCode's TestController filtering API to dynamically show/hide test items based on the search query, enabling quick navigation to specific tests without scrolling through large test hierarchies.

Measures and displays the time taken to import/load test files and dependencies during test execution, providing insights into test startup performance. The extension collects timing data from Vitest's execution metrics and displays import durations in the Testing view or output panel, helping developers identify slow imports that impact test execution speed.

Provides right-click context menus on test items in the Testing sidebar, enabling quick access to test execution actions (run, debug, run with coverage) without navigating to toolbar buttons. The extension registers context menu handlers that trigger test execution commands based on the selected test item (file, suite, or individual test), with actions available at multiple levels of the test hierarchy.

Maintains real-time synchronization of test status (pass/fail/skip/queued/not-executed) across multiple UI elements: the Testing sidebar tree, editor gutter icons, and status indicators. The extension uses VSCode's TestController state management to update test item states as Vitest reports execution results, ensuring all UI elements reflect the current test status without manual refresh.