Skip to content

Commit 653d7c6

Browse files
DavertMikclaude
andcommitted
docs: show how to point the Lightpanda helper at its binary
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
1 parent 4cec688 commit 653d7c6

1 file changed

Lines changed: 19 additions & 2 deletions

File tree

‎docs/alternative-browsers.md‎

Lines changed: 19 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -48,8 +48,25 @@ without changing them: `I.amOnPage`, `I.click`, `I.fillField`, `I.see`, `I.seeEl
4848
sudo mv lightpanda /usr/local/bin/
4949

5050
Other builds (`lightpanda-aarch64-linux`, `lightpanda-x86_64-macos`) are on the
51-
[releases page](https://github.com/lightpanda-io/browser/releases). If you would rather not put it
52-
on `PATH`, leave it anywhere and set `LIGHTPANDA_PATH=/path/to/lightpanda`.
51+
[releases page](https://github.com/lightpanda-io/browser/releases).
52+
53+
You don't have to put it on `PATH`. Keep the binary anywhere and tell the helper where it is,
54+
the way Playwright's `executablePath` points at a custom browser — either in the config:
55+
56+
helpers: {
57+
Lightpanda: {
58+
url: 'http://localhost:3000',
59+
binaryPath: './bin/lightpanda',
60+
},
61+
}
62+
63+
or with an environment variable, handy when the location differs between machines:
64+
65+
LIGHTPANDA_PATH=/opt/lightpanda/lightpanda npx codeceptjs run
66+
67+
The helper looks in this order: `binaryPath`, then `LIGHTPANDA_PATH`, then `lightpanda` on `PATH`.
68+
A relative path is resolved from the directory you run `npx codeceptjs` in. A wrong path fails
69+
the first test with `Failed to start lightpanda at <path>`.
5370

5471
**2. Add the helper next to Playwright.** Keep one config and choose the engine with an
5572
environment variable, so Playwright stays the default:

0 commit comments

Comments
 (0)