browser library

Classes

BrowserConfig
Defines configuration options for launching and running browser-based tests.
BrowserFactory
Creates browser instances with different WebDriver implementations.
BrowserLogger
Structured logger used by the browser bootstrap code.
BrowserManagement
Browser management utilities for installing, updating, and listing browsers.
BrowserPaths
Provides canonical paths and URLs related to browser downloads and installations, mirroring the structure expected by tools like Playwright.
ChromiumType
Implements the BrowserType interface for Google Chrome/Chromium.
Component
Represents a reusable UI component within a web page, forming part of the Page Object Pattern.
EnhancedBrowserLogger
Logger used by browser page/component helpers.
FirefoxType
Implements the BrowserType interface for Mozilla Firefox.
Page
A page object representing a specific page in a web application.
ProxyClient
A simple HTTP client wrapper that sends all requests through a configured proxy.
ProxyConfiguration
Holds configuration details for connecting through an HTTP proxy server.
ScreenshotManager
Manages screenshot capture for browser tests, including automatic capture on failures.
TestBootstrap
Manages global state for the browser test bootstrap process.

Mixins

Browser
Browser automation interface for interacting with web pages.

Functions

browserGroup(String description, {required void define(Browser browser()), BrowserType? browserType, bool? headless, List<String>? args, String? baseUrl, Duration? timeout, Duration? launchTimeout, Map<String, dynamic>? extraCapabilities, ProxyConfiguration? proxy, bool useAsync = true, Device? device}) → void
Defines a group of related browser test cases that share a single browser instance.
browserTest(String description, Future<void> callback(Browser browser), {BrowserType? browserType, bool? headless, List<String>? args, String? baseUrl, Duration? timeout, Duration? launchTimeout, Map<String, dynamic>? extraCapabilities, ProxyConfiguration? proxy, Device? device, bool useAsync = true}) Future<void>
Defines an individual browser test case using the package:test framework.
testBootstrap([BrowserConfig? config]) Future<void>
Configures and initializes the browser testing environment.

Exceptions / Errors

BrowserException
Represents an error that occurred during browser automation or setup.
EnhancedBrowserException
An enhanced browser exception that provides additional context about failed operations.
EnhancedTimeoutException
An enhanced timeout exception that provides additional context about timeout failures.
TimeoutException
An error indicating that an operation did not complete within the expected time limit.