Get the FREE Ultimate OpenClaw Setup Guide →

webapp-testing

npx machina-cli add skill garrettsiegel/lobstore/webapp-testing --openclaw
Files (1)
SKILL.md
3.2 KB

Web Application Testing

This skill enables comprehensive testing and debugging of local web applications using Playwright automation.

When to Use This Skill

Use this skill when you need to:

  • Test frontend functionality in a real browser
  • Verify UI behavior and interactions
  • Debug web application issues
  • Capture screenshots for documentation or debugging
  • Inspect browser console logs
  • Validate form submissions and user flows
  • Check responsive design across viewports

Prerequisites

  • Node.js installed on the system
  • A locally running web application (or accessible URL)
  • Playwright will be installed automatically if not present

Core Capabilities

1. Browser Automation

  • Navigate to URLs
  • Click buttons and links
  • Fill form fields
  • Select dropdowns
  • Handle dialogs and alerts

2. Verification

  • Assert element presence
  • Verify text content
  • Check element visibility
  • Validate URLs
  • Test responsive behavior

3. Debugging

  • Capture screenshots
  • View console logs
  • Inspect network requests
  • Debug failed tests

Usage Examples

Example 1: Basic Navigation Test

// Navigate to a page and verify title
await page.goto('http://localhost:3000');
const title = await page.title();
console.log('Page title:', title);

Example 2: Form Interaction

// Fill out and submit a form
await page.fill('#username', 'testuser');
await page.fill('#password', 'password123');
await page.click('button[type="submit"]');
await page.waitForURL('**/dashboard');

Example 3: Screenshot Capture

// Capture a screenshot for debugging
await page.screenshot({ path: 'debug.png', fullPage: true });

Guidelines

  1. Always verify the app is running - Check that the local server is accessible before running tests
  2. Use explicit waits - Wait for elements or navigation to complete before interacting
  3. Capture screenshots on failure - Take screenshots to help debug issues
  4. Clean up resources - Always close the browser when done
  5. Handle timeouts gracefully - Set reasonable timeouts for slow operations
  6. Test incrementally - Start with simple interactions before complex flows
  7. Use selectors wisely - Prefer data-testid or role-based selectors over CSS classes

Common Patterns

Pattern: Wait for Element

await page.waitForSelector('#element-id', { state: 'visible' });

Pattern: Check if Element Exists

const exists = await page.locator('#element-id').count() > 0;

Pattern: Get Console Logs

page.on('console', msg => console.log('Browser log:', msg.text()));

Pattern: Handle Errors

try {
  await page.click('#button');
} catch (error) {
  await page.screenshot({ path: 'error.png' });
  throw error;
}

Limitations

  • Requires Node.js environment
  • Cannot test native mobile apps (use React Native Testing Library instead)
  • May have issues with complex authentication flows
  • Some modern frameworks may require specific configuration

Source

git clone https://github.com/garrettsiegel/lobstore/blob/main/.github/skills/webapp-testing/SKILL.mdView on GitHub

Overview

This skill enables end-to-end testing and debugging of local web applications using Playwright automation. It covers navigating in real browsers, validating UI interactions, capturing screenshots, and inspecting console logs to diagnose issues.

How This Skill Works

The skill uses Playwright to automate a browser, perform actions (navigate, click, fill, select), and verify outcomes (element presence, text, URLs, responsiveness). It also collects console logs and screenshots for debugging, and emphasizes reliable tests with explicit waits and proper cleanup.

When to Use It

  • Test frontend functionality in a real browser
  • Verify UI behavior and user interactions
  • Debug web application issues with logs and screenshots
  • Capture screenshots for documentation or debugging
  • Validate forms and responsive design across viewports

Quick Start

  1. Step 1: Ensure Node.js and your local app are running
  2. Step 2: Create a Playwright script using page.goto, page.fill, and assertions
  3. Step 3: Run the script and review console logs and screenshots

Best Practices

  • Always verify the local server is running before tests
  • Use explicit waits for elements and navigation
  • Capture screenshots on failure to aid debugging
  • Close the browser to clean up resources
  • Prefer data-testid or accessible selectors over brittle CSS selectors

Example Use Cases

  • Basic Navigation Test — navigate to a page and verify the title
  • Form Interaction — fill a login form and wait for dashboard URL
  • Screenshot Capture — take a full-page screenshot for debugging
  • Console Logs Inspection — capture and print browser logs during tests
  • Responsive Design Check — verify layout across multiple viewports

Frequently Asked Questions

Add this skill to your agents
Sponsor this space

Reach thousands of developers