Skip to content

iQuestAgentic Test Harness

Discover ยท Validate ยท Assure

All You Need to Write โ€‹

A .feature file:

gherkin
Feature: TodoMVC Automation

  Scenario: Add todo item
    * Navigate to "https://demo.playwright.dev/todomvc/"
    * Add a new todo item "Buy groceries"
    * Should see "Buy groceries" in the todo list

Then run:

bash
npx @vsaripella/iquest init   # one-time setup
cd .iquest
npm run test:headed

That's it. No step definitions. No selectors. No code.

Node.js requirement: Scaffolded projects require Node 22+ (for varlock env validation). The iQuest library itself works on Node 18+. We recommend Node 22 LTS.

UI & API Examples โ€‹

Browser (UI) Test โ€‹

gherkin
Feature: UI Test

  Scenario: Navigate to SauceDemo
    * Navigate to "https://www.saucedemo.com/"
    * Should see the login page with username and password fields
    * Enter "standard_user" in the username field
    * Enter "secret_sauce" in the password field
    * Click the login button
    * Should see the inventory page with products listed

API Test โ€‹

gherkin
Feature: API

  Scenario: API Testing
    * Hit API URL: https://automationexercise.com/api/productsList with Request Method: GET
    * Response Code should be 200
    * Response Body should contain "products"
    * Response Body should contain "id"
    * Response Body should contain "name"
    * Response Body should contain "price"

Hybrid UI + API โ€‹

gherkin
Feature: User registration flow

  Scenario: Register via API, then verify in UI
    * Call POST "/api/users" with body { "email": "test@example.com", "password": "secret123" }
    * Verify the response status is 201
    * Verify the JSON body has "id" equal to a non-empty string
    * Navigate to "/login"
    * Fill "email" with "test@example.com"
    * Fill "password" with "secret123"
    * Click "Submit"
    * Should see "Welcome, test@example.com"
  • Quickstart โ€” Set up in 2 minutes
  • How It Works โ€” Architecture and design decisions
  • GitHub โ€” Source code and examples
  • npm โ€” Package on npm

Released under the MIT License.