🧇 Waffles

Production-ready Playwright testing utilities for AI applications

Battle-tested helpers from Vex - A production AI platform with 6,813+ commits in 2025

🎯 Why Waffles?

Waffles provides a collection of battle-tested Playwright utilities that make E2E testing delightful. Born from real-world production testing at Vex, these helpers solve common testing challenges like simulating user input, waiting for elements, and generating test data.

✨ Features

• 🎭 Playwright-first - Built specifically for Playwright
• 🧪 Production-tested - Used in Vex's extensive test suite
• 📦 Zero config - Works out of the box
• 🎯 TypeScript - Full type safety
• 🚀 Lightweight - Minimal dependencies

📦 Installation

npm install @chrryai/waffles @playwright/test

🚀 Quick Start

import { test, expect } from "@playwright/test";
import { wait, simulateInputPaste, waitForElement, generateTestEmail } from "@chrryai/waffles";

test("chat interaction", async ({ page }) => {
  await page.goto("https://yourapp.com");

  // Wait for chat to load
  await waitForElement(page, '[data-testid="chat-textarea"]');

  // Simulate pasting text
  await simulateInputPaste(page, "Hello, AI!");

  // Wait for response
  await wait(1000);

  // Assert
  await expect(page.locator(".message")).toBeVisible();
});

📚 API Reference

Timing Utilities

wait(ms: number)

Wait for a specified number of milliseconds.

await wait(1000); // Wait 1 second

waitForElement(page, selector, timeout?)

Wait for an element to be visible.

await waitForElement(page, ".loading-spinner", 5000);

waitForElementToDisappear(page, selector, timeout?)

Wait for an element to disappear.

await waitForElementToDisappear(page, ".loading-spinner");

Input Simulation

simulateInputPaste(page, text, selector?)

Simulate pasting text into a textarea.

await simulateInputPaste(page, "Pasted content");

simulatePaste(page, text, buttonSelector?)

Simulate pasting using clipboard API and clicking paste button.

await simulatePaste(page, "Clipboard content");

Navigation

getURL(options)

Generate a URL with optional fingerprint for testing.

const url = getURL({
  baseURL: "https://app.com",
  path: "/chat",
  isMember: true,
  memberFingerprint: "abc-123",
});

scrollToBottom(page)

Scroll to the bottom of the page.

await scrollToBottom(page);

Utilities

capitalizeFirstLetter(str: string)

Capitalize the first letter of a string.

capitalizeFirstLetter("hello"); // "Hello"

generateTestEmail(prefix?)

Generate a unique test email.

const email = generateTestEmail("user"); // [email protected]

generateTestPassword(length?)

Generate a random password for testing.

const password = generateTestPassword(16);

Cleanup

clearLocalStorage(page)

Clear browser local storage.

await clearLocalStorage(page);

clearCookies(page)

Clear browser cookies.

await clearCookies(page);

Screenshots

takeScreenshot(page, name, fullPage?)

Take a screenshot with a custom name.

await takeScreenshot(page, "error-state", true);

🎨 Real-World Examples

Testing Chat Flow

import { test } from "@playwright/test";
import { simulateInputPaste, waitForElement, wait } from "@chrryai/waffles";

test("complete chat interaction", async ({ page }) => {
  await page.goto("https://app.com/chat");

  // Wait for chat to be ready
  await waitForElement(page, '[data-testid="chat-textarea"]');

  // Send message
  await simulateInputPaste(page, "What's the weather?");
  await page.click('[data-testid="send-button"]');

  // Wait for AI response
  await wait(2000);
  await waitForElement(page, ".ai-message");
});

Testing Authentication

import { test } from "@playwright/test";
import { generateTestEmail, generateTestPassword, wait } from "@chrryai/waffles";

test("user registration", async ({ page }) => {
  const email = generateTestEmail("newuser");
  const password = generateTestPassword();

  await page.goto("https://app.com/signup");
  await page.fill('[name="email"]', email);
  await page.fill('[name="password"]', password);
  await page.click('button[type="submit"]');

  await wait(1000);
  await expect(page).toHaveURL(/dashboard/);
});

🤝 Contributing

We welcome contributions! Waffles is extracted from Vex's production test suite, and we're always improving it.

🔗 Links

• GitHub
• npm
• Issues
• Vex - Powered by Waffles

Built with ❤️ by the Vex team