How marketsquare/robotframework-browser works
Robot Framework Browser exposes browser-automation keywords to Robot test authors. The principal workflow is a test calling a keyword through the Browser library, which sends requests through its Python Playwright client to a Node gRPC service; that service invokes Playwright against a browser and returns results. The keyword surface covers navigation, interaction, locators, evaluation, network, cookies, PDF and related capabilities. The README and source index establish the Python/Node split and many module references; unsampled handler internals and protocol details limit finer-grained call links.
Main entry points: browser.py Browser library · grpc-service.ts gRPC service · playwright.py gRPC client · browser_control.py Browser control
Components 22
Python library
- Browser library
Browser/browser.py - Browser control
Browser/keywords/browser_control.py - Page interaction
Browser/keywords/interaction.py - Page getters
Browser/keywords/getters.py - Playwright state
Browser/keywords/playwright_state.py - Other keywords
Browser/keywords - Assertion polling
Browser/assertion_engine.py - gRPC client
Browser/playwright.py
Node service
- gRPC service
node/playwright-wrapper/grpc-service.ts - Browser control handlers
node/playwright-wrapper/browser-control.ts - Interaction handlers
node/playwright-wrapper/interaction.ts - Getter handlers
node/playwright-wrapper/getters.ts - Browser state
node/playwright-wrapper/playwright-state.ts - Locator handlers
node/playwright-wrapper/locator-handler.ts - Response utilities
node/playwright-wrapper/response-util.ts - Load reporting
node/playwright-wrapper/load-report.ts - RPC schema
protobuf/playwright.proto
Browser runtime
- Playwright
- Browser engine
Automation support
- Argument types
Browser/utils/data_types.py - Robot logging
Browser/utils/logger.py
Other components
- Robot test
Connections 25
- Robot test → Browser library: calls keywords
README.md - Browser library → Browser control: exposes
Browser/browser.py - Browser library → Page interaction: exposes
Browser/browser.py - Browser library → Page getters: exposes
Browser/browser.py - Browser library → Playwright state: exposes
Browser/browser.py - Browser library → Other keywords: loads keywords
Browser/keywords/__init__.py - Browser library → gRPC client: uses client
Browser/browser.py - Browser library → Assertion polling: uses assertions
- Browser library → Argument types: uses types
Browser/browser.py - Browser library → Robot logging: logs through
Browser/browser.py - Browser control → gRPC client: sends requests
- Page interaction → gRPC client: sends requests
- Page getters → gRPC client: sends requests
- Playwright state → gRPC client: sends requests
- gRPC client → gRPC service: RPC requests
- gRPC service → Browser control handlers: dispatches
node/playwright-wrapper/grpc-service.ts - gRPC service → Interaction handlers: dispatches
node/playwright-wrapper/grpc-service.ts - gRPC service → Getter handlers: dispatches
node/playwright-wrapper/grpc-service.ts - gRPC service → Browser state: dispatches
node/playwright-wrapper/grpc-service.ts - gRPC service → Locator handlers: dispatches
node/playwright-wrapper/grpc-service.ts - gRPC service → Response utilities: formats responses
node/playwright-wrapper/grpc-service.ts - gRPC service → Load reporting: wraps navigation
node/playwright-wrapper/grpc-service.ts - gRPC service → RPC schema: uses messages
- Browser state → Playwright: launches browsers
node/playwright-wrapper/playwright-state.ts - Playwright → Browser engine: controls
README.md