Playwright Extension

Getting started

1. Introduction — What Donobu is and how it relates to Playwright
2. Installation & Setup — Install and configure Donobu
3. Quick Start — Write and run your first test
4. Playwright Configuration Reference — Recommended playwright.config.ts settings
5. AI Provider Configuration — Choose and configure the underlying LLM
6. Caching System — How flows are cached and replayed
7. Self-Healing Tests — Automatic test repair when the UI changes

API reference

8. page.ai() — Autonomous AI Flow
9. Supplementary page.ai.* methods
   • page.ai.assert — Natural-language assertions
   • page.ai.extract — Structured data extraction
   • page.ai.analyzePageText — Free-form page analysis
   • page.ai.createCookieReport — Cookie audit report
10. Additional page methods
    • page.find — Smart selector with failover
    • page.changeTab — Multi-tab support
    • page.runAccessibilityTest — axe-core accessibility audit
11. Available Tools Reference — All built-in tools page.ai can invoke

Running tests

12. Donobu Playwright Enhancements and Fixtures — The enhanced page fixture, gptClient, storageState, and test report attachments
13. CI/CD Integration — GitHub Actions, result export, cache strategy
14. CLI Reference — npx donobu test and all command-line options
15. Viewing Test Results in Donobu Studio — Studio interface and run inspection
16. Environment Variable Interpolation — {{$.env.VAR_NAME}} syntax and cache-safe dynamic values

Guides

17. Best Practices — Writing reliable, maintainable, cost-efficient tests
18. Troubleshooting & FAQ — Common errors and debugging tips

Advanced topics

• BrowserBase Integration — Cloud browser sessions
• Custom Tools & Persistence Plugins — Extend Donobu with custom tools and storage backends
• page.run() — Direct Tool Invocation — Bypass AI orchestration for deterministic tool calls
• Proxy Configuration — Route browser traffic through an HTTP proxy