Playwright Dart

A complete Dart port of Playwright — fast, reliable browser automation for Chromium, Firefox, and WebKit.

100% API parity with Node.js Playwright v1.60.0, including network interception, tracing, CDP sessions, and the full Locator API.

Features

• 🚀 Launch & control Chromium, Firefox, and WebKit
• 🎯 Locator API with getByRole, getByText, getByLabel, and more
• 🌐 Network interception — abort, mock, and modify requests
• 📸 Screenshots & PDFs — capture pages in any format
• 🔍 Tracing — record and view traces in the Playwright Trace Viewer
• ⚡ Auto-downloads Playwright driver and browser binaries

Installation

dependencies:
  playwright_dart: ^0.1.0

Quick Start

import 'package:playwright_dart/playwright_dart.dart';

void main() async {
  final playwright = await Playwright.create();
  final browser = await playwright.chromium.launch();
  final page = await browser.newPage();

  await page.goto('https://playwright.dev');
  await page.getByRole('link', name: 'Get started').click();
  await page.screenshot(path: 'screenshot.png');

  await browser.close();
}

Locators

Playwright's robust Locator API is fully supported:

// By role
await page.getByRole('button', name: 'Submit').click();

// By text
await page.getByText('Welcome').isVisible();

// By label
await page.getByLabel('Email').fill('user@example.com');

// By test ID
await page.getByTestId('nav-menu').click();

// Chaining
await page.locator('nav').getByText('Docs').click();

// State assertions
final isVisible = await page.locator('.modal').isVisible();
final text = await page.locator('h1').textContent();

Network Interception

Intercept, mock, or abort network requests:

// Block all images
await page.route('**/*.{png,jpg,jpeg}', (route) async {
  await route.abort();
});

// Mock an API response
await page.route('**/api/users', (route) async {
  await route.fulfill(
    status: 200,
    headers: {'content-type': 'application/json'},
    body: '{"users": [{"name": "Alice"}]}',
  );
});

Tracing

Record traces for debugging with the Playwright Trace Viewer:

await browser.startTracing(page: page, screenshots: true);
await page.goto('https://example.com');
final trace = await browser.stopTracing();
// Save trace bytes to a .zip file and open with: npx playwright show-trace trace.zip

CDP Session

Access the Chrome DevTools Protocol directly:

final session = await context.newCDPSession(page);
await session.send('Network.enable');
await session.send('Performance.enable');

API Coverage

Category	Classes
Core	Playwright, Browser, BrowserType, BrowserContext, Page, Frame
Interaction	Locator, ElementHandle, JSHandle, Keyboard, Mouse
Network	Request, Response, Route, APIRequestContext, WebSocket, WebSocketRoute
Utilities	Tracing, CDPSession, Dialog, Worker, Artifact
Debugging	Debugger, DebugController, BindingCall, EventTarget
Platform	Android, AndroidDevice, Electron, ElectronApplication

35 wrapper classes • 308 channel methods • 100% protocol coverage

Contributing

# Regenerate protocol bindings from Playwright source
dart tool/generate_protocol.dart

# Verify 100% API parity
dart tool/find_missing.dart

# Run tests
dart test --concurrency=1

# Static analysis
dart analyze

License

MIT — see LICENSE for details.