healenium-robot-framework-pw-example

Healenium with Robot Framework (Playwright) via robotframework-browser and the healenium-playwright-proxy WebSocket endpoint.

Architecture

Since RobotFramework Browser is the Playwright client (BrowserType.connect over WebSocket)

Healenium Playwright is the WebSocket proxy, that bridges to playwright run-server with healing.

Robot Framework  (healenium_tests, resource.robot)
        |
        |  [test code only]
        v
robotframework-browser  (Node + Playwright connect)
        |
        |  WebSocket
        v
Healenium Playwright Proxy  (:8095, path /hlm-playwright-proxy)
        |
        +---------------->  hlm-backend + postgres-db  (HTTP: healing / storage)
        |
        v  (forwards)
playwright run-server
(browser in container)

How to start

1. Install Robot Framework

Install dependencies and the Browser library’s Playwright bundle:

python3 -m pip install -r requirements.txt
python3 -m Browser.entry init

2. Start Healenium components

Playwright version: the playwright-server image in the compose file must use the same major Playwright as robotframework-browser (the library bundles playwright in its Node wrapper).

The Client version can be checked under …/site-packages/Browser/wrapper/node_modules/playwright-core/package.json after Robot Framework is installed.

Start the Playwright stack:

docker compose -f healenium/docker-compose-pw-proxy.yaml up -d

Verify these services are up:

• postgres-db (PostgreSQL for selectors / healing / report)
• healenium (hlm-backend, port 7878 on the host in this file)
• playwright-server (Playwright run-server, used by the proxy)
• healenium-playwright-proxy (port 8095 — WebSocket path /hlm-playwright-proxy)

3. Connect from tests

Tests use the Browser library: Connect To Browser with a WebSocket URL, not a Selenium http:// Remote WebDriver URL.

*** Variables ***
${PROXY_URL}    ws://localhost:8095/hlm-playwright-proxy
${BROWSER}      chromium

Open Remote Chrome Browser
    PWB.Connect To Browser    ${PROXY_URL}    ${BROWSER}
    PWB.New Page    ${TEST_PAGE}

See healenium_tests/resource.robot for the full resource file (including Library Browser WITH NAME PWB).

4. Run test

From the project root, run the tests in healenium_tests with:

python3 -m robot healenium_tests

Community / Support

• Telegram chat
• YouTube Channel