# Playwright Extension

## AI-powered Playwright extension that adds autonomous test automation, self-healing, and structured data extraction to your existing test suite.

## Getting started

1. [Introduction](/content/docs/playwright/introduction/index.html) — What Donobu is and how it relates to Playwright
2. [Installation & Setup](/content/docs/playwright/installation/index.html) — Install and configure Donobu
3. [Quick Start](/content/docs/playwright/quick-start/index.html) — Write and run your first test
4. [Playwright Configuration Reference](/content/docs/playwright/playwright-config/index.html) — Recommended `playwright.config.ts` settings
5. [AI Provider Configuration](/content/docs/playwright/ai-providers/index.html) — Choose and configure the underlying LLM
6. [Caching System](/content/docs/playwright/caching/index.html) — How flows are cached and replayed
7. [Self-Healing Tests](/content/docs/playwright/self-healing/index.html) — Automatic test repair when the UI changes

## API reference

8. [`page.ai()` — Autonomous AI Flow](/content/docs/playwright/api/page-ai/index.html)
9. Supplementary `page.ai.*` methods
   - [`page.ai.assert`](/content/docs/playwright/api/page-ai-assert/index.html) — Natural-language assertions
   - [`page.ai.extract`](/content/docs/playwright/api/page-ai-extract/index.html) — Structured data extraction
   - [`page.ai.analyzePageText`](/content/docs/playwright/api/page-ai-analyze-page-text/index.html) — Free-form page analysis
   - [`page.ai.createCookieReport`](/content/docs/playwright/api/page-ai-create-cookie-report/index.html) — Cookie audit report
10. Additional page methods
   - [`page.find`](/content/docs/playwright/api/page-find/index.html) — Smart selector with failover
   - [`page.changeTab`](/content/docs/playwright/api/page-change-tab/index.html) — Multi-tab support
   - [`page.runAccessibilityTest`](/content/docs/playwright/api/page-run-accessibility-test/index.html) — axe-core accessibility audit
11. [Available Tools Reference](/content/docs/playwright/api/tools-reference/index.html) — All built-in tools `page.ai` can invoke

## Running tests

12. [Donobu Playwright Enhancements and Fixtures](/content/docs/playwright/test-fixture/index.html) — The enhanced `page` fixture, `gptClient`, `storageState`, and test report attachments
13. [CI/CD Integration](/content/docs/playwright/ci-cd/index.html) — GitHub Actions, result export, cache strategy
14. [CLI Reference](/content/docs/playwright/cli/index.html) — `npx donobu test` and all command-line options
15. [Viewing Test Results in Donobu Studio](/content/docs/playwright/donobu-studio/index.html) — Studio interface and run inspection
16. [Environment Variable Interpolation](/content/docs/playwright/env-var-interpolation/index.html) — `{{$.env.VAR_NAME}}` syntax and cache-safe dynamic values

## Guides

17. [Best Practices](/content/docs/playwright/best-practices/index.html) — Writing reliable, maintainable, cost-efficient tests
18. [Troubleshooting & FAQ](/content/docs/playwright/troubleshooting/index.html) — Common errors and debugging tips

## Advanced topics

- [BrowserBase Integration](/content/docs/playwright/advanced/browserbase/index.html) — Cloud browser sessions
- [Custom Tools & Persistence Plugins](/content/docs/playwright/advanced/custom-plugins/index.html) — Extend Donobu with custom tools and storage backends
- [`page.run()` — Direct Tool Invocation](/content/docs/playwright/advanced/page-run/index.html) — Bypass AI orchestration for deterministic tool calls
- [Proxy Configuration](/content/docs/playwright/advanced/proxy/index.html) — Route browser traffic through an HTTP proxy