testdriverai 7.2.20 → 7.2.22

package/README.md

@@ -1,67 +1,52 @@
 <div align="center">
   <a href="https://testdriver.ai">
-    <img src="https://github.com/dashcamio/testdriver/assets/318295/2a0ad981-8504-46f0-ad97-60cb6c26f1e7" height="200" alt="TestDriver.ai"/>
+    <img width="250" alt="TestDriver.ai Icon" src="https://github.com/user-attachments/assets/c591b39d-6e17-454b-b36d-370ae8618840" />
   </a>
 </div>
-<h4 align="center">
-  Reliably test your most difficult flows. Don't ship bugs because flows are too hard to test.
-</h4>
 
-<p align="center">
-  TestDriver helps engineering teams easily test, debug, and monitor E2E flows that are hard or impossible to cover with other tools.
-</p>
+<h1 align="center">Computer-Use SDK for E2E QA Testing</h1>
 
-<div align="center">
+<div align="center">The TestDriver SDK is a JS plugin for vitest that makes it easy to spawn ephemeral devices and use vision-based LLMs to construct detemanistic and reliable tests.
+
+<br />
+<br />
   
-[🚀 **Quick Start**](#-quick-start) • [📖 **Documentation**](https://docs.testdriver.ai) • [💻 **Examples**](https://github.com/testdriverai/testdriverai/tree/main/test/testdriver) • [💬 **Discord**](https://discord.com/invite/cWDFW8DzPm) • [🌐 **Website**](https://testdriver.ai)
+[🚀 **Quick Start**](#-quick-start) • [📖 **Documentation**](https://docs.testdriver.ai) • [💻 **Examples**](https://github.com/testdriverai/testdriverai/tree/main/test/testdriver) • [📖 **Pricing**](https://docs.testdriver.ai) • [💬 **Discord**](https://discord.com/invite/cWDFW8DzPm) • [🌐 **Website**](https://testdriver.ai)
 
 </div>
 
----
-
-## 🎬 What Can You Test?
-
-<div align="center">
-
-**Third-Party Web Apps** • **Desktop Apps** • **VS Code Extensions** • **Chrome Extensions** • **AI Chatbots** • **OAuth Flows** • **PDF Content** • **Spelling & Grammar** • **File System & Uploads** • **OS Accessibility** • **Visual Content** • **`<iframe>`** • **`<canvas>`** • **`<video>`**
-
-</div>
+<img width="1490" height="854" alt="image" src="https://github.com/user-attachments/assets/36e426cc-e740-426f-b9f6-6e8565e66ad6" />
 
 ---
 
-## 🎯 Why TestDriver?
+## Why TestDriver?
 
-TestDriver isn't just another testing framework—it's a **computer-use agent for QA**. Using AI vision and mouse/keyboard emulation, TestDriver can test anything you can see on screen, just like a human QA engineer would.
+Don't ship bugs because flows are too hard to test. TestDriver helps engineering teams easily test, debug, and monitor E2E flows that are hard or impossible to cover with other tools like:
 
-### The Problem with Traditional Testing
+*Third-Party Web Apps* • *Desktop Apps* • *VS Code Extensions* • *Chrome Extensions* • *AI Chatbots* • *OAuth Flows* • *PDF Content* • *Spelling & Grammar* • *File System & Uploads* • *OS Accessibility* • *Visual Content* • *`<iframe>`* • *`<canvas>`* • *`<video>`*
 
-Modern testing tools like Playwright are powerful but limited to selector-based testing in single browser tabs. This breaks down when you need to test:
+## Example
 
-| Challenge | Traditional Tools | TestDriver |
-|-----------|------------------|------------|
-| **Dynamic AI Content** | ❌ No selectors for chatbots, images, videos | ✅ AI vision sees everything |
-| **Fast-Moving Teams** | ❌ Brittle selectors break constantly | ✅ Natural language adapts to changes |
-| **Desktop Applications** | ❌ Web-only tools | ✅ Full OS control |
-| **Third-Party Software** | ❌ No access to selectors | ✅ Tests anything visible |
-| **Visual States** | ❌ Can't verify layouts, charts, images | ✅ Computer vision validation |
-| **Multi-App Workflows** | ❌ Single-app limitation | ✅ Cross-application testing |
+```js
+// Click on the new text document
+await testdriver.find("New text document").mouseDown();
 
-### The TestDriver Solution
+// Drag the "New Text Document" icon to the "Recycle Bin" 
+await testdriver.find("Recycle Bin icon").mouseUp();
 
-```javascript
-// Instead of fragile selectors...
-await page.locator('#user-menu > div.dropdown > button[data-testid="profile-btn"]').click();
-
-// ...use natural language that adapts to UI changes
-await testdriver.find('profile button in the top right').click();
+// Assert "New Text Document" icon is not on the Desktop
+const result = await testdriver.assert(
+  'the "New Text Document" icon is not visible on the Desktop'
+);
+expect(result).toBeTruthy();
 ```
 
+[See Full Example](https://github.com/testdriverai/testdriverai/blob/main/test/testdriver/drag-and-drop.test.mjs) • [Browse All Examples](https://github.com/testdriverai/testdriverai/tree/main/test/testdriver)
+
 ---
 
 ## 🚀 Quick Start
 
-Get your first test running in under 5 minutes:
-
 ### Step 1: Create a TestDriver Account
 
 <a href="https://app.testdriver.ai/team"><img src="https://img.shields.io/badge/Sign_Up-Free_Account-blue?style=for-the-badge" alt="Sign Up"/></a>
@@ -92,134 +77,4 @@ Watch as TestDriver:
 3. Runs your test using AI vision
 4. Returns results with video replay
 
-<div align="center">
 <a href="https://docs.testdriver.ai/v7/quickstart"><img src="https://img.shields.io/badge/📖_Read_Full_Quickstart-4A90E2?style=for-the-badge" alt="Full Quickstart"/></a>
-</div>
-
----
-
-## �️ Core Concepts
-
-### Real-World Examples
-
-#### Web Applications
-
-```javascript
-// Test dynamic AI chatbots (no selectors needed!)
-test('chatbot conversation', async (context) => {
-  const { testdriver } = await chrome(context, { url: 'https://chatapp.com' });
-  
-  await testdriver.find('message input').type('What is TestDriver?');
-  await testdriver.find('send button').click();
-  
-  const response = await testdriver.assert('AI response is visible');
-  expect(response).toBeTruthy();
-});
-
-// Test OAuth flows across multiple domains
-test('OAuth login', async (context) => {
-  const { testdriver } = await chrome(context, { url: 'https://myapp.com' });
-  
-  await testdriver.find('Login with Google').click();
-  // Handles popup, enters credentials, returns to app
-  await testdriver.find('email input').type('user@gmail.com');
-  await testdriver.find('password input').type('password');
-  await testdriver.find('Sign in').click();
-  
-  await testdriver.assert('successfully logged into the app');
-});
-```
-
-#### Desktop Applications
-
-```javascript
-// Install and test native desktop apps
-test('desktop app', async (context) => {
-  const testdriver = TestDriver(context, { os: 'windows' });
-  
-  await testdriver.provision.installer({
-    url: 'https://example.com/MyApp.msi',
-    launch: true
-  });
-  
-  await testdriver.find('main window').assert('app launched successfully');
-});
-```
-
-#### Browser Extensions
-
-```javascript
-// Test Chrome extensions from the Web Store
-test('chrome extension', async (context) => {
-  const { testdriver } = await chrome(context);
-  
-  await testdriver.provision.chromeExtension({
-    extensionId: 'liecbddmkiiihnedobmlmillhodjkdmb' // Loom
-  });
-  
-  const button = await testdriver.find('extension icon in toolbar');
-  await button.click();
-  
-  const panel = await testdriver.find('extension popup');
-  expect(panel.found()).toBeTruthy();
-});
-```
-
-#### Visual Validation
-
-```javascript
-// Verify visual states, charts, images
-test('dashboard chart', async (context) => {
-  const { testdriver } = await chrome(context, { url: 'https://analytics.example.com' });
-  
-  await testdriver.assert('line chart shows upward trend');
-  await testdriver.assert('data points are visible on the graph');
-  
-  // Extract text from images/PDFs
-  const value = await testdriver.extract('the total revenue number');
-  console.log('Revenue:', value);
-});
-
-// Test spelling and grammar checking
-test('content validation', async (context) => {
-  const { testdriver } = await chrome(context, { url: 'https://docs.example.com' });
-  
-  await testdriver.assert('there are no spelling errors on the page');
-  await testdriver.assert('all headings use title case');
-});
-
-// Test canvas and video elements
-test('canvas rendering', async (context) => {
-  const { testdriver } = await chrome(context, { url: 'https://canvas-app.com' });
-  
-  await testdriver.find('draw tool').click();
-  await testdriver.assert('canvas shows a red circle');
-  
-  // Video content validation
-  await testdriver.assert('video is playing');
-  await testdriver.assert('video progress bar shows 50% complete');
-});
-```
-
-#### Multi-Application Workflows
-
-```javascript
-// Test interactions across multiple apps
-test('copy from browser to VS Code', async (context) => {
-  const testdriver = TestDriver(context, { os: 'linux' });
-  
-  await testdriver.provision.chrome({ url: 'https://example.com' });
-  await testdriver.find('code snippet').click();
-  await testdriver.pressKeys(['ctrl', 'c']);
-  
-  await testdriver.provision.vscode();
-  await testdriver.find('editor').click();
-  await testdriver.pressKeys(['ctrl', 'v']);
-  
-  await testdriver.assert('code is pasted in editor');
-});
-```
-
-<div align="center">
-<a href="https://github.com/testdriverai/testdriverai/tree/main/test/testdriver"><img src="https://img.shields.io/badge/💻_Browse_More_Examples-gray?style=for-the-badge" alt="More Examples"/></a>
-</div>

package/docs/v7/_drafts/plugin-migration.mdx

@@ -142,11 +142,9 @@ export default defineConfig({
 
 ### Test Helpers
 
-- ✅ **Updated**: `testdriver/acceptance-sdk/setup/testHelpers.mjs`
-  - Removed temp file writing
-  - Removed `__testdriverRegistry` initialization
-  - Removed `__testdriverMeta` initialization
-  - Uses `globalThis.__testdriverPlugin.registerDashcamUrl()` instead
+- ✅ **Removed**: `test/testdriver/setup/` folder (legacy helpers)
+  - Code moved to `lib/vitest/hooks.mjs` framework
+  - Tests now use `TestDriver(context, options)` pattern directly
 
 ### Documentation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "testdriverai",
-  "version": "7.2.20",
+  "version": "7.2.22",
   "description": "Next generation autonomous AI agent for end-to-end testing of web & desktop",
   "main": "sdk.js",
   "exports": {

package/test/testdriver/hover-image.test.mjs

@@ -5,7 +5,25 @@
 
 import { describe, expect, it } from "vitest";
 import { TestDriver } from "../../lib/vitest/hooks.mjs";
-import { performLogin } from "./setup/testHelpers.mjs";
+
+/**
+ * Perform login flow for SauceLabs demo app
+ * @param {TestDriver} client - TestDriver client
+ * @param {string} username - Username (default: 'standard_user')
+ */
+async function performLogin(client, username = "standard_user") {
+  await client.focusApplication("Google Chrome");
+  const password = await client.extract("the password");
+  const usernameField = await client.find(
+    "Username, label above the username input field on the login form",
+  );
+  await usernameField.click();
+  await client.type(username);
+  await client.pressKeys(["tab"]);
+  await client.type(password, { secret: true });
+  await client.pressKeys(["tab"]);
+  await client.pressKeys(["enter"]);
+}
 
 describe("Hover Image Test", () => {
   it("should click on shopping cart icon and verify empty cart", async (context) => {

package/test/testdriver/hover-text-with-description.test.mjs

@@ -5,7 +5,25 @@
 
 import { describe, expect, it } from "vitest";
 import { TestDriver } from "../../lib/vitest/hooks.mjs";
-import { performLogin } from "./setup/testHelpers.mjs";
+
+/**
+ * Perform login flow for SauceLabs demo app
+ * @param {TestDriver} client - TestDriver client
+ * @param {string} username - Username (default: 'standard_user')
+ */
+async function performLogin(client, username = "standard_user") {
+  await client.focusApplication("Google Chrome");
+  const password = await client.extract("the password");
+  const usernameField = await client.find(
+    "Username, label above the username input field on the login form",
+  );
+  await usernameField.click();
+  await client.type(username);
+  await client.pressKeys(["tab"]);
+  await client.type(password, { secret: true });
+  await client.pressKeys(["tab"]);
+  await client.pressKeys(["enter"]);
+}
 
 describe("Hover Text With Description Test", () => {
   it("should add TestDriver Hat to cart and verify", async (context) => {

package/test/testdriver/match-image.test.mjs

@@ -7,7 +7,25 @@ import path, { dirname } from "path";
 import { fileURLToPath } from "url";
 import { describe, expect, it } from "vitest";
 import { TestDriver } from "../../lib/vitest/hooks.mjs";
-import { performLogin } from "./setup/testHelpers.mjs";
+
+/**
+ * Perform login flow for SauceLabs demo app
+ * @param {TestDriver} client - TestDriver client
+ * @param {string} username - Username (default: 'standard_user')
+ */
+async function performLogin(client, username = "standard_user") {
+  await client.focusApplication("Google Chrome");
+  const password = await client.extract("the password");
+  const usernameField = await client.find(
+    "Username, label above the username input field on the login form",
+  );
+  await usernameField.click();
+  await client.type(username);
+  await client.pressKeys(["tab"]);
+  await client.type(password, { secret: true });
+  await client.pressKeys(["tab"]);
+  await client.pressKeys(["enter"]);
+}
 
 // Get the directory of the current module
 const __filename = fileURLToPath(import.meta.url);

package/test/testdriver/scroll-until-text.test.mjs

@@ -5,7 +5,25 @@
 
 import { describe, expect, it } from "vitest";
 import { TestDriver } from "../../lib/vitest/hooks.mjs";
-import { performLogin } from "./setup/testHelpers.mjs";
+
+/**
+ * Perform login flow for SauceLabs demo app
+ * @param {TestDriver} client - TestDriver client
+ * @param {string} username - Username (default: 'standard_user')
+ */
+async function performLogin(client, username = "standard_user") {
+  await client.focusApplication("Google Chrome");
+  const password = await client.extract("the password");
+  const usernameField = await client.find(
+    "Username, label above the username input field on the login form",
+  );
+  await usernameField.click();
+  await client.type(username);
+  await client.pressKeys(["tab"]);
+  await client.type(password, { secret: true });
+  await client.pressKeys(["tab"]);
+  await client.pressKeys(["enter"]);
+}
 
 describe("Scroll Until Text Test", () => {
   it('should scroll until "testdriver socks" appears', async (context) => {