Quick start
Install sarvaTest, write your first test, and run it in under five minutes.
Install the CLI
sarvaTest ships as a single npm package. No browser binaries to manage, no Selenium grid to maintain — the runner downloads what it needs on first run.
npm install --save-dev sarvatest
# or
pnpm add -D sarvatest
Write your first test
Create tests/landing.test.ts and paste:
import { test, expect } from "sarvatest";
test("landing page loads", async ({ page }) => {
await page.goto("https://example.com");
await expect(page.getByRole("heading", { level: 1 })).toBeVisible();
});
Run it
npx sarvatest run
By default the runner uses headless Chrome. Pass --browsers=chromium,firefox,webkit
to run the same test on every engine in parallel.
Add it to CI
Most projects wire sarvaTest into GitHub Actions. Drop this in
.github/workflows/test.yml:
- name: Run sarvaTest
run: npx sarvatest run --reporter=github
The --reporter=github flag emits annotations directly on the PR for
any failing assertion.
Next steps
- API reference — programmatic access to runs and reports.
- Integrations — wire into GitHub Actions, CircleCI, GitLab CI, and Slack.
- Roadmap — see what's shipping next.