webapp-testing
npx machina-cli add skill onurkanbakirci/awesome-skills/47aab118-ddfd-4ebd-9033-80bafcddc47b --openclawFiles (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
- Always verify the app is running - Check that the local server is accessible before running tests
- Use explicit waits - Wait for elements or navigation to complete before interacting
- Capture screenshots on failure - Take screenshots to help debug issues
- Clean up resources - Always close the browser when done
- Handle timeouts gracefully - Set reasonable timeouts for slow operations
- Test incrementally - Start with simple interactions before complex flows
- 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/onurkanbakirci/awesome-skills/blob/main/public/skills/47aab118-ddfd-4ebd-9033-80bafcddc47b/SKILL.mdView on GitHub Overview
Web Application Testing enables comprehensive testing and debugging of local web apps using Playwright automation. It helps verify frontend functionality, UI behavior, and captures logs and screenshots for debugging purposes.
How This Skill Works
The skill automates browser actions (navigate, click, fill, select) and verifies content, while collecting console logs, network insights, and screenshots. It supports responsive checks and asserts on URLs, visibility, and text to validate user flows in a locally running app.
When to Use It
- Test frontend functionality in a real browser
- Verify UI interactions and dynamic behavior
- Debug local web app issues with logs and network inspection
- Capture screenshots for debugging or documentation
- Validate forms, submissions and responsive layouts
Quick Start
- Step 1: Verify the local app is running and accessible
- Step 2: Add explicit waits for elements and navigation before actions
- Step 3: Run tests and capture screenshots on failure, then close the browser
Best Practices
- Ensure the local app is running and reachable before tests
- Use explicit waits for elements and navigation before interactions
- Capture screenshots on failure to aid debugging
- Close the browser and clean up resources after tests
- Prefer data-testid or accessibility selectors over brittle CSS classes
Example Use Cases
- Navigate to a page and verify the page title
- Fill a login form, submit, and verify the resulting URL or dashboard
- Capture a full-page screenshot for debugging
- Test responsive behavior by resizing to multiple viewports
- Listen to and log browser console output during test runs
Frequently Asked Questions
Add this skill to your agents