@snapvisor/vitest weekly downloads statistics

The open source visual testing platform for AI-native engineering teams.

Official Argos Vitest integration

Capture Argos screenshots directly from your Vitest browser tests.

Visit the Vitest SDK documentation for guides, API and more.

Installation

Install the package:

argosSnapshot runs in any Vitest test — browser or Node — and needs nothing else.

To capture screenshots with argosScreenshot, run your tests in Vitest browser mode with the Playwright provider and install the following peer dependencies:

Usage

Register the plugin in your Vitest config:

Then take screenshots from your browser tests:

Automatic naming

The name is optional. When omitted, Argos derives one from the current test, mimicking Vitest snapshots. Several unnamed captures in the same test get an incrementing counter so they stay unique:

Unlike Vitest — which keeps a per-file .snap, so its keys only need to be unique within a file — Argos names are global across the build. The generated name therefore includes the test file path, so two tests with the same title in different files never collide.

Snapshots

argosSnapshot captures a snapshot of any value — not just a screenshot — and uploads it to Argos to diff across builds, mimicking Vitest snapshots. Unlike argosScreenshot, it does not need a browser and works in both browser and Node tests.

The value comes first; the name is optional. Omit it to auto-name the snapshot from the current test (like screenshots above), or pass options.name to set it explicitly:

Use the extension option to control how Argos renders and diffs the snapshot, and tag to attach tags:

Screenshots and snapshots are both written to the ./snapshots directory by default (configurable via the plugin root option) and uploaded by the reporter when uploadToArgos is enabled.

Links

• Official SDK Docs • Quickstart • Discord

Description from the npm listing.