Way.test - UI Recorder & Testing Framework

🎬 Record browser interactions and generate tests automatically

✨ What is Way.test?

Way.test is a UI Recorder that lets you create browser tests by simply interacting with your web application. No more writing selectors manually - just click, type, and interact naturally while the recorder generates production-ready test code.

🎯 Key Features

• 🎬 UI Recorder - Record real browser interactions automatically
• ⚡ Instant Test Generation - Get clean, readable test code immediately
• 🎨 Professional UI - Minimal, non-intrusive recording toolbar
• 🧠 Smart Code Generation - Optimized selectors and consolidated actions
• 🔄 Real-time Preview - See generated code as you interact

🚀 Quick Start

1. Install

npm install --save-dev waytest-ui

That's it! Browser automation is included automatically.

2. Start Recording

# Record interactions on any website
npx waytest record https://your-app.com

# Record on localhost during development  
npx waytest record http://localhost:3000

3. Interact Naturally

A minimal toolbar appears in your browser:

● 👁️ T 🕐 ZZZ {} [0]

• ● Recording indicator
• 👁️ Assert element visibility
• T Assert text content
• 🕐 Wait for elements
• ZZZ Add delays
• {} View generated code
• [0] Action counter

4. Generate Test Code

Click the {} button to see your generated test:

const { way } = require('waytest-ui');

way.test('Login flow', async () => {
  // 🌐 Navigate to login page
  await way.browser.goto('https://your-app.com/login');

  // 👆 Click username field
  await way.browser.click('#username');

  // 📝 Type username
  await way.browser.type('#username', '[email protected]');

  // 👆 Click password field  
  await way.browser.click('#password');

  // 📝 Type password
  await way.browser.type('#password', 'password123');

  // 👆 Click login button
  await way.browser.click('#login-button');

  // ✅ Assert welcome message
  const welcomeText = await way.browser.getText('.welcome');
  way.check(welcomeText).includes('Welcome');
});

5. Run Your Tests

# Run with visible browser (for debugging)
npx waytest --browser login.test.js

# Run in headless mode (for CI/CD)
npx waytest --browser --headless login.test.js

💡 Perfect For

• E-commerce flows - Shopping cart, checkout, payments
• Authentication - Login, signup, password reset
• Form testing - Contact forms, surveys, validation
• User journeys - Multi-step workflows
• Regression testing - Ensure features keep working

🎯 Why Choose Way.test?

✅ vs Manual Test Writing

• 10x Faster - No more writing selectors manually
• Zero Errors - Perfect selectors every time
• Real User Flows - Tests exactly what users do

✅ vs Other Recorders

• Cleaner Code - Optimized, readable test generation
• Professional UI - Minimal, non-intrusive interface
• Smart Features - Action consolidation and selector optimization

✅ Perfect for Teams

• No Learning Curve - Anyone can record tests
• Consistent Quality - Same high-quality tests every time
• Fast Onboarding - New team members productive immediately

📚 Documentation

For complete documentation, examples, and advanced features, visit: 📖 Full Documentation

🤝 Contributing

Way.test is open source and welcomes contributions!

📄 License

MIT License - see LICENSE file for details.

🎬 Start recording your first test in under 30 seconds:

npm install --save-dev waytest-ui
npx waytest record https://your-app.com

Way.test - The fastest way to create reliable browser tests.